Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Getting Started: A Quick Tour of the CLI

The following topics can help you (the network administrator) get started with the Junos OS CLI to perform configuration changes, switch between operational mode and configuration mode, create a user account, and execute some of the basic commands.

Note:

If you need a basic introduction to Junos OS, see the Getting Started Guide for Junos OS.

For more in-depth information, as well as to learn how to use Junos OS with Juniper Networks devices, see the Overview for Junos OS.

This Junos OS CLI Guide assumes that you are familiar with Junos OS concepts and operation principles.

Get Started with the Command-Line Interface

This topic shows you how to start the Junos OS CLI, view the command hierarchy, and make minor configuration changes.

Note:

Before you begin, make sure that your device hardware is set up and Junos OS is installed. You must have a direct console connection to the device or network access using SSH or Telnet. If your device is not set up, follow the installation instructions provided with the device before proceeding.

To log in to a device and start the CLI:

  1. Log in as root.

    The root login account has superuser privileges, with access to all commands and statements.

  2. Start the CLI:

    The > command prompt shows that you are in operational mode. Later, when you enter configuration mode, the prompt will change to #.

Note:

If you are using the root account for the first time on the device, remember that the device ships with no password required for root. The first time you commit a configuration, you must set a root password. Root access is not allowed over a telnet session. To enable root access over an SSH connection, you must configure the system services ssh root-login allow statement.

CLI commands can vary by platform and software release. The CLI includes several ways to get help about available commands. This section demonstrates some examples showing how to get help:

  1. Type ? to show the top-level commands available in operational mode.

  2. Type file ? to show all possible completions for the file command.

  3. Type file archive ? to show all possible completions for the file archive command.

Switch Between Operational Mode and Configuration Mode

