2.12. Basic CLI Command Reference

This command moves the context back one level of the command hierarchy. For example, if the current level is the config router ospf context, the back command moves the cursor to the config router context level.

This command echoes arguments on the command line. The primary use of this command is to allow messages to be displayed to the screen in files executed with the exec command.

See the description for the admin-password command. If the admin-password is configured in the config>system>security>password context, then any user can enter a special administrative mode by entering the enable-admin command.

enable-admin is in the default profile. By default, all users are given access to this command.

Once the enable-admin command is entered, the user is prompted for a password. If the password matches, the user is given unrestricted access to all the commands.

The minimum length of the password is determined by the minimum-length command. The complexity requirements for the password are determined by the complexity command.

The following shows a password configuration example:

There are two ways to verify that a user is in the enable-admin mode:

This command executes the contents of a text file as if they were CLI commands entered at the console.

exec commands do not have no versions.

Related Commands:

boot-bad-exec: Use this command to configure a URL for a CLI script to exec following a failed configuration boot.

boot-good-exec: Use this command to configure a URL for a CLI script to exec following a successful configuration boot.

<<: Stdin can be used as the source of commands for the exec command. When stdin is used as the exec command input, the command list is terminated with <Ctrl-C>, “EOF<Return>” or “eof_string<Return>”.

If an error occurs entering an exec file sourced from stdin, all commands after the command returning the error will be silently ignored. The exec command will indicate the command error line number when the stdin input is terminated with an end-of-file input.

This command returns to the context from which the current level was entered. For example, to navigate to the current level on a context by context basis, then the exit command only moves the cursor back one level.

When navigating to the current level by entering a command string, the exit command returns the cursor to the context in which the command was initially entered.

The exit all command moves the cursor all the way back to the root level.

This command provides a brief description of the help system. The following information is shown:

This command lists the last 30 commands entered in this session.

Re-execute a command in the history with the !n command, where n is the line number associated with the command in the history output.

Example:

This command displays the running configuration for the configuration context.

The output of this command is similar to the output of the admin display-config command. This command, however, lists the configuration of the context where it is entered and all branches below that context level.

By default, the command only enters the configuration parameters that vary from the default values. The detail keyword causes all configuration parameters to be displayed. The “include-dynamic” objective keyword includes configuration parameters from dynamic sources such as VSD or dynamic data service Python scripts. These dynamic configuration parameters are not saved in the configuration file.

Example:

This command logs out of the router session.

When the logout command is issued from the console, the login prompt is displayed, and any log IDs directed to the console are discarded. When the console session resumes (regardless of the user), the log output to the console resumes.

When a Telnet session is terminated from a logout command, all log IDs directed to the session are removed. When a user logs back in, the log IDs must be re-created.

This command is used to print relevant multicast information from the target multicast router. Information displayed includes adjacency information, protocol, metrics, thresholds, and flags from the target multicast route.

This command traces a multicast path from a source to a receiver and displays multicast packet rate and loss information.

This command traces a multicast path from a source to a receiver.

This command changes a user’s CLI login password.

When a user logs in after the administrator forces a new-password-at-login, or the password has expired (aging), then this command is automatically invoked.

When invoked, the user is prompted to enter the old password, the new password, and then the new password again to verify the correct input.

If a user fails to create a new password after the administrator forces a new-password-at-login or after the password has expired, the user is not allowed to access the CLI.

A user cannot configure a non-conformant password for themselves using the global password command. A password value that does not conform to the minimum-length or other password complexity rules can be configured using the config>system>security>user>password command (for example, by an administrator), but a warning is provided in the CLI. This allows, for example, an administrator to configure a non-conformant password for a user.

This command is the TCP/IP utility that is used to verify IP reachability.

This command displays the present or previous working context of the CLI session. The pwc command provides a user who is in the process of dynamically configuring a chassis a way to display the current or previous working context of the CLI session. The pwc command displays a list of the CLI nodes that hierarchically define the current context of the CLI instance of the user.

The following example is from a 7750 SR:

When the previous keyword is specified, the previous context displays. This is the context entered by the CLI parser upon execution of the exit command. The current context of the CLI is not affected by the pwc command.

The following example is from a 7450 ESS:

This command causes the console session to pause operation (sleep) for 1 second (default) or for the specified number of seconds.

This command initiates a client SSH session with the remote host and is independent from the administrative or operational state of the SSH server. However, to be the target of an SSH session, the SSH server must be operational.

Quitting SSH while in the process of authentication is accomplished by either executing a ctrl-c or "~." (tilde and dot) assuming the “~” is the default escape character for SSH session.

This command opens a Telnet session to a remote host. Telnet servers in SR-series networks limit Telnet clients to three attempts to login; this number is not user configurable. The Telnet server disconnects the Telnet client session after three attempts.

The TCP/IP traceroute utility determines the route to a destination address. Note that aborting a traceroute with the <Ctrl-C> command could require issuing a second <Ctrl-C> command before the prompt is returned.

This command displays the command hierarchy structure of the current working context.

This command sends a console message to a specific user or to all users with active console sessions.

This command monitors policer statistics in an ingress FP queue group.

Displays monitor command output of traffic statistics for Cross Connect Aggregation Groups (CCAGs) ports.

This command displays monitor command output for CPM filters.

This command displays monitor command statistics for IP filter entries.

This command displays monitor command statistics for IPv6 filter entries.

This command displays monitor command statistics for MAC filter entries.

This command enables the context to configure criteria to monitor IP and MAC filter statistics.

This command enables IP filter monitoring. The statistical information for the specified IP filter entry displays at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified IP filter. The subsequent statistical information listed for each interval is displayed as a delta to the previous display.

When the keyword rate is specified, the rate-per-second for each statistic is displayed instead of the delta.

Monitor commands are similar to show commands but only statistical information displays. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

This command enables IPv6 filter monitoring. The statistical information for the specified IPv6 filter entry displays at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified IPv6 filter. The subsequent statistical information listed for each interval is displayed as a delta to the previous display.

When the keyword rate is specified, the rate-per-second for each statistic is displayed instead of the delta.

Monitor commands are similar to show commands but only statistical information displays. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

This command enables MAC filter monitoring. The statistical information for the specified MAC filter entry displays at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified MAC filter. The subsequent statistical information listed for each interval is displayed as a delta to the previous display. When the keyword rate is specified, the rate-per-second for each statistic is displayed instead of the delta.

Monitor commands are similar to show commands but only statistical information displays. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

This command monitors traffic statistics for Link Aggregation Group (LAG) ports. Statistical information for the specified LAG ID(s) displays at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified LAG ID. The subsequent statistical information listed for each interval is displayed as a delta to the previous display. When the keyword rate is specified, the rate-per-second for each statistic is displayed instead of the delta.

Monitor commands are similar to show commands but only statistical information displays. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

This command enables the context to monitor management-access filters. These filters are configured in the config>system>security>mgmt-access-filter context.

This command monitors statistics for the MAF IP filter entry.

This command monitors statistics for the MAF IPv6 filter entry.

This command monitors statistics for the MAF MAC filter entry.

This command enables port traffic monitoring. The specified port(s) statistical information displays at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified port(s). The subsequent statistical information listed for each interval is displayed as a delta to the previous display.

When the rate is specified, the rate-per-second for each statistic is displayed instead of the delta.

Monitor commands are similar to show commands but only statistical information displays. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

This command enables the context to configure criteria to monitor QoS scheduler statistics for specific customers and SAPs.

This command enables the context to configure monitor commands for arbiter statistics.

This command monitors arbiter statistics in an ingress FP queue group.

This command monitors arbiter statistics for a customer site.

This command monitors arbiter statistics for a customer site.

This command monitors arbiter statistics for a SAP.

This command monitors arbiter statistics for a subscriber.

This command monitors expanded secondary shaper statistics.

This command enables the context to configure monitor commands for scheduler statistics.

Use this command to monitor scheduler statistics per customer multi-service-site. The first screen displays the current statistics related to the specified customer ID and customer site name. The subsequent statistical information listed for each interval is displayed as a delta to the previous display. When the keyword rate is specified, the rate-per-second for each statistic is displayed instead of the delta. Monitor commands are similar to show commands but only statistical information displays. These commands display selected statistics per the configured number of times at the interval specified.

This command monitors scheduler statistics in a port queue group or a VPORT.

Use this command to monitor scheduler statistics for a SAP at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified SAP. The subsequent statistical information listed for each interval is displayed as a delta to the previous display.

When the keyword rate is specified, the rate-per-second for each statistic is displayed instead of the delta.

Monitor commands are similar to show commands but only statistical information displays. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

This command monitors scheduler statistics for a SAP encap-group.

This command monitors scheduler statistics for a subscriber.

This command enables the context to configure criteria to monitor statistical information for a variety of routing protocols.

This command monitors commands for the BGP instance.

This command displays statistical BGP neighbor information at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified neighbor(s). The subsequent statistical information listed for each interval is displayed as a delta to the previous display.

When the keyword rate is specified, the rate-per-second for each statistic is displayed instead of the delta.

Monitor commands are similar to show commands but only statistical information displays. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

This command monitors commands for the ISIS instance.

This command displays statistical IS-IS traffic information at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified router statistics. The subsequent statistical information listed for each interval is displayed as a delta to the previous display. When the keyword rate is specified, the rate-per-second for each statistic is displayed instead of the delta.

Monitor commands are similar to show commands but only statistical information displays. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

This command monitors commands for the LDP instance.

This command monitors egress statistics for LDP FEC prefixes.

This command displays statistical information for LDP sessions at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified LDP session(s). The subsequent statistical information listed for each interval is displayed as a delta to the previous display.

When the keyword rate is specified, the rate-per-second for each statistic is displayed instead of the delta.

Monitor commands are similar to show commands but only statistical information displays. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

Monitor statistics for LDP instance at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the LDP statistics. The subsequent statistical information listed for each interval is displayed as a delta to the previous display. When the keyword rate is specified, the rate-per-second for each statistic is displayed instead of the delta.

Monitor commands are similar to show commands but only statistical information displays. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

This commands monitors commands for the MPLS instance.

This command displays statistics for MPLS interfaces at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the MPLS interface(s). The subsequent statistical information listed for each interval is displayed as a delta to the previous display. When the keyword rate is specified, the rate-per-second for each statistic is displayed instead of the delta.

Monitor commands are similar to show commands but only statistical information displays. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

This command displays egress statistics for LSP interfaces at the configured interval until the configured count is reached.

This command displays ingress statistics for LSP interfaces at the configured interval until the configured count is reached.

This command monitors MPLS TP LSP egress statistics.

This command monitors MPLS TP LSP ingress statistics.

This command enables the context to configure monitor commands for the OSPF instance.

This command enables the context to configure monitor commands for the OSPF3 instance.

This command displays statistics for OSPF interfaces at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the OSPF interface(s). The subsequent statistical information listed for each interval is displayed as a delta to the previous display.

When the keyword rate is specified, the rate-per-second for each statistic is displayed instead of the delta.

Monitor commands are similar to show commands but only statistical information displays. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

This command displays statistical OSPF or OSPF3 neighbor information at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified OSPF neighbor(s). The subsequent statistical information listed for each interval is displayed as a delta to the previous display.

When the keyword rate is specified, the rate-per-second for each statistic is displayed instead of the delta.

Monitor commands are similar to show commands but only statistical information displays. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

This command displays statistical OSPF virtual link information at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified neighbor(s). The subsequent statistical information listed for each interval is displayed as a delta to the previous display.

When the keyword rate is specified, the rate-per-second for each statistic is displayed instead of the delta.

Monitor commands are similar to show commands but only statistical information displays. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

This command displays statistical OSPF virtual neighbor information at the configured interval until the configured count is reached.

The first screen displays the current statistics related to the specified OSPF virtual neighbor router. The subsequent statistical information listed for each interval is displayed as a delta to the previous display.

When the keyword rate is specified, the rate-per-second for each statistic is displayed instead of the delta.

Monitor commands are similar to show commands but only statistical information displays. Monitor commands display the selected statistics according to the configured number of times at the interval specified.

This command monitors commands for the PIM instance.

This command monitors statistics for a PIM source group.

This command monitors commands for the RIP instance.