When you monitor and configure a device running Junos OS, you may need to switch between modes . When you switch between operational mode and configuration mode, the command prompt also changes. The operational mode prompt is a right-angle bracket (>). The configuration mode prompt is a pound or hash sign (#).

To switch between operational mode and configuration mode:

  1. When you log in to the device and type the cli command and press Enter, you are automatically in operational mode:
  2. To enter configuration mode, type the configure command or the edit command in CLI operational mode. The prompt in brackets ([edit]), also known as a banner, shows that you are in configuration mode at the top of the hierarchy. For example:

    The CLI prompt changes from user@host> to user@host#, showing that you are in configuration mode, and a banner appears to indicate the hierarchy level.

  3. You can exit configuration mode and return to operational mode in one of the following ways:
    • To commit the configuration and exit:

    • To exit without committing:

    When you exit configuration mode, the CLI prompt changes from user@host# to user@host>, and the banner no longer appears. You can enter or exit configuration mode as many times as you wish without committing your changes.

  4. To display the output of an operational mode command such as show while in configuration mode, issue the run configuration mode command. Then, specify the operational mode command:

    For example, to display the currently set priority value of the Virtual Router Redundancy Protocol (VRRP) primary device while you are modifying the VRRP configuration for a backup device:

Use Keyboard Sequences to Navigate and Edit the CLI

You can use keyboard sequences in the Junos OS CLI to navigate and edit the command line. You can also use keyboard sequences to scroll through a list of recently executed commands. The following table lists some of the CLI keyboard sequences. They are the same as those used in Emacs.

Table 1: CLI Keyboard Shortcuts

Keyboard sequence

Action

Ctrl+b

Move the cursor back one character.

Esc+b or Alt+b

Move the cursor back one word.

Ctrl+f

Move the cursor forward one character.

Esc+f or Alt+f

Move the cursor forward one word.

Ctrl+a

Move the cursor to the beginning of the command line.

Ctrl+e

Move the cursor to the end of the command line.

Ctrl+h, Delete, or Backspace

Delete the character before the cursor.

Ctrl+d

Delete the character at the cursor.

Ctrl+k

Delete the all characters from the cursor to the end of the command line.

Ctrl+u or Ctrl+x

Delete the all characters from the command line.

Ctrl+w, Esc+Backspace, or Alt+Backspace

Delete the word before the cursor.

Esc+d or Alt+d

Delete the word after the cursor.

Ctrl+y

Insert the most recently deleted text at the cursor.

Ctrl+l

Redraw the current line.

Ctrl+p

Scroll backward through the list of recently executed commands.

Ctrl+n

Scroll forward through the list of recently executed commands.

Ctrl+r

Search the CLI history incrementally in reverse order for lines matching the search string.

Esc+/ or Alt+/

Search the CLI history for words for which the current word is a prefix.

Esc+. or Alt+.

Scroll backward through the list of recently entered words in a command line.

Esc+number sequence or Alt+number sequence

Specify the number of times to execute a keyboard sequence.

Configure a User Account on a Juniper Networks Device

This topic describes how to use a root account to log in to a Juniper Networks device and configure a new user account. You can configure an account for your own use or create a test account.

To configure a new user account on the device:

  1. Log in as root and enter configuration mode:

    The ([edit]) prompt banner shows that you are in configuration edit mode at the top of the hierarchy.

  2. Change to the [edit system login] section of the configuration:

    The prompt in brackets changes to [edit system login] to show that you are at a new level in the hierarchy.

  3. Now add a new user account. In the example, user1 represents a username:

    This example adds an account user1.

    Note:

    User account names can contain a period (.). For example, you can have a user account user.1. However, the username cannot begin or end with a period.

  4. Configure a full name for the account. If the name includes spaces, enclose the entire name in quotation marks (" "):
  5. Configure an account class. The account class sets the user access privileges for the account:
  6. Configure an authentication method and password for the account:

    When the new password prompt appears, enter a clear-text password that the system can encrypt, and then confirm the new password.

  7. Commit the configuration:

    Configuration changes are not active until you commit the configuration. If the commit is successful, a commit complete message appears.

  8. Return to the top level of the configuration, and then exit:
  9. Log out of the device:
  10. To test your changes, log back in with the user account and password you just configured:

    When you log in, you should see the new username at the command prompt.

You have successfully used the CLI to view the device status and perform a simple configuration change.

Note:

For complete information about the commands to issue to configure your device, including examples, see the Junos OS configuration guides.

Use the CLI Editor in Configuration Mode

This topic describes basic commands that you can use to enter configuration mode in the CLI editor. The topic also describes commands that you use to navigate the configuration hierarchy, get help, and commit or revert the changes that you make during the configuration session.

Task

Command/Statement

Example

Edit Your Configuration  

Enter configuration mode.

When you start the CLI, the device is in operational mode. You must explicitly enter configuration mode. When you do, the CLI prompt changes from user@host> to user@host#, and the hierarchy level appears in square brackets.

configure
user@host> configure
[edit]
user@host# 

Create a statement hierarchy.

You can use the edit command to simultaneously create a hierarchy and move to that new level in the hierarchy. You cannot use the edit command to change the value of identifiers.

edit hierarchy-level value
[edit]
user@host# edit security zones security-zone myzone
[edit security zones security-zone myzone]
user@host# 

Create a statement hierarchy, and set identifier values.

The set command is like edit, except that your current level in the hierarchy does not change.

set hierarchy-level value
[edit]
user@host# set security zones security-zone myzone
[edit]
user@host# 
Navigate the Hierarchy  

Navigate down to an existing hierarchy level.

edit hierarchy-level
[edit]
user@host# edit security zones
[edit security zones]
user@host#

Navigate up one level in the hierarchy.

up
[edit security zones]
user@host# up
[edit security]
user@host#

Navigate to the top of the hierarchy.

top 
[edit security zones]
user@host# top
[edit]
user@host#
Commit or Revert Changes  

Commit your configuration.

commit
[edit]
user@host# commit
commit complete

Roll changes back from the current session.

Use the rollback command to revert all changes from the current configuration session. When you run the rollback command before you exit your session or commit changes, the software loads the most recently committed configuration onto the device. You must enter the rollback statement at the edit level in the hierarchy.

rollback 
[edit]
user@host# rollback
load complete
Exit Configuration Mode  

Commit the configuration, and exit configuration mode.

commit and-quit
[edit]
user@host# commit and-quit
user@host>

Exit configuration mode without committing your configuration.

You must navigate to the top of the hierarchy using the up or top commands before you can exit configuration mode.

exit
[edit]
user@host# exit
The configuration has been changed but not committed
Exit with uncommitted changes? [yes,no] (yes)
Get Help  

Display a list of valid options for the current hierarchy level.

?
[edit ]
user@host# edit security zones ?
Possible completions:
   <[Enter]>                Execute this command 
> functional-zone      Functional zone 
> security-zone          Security zones   
|                                  Pipe through a command 
[edit]

Check the Status of a Juniper Networks Device

In operational mode, you can use show commands to check the status of the device and monitor the activities on the device.

To help you become familiar with show commands:

  • Type show ? to display the list of show commands you can use to monitor the router:

  • Use the show chassis routing-engine command to view the Routing Engine status:

  • Use the show system storage command to view available storage on the device:

Roll Back Configuration Changes

This topic shows how to use the rollback command to return your uncommitted but revised configuration to the state of the most recently committed Junos OS configuration. The rollback command is useful if you make configuration changes and then decide not to keep them.

The following procedure shows how to configure an SNMP health monitor on a Juniper Networks device and then return to the most recently committed configuration that does not include the health monitor. When configured, the SNMP health monitor provides the network management system (NMS) with predefined monitoring for file system usage, CPU usage, and memory usage on the device.

  1. Enter configuration mode:

  2. Show the current configuration (if any) for SNMP:

    No snmp statements appear because SNMP has not been configured on the device.

  3. Configure the health monitor:

  4. Show the new configuration:

    The health-monitor statement indicates that SNMP health monitoring is configured on the device.

  5. Enter the rollback configuration mode command to return to the most recently committed configuration:

  6. Show the configuration again to make sure your change is no longer present:

    No snmp configuration statements appear. The health monitor is no longer configured.

  7. Enter the commit command to activate the configuration to which you rolled back:

  8. Exit configuration mode:

You can also use the rollback command to return to earlier configurations.

Configure a Routing Protocol

This topic provides a sample configuration that describes how to configure an OSPF backbone area that has two SONET interfaces.

The final configuration looks like this:

Shortcut

You can create a shortcut for this entire configuration with the following two commands:

Longer Configuration

This section provides a longer example of creating the previous OSPF configuration. In the process, it illustrates how to use the different features of the CLI.

  1. Enter configuration mode by issuing the configure command:

    Notice that the prompt has changed to a pound or hash sign (#) to indicate configuration mode.

  2. To create the above configuration, you start by editing the protocols ospf statements:
  3. Now add the OSPF area:
  4. Add the first interface:

    You now have four nested statements.

  5. Set the hello and dead intervals.
  6. You can see what is configured at the current level with the show command:
  7. You are finished at this level, so go up a level and view what you have done so far:

    The interface statement appears because you have moved to the area statement.

  8. Add the second interface:
  9. Move up to the top level and review what you have:

    This configuration now contains the statements that you want.

  10. Before committing the configuration (and thereby activating it), verify that the configuration is correct:
  11. Commit the configuration to activate it on the device:

Make Changes to a Routing Protocol Configuration

Suppose you decide to use different dead intervals and hello intervals on interface so-0/0/1. You can make changes to the configuration.

  1. Go directly to the appropriate hierarchy level by typing the full hierarchy path to the statement that you want to edit:
  2. If you decide not to run OSPF on the first interface, delete the statement:

    Everything inside the statement you deleted was deleted with it. You can also eliminate the entire OSPF configuration by simply entering delete protocols ospf while at the top level.

  3. Maybe you decide to use the default values for the hello intervals and dead intervals on your remaining interface but want OSPF to run on that interface. In that case, delete the hello interval timer and dead interval timer:

    You can set multiple statements at the same time as long as they are all part of the same hierarchy. The hierarchy consists of the path of statements from the top inward, as well as one or more statements at the bottom of the hierarchy. Setting multiple statements at the same time can reduce considerably the number of commands you must enter.

  4. To go back to the original hello interval timer and dead interval timer on interface so-0/0/1, enter:
  5. You also can re-create the other interface, as you had it before, with only a single entry: