|
|
The command line interface (CLI) enables displaying and setting the various ONS 15194 options and general management of the ONS 15194, including the definition of nodes and configuration of logical rings, as well as displaying the status of the ONS 15194. All available commands are described in this chapter. Use of these commands to configure your ONS 15194 and examples of their use are presented in the chapter "Configuring the ONS 15194."
The command line interface reference is presented in the following sections:
In general, the ONS 15194 command line interface (CLI) is very similar to the Cisco IOS software. This section describes a number of general features of Cisco IOS that are implemented in the ONS 15194 CLI as well. For a more detailed explanation of Cisco IOS, see the Cisco IOS documentation.
(For information on the conventions used in the Cisco IOS documentation set, see the "About the Cisco IOS Software Documentation" chapter in the Cisco IOS Configuration Fundamentals Configuration Guide.)
The Cisco IOS user interface is divided into many different modes. The commands available to you at any given time depend on which mode you are currently in. Entering a question mark (?) at the ONS 15194 prompt allows you to obtain a list of commands available for each command mode.
When you log in to the Cisco IOS software, you begin in user mode, often called EXEC mode. Only a limited subset of the commands are available in EXEC mode. To have access to all commands, you must enter privileged EXEC mode. Normally, you must enter a password to enter privileged EXEC mode. From privileged mode, you can enter any EXEC command or enter global configuration mode. Most of the EXEC commands are one-time commands, such as show commands, that show important status information, and clear commands, that clear counters or interfaces. The EXEC commands are not saved when the networking device reboots.
The configuration modes allow you to make changes to the running configuration. In the ONS 15194, there are two separate configuration modes:
The various command modes of the ONS 15194, follow in Table 5-1.
| Command Mode | Access Method | Prompt | Exit Method |
|---|---|---|---|
User EXEC | Log in | ons15194> | Use the exit command |
Privileged EXEC | From user EXEC mode, use the enable EXEC command. | ons15194# | To exit back to user EXEC mode, use the disable command. To enter global configuration mode, use the configure terminal privileged EXEC command. |
Global configuration | From privileged EXEC mode, use the configure terminal privileged EXEC command. | ons15194(config)# | To exit privileged EXEC mode, use the exit or end command or press Ctrl-Z. To enter interface or line configuration mode, use an interface or line configuration command. |
Interface configuration | From global configuration mode, enter by specifying an interface with an interface command. | ons15194(config-if)# | To exit to global configuration, use the exit command To exit to privileged EXEC mode, use the end command or press Ctrl-Z. |
Line configuration | From global configuration mode, enter by specifying a line with the line command. | ons15194(config-line)# | To exit to global configuration, use the exit command. To exit to privileged EXEC mode, use the end command or press Ctrl-Z. |
rconf configuration | From privileged EXEC mode, use the rconf privileged EXEC command. | ons15194(rconf)# | To exit to privileged EXEC mode, use either the end or exit command. |
Entering a question mark (?) at the ONS 15194 prompt displays a list of commands available for each command mode. You can also get a list of keywords and arguments associated with any command by using the context-sensitive help feature.
To get help for a specific command mode, command, keyword, or argument, use one of the following commands:
| Command | Description |
|---|---|
help | Presents a brief description of the help system in any command mode. |
abbreviated-command-entry? | Lists all commands that begin with a particular character string. (No space between command and question mark.) |
abbreviated-command-entry<Tab> | Completes a partial command name. |
? | Lists all commands available for a particular command mode. |
command ? | Lists the keywords or arguments that you must enter next on the command line. (Space between command and question mark.) |
The following example illustrates how the context-sensitive help feature enables you to create a new node using the node rconf configuration command. To list all possible keywords and a brief explanation of each, enter a question mark (?) at the ONS 15194 prompt.
ons15194(rconf)# ?
apply Apply draft configuration to running configuration
autoconnect-to-draft Autoconnect all nodes (in draft configuration)
clear-draft Set draft configuration to null
display Display configuration
end exit from rconf mode
exit exit from rconf mode
help Description of the interactive help system
io-autoconnect-to-draft Inner/Outer autoconnect all nodes (in draft configuration)
no Negate a command or set its defaults
node Node configuration
pos POS connection configuration
revert-to-running Revert draft configuration to running configuration
ring Ring connection configuration
sniff Sniff connection configuration
Each successive keyword can be followed by a question mark (?) to determine the format of the options to follow.
ons15194(rconf)# node ?
all All nodes
autodetect Auto-detect nodes
create Create new node
io-autodetect Inner/Outer Auto-detect nodes
NODE Node identifier
nod1
nod2
ny
baltimore
ons15194(rconf)# node create ?
aps APS node
fiber Fiber node
pos POS node
sniff Sniffer node
srp SRP node
srp-inner SRP Inner node
srp-outer SRP Outer node
ons15194(rconf)# node create srp ?
WORD SRP node name
Many configuration commands have a no form. In general, use the no form to disable a function. Use the command without the keyword no to reenable a disabled function or to enable a function that is disabled by default.
For example, E-IPS functionality is disabled by default. To enable E-IPS, use the eips enable command and specify no eips enable to disable it.
The ONS 15194 CLI editing features are, to a great extent, taken from features used in UNIX, EMACS, and 4NT systems. The CLI supports VT100 emulation. In order to use the arrow keys, the VT100 arrows option in the Telnet terminal configuration must be enabled.
Use the following keyboard commands to move the line cursor on the screen:
| Keyboard Command | Move Cursor |
|---|---|
| One character to the right. |
| One character to the left. |
Ctrl-A | To the start of the line. |
Ctrl-E | To the end of the line. |
Esc-F | Forward one letter. |
Esc-B | Backward one letter. |
Use the following keyboard commands to move the cursor between commands:
| Keyboard command | Action |
|---|---|
| Move cursor to the previous command with the same prefix as the current command. Up to 40 previous commands are maintained in the history buffer. |
| Move cursor to the next command with the same prefix as the original command. |
Ctrl-L or Ctrl-R | Redisplay the current command line. |
Use these commands to edit at the command line:
| Command | Action |
|---|---|
Ctrl-D | Delete the character where the cursor is located. |
Esc-D | Delete the word where the cursor is located (from the cursor position to the end of the word). |
Backspace, Ctrl-H | Delete the character before the current location of the cursor. |
Ctrl-K | Delete the entire line (from the cursor position to the end of the line). |
Ctrl-U, Ctrl-X | Delete all characters from the cursor to the beginning of the command line. |
Ctrl-W | Delete the word to the left of the cursor. |
Ctrl-Y | Recall the last item deleted. |
Similar to UNIX systems, the ONS 15194 CLI supports some shell processing, such as history and modification commands.
| Command | Action |
|---|---|
** | Execute the previous command |
*# | Execute command number # (command numbers are displayed with the history command) |
*-# | Execute the command that was executed # number of times ago |
*str | Execute the previous command, starting with the str prefix |
^string1^string2 | Replace the first occurrence of string1 in the previous command with string2, and then execute the modified command |
:p at all shell commands 1 | Add the command to the history buffer without executing the command |
| 1For example, !5:p |
Whenever an error is entered, the location of the problem will be indicated by the display of a small arrow (^). Whenever a command is incomplete, an appropriate error message will be displayed.
All valid ONS 15194 commands are described in this section. Commands appear in alphabetical order. A complete list of commands and their respective mode are given in
| Command | Description | Command Mode |
|---|---|---|
Enables AAA accounting for billing or security. | global | |
Specifies default enable authentication methods. | global | |
Specifies default login authentication methods. | global | |
Enables user EXEC and privileged EXEC command authorization. | global | |
Enables configuration command authorization. | global | |
Applies the current draft configuration changes to the running configuration. | rconf | |
Automatically detects all connected SRP nodes and configures them into default rings. | privileged EXEC | |
Automatically detects all connected SRP nodes and configures them into default rings, in the draft configuration only. | rconf | |
Tracks nodes when they are disconnected and reconnected to the ONS 15194. | privileged EXEC | |
Specifies a message to be used as the message-of-the-day. | global | |
Modifies the boot configuration file. | global | |
Modifies the boot image file. | global | |
Sets the ONS 15194 calendar. | privileged EXEC | |
Changes the default directory or file system. | privileged EXEC | |
Deletes all dynamic entries from the ARP cache on the Ethernet interface. | privileged EXEC | |
Clears the POS counters. | privileged EXEC | |
Returns a terminal line to the idle state. | privileged EXEC | |
Clears the interface-data-stats and node-data-stats files. | privileged EXEC | |
Clears messages from the logging buffer. | privileged EXEC | |
Reverts draft configuration to null. | rconf | |
Sets the ONS 15194 clock. | privileged EXEC | |
Sets the time zone for display purposes. | global | |
Enters global configuration mode. | privileged EXEC | |
Copies a configuration file from the Flash memory to the running configuration. | privileged EXEC | |
Copies a configuration file from a source destination to the running configuration. | privileged EXEC | |
Logs on to a host that supports Telnet. | EXEC | |
Copies any file from a source to a destination. | privileged EXEC | |
Copies the data statistics internal binary file to a destination text file. | privileged EXEC | |
Deletes a file from a file system. | privileged EXEC | |
Displays a list of files on a file system. | privileged EXEC | |
Exits privileged EXEC command mode and returns to user EXEC mode. | privileged EXEC | |
Displays the draft configuration (the configuration that has not yet been applied). | rconf | |
Displays the current running configuration which was last applied. | rconf | |
Specifies the amount of time the ONS 15194 waits after receiving an SRR failure before bypassing the node. | global | |
Enables enhanced-IPS capabilities. | global | |
Specifies a wait-to-restore period for SRP nodes. | global | |
Enters privileged EXEC command mode. | user EXEC | |
Sets a local password to control access to privileged EXEC mode. | global | |
Exits configuration modes. | global, interface, rconf, line | |
Erases the ONS 15194 startup configuration. | privileged EXEC | |
Sets the interval that the EXEC command interpreter waits until user input is detected. | line | |
Exits command mode or closes active terminal session and terminates the EXEC. | all | |
Formats a file system. | privileged EXEC | |
Checks a file system for damage and optionally repairs any found problems. | privileged EXEC | |
Specifies the default SRP framing type. | global | |
Displays a brief description of the help system. | EXEC | |
Specifies or modifies the host name of the ONS 15194. | global | |
Causes all LEDs associated with a particular slot or interface to blink. | privileged EXEC | |
Stops the laser transmission on a particular interface. | privileged EXEC | |
Places an interface into loopback mode. | privileged EXEC | |
Resets a specific card in the ONS 15194. | privileged EXEC | |
Disables a specific slot in the chassis. | global | |
Temporarily changes the transmitted pathtrace message. | privileged EXEC | |
Enters interface configuration mode. | global | |
Automatically detects all connected inner-outer SRP nodes and configures them into default rings. | privileged EXEC | |
Automatically detects all connected inner-outer SRP nodes and configures them into default rings, in the draft configuration only. | rconf | |
Sets the IP address for an interface. | interface | |
Defines a default gateway. | global | |
Defines a default domain name that is used to complete unqualified host names. | global | |
Specifies a default password to use for FTP connections. | global | |
Specifies a default username to use for FTP connections. | global | |
Specifies the address of one or more name servers. | global | |
Changes the switching control for APS nodes. | privileged EXEC | |
Enters line configuration command mode. | global | |
Logs messages to a syslog server host. | global | |
Logs messages to an internal buffer. | global | |
Limits messages logged to the console based on severity. | global | |
Limits messages logged to the maintenance port based on severity. | global | |
Limits messages logged to terminal lines based on severity. | global | |
Limits messages logged to the ONS 15194 servers based on severity. | global | |
Creates a new directory in a file system. | privileged EXEC | |
Displays the contents of a file. | privileged EXEC | |
Displays the message-of-the-day. | global | |
Disables support for SNMP. | EXEC | |
Automatically detects new nodes. | rconf | |
Configures a new node. | rconf | |
Bypasses a node. | rconf | |
Defines the interfaces to which a node is connected. | rconf | |
Automatically detects new inner/outer nodes. | rconf | |
Renames a node. | rconf | |
Specifies the AIS properties for a node. | rconf | |
Specifies the clock source for a node. | rconf | |
Specifies whether a node is configured for SDH or SONET. | rconf | |
Specifies the BER threshold for a signal degrade or signal fail. | rconf | |
Specifies the switching mode of APS nodes to be revertive. | rconf | |
Specifies that the pathtrace message (PTM) reflect the PTM of the connected node. | global | |
Pings a host. | EXEC | |
Connects two POS or APS nodes. | rconf | |
Shows the current settings of the cd command. | privileged EXEC | |
Enters rconf configuration command mode. | privileged EXEC | |
Halts the software and performs a cold restart. | privileged EXEC | |
Renames a file in a file system. | privileged EXEC | |
Reverts draft configuration to running configuration. | rconf | |
Adds a node to a ring or reorders a node in a ring. | rconf | |
Defines a new SRP ring. | rconf | |
Adds multiple nodes to a ring. | rconf | |
Renames a ring. | rconf | |
Removes a directory from a file system. | privileged EXEC | |
Sends messages to one or all Telnet sessions. | privileged EXEC | |
Initially configures the network parameters, enable secret and configuration file. | privileged EXEC | |
Displays information about the chassis. | EXEC | |
Displays status information for APS nodes. | EXEC | |
Displays the entries in the ARP table. | EXEC | |
Displays the status of th autotrack capability. | EXEC | |
Displays the contents of the BOOT environment variable and the name of the configuration file pointed to by the CONFIG_FILE environment variable. | EXEC | |
Displays the | EXEC | |
Displays the calendar hardware setting. | EXEC | |
Displays the SONET indications. | EXEC | |
Displays whether E-IPS is enabled or not. | EXEC | |
Displays the status and temperature of all cards in the ONS 15194. | EXEC | |
Displays the file systems on the ONS 15194. | EXEC | |
Lists the commands you entered in the current EXEC session. | EXEC | |
Displays status information about a card. | EXEC | |
Displays the current status for an interfaces. | EXEC | |
Displays the POS counters for an interface. | EXEC | |
Displays information about the Ethernet interface. | EXEC | |
Displays the laser monitor status for an interface. | EXEC | |
Displays the packet monitoring counters for an interface. | EXEC | |
Displays the received pathtrace messages. | EXEC | |
Displays the SRR status of an interface. | EXEC | |
Displays the transmitted pathtrace message. | EXEC | |
Displays the current state of the routing table. | EXEC | |
Displays the contents of the logging buffer. | privileged EXEC | |
Displays statistics about the ONS 15194 memory. | EXEC | |
Displays information about the configuration of the node. | EXEC | |
Displays data statistics for the node. | EXEC | |
Displays the privilege command level. | EXEC | |
Displays information about the currently running processes | EXEC | |
Displays the current running configuration which was last applied. | EXEC | |
Display information about ONS 15194 redundancy. | EXEC | |
Displays the running configuration. | privileged EXEC | |
Displays the status of SNMP communications. | EXEC | |
Displays the current UTC and SNTP server. | EXEC | |
Displays SRR information about ONS 15914 nodes. | EXEC | |
Displays the current configuration file saved to Flash memory. | EXEC | |
Displays SRR information for ONS 15194 nodes. | EXEC | |
Displays information about active SSH sessions. | EXEC | |
Displays a log of information about the ONS 15194 for troubleshooting purposes. | EXEC | |
Displays whether or not the temperature protection mechanism is enabled. | EXEC | |
Displays information about the terminal configuration parameter settings. | EXEC | |
Displays the status of the Telnet daemon | EXEC | |
Displays information about the active lines. | EXEC | |
Displays the configuration of the ONS 15194 hardware, software version, names and sources of configuration files and boot images. | EXEC | |
Configures a node to be monitored by a sniff node. | rconf | |
Enables support for SNMP. | global | |
Sets the ONS 15194 contact. | global | |
Sets the ONS 15194 description. | global | |
Enables the ONS 15194 to send SNMP traps and informs. | global | |
Specifies the recipient of an SNMP notification. | global | |
Sets the system location. | global | |
Configures the system to use SNTP to request and accept NTP traffic from a time server. | global | |
Sets the terminal baud rate. | line | |
Specifies a TACACS+ server host. | global | |
Sets the encryption key to be used for TACACS+ communications. | global | |
Specifies a timeout value for communications with the TACACS+ servers. | global | |
Logs on to a host that supports Telnet. | user EXEC | |
Disables the temperature protection capability. | global | |
Specifies the number of lines on the current terminal screen for the current session | privileged EXEC | |
Displays debug command output to the terminal. | privileged EXEC | |
Begins or ends mirroring of a Telnet session. | privileged EXEC | |
Enables or disables additional Telnet sessions. | privileged EXEC | |
Discover the routes that packets will actually take when traveling to their destination. | privileged EXEC | |
Verifies the checksum of a file on a Flash memory file system. | privileged EXEC | |
Erases all system configurations and resets the factory defaults. | privileged EXEC | |
Writes the currently running configuration to Flash memory. | privileged EXEC | |
Writes the contents of the configuration file to a TFTP server. | privileged EXEC | |
Writes the contents of the running configuration to the terminal. | privileged EXEC |
To enable AAA accounting of requested services for billing or security purposes when you use TACACS+, use the aaa accounting command in global configuration mode. Use the no form of this command to disable accounting.
aaa accounting {system | exec | commands level} default {start-stop | stop-only} tacacs+
Syntax Description
system Performs accounting for all system-level events not associated with users, such as reloads. exec Provides information about user EXEC terminal sessions on the ONS 15194 including username, date, start and stop times and the user terminal IP address. commands Provides information about the EXEC mode commands that a user issues on the ONS 15194. level Specific command level to track for accounting. Valid entries are 0 through 15. default Uses the listed authentication methods that follow this argument as the default list of methods for accounting services. start-stop Sends a start accounting notice at the beginning of a process and a stop accounting notice at the end of a process. The start accounting record is sent in the background. The requested user process begins regardless of whether the start accounting notice was received by the accounting server. stop-only Sends a stop accounting notice at the end of the requested user process. tacacs+ Uses a TACACS+ server for authentication.
Defaults
Accounting is disabled.
Command Modes
Global configuration
Usage Guidelines
Use the aaa accounting command to track the services users are accessing as well as the amount of network resources they are consuming. When aaa accounting is enabled, the network security server receives reports from the ONS15194 regarding user activity in the form of accounting records. These records are saved on the security server and can be analyzed for network management purposes.
Cisco IOS software on the ONS 15194 supports TACACS+. The network access server reports user activity to the TACACS+ security server in the form of accounting records. Each accounting record contains accounting attribute-value (AV) pairs and is stored on the security server.
For minimal accounting, include the stop-only keyword to send a stop record accounting notice at the end of the requested user process. For more accounting, you can include the start-stop keyword, so that TACACS+ sends a start accounting notice at the beginning of the requested process and a stop accounting notice at the end of the process.
Command accounting generates accounting records for all EXEC mode commands associated with the specific privilege level, including global configuration commands. Each command accounting record includes a list of the commands executed for that level, as well as the date and time each command was executed, and the user who executed it.
When aaa accounting is activated, the network access server monitors TACACS+ AV pairs pertinent to the connection. The network access server reports these attributes as accounting records, that are then stored in an accounting log on the security server. For a list of supported TACACS+ accounting AV pairs, refer to the "TACACS+ Attribute-Value Pairs" appendix in the Cisco IOS Security Configuration Guide.
Examples
The following example defines a default commands accounting method list, where accounting services are provided by a TACACS+ security server, set for privilege level 15 commands with a stop-only restriction:
ons15194(config)# aaa accounting commands 15 default stop-only group tacacs+
Related Commands
(global configuration) Sets parameters that restrict access to specific commands.
Command
Description
To enable AAA authentication to determine if a user can access the privileged command level, use the aaa authentication enable command in global configuration mode. Use the no form of this command to disable AAA authentication.
aaa authentication enable default method1 [method2...]
Syntax Description
default Uses the listed authentication methods that follow this argument as the default list of methods when a user tries to access the privileged command level. method1 At least one of the keywords described in Table 5-4.
Defaults
If the default list is not set, only the enable password is checked. This has the same effect as the command in the following example:
ons15194(config)# aaa authentication enable default enable
On the console, the enable password is used if it exists. If no password is set, the process will succeed anyway.
Command Modes
Global configuration
Usage Guidelines
Use the aaa authentication enable command to create a series of authentication methods that are used to determine whether a user can access the privileged command level. Method keywords are described in Table 5-4. The additional methods of authentication are used only if the previous method returns an error, not if it fails. To specify that the authentication should succeed even if all methods return an error, specify none as the final method in the command line.
| Keyword | Description |
|---|---|
enable | Uses the enable password for authentication. |
none | Uses no authentication. |
tacacs+1 | Uses the list of all TACACS+ servers for authentication. |
| 1The tacacs+ method refers to a set of previously defined TACACS+ servers. Use the tacacs-server host command to configure the host servers. |
Examples
This example creates an authentication list that first tries to contact a TACACS+ server. If no server can be found, AAA tries to use the enable password. If this attempt also returns an error (because no enable password is configured on the server), the user is allowed access with no authentication.
ons15194(config)# aaa authentication enable default tacacs enable none
Related Commands
(global configuration) Sets parameters that restrict access to specific commands. (global configuration) Sets a local password to control access to various privilege levels.
Command
Description
To set AAA authentication at login, use the aaa authentication login command in global configuration mode. Use the no form of this command to disable AAA authentication.
aaa authentication login default method1 [method2...]
Syntax Description
default Uses the listed authentication methods that follow this argument as the default list of methods when a user logs in. method1 At least one of the keywords described in Table 5-5.
Defaults
The default login authentication method is enable (using the enable secret). For this reason it is not possible to log in to the ONS 15194 via the network (Telnet) until either the enable secret has been set or the aaa authentication login has been changed. This has the same effect as the command in the following example:
ons15194(config)# aaa authentication login default enable
Command Modes
Global configuration
Usage Guidelines
The aaa authentication login command is similar to the aaa authentication login command that first appeared in Cisco IOS Release 10.3.
The method argument identifies the list of methods that the authentication algorithm tries, in the given sequence. Method keywords are described in Table 5-5.
The additional methods of authentication are used only if the previous method returns an error, not if it fails. To ensure that the authentication succeeds even if all methods return an error, specify none as the final method in the command line.
| Keyword | Description |
|---|---|
enable | Uses the enable secret for login authentication. |
none | Uses no authentication. |
tacacs+1 | Uses the list of all TACACS+ servers for login authentication. |
| 1The tacacs+ method refers to a set of previously defined TACACS+ servers. Use the tacacs-server host command to configure the host servers. |
Examples
The following example creates an authentication list that first tries to contact a TACACS+ server. If no server can be found, AAA tries to use the enable password. If this attempt also returns an error (because no enable password is configured on the server), the user is allowed access with no authentication.
ons15194(config)# aaa authentication login default tacacs+ enable none
Related Commands
(global configuration) Sets parameters that restrict access to specific commands. (global configuration) Sets a local password to control access to the privileged EXEC mode.
Command
Description
To set parameters that restrict command-level access to a user, use the aaa authorization commands command in global configuration mode. To disable authorization for a command level, use the no form of this command.
aaa authorization commands level default method1 [method2...]
Syntax Description
level Command level number of commands to be authorized. Levels may be 1 for user EXEC mode and 15 for privileged EXEC mode. default Uses the listed authorization methods that follow this argument as the default list of methods for authorization. method1 [method2...] One of the keywords listed in Table 5-6.
Defaults
Authorization is disabled for all actions (equivalent to the method keyword none).
Command Modes
Global configuration
Usage Guidelines
Use the aaa authorization commands command to restrict command-level access and to create methods lists, that define authorization methods to be used when a user accesses the specified command. A method list describes the authorization methods to be used (such as TACACS+), in sequence. Method lists enable you to designate a security protocol to be used for authorization, thus ensuring a backup system in case the initial method fails. Cisco IOS software uses the first method listed to authorize users for specific network services; if that method fails to respond, the Cisco IOS software selects the next method listed in the method list. This process continues until there is successful communication with a listed authorization method, or all methods defined are exhausted.
Authorization is not performed on the console interface.
The Cisco IOS software attempts authorization with the next listed method only when there is no response from the previous method. If authorization fails at any point in this cycle—meaning that the security server responds by denying the user services—the authorization process stops and no other authorization methods are attempted.
Method keywords are described in Table 5-6.
| Keyword | Description |
|---|---|
if-authenticated | Allows the user to access the requested function if the user is authenticated. |
none | Uses no authentication. |
tacacs+1 | Uses the list of all TACACS+ servers for authentication. When used, the network access server exchanges authorization information with the TACACS+ security daemon. TACACS+ authorization defines specific rights for users by associating attribute-value (AV) pairs, which are stored in a database on the TACACS+ security server, with the appropriate user. |
| 1The tacacs+ method refers to a set of previously defined TACACS+ servers. Use the tacacs-server host command to configure the host servers. |
Examples
The following example specifies that the TACACS+ server is used to authorize all commands of level 15. If there is no response from the TACACS+ server, all authenticated users are authorized. If both of these methods return errors, then the user is authorized anyway because the last method listed is none.
ons15194(config)# aaa authorization commands 15 default tacacs+ if-authenticated none
Related Commands
(global configuration) Sets parameters that restrict network access to a user. (global configuration) Sets a local password to control access to various privilege levels.
Command
Description
To enable AAA configuration command authorization in the configuration mode, use the aaa authorization config-commands command in global configuration mode. Use the no form of this command to disable command authorization in the configuration mode.
aaa authorization config-commandsSyntax Description
This command has no arguments or keywords.
Defaults
Disabled by default
Command Modes
Global configuration
Usage Guidelines
If the aaa authorization commands command is enabled for level 1 and 15, all commands except configuration commands are authorized. In order to authorize configuration commands, use the aaa authorization config-commands command.
After the no form of this command is entered, AAA authorization of configuration commands is completely disabled. Care should be taken before entering the no form of this command because it potentially reduces the amount of administrative control on configuration commands.
The methods used for global command authorization are the same as those you specified for level 15 commands using the aaa authorization commands 15 default command.
Examples
The following example specifies TACACS+ authorization for level 15 commands and the AAA authorization of configuration commands is enabled:
ons15194(config)# aaa authorization commands 15 default tacacs none
ons15194(config)# aaa authorization config-commands
Related Commands
(global configuration) Sets parameters that restrict access to specific commands.
Command
Description
To copy the current draft configuration to the running configuration, use the apply rconf configuration command.
applySyntax Description
This command has no arguments or keywords.
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194.
The draft configuration only becomes operational after it is applied.
Any changes made to the running configuration must be saved to the startup configuration file, so that when the ONS 15194 is rebooted, the changes will remain in effect. This is also necessary to provide controller redundancy. To do this, use either the copy running-config startup-config command or the write command.
Related Commands
(rconf configuration) Sets draft configuration to null. (privileged EXEC) Copies any file from a source to a destination. (rconf configuration) Displays information concerning the draft configuration that has not yet been applied. (rconf configuration) Displays information concerning the currently running configuration. (rconf configuration) Changes the draft configuration to be the same as the current running configuration. (privileged EXEC) Saves the currently running configuration to Flash memory.
Command
Description
Use the autoconnect privileged EXEC command to detect all nodes that are physically connected to the ONS 15194 and to configure SRP nodes into default rings.
autoconnectSyntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
When used, the command displays all detected nodes and the proposed ring configuration, and you are prompted to apply the configuration. The autoconnect command detects POS nodes, but does not connect them. If two unmatched sides of SRP nodes are detected where one side is A and the other side is B, the autoconnect command treats them as one SRP node. If more that two unmatched sides of SRP nodes are detected, or both are either A or B, then the autoconnect command ignores them.
To connect SRP-inner and SRP-outer nodes to rings, use the io-autoconnect command.
Examples
Sample output for the autoconnect command follows:
ons15194# autoconnect
Ring configuration (nodes in order of outer ring):
AB Ring: default
Node IP Address A B Type Other
------------------------ --------------- ---- ---- ---- -------------
Gidon 20.1.4.8 L4/1 L1/1 OC48
Gil 20.1.5.2 L4/5 L1/7 OC48
Giora 20.1.4.2 L2/1 L4/2 OC48
Gidon-002 20.1.5.3 L2/7 L2/4 OC48
Golan 20.1.4.6 L3/5 L3/1 OC48
No Outer rings defined.
No Inner rings defined.
No free nodes.
Apply configuration? y
Configuration applied.
Related Commands
(rconf configuration) Automatically detects valid SRP nodes that are physically connected to the ONS 15194 and configures them into a default ring in the draft configuration. (privileged EXEC) Automatically detects SRP-inner or SRP-outer nodes that are physically connected to the ONS 15194 and configures them into default inner or outer rings in the running configuration. (rconf configuration) Automatically detects SRP-inner and SRP-outer nodes that are physically connected to the ONS 15194 and configures them into default inner or outer rings in the draft configuration.
Command
Description
Use the autoconnect-to-draft rconf configuration command to automatically detect all nodes that are physically connected to the ONS 15194 and to configure SRP nodes into default rings in the draft configuration.
autoconnect-to-draft [unassigned]
Syntax Description
unassigned Optional. Detects only unassigned nodes.
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194.
When used, the command creates a ring from all detected SRP nodes, to the draft configuration only. POS nodes are detected, but not connected. After using this command, you can further modify the configuration using additional rconf configuration commands.
When the autoconnect-to-draft command is used without any parameters, it acts on all ONS 15194 optical interfaces without regard to previous definitions. You can optionally use the unassigned keyword to force the autoconnect-to-draft command to act only on interfaces that are not currently defined to nodes.
You must use the apply command to copy the draft configuration to the running configuration.
The autoconnect-to-draft command connects only valid SRP nodes. To connect SRP-inner or SRP-outer nodes to rings, use the io-autoconnect-to-draft command.
Examples
Sample output for the autoconnect-to-draft command follows:
ons15194# autoconnect-to-draft
Ring configuration (nodes in order of outer ring):
AB Ring: default
Node IP Address A B Type Other
------------------------ --------------- ---- ---- ---- -------------
Gidon 20.1.4.8 L4/1 L1/1 OC48
Gil 20.1.5.2 L4/5 L1/7 OC48
Giora 20.1.4.2 L2/1 L4/2 OC48
Gidon-002 20.1.5.3 L2/7 L2/4 OC48
Golan 20.1.4.6 L3/5 L3/1 OC48
No Outer rings defined.
No Inner rings defined.
No free nodes.
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (privileged EXEC) Automatically detects valid SRP nodes that are physically connected to the ONS 15194 and configures them into a default ring in the running configuration. (privileged EXEC) Automatically detects SRP-inner or SRP-outer nodes that are physically connected to the ONS 15194 and configures them into default inner or outer rings in the running configuration. (rconf configuration) Automatically detects SRP-inner and SRP-outer nodes that are physically connected to the ONS 15194 and configures them into default inner or outer rings in the draft configuration.
Command
Description
To enable or disable the autotracking capabilities of the ONS 15194, use the autotrack privileged EXEC command.
autotrack {enable | disable}
Syntax Description
enable Enable automatic tracking of nodes. disable Disable automatic tracking of nodes.
Command Modes
Privileged EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
This command enables the tracking of nodes, when they are moved from one interface to another. This allows you to reorganize the optic-fiber connections to the ONS 15194, while retaining the internal node connections. Only nodes with valid pathtraces can be tracked. The autotrack option is enabled or disabled for the entire system (all trackable nodes), and is disabled by default.
The autotrack option should only be enabled for individual sessions. After enabling the option, you should rearrange the fiber connections as necessary. After you verify that the messages displayed to the screen correctly reflect the desired results, you should disable the autotrack option. Use the show running or show rconf running command to verify that the node connection configuration is correct. Use the write command to save the changes to the startup configuration.
No changes can be made to the draft configuration while the autotrack option is enabled. You cannot enter the rconf configuration mode while the autotrack option is enabled. And when you enable the autotrack option, any unsaved changes to the draft configuration will be lost. When tracked nodes are moved between interfaces, messages are sent to the screen to indicate the changes.
Examples
The following example enables the autotrack option:
ons15194# autotrack enable
Autotracking is on.
No nodes set to autotracking.
Related Commands
(EXEC) Displays ring configuration information in current running configuration. (EXEC) Displays the current running configuration.
Command
Description
To specify a message-of-the-day (MOTD) banner, use the banner motd global configuration command. The no form of this command deletes the MOTD banner.
banner motd d message d
Syntax Description
d Delimiting character of your choice—a pound sign (#), for example. You cannot use the delimiting character in the banner message. message Message text. You can enter multiple lines as long as the delimiter is entered at the beginning and the end of the message
Defaults
No MOTD banner is specified
Command Modes
Global configuration
Usage Guidelines
This command is similar to the banner motd command that first appeared in Cisco IOS Release 10.0.
Follow this command with one or more blank spaces and a delimiting character of your choice. Then enter one or more lines of text, terminating the message with the second occurrence of the delimiting character.
After the MOTD is defined, you must enable the display of the MOTD with the motd-banner command.
Examples
The following example takes all text between the two % signs to be used as the current MOTD message:
ons15194# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
ons15194(config)# banner motd %
Enter text message. End with the character '%'
first line
second line %
Related Commands
(global configuration) Enables the display of the MOTD. copy tftp://host/banner.txt motd (privileged EXEC) Copies the contents of a text file from a TFTP server to be used as the login message of the ONS 15194.
Command
Description
To specify the device and filename of the configuration file from which the ONS 15194 configures itself during initialization (startup), use the boot config global configuration command. Use the no form of this command to remove the specification.
boot config file-url
Syntax Description
file-url URL of the configuration file, of the format flash:filename. The configuration file must be an ASCII file located in a Flash file system.
Command Modes
Global configuration
Usage Guidelines
You set the CONFIG_FILE environment variable in the current running memory when you use the boot config command. This variable specifies the configuration file used for initialization (startup).
 |
Note When you use this global configuration command, you affect only the running configuration. You must save the environment variable setting to your startup configuration to place the information under ROM monitor control and to have the environment variable function as expected. Use the copy system:running-config nvram:startup-config command to save the environment variable from your running configuration to your startup configuration. |
The software displays an error message and does not update the CONFIG_FILE environment variable if you specify a configuration file in the filename argument that does not exist or is not valid.
Related Commands
(privileged EXEC) Copies any file from a source to a destination. (privileged EXEC) Deletes a file on a Flash memory device. (privileged EXEC) Displays a list of files on a file system.
Command
Description
To specify the system image that the ONS 15194 loads at startup, use the boot system global configuration command. Use the no form of this command to remove the startup system image specification.
boot system file-url
Syntax Description
file-url URL of the configuration file, of the format flash:filename. The configuration file must be an ASCII file located in the Flash file system.
Command Modes
Global configuration
Usage Guidelines
Enter several boot system commands to provide a fail-safe method for booting your ONS 15194. The ONS 15194 stores and executes the boot system commands in the order in which you enter them in the configuration file. If you enter multiple boot commands of the same type—for example, if you enter two commands that instruct the router to boot from different network servers—then the router tries them in the order in which they appear in the configuration file. If a boot system command entry in the list specifies an invalid device, the ONS 15194 skips that entry.
Related Commands
(privileged EXEC) Copies any file from a source to a destination. (privileged EXEC) Deletes a file on a Flash memory device. (privileged EXEC) Displays a list of files on a file system.
Command
Description
To set the ONS 15194 calendar, use one of the formats of the calendar set privileged EXEC command.
calendar set hh:mm:ss day month year
Syntax Description
hh:mm:ss Current time in hours, minutes, and seconds (military format). day Current day in the month (a number between 01 to 31). month Current month (by name). year Current year as 4-digit number between 1970 to 2030.
Command Modes
Privileged EXEC
Usage Guidelines
This command is the same as the calendar set command that first appeared in Cisco IOS Release 10.0.
The calendar in the ONS 15194 is identical to the system clock.
Examples
The following example manually sets the ONS 15194 calendar to 1:32 p.m. on July 23, 2001:
ons15194# calendar set 13:32:00 23 july 2001
Related Commands
(privileged EXEC) Set ONS 15194 clock.
Command
Description
To change the default directory or file system, use the cd privileged EXEC command.
cd file-url
Syntax Description
file-url URL or alias of the directory or file system followed by a colon.
Defaults
The initial default file system is flash:. If you do not specify a directory on a file system, the default is the root directory on that file system.
Command Modes
Privileged EXEC
Usage Guidelines
For all EXEC commands that have an optional file-url argument, the ONS 15194 uses the file system specified by the cd command when you omit the optional file-url argument. For example, the dir command, which displays a list of files on a file system, contains an optional file-url argument. When you omit this argument, the ONS 15194 lists the files on the file system specified by the cd command.
Related Commands
(privileged EXEC) Copies any file from a source to a destination. (privileged EXEC) Deletes a file on a Flash memory device. (privileged EXEC) Displays a list of files on a file system. (privileged EXEC) Displays the current setting of the cd command. (EXEC) Lists available file systems and their alias prefix names.
Command
Description
To delete all dynamic entries from the ARP cache on the Ethernet interface, use the clear arp-cache privileged EXEC command.
clear arp-cacheSyntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Usage Guidelines
This command is the same as the clear arp-cache command that first appeared in Cisco IOS Release 10.0.
Examples
The following example removes all dynamic entries from the ARP cache:
ons15194# clear arp-cache
Related Commands
(EXEC) Display the ARP table.
Command
Description
To clear the total data counters that are displayed by the show interfaces data command, use the clear counters privileged EXEC command.
clear counters [interface-id]
Syntax Description
interface-id Optional. Specifies the interface of the format Lcard/interface where card is the card number (1 to 8) and interface is the interface number (1 to 8). If no interface-identifier is specified, the counters for all interfaces are cleared.
Command Modes
Privileged EXEC
Usage Guidelines
This command only clears the total data counters that are displayed using the show interfaces data command with the total keyword. The current and history counters are not changed.
Examples
The following example clears the total data counters for first interface on the third line card:
ons15194# clear counters L3/1
Port L3/1 accumulated counters were reset.
Related Commands
(EXEC) Displays the traffic counters for a specific interface or all interfaces.
Command
Description
To delete the statistics data, use the clear data-stats privileged EXEC command.
clear data-statsSyntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Usage Guidelines
Implicit deletion of the binary files that contain the data statistics is not allowed. You must first delete all data in these files using the clear data-stats command. This command clears both the node-data-stats file and the interface-data-stats file.
 |
Caution This command irreversibly deletes all saved statistics which can be as much as a month of data. |
Generally there is no need to use this command, because the data records are automatically overwritten in a first-in-first-out fashion when the maximum amount of data has been stored. This command is most useful in the event that the ONS 15194 is moved to a different location and the stored statistics are longer relevant.
To return a terminal line to idle state, use the clear line privileged EXEC command.
clear line {console | maint | vty} line-number
Syntax Description
console Primary terminal line. maint Maintenance line. vty Virtual line. line-number Number of line to be cleared: 0 for console and maint; 0 to 4 for vty.
Command Modes
Privileged EXEC
Usage Guidelines
This command is the same as the clear line command that first appeared in Cisco IOS Release 10.0.
Use this command to log out of a specific session running on another line. The vty keyword specifies to clear both Telnet and SSH sessions.
Examples
The following example resets line 3 to the idle state:
ons15194# clear line vty 3
To clear messages from the logging buffer, use the clear logging privileged EXEC command.
clear loggingSyntax Description
This command contains no arguments or keywords.
Command Modes
Privileged EXEC
Usage Guidelines
This command is the same as the clear logging command that first appeared in Cisco IOS Release 11.2.
Related Commands
(global configuration) Specifies remote logging station address. (global configuration) Specifies which if any messages are to be saved to the logging buffer. (global configuration) Specifies which if any messages are to be sent to the console. (global configuration) Specifies which if any messages are to be sent to the maintenance port. (global configuration) Specifies which if any messages are to be sent to the monitor terminal line. (global configuration) Specifies which if any messages are to be saved to the ONS 15194 servers. (EXEC) Displays the contents of the logging buffer.
Command
Description
To manually set the ONS 15194 clock, use one of the formats of the clock set privileged EXEC command.
clock set hh:mm:ss day month year
Syntax Description
hh:mm:ss Current time in hours, minutes, and seconds (military format). day Current day (number from 01 to 31) in the month. month Current month (by name). year Current year (4-digit number between 1970 to 2030).
Command Modes
Privileged EXEC
Usage Guidelines
This command is the same as the clock set command that first appeared in Cisco IOS Release 10.0. This command is also the same as the calendar set command.
Examples
The following example manually sets the ONS 15194 clock to 1:32 p.m. on July 23, 2001:
ons15194# clock set 13:32:00 23 July 2001
Related Commands
(privileged EXEC) Specifies the calendar (date and time) for the ONS 15194.
Command
Description
To set the time zone for display purposes, use the clock timezone global configuration command. To set the time to Coordinated Universal Time (UTC), use the no form of this command.
clock timezone zone hours-offset
Syntax Description
zone Name of the timezone to be displayed when standard time is in effect. hours-offset Hours difference from UTC.
Defaults
UTC
Command Modes
Global configuration
Usage Guidelines
The ONS 15194 internally keeps time in UTC, so this command is used only for display purposes and when the time is manually set.
Table 5-7 lists common time zone acronyms used for the zone argument.
| Acronym | Time Zone Name and UTC Offset |
|---|---|
| Europe | |
GMT | Greenwich Mean Time, as UTC |
BST | British Summer Time, as UTC +1 |
IST | Irish Summer Timer, as UTC +1 |
WET | Western Europe Time, as UTC |
WEST | Western Europe Summer Time, as UTC +1 |
CET | Central Europe Time, as UTC +1 |
CEST | Central Europe Summer Time, as UTC +2 |
EET | Eastern Europe Time, as UTC +2 |
EEST | Eastern Europe Summer Time, as UTC +3 |
MSK | Moscow Time, as UTC +3 |
MSD | Moscow Summer Time, as UTC +4 |
| US and Canada | |
AST | Atlantic Standard Time, as UTC -4 |
ADT | Atlantic Daylight Time, as UTC -3 |
ET | Eastern Time, either as EST or EDT, depending on place and time of year |
EST | Eastern Standard Time, as UTC -5 |
EDT | Eastern Daylight Saving Time, as UTC -4 |
CT | Central Time, either as CST or CDT, depending on place and time of year |
CST | Central Standard Time, as UTC -6 |
CDT | Central Daylight Saving Time, as UTC -5 |
MT | Mountain Time, either as MST or MDT, depending on place and time of year |
MST | Mountain Standard Time, as UTC -7 |
MDT | Mountain Daylight Saving Time, as UTC -6 |
PT | Pacific Time, either as PST or PDT, depending on place and time of year |
PST | Pacific Standard Time, as UTC -8 |
PDT | Pacific Daylight Saving Time, as UTC -7 |
HST | Hawaiian Standard Time, as UTC -10 |
AKST | Alaska Standard Time, as UTC -9 |
AKDT | Alaska Standard Daylight Saving Time |
| Australia | |
WST | Western Standard Time, as UTC +8 |
CST | Central Standard Time, as UTC +9.5 |
EST | Eastern Standard/Summer Time, as UTC +10 (+11 hours during summer time) |
Examples
The following example sets the timezone to Pacific Standard Time (PST), which is 8 hours behind UTC:
ons15194(config)# clock timezone PST -8
Related Commands
(privileged EXEC) Specifies the calendar (date and time) for the ONS 15194.
Command
Description
To set the draft configuration to null, use the clear-draft rconf configuration command.
clear draftSyntax Description
This command contains no arguments or keywords.
Command Modes
rconf configuration
Usage Guidelines
This command only applies to the ONS 15194. After executing this command, the draft configuration is null. In other words, all current draft configuration changes are discarded. This is useful if you want to create a new configuration, not related to the current running configuration.
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (rconf configuration) Displays information concerning the draft configuration. (rconf configuration) Revert draft configuration to be the same as the running configuration.
Command
Description
To enter global configuration mode, use the configure privileged EXEC command. You must be in global configuration mode to enter global configuration commands.
configure terminalCommand Modes
Privileged EXEC
Syntax Description
terminal Specifies that configuration commands are to be executed from the terminal screen.
Usage Guidelines
This command is similar to the configure command that first appeared in Cisco IOS Release 10.0. This command executes configuration commands from the terminal.
To copy a configuration file from the Flash memory to the running-config file, use the configure memory privileged EXEC command.
configure memorySyntax Description
This command contains no arguments or keywords.
Command Modes
Privileged EXEC
Usage Guidelines
This command is the same as the copy source-url running-config command, where source-url is understood to be the Flash memory. The contents of the Flash memory are copied to the running configuration file.
Related Commands
(global configuration) Specifies the device and filename of the configuration file from which the ONS 15194 initializes. (global configuration) Specifies the system image that is used at startup. (privileged EXEC) Deletes a file on a Flash memory device. (EXEC) Lists available file systems and their alias prefix names.
Command
Description
To copy a configuration file from a source destination to the running-config file, use the configure network privileged EXEC command.
configure network source-url
Syntax Description
source-url Alias of the directory or file system as given in Table 5-8, followed by the path and filename.
The exact format of the source URL varies according to the file or directory location. You may enter either a alias keyword for a particular file or a alias keyword for a file system type. The path and name of the file to copy follow the alias keyword. Alias keywords are given in Table 5-8.
| Alias | Source |
|---|---|
disk0: | First PCMCIA flash disk card slot. |
disk1: | Second PCMCIA flash disk card slot. |
flash: | Internal Flash memory. |
tftp: | Remote TFTP file server. |
ftp: | Remote TFP file server. |
Command Modes
Privileged EXEC
Usage Guidelines
This command is the same as the copy source-url running-config command. The contents of the source-url are copied to the running configuration file.
Examples
The following example establishes a copies a configuration file from a PCMCIA disk to be used as the running configuration file:
ons15194# configure network disk0:con1001
Related Commands
(global configuration) Specifies the device and filename of the configuration file from which the ONS 15194 initializes. (global configuration) Specifies the system image that is used at startup. (privileged EXEC) Copies any file from a source to a destination. (privileged EXEC) Deletes a file on a Flash memory device. (privileged EXEC) Displays a list of files on a file system. (EXEC) Lists available file systems and their alias prefix names.
Command
Description
To log on to a host that supports Telnet, use the connect EXEC command.
connect host [port]
Syntax Description
host A host name or an IP address. port Optional. Specifies the server port on which to connect.
Command Modes
EXEC
Usage Guidelines
This command is similar to the connect command that first appeared in a release prior to Cisco IOS Release 10.0; however this command supports only Telnet.
Examples
The following example establishes a Telnet session from the ONS 15194 to a remote host named host1:
ons15194# connect host1
To copy any file from a source to a destination, use the copy privileged EXEC command.
copy source-url destination-url
Syntax Description
source-url The location of the source file or directory to be copied. destination-url The destination of the copied file or directory.
The source-url and destination-url must be one of the keywords as shown in Table 5-9.
| Keyword | Description |
|---|---|
running-config | Copy from current system configuration. |
startup-config | Copy from startup configuration. |
tech-support | Copy from tech-support. |
disk0: | Copy from disk0: file system. This is the disk in the first PCMCIA card slot. |
disk1: | Copy from disk1: file system. This is the disk in the second PCMCIA card slot. |
flash: | Copy from flash: file system. |
tftp: | Copy from tftp: file system. |
ftp: | Copy from ftp: file system. |
Command Modes
Privileged EXEC
Usage Guidelines
This command is a subset of the copy command that first appeared in Cisco IOS Release 11.3T.
When a file is copied to the startup configuration, it only becomes active after you reset the ONS 15194.
The copy of the startup-config to a TFTP server is the same as executing the privileged EXEC command write network. The command copy running-config startup-config effectively saves the currently running configuration to Flash memory. It is the same as executing the privileged EXEC command write or write memory.
the node-data-stats and interface-data-stats keywords copy the data statistics file from an internal binary file to a text file that you specify on one of the devices.
Examples
The following example downloads the configuration file conf in the directory confiles to the ONS 15194 startup configuration. The file conf will then be used to configure the ONS 15194 the next time it is booted.
ons15194# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
ons15194(config)# copy tftp://195.33.11.9/confiles/conf startup-config
The following example saves the currently running configuration to Flash memory:
ons15194(config)# copy running-config startup-config
The following example downloads and installs a new version of software to the ONS 15194.
ons15194(config)# copy tftp://192.168.10.1/ver30 image
The following example copies the file named motd.txt from the host cisco.com to be used as the current MOTD message:
ons15194(config)# banner motd tftp://www.cisco.com/motd-dir/motd.txt
Related Commands
(privileged EXEC) Saves the contents of the running configuration to Flash memory. (privileged EXEC) Saves the startup configuration to a TFTP server. (EXEC) Displays the currently running configuration to the terminal. (global configuration) Enables the display of the MOTD.
Command
Description
To copy the interface or node data statistics from their internal binary format to a text file, use the copy interface-data-stats or copy node-data-stats privileged EXEC commands.
copy interface-data-stats destination-url [intervals]
Syntax Description
destination-url Destination of the copied file or directory. intervals Optional. Number of intervals for which to copy the statistics. If not specified, data for all saved intervals is copied.
The destination-url must be one of the keywords as shown in Table 5-10.
| Keyword | Description |
|---|---|
disk0: | Copy to disk0: file system. This is the disk in the first PCMCIA card slot. |
disk1: | Copy to disk1: file system. This is the disk in the second PCMCIA card slot. |
flash: | Copy to flash: file system. |
ftp: | Copy to ftp: file system. |
tftp: | Copy to tftp: file system. |
Command Modes
Privileged EXEC
Usage Guidelines
These commands copy the data statistics files from an internal binary file to a text file that you specify on one of the devices. The text file is comma delimited and can be conveniently opened in a spreadsheet application for futher manipulation.
The copy interface-data-stats command copies the data statistics file that is computed by interface. The copy node-data-stats command copies the data statistics file that is computed by node.
Up to 2976 time intervals can be copied, where 1 is the 15-minute interval before the current interval, and 2976 is 31 days ago. Statistics are copied for all time intervals from 1 up to and including the specified interval. Data is copied from the oldest to the most recent.
Examples
The following example copies the node data statistics for the last 2 days to a TFTP server file. Note that each day contains 96 15-minute intervals.
ons15194# copy node-data-stats tftp://192.168.11.9/node_stats1101.txt 192
Related Commands
(EXEC) Displays data statistics for an interface. (EXEC) Displays data statistics for a node.
Command
Description
To delete a file from a file ONS 15194, use the delete privileged EXEC command.
delete file-system
Syntax Description
file-system Keyword of the directory or file system.
The file system must be one of the keywords as shown in Table 5-11.
| Keyword | Description |
|---|---|
disk0: | Delete from disk0: file system. This is the disk in the first PCMCIA card slot. |
disk1: | Delete from disk1: file system. This is the disk in the second PCMCIA card slot. |
flash: | Delete from flash: file system. |
Command Modes
Privileged EXEC
Usage Guidelines
The delete command actually deletes all files on the specified file system. There is no recovery of deleted files. You must not delete any files contained in the boot-ons15194 directory in the flash file system. These files are necessary for proper running of the ONS 15194.
Related Commands
(privileged EXEC) Copies any file from a source to a destination. (privileged EXEC) Displays a list of files on a file system. (privileged EXEC) Displays the current setting of the cd command. (EXEC) Lists available file systems and their alias prefix names.
Command
Description
To display a list of files on a file system, use the dir EXEC command.
dir file-url
Syntax Description
file-url Keyword of the directory or file system.
The file system must be one of the keywords as shown in Table 5-12.
| Keyword | Description |
|---|---|
disk0: | Display from disk0: file system. This is the disk in the first PCMCIA card slot. |
disk1: | Display from disk1: file system. This is the disk in the second PCMCIA card slot. |
flash: | Display from flash: file system. |
Defaults
The default file system is specified by the cd command.
Command Modes
Privileged EXEC
Usage Guidelines
Use the show (file system) command to display more detail about the files in a particular file system.
Examples
Sample output from the dir command follows:
ons15194# dir
Directory of flash:/
1 drwx 4096 oct 14 21:29:12 2001 boot-ons15194
1 -rwx 2473 oct 14 21:26:02 2001 startup-config
1 drwx 4096 sep 11 11:31:44 2001 John
1 drwx 4096 sep 11 11:32:14 2001 Test1
1 -rwx 1781279 oct 11 10:45:18 2001 ver1.0.22
1 -rwx 198040 sep 11 11:32:34 2001 Tec_support_1009
1 -rwx 1781687 oct 04 13:40:00 2001 mic
1 -rwx 1781415 oct 04 19:32:32 2001 ver1.0.21
1 -rwx 2334 oct 10 14:07:24 2001 sc1
1 -rwx 1780580 oct 14 21:23:18 2001 ver1.0.23
98398208 bytes total (88891392 bytes free)
Related Commands
(privileged EXEC) Changes the default directory or file system. (privileged EXEC) Copies any file from a source to a destination. (privileged EXEC) Deletes a file on a Flash memory device. (privileged EXEC) Displays the current setting of the cd command. (EXEC) Lists available file systems and their alias prefix names.
Command
Description
To exit privileged EXEC mode and return to user EXEC mode, enter the disable privileged EXEC command.
disableSyntax Description
This command contains no arguments or keywords.
Command Modes
Privileged EXEC
Usage Guidelines
This command is similar to the disable command that first appeared in Cisco IOS Release 10.0.
Examples
In the following example, entering the disable command causes the ONS 15194 to exit privileged EXEC mode and return to user EXEC mode as indicated by the angle bracket (>):
ons15194# disable
ons15194>
To display information concerning the draft configuration that has not yet been applied (with the apply command), use the display draft rconf configuration command.
display draft [raw]
Syntax Description
raw Optional. Displays physical low-level connections in terms of interfaces.
Command Modes
rconf configuration
Usage Guidelines
This command only applies to the ONS 15194. This command only displays information concerning the draft configuration that was defined since the last use of the apply command.Use the raw keyword to display the actual physical connections to the interfaces on the ONS 15194.
Examples
Sample output from the display draft command follows:
ONS15194(rconf)# display draft
Draft connection configuration:
Ring configuration (nodes in order of outer ring):
AB Ring: default
Node IP Address A B Type Other
------------------------ --------------- ---- ---- ---- -------------
Giora 20.1.4.2 L1/3 L2/2 OC48
Golan 20.1.4.6 L1/8 L1/4 OC48
Gidon 20.1.5.3 L1/5 L1/7 OC48
Gidon-002 20.1.4.8 L1/6 L2/1 OC48
Gilboa 20.1.4.1 L2/3 L2/4 OC48
No Outer rings defined.
No Inner rings defined.
No free nodes.
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (rconf configuration) Displays information concerning the currently running configuration.
Command
Description
To display information concerning the current configuration, that was last applied (using the apply command), use the display running rconf configuration command.
display running [raw]
Syntax Description
raw Optional. Displays physical low-level connections in terms of interfaces.
Command Modes
rconf configuration
Usage Guidelines
This command only applies to the ONS 15194. This command displays information about the currently running configuration only. Use the raw keyword to display the actual physical connections to the interfaces on the ONS 15194. To display information about the draft configuration, use the display draft command. This command displays the same output as the show rconf running EXEC command.
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (rconf configuration) Displays information concerning the draft configuration. (EXEC) Displays information concerning the current configuration.
Command
Description
To specify the amount of time that the ONS 15194 waits before bypassing an SRP-inner or SRP-outer node that has a failure on a fiber transmitting out of the ONS 15194, use the eips awareness-agein global configuration command. Use the no form of this command to restore the awareness-agein time to its default value.
eips awareness-agein seconds
Syntax Description
seconds The amount of time to wait before bypassing a failed node on the ring.
Defaults
90 seconds.
Command Modes
Global configuration
Usage Guidelines
The eips awareness-agein command is only relevant to the ONS 15194 where there are SRP-inner and SRP-outer rings defined. When there are inner-outer SRP rings, the E-IPS capability should always be enabled. A node on a single inner-outer ring is considered failed when at least one of its fiber connections has failed. Failed nodes are removed from the ring depending on the type of failure, as described following:
A bypassed node is returned to the ring after a wait-to-restore period in seconds has passed since the node was detected as being functional. Use the eips wtr-timer command to set the wait-to-restore period.
The awareness-agein value is important when configuration changes are made, such that some nodes receive temporary keep-alive failures. In this case, such nodes should not be bypassed before the SRR wait to restore (WTR) time elapses.
The default value of the awareness-agein time on the ONS 15194 is 90 seconds. This value was chosen to be 30 seconds more that the default SRR WTR period DPT router line cards, which is 60 seconds.
|
Caution If the awareness-agein time is less than the SRR WTR specified on any of the connected nodes, due to a change in configuration on either the ONS 15194 or the routers, then a situation of oscillating SRR switches can occur. |
Examples
In the following example, the awareness-agein time is set to 150 seconds:
ons15194(config)# eips awareness-agein 150
Related Commands
(global configuration) Enables the E-IPS capability in the ONS 15194. (global configuration) Specifies the WTR period for E-IPS capability on the ONS 15194. (EXEC) Indicates whether the E-IPS option is enabled and displays the specified WTR value.
Command
Description
To enable the enhanced intelligent protection switching (E-IPS) capability of the ONS 15194, use the eips enable global configuration command. Use the no form of this command to disable the E-IPS capability of the ONS 15194.
eips enableSyntax Description
This command contains no arguments or keywords.
Defaults
Not enabled for A/B SRP rings; Enabled for SRP-inner and SRP-outer rings
Command Modes
Global configuration
Usage Guidelines
The eips enable command is only relevant to the ONS 15194. When enabled, the E-IPS capability applies to all SRP nodes.
When the E-IPS capability is enabled, failed nodes on A/B SRP rings are removed from the ring within 1 ms of the failure event. A node on such a ring is considered failed when:
For inner-outer rings, the E-IPS capability should always be enabled. A node on a single inner-outer ring is considered failed when at least one of its fiber connections has failed. Failed nodes are removed from the ring depending on the type of failure, as described following:
A bypassed node is returned to the ring after a wait-to-restore period in seconds has passed since the node was detected as being functional. Use the eips wtr-timer command to set the wait-to-restore period.
When the E-ISP capability is not enabled and there is a router failure, all remaining routers will be connected by a single wrapped ring according to the SRP protocol.
Examples
In the following example, the E-IPS option is disabled.
ons15194(config)# no eips enable
Related Commands
(global configuration) Specifies the WTR period for E-IPS capability on the ONS 15194. (EXEC) Indicates whether the E-IPS option is enabled and displays the specified wait-to-restore value.
Commands
Description
To specify the wait-to-restore (WTR) period for SRP nodes, use the eips wtr-timer global configuration command. Use the no form of this command to restore the wait-to-restore default value.
eips wtr-timer seconds
Syntax Description
seconds The amount of time to wait before returning a bypassed node to the ring, after the node is detected as being functional.
Defaults
10 seconds.
Command Modes
Global configuration
Usage Guidelines
The eips wtr-timer command is only relevant to the ONS 15194 where the eips enable command has been executed.
When the E-IPS capability is enabled, failed nodes on A/B SRP rings are removed from the ring within 1 ms of the failure event. A node on such a ring is considered failed when:
For inner-outer rings, the E-IPS capability should always be enabled. A node on a single inner-outer ring is considered failed when at least one of its fiber connections has failed. Failed nodes are removed from the ring depending on the type of failure, as described following:
A bypassed node is returned to the ring after a wait-to-restore period (WTR) in seconds has passed since the node was detected as being functional.
Examples
In the following example, the wait-to-restore time is set to 10 seconds:
ons15194(config)# eips wtr-timer 10
Related Commands
(global configuration) Specifies the amount of time that the ONS 15194 waits before bypassing a failed inner-outer SRP node. (global configuration) Enables the E-IPS capability in the ONS 15194. (EXEC) Indicates whether the E-IPS option is enabled and displays the specified WTR value.
Command
Description
To enter privileged EXEC mode, use the enable user EXEC command.
enableSyntax Description
This command contains no arguments or keywords.
Command Modes
User EXEC
Usage Guidelines
This command is the same as the enable command that first appeared in Cisco IOS Release 10.0.
Because many of the privileged commands set operating parameters, privileged access should be password-protected to prevent unauthorized use. If the ONS 15194 administrator has set a password with the enable secret global configuration command, or the TACACS+ server requests an enable secret, you are prompted to enter it before being allowed access to privileged EXEC mode. The password is case sensitive.
Examples
In the following example, the privileged EXEC command mode is entered after the correct password is provided:
ons15194> enable
password:
ons15194#
To set a local password to control access to various privilege levels, use the enable secret global configuration command. Use the no form of this command to remove the password requirement.
enable secret [0 | 5] password
Syntax Description
0|5 Optional. Encryption type for password. 0 (default) indicates that an unencrypted password will follow; 5 indicates that an encrypted password will follow. password Password users type to enter enable mode. This should be encrypted or unencrypted depending on the use of the encryption type. If no encryption type is specified, the password is unencrypted.
Defaults
No password is defined.
Command Modes
Global configuration
Usage Guidelines
This command is similar to the enable secret command that first appeared in Cisco IOS Release 11.0.
Use this command to define a password for the enable command. After you specify the password, give the password to the users who need to access the privileged EXEC command mode.
An enable password is defined as follows:
Examples
The following example enables the password pswd2:
ons15194(config)# enable secret pswd2
Related Commands
(user EXEC) Enter privileged EXEC mode. (privileged EXEC) Exit privileged EXEC mode. (global configuration) Enables AAA authentication.
Command
Description
To exit configuration mode, or any of the configuration submodes, use the end global configuration command.
endSyntax Description
This command has no arguments or keywords.
Command Modes
Global configuration and configuration submodes
Usage Guidelines
This command is the same as the end command that first appeared in Cisco IOS Release 10.0.
You can also press Ctrl-Z to exit the configuration mode.
Related Commands
(privileged EXEC) Enters global configuration mode.
Command
Description
To erase the ONS 15194 startup configuration, use the erase startup-config privileged EXEC command.
erase startup-configSyntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Usage Guidelines
The erase startup-config command is the same as the write erase command.
When the startup configuration is erased, all ONS 15194 startup configurations are lost.
Examples
The following example erases the startup configuration:
ons15194# erase startup-cofnig
Related Commands
(privileged EXEC) Erases all ONS 15194 configurations.
Command
Description
To set the interval that the EXEC command interpreter waits until user input is detected, use the exec-timeout line configuration command. The timeout is set for the specific line being configured (for example, console, maintenance, vty). Use the no form of this command to remove the timeout definition.
exec-timeout minutes
Syntax Description
minutes Number between 0 to 10,000 that specifies the timeout in minutes. Zero specifies no timeouts.
Command Modes
Line configuration
Defaults
5 minutes
Usage Guidelines
This command is similar to the exec-timeout command that first appeared in Cisco IOS Release 10.0.
A value of 0 disables the timeout facility.
Examples
The following example sets a time interval of 5 minutes:
ons15194(config)# line console 0
ons15194(config-line)# exec-timeout 5
Related Commands
(global configuration) Enters line configuration command mode.
Command
Description
To exit any configuration mode or close an active terminal session and terminate the EXEC, use the exit command at the ONS 15194 prompt.
exitSyntax Description
This command has no arguments or keywords.
Command Modes
Available in all command modes.
Usage Guidelines
This command is the same as the exit command that first appeared in Cisco IOS Release 10.0.
Use the exit command at the EXEC levels to exit the EXEC mode. Use the exit command at the configuration level to return to privileged EXEC mode. Use the exit command in interface, line, rconf, and rconf command modes to return to global configuration mode. You also can press Ctrl-Z, or use the end command, from any configuration mode to return to privileged EXEC mode.
Related Commands
Exit configuration mode, or any of the configuration submodes.
Command
Description
To format a file system, use the format EXEC command.
format file-system
Syntax Description
file-system Keyword of the directory or file system to format.
The file system must be one of the keywords as shown in Table 5-13.
| Keyword | Description |
|---|---|
disk0: | Format disk0: file system. This is the disk in the first PCMCIA card slot. |
disk1: | Format disk1: file system. This is the disk in the second PCMCIA card slot. |
flash: | Format flash: file system. |
standby-flash | Format standby controller flash: file system. |
Command Modes
Privileged EXEC
Usage Guidelines
This command formats the specified file system and thereby erases all files. If you format the flash: file system, you must then copy a new image file to the Flash memory, configure the boot system and use the write command. If these actions are not done, then you will not be able to boot the ONS 15194 without first configuring the system using the boot application via the maintenance interface.
This command should only be performed on the flash: file system in the unlikely event of a file system corruption. If you suspect a file system corruption, you should first try using the fsck command.
If for some reason you need to format the controller Flash memory, you can restart the controller, so that the active controller becomes the standby controller. Then you can use the format command with the standby-flash keyword to format the Flash memory of the standby controller. After the Flash memory is formatted, the running image will automatically be copied from the active controller.
Related Commands
(privileged EXEC) Displays a list of files on a file system. (privileged EXEC) Checks a file system for damage and optionally repairs any problems. (privileged EXEC) Removes an existing directory.
Command
Description
To specify the default SRP framing type, use the framing-default global configuration command.
framing-default {sdh | sonet}
Syntax Description
sdh Set the default framing to be SDH. sonet Set the default framing to be SONET.
Command Modes
Global configuration
Usage Guidelines
This command is only applicable to the ONS 15194.
Examples
The following command specifies the SRP framing to be SONET:
ons15194# framing-default sonet
Related Commands
(privileged EXEC) Displays a list of files on a file system. (privileged EXEC) Removes an existing directory.
Command
Description
To check a file system for damage and optionally repair any problems, use the fsck EXEC command.
fsck file-system [repair]
Syntax Description
file-system Keyword of the directory or file system. repair Specifies to repair any found problems.
The file system must be one of the keywords as shown in Table 5-14.
| Keyword | Description |
|---|---|
disk0: | Copy from disk0: file system. This is the disk in the first PCMCIA card slot. |
disk1: | Copy from disk1: file system. This is the disk in the second PCMCIA card slot. |
flash: | Copy from flash: file system. |
Command Modes
Privileged EXEC
Usage Guidelines
This command is only valid on Class C Flash file systems.
Related Commands
(privileged EXEC) Displays a list of files on a file system. (privileged EXEC) Removes an existing directory.
Command
Description
To display a brief description of the help system, enter the help EXEC command.
helpSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command is the same as the help command that first appeared in Cisco IOS Release 10.0.
The help command provides a brief description of the context-sensitive help system.
Examples
In the following example, the output from the help command is displayed:
ons15194# help
Enter '?' at any place in the command line for help
Two styles of help are supported:
- Argument help (e.g. 'command ?') : describes each possible argument.
- Partial help (e.g. 'command pr?') : describes all matching arguments.
To specify or modify the host name for the ONS 15194, use the hostname global configuration command. The host name is used in prompts and show commands. Use the no form of this command to revert to the default host name (ons15194).
hostname name
Syntax Description
name String representing the new host name for the ONS 15194.
Defaults
ons15194
Command Modes
Global configuration
Usage Guidelines
This command is the same as the hostname command that first appeared in Cisco IOS Release 10.0.
The name must also follow the rules for ARPANET host names. They must start with a letter, end with a letter or digit, and have as interior characters only letters, digits, and hyphens. Names must be 63 characters or fewer. For more information, refer to RFC 1035, Domain Names—Implementation and Specification.
Examples
The following example changes the host name to sandbox:
ons15194(config)# hostname sandbox
To cause all LEDs associated with a particular slot or interface to blink, use the hw-module blink privileged EXEC command.
hw-module {slot slot-identifier | interface interface-identifier} blink [number | stop]
Syntax Description
slot Specifies a slot in the ONS 15194 to control. slot-identifier Specifies the slot, which can be one of C1, C2 (controllers), S1 to S5 (switch cards), or L1 to L8 (line cards). interface Specifies an interface in the ONS 15194 to control. interface-identifier Specifies the interface of the format Lcard/interface where card is the card number (1 to 8) and interface is the interface number (1 to 8). number Optional. Specifies the number of seconds the LEDs should blink. If no value is specified, the LEDs will blink for 10 seconds. stop Stops the LEDs from blinking.
Defaults
LEDs blink for 10 seconds.
Command Modes
Privileged EXEC
Usage Guidelines
This command is only applicable to the ONS 15194. This command is useful to identify interfaces/slots for technicians at a remote location.
Examples
The following example causes the LEDs associated with slot L1 to blink for 20 seconds.
ons15194# hw-module slot L1 blink 20
Related Commands
(privileged EXEC) Resets a specific card in the ONS 15194. (global configuration) Disables a specific slot in the ONS 15194. (EXEC) Displays status information about a specific card in a slot.
Command
Description
To stop the laser transmission on a particular interface, use the hw-module laser privileged EXEC command.
hw-module {interface interface-identifier} laser {off | on}
Syntax Description
interface Specifies an interface in the ONS 15194 to control. interface-identifier Specifies the interface of the format Lcard/interface where card is the card number (1 to 8) and interface is the interface number (1 to 8). off Shutdown Tx laser power. on Restore Tx laser power.
Defaults
On
Command Modes
Privileged EXEC
Usage Guidelines
This command is useful for testing router functionality in the event of a fiber cut. When the Tx laser power is turned off, no signal is transmitted from the specified interface.
Examples
The following example stops all laser power transmission on interface L1/1:
ons15194# hw-module interface l1/1 laser off
Related Commands
(EXEC) Displays information about the interfaces.
Command
Description
To place a Cisco ONS 15194 interface into loopback mode, use the hw-module loopback privileged EXEC command.
hw-module {interface interface-identifier} loopback {internal | line | none}
Syntax Description
interface Specifies an interface in the ONS 15194 to control. interface-identifier Specifies the interface of the format Lcard/interface where card is the card number (1 to 8) and interface is the interface number (1 to 8). internal Places the interface into internal loopback. Data that is transmitted by the interface is also looped back in as if received from an outside source. line Places the interface into external loopback at the line. Data received through the interface is mirrored back out to the network. This is the default. none Disables the loopback mode for the interface.
Defaults
Disabled
Command Modes
Privileged EXEC
Usage Guidelines
This command has the same functionality same as the loopback command that first appeared in Cisco IOS Release 11.0.
This command is useful for testing because it loops all packets from the interface back to the interface in addition to directing the packets to the network.
Examples
The following example loops all packets back to the interface on interface L1/1:
ons15194# hw-module interface l1/1 loopback line
Related Commands
(EXEC) Displays information about the interfaces.
Command
Description
To reload a specific card in the ONS 15194, use the hw-module reload privileged EXEC command.
hw-module slot slot-identifier reload
Syntax Description
slot Specifies a card in a particular slot is to be reload. slot-identifier Specifies the slot, which can be one of C1, C2 (controllers), S1 to S5 (switch cards), or L1 to L8 (line cards).
Command Modes
Privileged EXEC
Usage Guidelines
This command is similar to the hw-module command that first appeared in Cisco IOS Release 12.1.
This command performs a reload on the card located in the slot identified by slot-identifier. The reload is performed immediately.
Examples
The following example reloads the line card located in slot L1.
ons15194# hw-module slot l1 reload
Related Commands
(global configuration) Disables a specific slot in the ONS 15194. (EXEC) Displays status information about a specific card in a slot.
Command
Description
To disable a specific slot in the ONS 15194 chassis, use the hw-module shutdown global configuration command. Use the no form of this command to enable a specific slot.
hw-module slot slot-identifier shutdown
Syntax Description
slot Specifies a particular slot is to be shutdown. slot-identifier Specifies the slot, which can be one of C1, C2 (controllers), S1 to S5 (switch cards), or L1 to L8 (line cards).
Command Modes
Global configuration
Usage Guidelines
This command is similar to the hw-module command that first appeared in Cisco IOS Release 12.1.
This command disables the specified slot, regardless of the card located in that slot. Even if the card is removed and replaced, the slot will continue to be disabled until the no form of the command is used.
Examples
The following example disables slot S5:
ons15194(config)# hw-module slot s5 shutdown
Related Commands
(privileged EXEC) Reloads the specific card in the ONS 15194. (EXEC) Displays status information about a specific card in a slot.
Command
Description
To temporarily change the transmitted pathtrace message, use the hw-module tx-pathtrace privileged EXEC command.
hw-module interface interface-identifier tx-pathtrace {default | host hostname | interface protocol interface-identifier | side interface-side}
Syntax Description
interface Specifies an interface in the ONS 15194 to control. interface-identifier Specifies the interface of the format Lcard/interface where card is the card number (1 to 8) and interface is the interface number (1 to 8). default Reverts the transmitted pathtrace message to its default. host Specifies to change the hostname in the transmitted pathtrace message. hostname New hostname to be used in the transmitted pathtrace message. interface Specifies to change the interface information in the transmitted pathtrace message. protocol Specifies a whether the interface definition in the transmitted pathtrace message is SRP or POS. side Specifies to change the A/B definition of the interface in the transmitted pathtrace message. interface-side Specifies the A/B definition of the interface in the transmitted pathtrace message.
Command Modes
Privileged EXEC
Usage Guidelines
This command changes the transmitted pathtrace message for the specified interface. Any configuration change to the ONS 15194 will cause the pathtrace message to revert to its default value. This command is only intended to be used for short periods of time for testing purposes.
Examples
The following example changes the interface definitions transmitted in the pathtrace message for the interface:
ons15194# hw-module interface l1/1 tx-pathtrace interface pos l1/2
Related Commands
(EXEC) Displays the transmitted pathtrace message for an interface or all interfaces.
Command
Description
Use the interface global configuration command to configure the Ethernet interface and enter interface configuration mode.
interface ethernet 0
Syntax Description
ethernet Specifies that the Ethernet interface is to be configured. 0 The interface identifier for the Ethernet interface.
Command Modes
Global configuration
Usage Guidelines
This command is similar to the interface command that first appeared in Cisco IOS Release 10.0 for the Cisco 7000 series routers and in Cisco IOS Release 11.0 for the Cisco 4000 series routers.
Examples
The following example sets the IP address for the Ethernet interface to be 12.52.21.7:
ons15194(config)# interface ethernet 0
ons15194(config-if)# ip address 12.52.21.7
Related Commands
(EXEC) Displays information about the interfaces.
Command
Description
Use the io-autoconnect privileged EXEC command to automatically detect all SRP-inner and SRP-outer nodes that are physically connected to the ONS 15194 and to configure them into default inner and outer rings. This command is used to automatically connect rings being configured on two redundant ONS 15194s. The command must be entered on both ONS 15194s.
io-autoconnectSyntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
When executed, the command displays all detected nodes and the proposed ring configuration, and you are prompted to apply the configuration. The io-autoconnect command operates on srp-inner and srp-outer nodes. The command must be entered on both ONS 15194s for SRR redundancy to be effective. To obtain complete ONS 15194 redundancy, all connected devices must support SRR.
The io-autoconnect command detects POS nodes, but does not connect them.
After the io-autoconnect is used, you must verify that the node order on both ONS 15194s is the same, otherwise the SRP rings will not function correctly.
Examples
The following example shows io-autoconnect command output. After performing the autoconnect, you must execute the write command to save the configuration to Flash memory.
ons15194# io-autoconnect
Configuration contains SRP rings definition, and may be discarded.
Continue? y
Sniff configuration:
Sniffer Interface Sniffed node Interface
-------------------- ---------- -------------------- ----------
No sniffer nodes.
POS connections:
Node IP Address Interfaces Type Other
-------------------- --------------- -------------- ---- -------------------
PoSiTiOn25 L5/3 OC48
pOsItIoN26 L1/2 OC48
Ring configuration (nodes in order of outer ring):
AB Rings:
Ring Name Nodes IP Address A B Type Other
---------- -------------------- --------------- ---- ---- ---- -------------
PILOT Abi L1/4 L5/2 OC48
Babi L5/4 L8/2 OC48
Gabi L8/1 L1/3 OC48
Dabi L8/3 L5/1 OC48
Inner Rings:
Ring Name Nodes IP Address A/I B Type Other
---------- -------------------- --------------- ---- ---- ---- -------------
i-default I_GSR_Back_Right 20.1.4.4 L6/2 OC48
I_GSR_Back_Left 20.1.4.3 L7/2 OC48
I_GSR_Right 20.1.4.2 L3/1 OC48
I_GSR_Left 20.1.4.1 L2/1 OC48
Outer Rings:
Ring Name Nodes IP Address A/O B Type Other
---------- -------------------- --------------- ---- ---- ---- -------------
o-default O_GSR_Back_Right 20.1.4.4 L3/2 OC48
O_GSR_Back_Left 20.1.4.3 L2/2 OC48
O_GSR_Right 20.1.4.2 L4/2 OC48
O_GSR_Left 20.1.4.1 L7/1 OC48
Free SRP/Fiber nodes:
No Free AB nodes.
No Free Inner nodes.
No Free Outer nodes.
No Free Fiber nodes.
Apply configuration? y
Configuration applied.
ons15194# write
Building configuration...
[OK]
Related Commands
(global configuration) Specifies the trace-mode of the node to be transparent. (privileged EXEC) Saves the currently running configuration to Flash memory.
Command
Description
Use the io-autoconnect-to-draft rconf configuration command to automatically detect all one-sided SRP nodes that are physically connected to the ONS 15194 and to configure them into default rings, in the draft configuration only. This command is used to automatically connect rings being configured on two redundant ONS 15194s. The command must be entered on both systems.
io-autoconnect-to-draft [unassigned]
Syntax Description
unassigned Optional. Detects only unassigned nodes.
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194.
The io-autoconnect-to-draft command operates on srp-inner and srp-outer nodes. The command only changes the draft configuration. The command must be entered on both ONS 15194s for SRR redundancy to be effective. To obtain complete ONS 15194 redundancy, all connected devices must support SRR. Use the apply command to copy the draft configuration to the running configuration.
If the trace-mode is set to transparent (pathtrace-mode command) for SRP nodes, and the ONS 15194 that you perform the autoconnect command on is connected to a second ONS 15194, any nodes connected to the second ONS 15194 will not be identified.
After the io-autoconnect is used, you must verify that the node order on both ONS 15194s is the same, otherwise the SRP rings will not function correctly.
Examples
The following example shows io-autoconnect-to-draft command output.
ons15194# io-autoconnect-to-draft
Configuration contains SRP rings definition, and may be discarded.
Continue? y
Sniff configuration:
Sniffer Interface Sniffed node Interface
-------------------- ---------- -------------------- ----------
No sniffer nodes.
POS connections:
Node IP Address Interfaces Type Other
-------------------- --------------- -------------- ---- -------------------
PoSiTiOn25 L5/3 OC48
pOsItIoN26 L1/2 OC48
Ring configuration (nodes in order of outer ring):
AB Rings:
Ring Name Nodes IP Address A B Type Other
---------- -------------------- --------------- ---- ---- ---- -------------
PILOT Abi L1/4 L5/2 OC48
Babi L5/4 L8/2 OC48
Gabi L8/1 L1/3 OC48
Dabi L8/3 L5/1 OC48
Inner Rings:
Ring Name Nodes IP Address A/I B Type Other
---------- -------------------- --------------- ---- ---- ---- -------------
i-default I_GSR_Back_Right 20.1.4.4 L6/2 OC48
I_GSR_Back_Left 20.1.4.3 L7/2 OC48
I_GSR_Right 20.1.4.2 L3/1 OC48
I_GSR_Left 20.1.4.1 L2/1 OC48
Outer Rings:
Ring Name Nodes IP Address A/O B Type Other
---------- -------------------- --------------- ---- ---- ---- -------------
o-default O_GSR_Back_Right 20.1.4.4 L3/2 OC48
O_GSR_Back_Left 20.1.4.3 L2/2 OC48
O_GSR_Right 20.1.4.2 L4/2 OC48
O_GSR_Left 20.1.4.1 L7/1 OC48
Free SRP/Fiber nodes:
No Free AB nodes.
No Free Inner nodes.
No Free Outer nodes.
No Free Fiber nodes.
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (global configuration) Specifies the trace-mode of the node to be transparent. (privileged EXEC) Saves the currently running configuration to Flash memory.
Command
Description
To set the IP address for an interface, use the ip address interface configuration command. To remove the specified addresses, use the no form of this command.
ip address address mask
Syntax Description
address IP address. mask Network mask for the associated IP addresses.
Defaults
No default IP address.
Command Modes
Interface configuration
Usage Guidelines
This command is the same as the ip address command that first appeared in Cisco IOS Release 10.0.
Examples
The following example sets the IP address for the Ethernet interface to be 172.16.1.27 and the mask to be 255.255.255.0:
ons15194(config)# interface ethernet 0
ons15194(config-if)# ip address 172.16.1.27 255.255.255.0
Related Commands
(global configuration) Specifies the default gateway for the ONS 15194.
Command
Description
To define a default gateway, use the ip default-gateway global configuration command. To disable this function, use the no form of this command.
ip default-gateway ip-address
Syntax Description
ip-address IP address of the ONS 15194.
Command Modes
Global configuration
Usage Guidelines
This command is the same as the ip default-gateway command that first appeared in Cisco IOS Release 10.0.
Examples
The following example defines the IP address 192.31.7.18 as the default gateway:
ons15194(config)# ip default-gateway 192.31.7.18
Related Commands
(interface configuration) Specifies the IP address of ONS 15194.
Command
Description
To define a default domain name that the ONS 15194 uses to complete unqualified host names (names without a dotted-decimal domain name), use the ip domain-name global configuration command. To disable use of the DNS, use the no form of this command.
ip domain-name name
Syntax Description
name Default domain name used to complete unqualified host names. Do not include the initial period that separates an unqualified name from the domain name.
Defaults
Disabled
Command Modes
Global configuration
Usage Guidelines
This command is the same as the ip domain-name command that first appeared in Cisco IOS Release 10.0.
Any IP host name that does not contain a domain name (that is, any name without a dot), will have the dot and cisco.com appended to it before being added to the host table.
Examples
The following example defines cisco.com as the default domain name:
ons15194(config)# ip domain-name cisco.com
Related Commands
(global configuration) Specifies the address of one or more name servers to use for name resolution.
Command
Description
To specify the password to be used for File Transfer Protocol (FTP) connections, use the ip ftp password global configuration command. Use the no form of this command to return the password to its default.
ip ftp password [type] password
Syntax Description
type Optional. Type of encryption to use on the password. A value of 0 disables encryption. A value of 7 indicates proprietary encryption. password Password to be used for logging into an FTP server.
Command Modes
Global configuration
Examples
The following example configures the router to use the username red and the password blue for FTP connections:
ons15194# ip ftp username red
ons15194# ip ftp password blue
Related Commands
(global configuration) Specifies the username to be used for FTP connections.
Command
Description
To configure the username for File Transfer Protocol (FTP) connections, use the ip ftp username global configuration command. To configure the ONS 15194 to use anonymous FTP, use the no form of this command.
ip ftp username [type] username
Syntax Description
type Optional. Type of encryption to use on the password. A value of 0 disables encryption. A value of 7 indicates proprietary encryption. username Username to be used for logging in to an FTP server.
Command Modes
Global configuration
Usage Guidelines
The remote username must be associated with an account on the destination server.
Examples
The following example configures the ONS 15194 to use the username red and the password blue for FTP connections:
ons15194# ip ftp username red
ons15194# ip ftp password blue
Related Commands
(global configuration) Specifies the password to be used for FTP connections.
Command
Description
To specify the address of one or more name servers to use for name and address resolution, use the ip name-server global configuration command. To remove the addresses specified, use the no form of this command.
ip name-server server-address1 [server-address2]
Syntax Description
server-address1 IP address of the name server. server-address2 Optional. Secondary address of the name server.
Command Modes
Global configuration
Usage Guidelines
This command is the same as the ip name-server command that first appeared in Cisco IOS Release 10.0.
Examples
The following example specifies host 131.108.1.111 as the primary name server and host 131.108.1.2 as the secondary server:
ons15194(config)# ip name-server 131.108.1.111 131.108.1.2
Related Commands
(global configuration) Specifies a default domain name.
Command
Description
To change the switching control for an APS node, use the l-aps privileged EXEC command. To disable the switching control, use the no form of this command.
l-aps aps-node force {0 | 1}
Syntax Description
aps-node Name of the APS node for which to change the switching control. force Forces a switch away from the specified link (0 or 1). When P (protection) is the forced link, the working link (W) remains active irrespective of the condition of its link. When W is the forced link (that is, P is active), control will return to the W link if there is a signal failure on the P link. 0 | 1 The link to switch away from, where lockout Lockout of protection. That is, the working link is forced to be active, irrespective of the condition of the links. manual Manually switches from either the working link (link=1) or protection link (link=0). If a problem (signal fail or signal degradation) is detected on the active link, a manual switch will be discarded, and an automatic switch will occur.
0 indicates to switch away from the protection link to the working link;
1 indicates to switch away from the working link to the protection link.
Command Modes
Privileged EXEC
Usage Guidelines
This command is only applicable to the ONS 15194. The l-aps command is used for user-initiated switching of APS nodes. Such nodes should be previously defined and configured using the node create aps command. Also, the trace-mode of APS nodes (pathtrace-mode command) should be set to transparent (default).
Examples
The following example causes a switch away from the protection (0) link to the working (1) link for the node node1. In this case, the working link remains active irrespective of the condition of its link.
ons15194# l-aps node1 force 0
Related Commands
node create aps (rconf configuration) Defines a new APS node. (rconf configuration) Specifies APS parameters of a node. (global configuration) Specifies the trace-mode of the node to be transparent.
Command
Description
To identify a specific line for configuration and start the line configuration command mode, use the line global configuration command.
line console 0
Syntax Description
console 0 Specifies that the first (and only) console terminal line is to be configured. maint 0 Specifies that the first (and only) maintenance line is to be configured. vty Specifies that the virtual terminal for remote console access (Telnet) is to be configured. line-number Specifies the relative number of the terminal line (or the first line in a contiguous group) that you want to configure when the line type is specified. Numbering begins with zero. ending-line-number Optional. Specifies the relative number of the last line in a contiguous group that you want to configure.
Command Modes
Global configuration
Usage Guidelines
This command is similar to the line command that first appeared in Cisco IOS Release 10.0.
You can address a single line or a consecutive range of lines with the line command. A line number is necessary, though, and you will receive an error message if you do not include it. For console and maint, the line number is always zero.
The line number is a relative line number. For instance, the following example refers to the second vty line.
ons15194(config)# line vty 1
Examples
The following example starts configuration for virtual terminal lines 0 to 4:
ons15194(config)# line vty 0 4
The following example starts configuration for the console line:
ons15194(config)# line console 0
Related Commands
(EXEC) Displays current Telnet sessions.
Command
Description
To log messages to a syslog server host, use the logging host global configuration command. To delete the syslog server with the specified address from the list of syslogs, use the no form of this command.
logging host host
Syntax Description
host Name or IP address of the host to be used as a syslog server.
Defaults
No messages are logged to a syslog server host.
Command Modes
Global configuration
Usage Guidelines
This command identifies a syslog server host to receive logging messages. By using this command more than once, you build a list of syslog servers that receive logging messages. the logging trap command specifies which logs are to be sent to the syslog server according to severity.
Examples
The following example logs messages to a host named cis12:
ons15194(config)# logging host cis12
Related Commands
(global configuration) Specifies syslog server logging level. (EXEC) Displays the logging buffer.
Command
Description
To change the severity used to determine which messages to log to an internal buffer on the Flash memory, use the logging buffered global configuration command. To rever the severity to the default value, use the no form of this command.
logging buffered severity
Syntax Description
severity Specifies the severity of messages that are to be logged. The severity value may be a keyword or decimal as described in Table 5-15.
Defaults
By default the software logs messages of severity warnings (4) or above to the internal buffer.
Command Modes
Global configuration
Usage Guidelines
This command provides the ability to specify a severity level for the messages to be logged, as described in Table 5-15.
| Severity Keyword | Severity | Description |
|---|---|---|
emergencies | 0 | System is unusable. |
alerts | 1 | Immediate action is needed. |
critical | 2 | Critical conditions. |
errors | 3 | Error conditions. |
warnings | 4 | Warning conditions. |
notifications | 5 | Normal but significant conditions. |
informational | 6 | Information messages. |
debugging | 7 | Debugging messages. |
This command copies logging messages to an internal buffer. The buffer is circular in nature, so newer messages overwrite older messages after the buffer is filled.
To display the messages that are logged in the buffer, use the EXEC command show logging. The first message displayed is the oldest message in the buffer.
Examples
The following example specifies to log messages to the internal buffer of severity 5 or greater (notifications):
ons15194(config)# logging buffered 5
Related Commands
(EXEC) Displays the contents of the logging buffer.
Command
Description
To change the severity used to determine which messages to log to the console, use the logging console global configuration command. To rever the severity to the default value, use the no form of this command.
logging console severity
Syntax Description
severity Specifies the severity of messages that are to be logged. The severity value may be a keyword or decimal as described in Table 5-16.
Defaults
By default, the software logs messages of severity warnings (4) or above to the console.
Command Modes
Global configuration
Usage Guidelines
Specifying a severity causes messages at that severity and numerically lower levels to be displayed on the console terminal. The severity may be specified by the keyword or decimal equivalent.
The EXEC command show logging displays the addresses and severities associated with the current logging setup, as well as any other logging statistics. (See Table 5-16 following.)
| Severity Keyword | Severity | Description |
|---|---|---|
emergencies | 0 | System is unusable. |
alerts | 1 | Immediate action needed. |
critical | 2 | Critical conditions. |
errors | 3 | Error conditions. |
warnings | 4 | Warning conditions. |
notifications | 5 | Normal but significant conditions. |
informational | 6 | Information messages. |
debugging | 7 | Debugging messages. |
Examples
The following example specifies that all messages of severity warnings (4) or above are logged to the console port:
ons15194(config)# logging console 4
Related Commands
(EXEC) Displays the contents of the logging buffer.
Command
Description
To change the severity used to determine which messages to log to the maintenance port, use the logging maint global configuration command. To rever the severity to the default value, use the no form of this command.
logging maint severity
Syntax Description
severity Specifies the severity of messages that are to be logged. The severity value may be a keyword or decimal as described in Table 5-17.
Defaults
By default, the software logs messages of severity warnings (4) or above to the maintenance port.
Command Modes
Global configuration
Usage Guidelines
The severity may be specified by keyword or decimal as shown in Table 5-17 following:
| Severity Keyword | Severity | Description |
|---|---|---|
emergencies | 0 | System is unusable. |
alerts | 1 | Immediate action needed. |
critical | 2 | Critical conditions. |
errors | 3 | Error conditions. |
warnings | 4 | Warning conditions. |
notifications | 5 | Normal but significant conditions. |
informational | 6 | Information messages. |
debugging | 7 | Debugging messages. |
The EXEC command show logging displays the addresses and severities associated with the current logging setup, as well as any other logging statistics.
Examples
The following example specifies to log messages of severity errors (3) or above to the maintenance port:
ons15194(config)# logging maint errors
Related Commands
(EXEC) Displays the contents of the logging buffer.
Command
Description
To change the severity used to determine which messages to log to terminal lines, use the logging monitor global configuration command. This command limits the messages logged to terminal lines to messages with a level at or above severity. To rever the severity to the default value, use the no form of this command.
logging monitor severity
Syntax Description
severity Specifies the severity of messages that are to be logged. The severity value may be a keyword or decimal as described in Table 5-18:
Defaults
By default the software logs messages of severity warnings (4) or above to the terminal lines.
Command Modes
Global configuration
Usage Guidelines
This command is similar to the logging monitor command that first appeared in Cisco IOS Release 10.0.
Specifying a severity causes messages at that severity and numerically lower levels to be displayed to the terminal lines. This does not include the console line.The severity may be specified by the keyword or decimal equivalent. (See Table 5-18 following.)
| Severity Keyword | Severity | Description |
|---|---|---|
emergencies | 0 | System is unusable. |
alerts | 1 | Immediate action needed. |
critical | 2 | Critical conditions. |
errors | 3 | Error conditions. |
warnings | 4 | Warning conditions. |
notifications | 5 | Normal but significant conditions. |
informational | 6 | Information messages. |
debugging | 7 | Debugging messages. |
Examples
The following example logs messages of severity critical (2) or above to the terminal monitor:
ons15194(config)# logging monitor critical
Related Commands
(EXEC) Displays the contents of the logging buffer. (privileged EXEC) Displays debug command output and system error messages for the current terminal and session.
Command
Description
To change the severity used to determine which messages to log to to the ONS 15194, use the logging trap global configuration command. The command limits the logging of error messages sent to ONS 15194 servers to only those messages at the specified level. To revert the severity to the default value, use the no form of this command.
logging trap severity
Syntax Description
severity Specifies the severity of messages that are to be logged. The severity value may be a keyword or decimal as described in Table 5-19.
Defaults
By default, the software logs messages of severity warnings (4) or above to the ONS 15194 servers.
Command Modes
Global configuration
Usage Guidelines
This command is similar to the logging trap command that first appeared in Cisco IOS Release 10.0.
Specifying a severity causes messages at that severity and numerically lower levels to be logged to the servers. The severity may be specified by the keyword or decimal equivalent. (See Table 5-19 following.)
| Severity Keyword | Severity | Description |
|---|---|---|
emergencies | 0 | System is unusable. |
alerts | 1 | Immediate action needed. |
critical | 2 | Critical conditions. |
errors | 3 | Error conditions. |
warnings | 4 | Warning conditions. |
notifications | 5 | Normal but significant conditions. |
informational | 6 | Information messages. |
debugging | 7 | Debugging messages. |
Examples
The following example logs messages of severity critical (2) or above to the system servers:
ons15194(config)# logging trap critical
Related Commands
(EXEC) Displays the contents of the logging buffer.
Command
Description
To create a new directory in the Flash memory or ATA PCMCIA file systems, use the mkdir EXEC command.
mkdir [file-url]
Syntax Description
file-url Optional. Keyword of the directory or file system as in Table 5-20. If the file system is not specified, the default file system is used.
The file system must be one of the keywords as shown in Table 5-20.
| Keyword | Description |
|---|---|
disk0: | Create directory on disk0: file system. This is the disk in the first PCMCIA card slot. |
disk1: | Create directory on disk1: file system. This is the disk in the second PCMCIA card slot. |
flash: | Create directory on flash: file system. |
Defaults
The initial default file system is as specified in the cd command.
Command Modes
Privileged EXEC
Usage Guidelines
You are prompted for the name of the directory to create.
Related Commands
(privileged EXEC) Displays a list of files on a file system. (privileged EXEC) Removes an existing directory in a Flash memory file system.
Command
Description
To display a file, use the more EXEC command.
mkdir [/binary] file-url
Syntax Description
/binary Optional. Displays a file in hex/text format. file-url Keyword of the directory or file system as in Table 5-21.
The file system must be one of the keywords as shown in Table 5-21.
| Keyword | Description |
|---|---|
disk0: | Display from disk0: file system. This is the disk in the first PCMCIA card slot. |
disk1: | Display from disk1: file system. This is the disk in the second PCMCIA card slot. |
flash: | Display from flash: file system. |
ftp: | Display from ftp: file system. |
tftp: | Display from tftp: file system. |
Command Modes
Privileged EXEC
Usage Guidelines
You are prompted for the name of the file to display.
Related Commands
(privileged EXEC) Displays a list of files on a file system. (privileged EXEC) Removes an existing directory in a Flash memory file system.
Command
Description
To display message-of-the-day (MOTD) banners, use the motd-banner global configuration command. To suppress the MOTD banners, use the no form of this command.
motd-bannerSyntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Global configuration
Usage Guidelines
This command is similar to the motd-banner line configuration command that first appeared in Cisco IOS Release 11.1.
This command determines whether the ONS 15194 will display the MOTD banner when an EXEC session is created. The MOTD banner is defined with the banner motd command.
Examples
The following example suppresses the MOTD banner:
ons15194(config)# no motd-banner
Related Commands
(global configuration) Copies the contents of a text file to be used as the login message.
Command
Description
To disable Simple Network Management Protocol (SNMP) agent operations, use the no snmp-server EXEC command.
no snmp-serverSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command disables all running versions of SNMP on the device.
Examples
The following example disables the current running version of SNMP:
15194> no snmp-server
To automatically detect new nodes, use the node autodetect rconf command.
node autodetect [unassigned]
Syntax Description
unassigned Optional. Detect nodes on unassigned interfaces only.
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194.
The node autodetect command detects all nodes that are physically connected to the ONS 15194. Use the unassigned keyword to detect only new nodes that are on interfaces that were previouslynot used in the definition of any nodes.
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (global configuration) Specifies that the pathtrace message (PTM) should not be transparent.
Command
Description
To configure a new node, use the node create rconf configuration command. To delete a node, use the no form of the command.
node create {aps | pos | sniff | srp | srp-inner | srp-outer} node-name interface-id1 interface-id2
Syntax Description
aps Specifies an automatic protection switching (APS) node. APS nodes are connected to the ONS 15194 via 2 interfaces where interface-id1 is the working link (W) and interface-id2 is the protection link (P). Once defined, an APS node may be connected to another APS or POS node using the pos connect command. pos Specifies a packet over SONET (POS) node. POS nodes are connected via a single interface interface-id1. After the POS node is defined, it can be connected to another APS or POS node using the pos connect command. sniff Specifies a sniffer node for monitoring traffic through a particular interface in the ONS 15194. Sniff nodes are connected through a single interface interface-id1. To define which interface is to be monitored (sniffed), use the sniff connect command. srp Specifies an SRP node. SRP nodes are connected via 2 interfaces: interface-id1 and interface-id2 (connected to the A and B sides of the node, respectively). After the nodes are defined, they can be connected into ring(s) by using the command ring create. srp-inner Specifies one side of an SRP node. Such connections are required when configuring two redundant ONS 15194s. In this event, all inner fibers are connected to one ONS 15194 and all outer fibers are connected to the second ONS 15194. One-sided SRP nodes are connected via one interface: interface-id1. After the nodes are defined, they can be connected into ring(s) by using the command ring create on both ONS 15194s. node-name Node identifier. interface-id1 interface-id2 Interfaces to which the node is physically connected. Interfaces must be of the format Lcard/interface where card is the card number (1 to 8) and interface is the interface number (1 to 8).
srp-outer
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194. Nodes are defined according to their use in the network (APS, POS, SRP, and so forth). Give each new node a name, and specify the physical interface or interfaces to which it is connected in the ONS 15194.
Examples
The following example creates an SRP node of name srp-line1, connected to interfaces L3/1 and L4/2.
ons15194(rconf)# node create srp srp-line1 L3/1 L4/2
OC48 SRP node srp-line1 created.
The following example creates a POS node of name pos-1, connected to interface L3/2:
ons15194(rconf)# node create pos pos-1 L3/2
OC48 POS node pos-1 created.
The following example deletes the POS node created in the previous example:
ons15194(rconf)# no node create pos pos-1
Node pos-1 deleted.
The following example creates an OC-12c/STM-4 APS node connected to interfaces L2/1 and L3/2:
ons15194(rconf)# node create aps aps-1 L2/1 L3/2
OC48 APS node aps-1 created.
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (rconf configuration) Connects two POS nodes together. (rconf configuration) Creates a new ring with the specified nodes.
Command
Description
To force the ONS 15194 to temporarily remove a node from the ring, use the node force-bypass rconf configuration command. To return the node to the ring, use the no form of the command.
node node-name force-bypass
Syntax Description
node-name Node identifier of the specific node to bypass.
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194.
You must use the apply command before any configuration changes take affect. Use the display draft command to display whether nodes are bypassed or not.
Examples
The following example bypasses the node baltimore from the ring:
ons15194(rconf)# node baltimore force-bypass
Node baltimore force bypass updated.
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (rconf configuration) Displays the contents of the current draft configuration.
Command
Description
To change the interfaces to which a node is connected, use the node interface rconf configuration command.
node node-name interface interface-id1 interface-id2
Syntax Description
node-name Node identifier. interface-id1 interface-id2 Interfaces to which the node is physically connected. Interfaces must be of the format Lcard/interface where card is the card number (1 to 8) and interface is the interface number (1 to 8).
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194.
The specified interfaces, interface-id1 and interface-id2 become the new interfaces to which the node is connected. When changing the defined interface for sniff or fiber ports, only one interface (interface-id1) is required.
Examples
The following example changes the defined interfaces for node srp-line1 to be L3/1 and L4/2:
ons15194(rconf)# node srp-line1 interface L3/1 L4/2
Node srp-line1 modified.
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (rconf configuration) Configures a new node.
Command
Description
To automatically detect srp-inner and srp-outer nodes, use the node io-autodetect rconf command.
node io-autodetect [unassigned]
Syntax Description
unassigned Optional. Detect nodes on unassigned interfaces only.
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194.
The node io-autodetect command detects all srp-inner and srp-outer nodes that are physically connected to the ONS 15194. Use the unassigned keyword to detect only nodes which are on unassigned interfaces.
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration.
Command
Description
To rename a node, use the node rename rconf configuration command.
node node-name rename new-name
Syntax Description
node-name Node identifier of the specific node. new-name New node identifier of the specific node.
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194.
You must use the apply command before any configuration changes take affect.
Examples
The following example renames the node aps-1 to aps-node:
ons15194(rconf)# node aps-1 rename aps-node
Node aps-1 renamed to aps-node.
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration.
Command
Description
To specify the line-level alarm indication signal (L-AIS) properties for a node, use the node set ais rconf configuration command. To return the L-AIS setting to the default (auto), use the no form of this command.
node {node-name | all} set ais {always | auto | never}
Syntax Description
node-name Node identifier of a specific node. all Changes the AIS properties for all nodes. always Specifies that the node interfaces generate a constant AIS signal. auto Specifies that the node interfaces mirror the AIS signal automatically. never Specifies that the node interfaces never generate an AIS signal.
Defaults
Auto
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194.
Before specifying the AIS parameters of a node, you must first create the node using the node create command. You must use the apply command before any configuration changes take affect.
Examples
The following example specifies that node srp-1 will mirror the AIS signal automatically:
ons15194(rconf)# node srp-1 set ais auto
Node srp-1 AIS setting set to Auto.
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (rconf configuration) Configures a new node.
Command
Description
To specify the clock source for the node, use the node set clock-source rconf configuration command. To return the clock-source setting to the default (internal), use the no form of this command with no parameters. If parameters are specified with the no form of this command, the clock-source setting is reversed.
node {node-name | all} set clock-source {internal | line}
Syntax Description
node-name Node identifier of a specific node. all Changes the clock source properties for all nodes. internal Specifies the clock source to be internal clock. line Specifies the clock source to be line-recovered clock.
Defaults
Internal
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194. Before specifying the clock source of a node, you must first create the node using the node create command. You must use the apply command before any configuration changes take affect.
Examples
The following example sets the clock-source to be line-recovered:
ons15194(rconf)# node all set clock-source line
The following example returns the clock-source to be internal clock:
ons15194(rconf)# no node all set clock-source
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (rconf configuration) Configures a new node.
Command
Description
To specify whether nodes are configured for SDH or SONET, use the node set framing rconf configuration command. To return the framing setting to the default (SONET), use the no form of this command with no parameters. If parameters are specified with the no form of this command, the framing setting is reversed.
node {node-name | all} set framing {sdh | sonet}
Syntax Description
node-name Node identifier of a specific node. all Specifies to change the framing properties for all nodes. sdh | sonet Specifies whether the node is configured for SDH or SONET.
Defaults
SONET
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194. Before specifying the mode of a node, you must first create the node using the node create command. You must use the apply command before any configuration changes take affect.
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (global configuration) Specifies the default SRP framing type. (rconf configuration) Configures a new node.
Command
Description
To specify the bit error rate (BER) threshold for the definition of a signal degrade (sd) or signal fail (sf), use the node set threshold rconf configuration command. To return the thresholds to their default values, use the no form of this command.
node {node-name | all} set threshold {sd-ber | sf-ber} threshold
Syntax Description
node-name Node identifier of a specific node. all Specifies to change the signal degrade or signal fail threshold properties for all nodes. sd-ber Indicates whether to define the threshold for a signal degrade or signal fail. threshold Specifies the BER threshold. Values for a signal degrade may be 5 to 9 as follows: Values for a signal fail may be 3 to 5 as follows:
sf-ber
5 for 1e-5
6 for 1e-6
7 for 1e-7
8 for 1e-8
9 for 1e-9
3 for 1e-3
4 for 1e-4
5 for 1e-5
Defaults
The default for signal degrade is 6; the default for signal fail is 5.
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194. Before specifying the mode of a BER threshold for a signal degrade, you must first create the node using the node create command. You must use the apply command before any configuration changes take effect.
Examples
The following example sets the BER threshold for a signal degrade to be 1e-5 for the SRP node srp-1:
ons15194(rconf)# node create srp srp-1 L4/2 L3/1
OC48 SRP node srp-1 created.
ons15194(rconf)# node srp-1 set threshold sd-ber 5
Node srp-1 SD BER set to 1e-5.
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (rconf configuration) Configures a new node.
Command
Description
To specify the switching mode of APS nodes to be revertive, use the node set aps rconf configuration command. To specify non-revertive switching or a bidirectional APS node, use the no form of the command.
node {node-name | all} set aps {revert [wait-to-restore] | unidirectional}
Syntax Description
node-name Node identifier of a specific node. all All nodes. revert Specifies that control returns to the working link (W) when the link becomes functional. wait-to-restore Optional. Number of minutes the ONS 15194 waits after the working link is functional before reverting to it. unidirectional Specifies node to be unidirectional.
Defaults
Revertive. The default wait-to-restore time is 5 minutes.
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194.
In revertive mode, control will return to the working link wait-to-restore minutes after the link becomes functional. The no form of this command specifies that control remains wherever it is as long as the link is functional.
Before specifying the switching mode of an APS node, you must first create the node using the node create command. You must then use the apply command before any configuration changes take affect.
Examples
The following example specifies the switching mode for the node aps-1 to be revertive with a wait-to-restore time of 2 minutes.
ons15194(rconf)# node aps-1 set aps revert 2
Node aps-1 set to revertive, WTR = 2 minutes.
The following example specifies the switching mode for the node aps-1 to be non-revertive.
ons15194(rconf)# no node aps-1 set revert
Node aps-1 set to non-revertive.
Related Commands
(rconf configuration) Copies the draft configuration to the running configuration. (rconf configuration) Configures a new node.
Command
Description
To specify that the pathtrace message (PTM) for the specified nodes reflect the PTM of the connected node and not that of the ONS 15194, use the pathtrace-mode global configuration command. To send PTMs that identify the ONS 15194, use the no form of this command.
pathtrace-mode {pos | sniff | srp} transparent
Syntax Description
pos | sniff | srp Specifies the type of nodes for which to set the path trace message. transparent Specifies that the PTMs sent by the ONS 15194 reflect the connected node.
Defaults
pathtrace-mode pos transparent
pathtrace-mode sniff transparent
no pathtrace-mode srp transparent
Command Modes
Global configuration
Usage Guidelines
This command is only applicable to the ONS 15194. When two interfaces are connected and they are operating in transparent mode, the path trace message transmitted by each is that received by the other.When transparent PTM is not used, each interface transmitts a PTM that identifies it as an ONS 15194 interface.
Examples
The following example sets the PTM for all SRP nodes to be that of the connected node:
ons15194(config)# pathtrace-mode srp transparent
SRP connections Trace mode set to Transparent.
The following example sets the PTM for all POS nodes to be that of the ONS 15194:
ons15194(config)# no pathtrace-mode pos transparent
POS connections Trace mode set to Normal.
Related Commands
(privileged EXEC) Automatically configures connected nodes. (rconf configuration) Specifies switching control for APS nodes.
Command
Description
To ping a host, use the ping EXEC command.
ping {host | address}
Syntax Description
host Host name of system to ping. address Address of system to ping.
Command Modes
EXEC and privileged EXEC
Usage Guidelines
This command is similar to the ping command that first appeared in Cisco IOS Release 10.0.
The ping command sends an echo request packet to an address, and awaits a reply. The ping command can help you evaluate path-to-host reliability, delays over the path, and whether the host can be reached or is functioning.
Examples
The following example pings the host cisco.com:
ons15194# ping cisco.com
resolving cisco.com...198.133.219.25
PING 198.133.219.25: 56 data bytes
64 bytes from www.cisco.com (198.133.219.25): icmp_seq=0. time=257. ms
64 bytes from www.cisco.com (198.133.219.25): icmp_seq=1. time=278. ms
64 bytes from www.cisco.com (198.133.219.25): icmp_seq=2. time=258. ms
64 bytes from www.cisco.com (198.133.219.25): icmp_seq=3. time=258. ms
64 bytes from www.cisco.com (198.133.219.25): icmp_seq=4. time=259. ms
----198.133.219.25 PING Statistics----
5 packets transmitted, 5 packets received, 0% packet loss
round-trip (ms) min/avg/max = 257/262/278
To connect two POS or two APS nodes, use the pos connect global configuration command. To disconnect two POS or two APS nodes, use the no form of this command.
pos connect node-id1 node-id2
Syntax Description
node-id1, node-id2 Node identifiers of nodes to connect.
Command Modes
rconf configuration
Usage Guidelines
This command is applicable only to the ONS 15194. Before you can connect two nodes together, you must define them using the node create command. The nodes being connected must be defined as POS or APS nodes. To disconnect two nodes, it is sufficient to specify either one of the connected nodes.
Examples
The following example creates two APS nodes and connects them:
ons15194(rconf)# node create aps aps1 l4/1 l5/2
OC48 APS node aps1 created.
ons15194(rconf)# node create aps aps2 l3/3 l4/4
OC48 APS node aps2 created.
ons15194(rconf)# pos connect aps1 aps2
Nodes connected.
Related Commands
node create aps (rconf configuration) Configures a new APS node. node create pos (rconf configuration) Configures a new POS node.
Command
Description
To show the current setting of the cd command, use the pwd EXEC command.
pwdSyntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Usage Guidelines
Use the pwd command to display the current directory or file system specified as the default by the cd command. For all EXEC commands that have an optional file-url argument, the system uses the file system specified by the cd command when you omit the optional file-url argument.
For example, the dir command contains an optional file-url argument and displays a list of files on a particular file system. When you omit this file-url argument, the system displays a list of the files on the file system specified by the cd command.
Examples
The following example shows that the present working file system specified by the cd command is slot 0:
ons15194# pwd
disk0:/
Related Commands
(privileged EXEC) Changes the current directory. (privileged EXEC) Displays a list of files on a file system. (EXEC) Lists available file systems and their alias prefix names.
Command
Description
To enter rconf configuration mode, use the rconf privileged EXEC command.
rconfSyntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Usage Guidelines
The command is only applicable to the ONS 15194.
To perform all node and ring configurations, you must enter the rconf configuration mode. Changes made in this mode are only made to the draft configuration, until the apply command is executed. After the apply command is used, the draft configuration is copied to the running configuration.
To save the running configuration to the startup configuration, use the write command. If configuration changes are not saved to the startup configuration and a reset is performed, any changes made to the running configuration will be lost.
Only one user at a time may enter rconf mode. If a second user attempts to enter rconf configuration, an error message is displayed.
To display the current draft configuration, use the display draft rconf configuration command. To display the running configuration, use the display running rconf configuration command.
Examples
The following example enters rconf configuration mode from Privileged EXEC mode. The (rconf) prompt indicates rconf configuration mode:
ons15194# rconf
Rconf configuration commands modify the Draft configuration only.
Enter 'apply' to copy the Draft configuration to the Running configuration.
ons15194(rconf)#
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (rconf configuration) Displays the contents of the current draft configuration. (rconf configuration) Displays the contents of the current running configuration. (privileged EXEC) Saves current running configuration to be the startup configuration.
Command
Description
To halt and perform a cold restart on the ONS 15194 controller, use the reload privileged EXEC command.
reload [standby]
Syntax Description
standby Specifies to reload the standby controller.
Command Modes
Privileged EXEC
Usage Guidelines
This command is similar to the reload command that first appeared in Cisco IOS Release 10.0.
The reload command halts the ONS 15194. If the startup configuration is different than the running configuration, the ONS 15194 prompts you to save the running configuration to the startup configuration. If you use the standby keyword, the ONS 15194 continues running on the active controller, and the standby controller is rebooted.
Examples
The following example resets the active controller:
ons15194# reload
Running-config is different from startup-conf.
Save running to startup? [Yes/No]:N
Controller will be reset.
Are you sure?y
To rename a file in a Flash file system, use the rename EXEC command.
rename file-system
Syntax Description
file-system Keyword of the directory or file system.
The file system must be one of the keywords as shown in Table 5-22.
| Keyword | Description |
|---|---|
disk0: | Rename file on disk0: file system. This is the disk in the first PCMCIA card slot. |
disk1: | Rename file on disk1: file system. This is the disk in the second PCMCIA card slot. |
flash: | Rename file on flash: file system. |
Command Modes
Privileged EXEC
Usage Guidelines
This command is valid only on Class C Flash memory file systems.
Examples
In the following example, the file named Karen.1 is renamed test:
15194# dir
Directory of disk0:/Karen.dir/
0 -rw- 0 Jan 21 1998 09:51:29 Karen.1
0 -rw- 0 Jan 21 1998 09:51:29 Karen.2
0 -rw- 0 Jan 21 1998 09:51:29 Karen.3
0 -rw- 0 Jan 21 1998 09:51:31 Karen.4
243 -rw- 165 Jan 21 1998 09:53:17 Karen.cur
340492288 bytes total (328400896 bytes free)
15194# rename disk0:Karen.dir/Karen.1 disk0:Karen.dir/test
Router# dir
Directory of disk0:/Karen.dir/
0 -rw- 0 Jan 21 1998 09:51:29 Karen.2
0 -rw- 0 Jan 21 1998 09:51:29 Karen.3
0 -rw- 0 Jan 21 1998 09:51:31 Karen.4
243 -rw- 165 Jan 21 1998 09:53:17 Karen.cur
0 -rw- 0 Apr 24 1998 09:49:19 test
340492288 bytes total (328384512 bytes free)
Related Commands
(privileged EXEC) Lists the files on a file system. (privileged EXEC) Deletes a directory on a file system.
Command
Description
To set the draft configuration to be the same as the current running configuration, use the revert-to-running rconf configuration command.
revert-to-runningSyntax Description
This command contains no arguments or keywords.
Command Modes
rconf configuration
Usage Guidelines
This command only applies to the ONS 15194. After executing this command, the draft configuration becomes the same as the current running configuration. This is helpful if you want to make changes to the current configuration.
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (rconf configuration) Sets the draft configuration to null. (rconf configuration) Displays information concerning the draft configuration.
Command
Description
To add a node to a ring, or reorder the nodes of a ring, use the ring connect rconf configuration command. To remove nodes from the ring, use the no form of this command.
ring ring-name connect {node-name | all} [after node-name]
Syntax Description
ring-name Ring identifier. node-name Node identifier. all Adds all nodes to the ring or delete all nodes from the ring. after Optional. Positions the node after the node specified after the keyword after, regardless of whether the node was previously in the ring or not. When not specified, the node is added to the end of the list.
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194.
Use of the ring connect command without the after option, adds the node to the ring at the end of the list. When used on a node that is currently in the ring, the nodes of the ring are reordered accordingly. When used on a node that is not in the ring, the node is added to the ring at the specified location.
Use of the keyword all, connects all free nodes into the ring. Use of the no form of the command and the keyword all, removes all nodes from the ring.
Use the keyword after to specify the location of the node in the ring. If the after keyword is not used, the node is added to the end of the list. It makes no difference if the node was previously part of the ring or not. If the node is a member of another ring, the command fails.
Examples
The following example adds the node srp-south to the ring ring-t2 after the node srp-west.
ons15194(rconf)# ring ring-t2 connect srp-south after srp-west
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (rconf configuration) Displays information about the current draft configuration, including the defined rings and their respective nodes. (rconf configuration) Configures a new ring. (rconf configuration) Adds multiple nodes to a ring.
Command
Description
To define a new SRP ring, use the ring create rconf configuration command. To delete an SRP ring from the draft configuration, use the no form of this command.
ring create ring-name [inner | outer]
Syntax Description
ring-name Ring identifier of the ring to reorder. inner Defines the ring to be SRP-inner. outer Defines the ring to be SRP-outer.
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194.
A ring created with this command has no nodes defined. You must add nodes to the ring using the ring node-list or ring add command. You must use the apply command before any configuration changes take affect.
Examples
The following example defines the new ring ring-t2 and adds node srp-south to this ring.
ons15194(rconf)# ring create ring-t2
SRP ring ring-t2 created.
ons15194(rconf)# ring ring-t2 add srp-south
Node srp-south added.
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (rconf configuration) Displays information about the current draft configuration, including the defined rings and their respective nodes. (rconf configuration) Adds a node to a ring. (rconf configuration) Adds multiple nodes to a ring.
Command
Description
To create a new ring from a specified list of nodes, use the ring node-list rconf configuration command.
ring ring-name node-list [inner | outer]
Syntax Description
ring-name Ring identifier of the ring. inner Defines the ring to be SRP-inner. outer Defines the ring to be SRP-outer.
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194.
Using the ring node-list command creates a new ring of the given name. If the ring exists, its contents are removed. You are then prompted to enter the nodes for the ring, line-by-line, in the desired order. Press enter after each node name entered. Press ? to display the available options and a list of the remaining nodes. When all nodes have been entered, press Ctrl-Z or type end to complete the ring configuration. You can press Ctrl-T at any time to display the current list of nodes for the ring. The no option can be used at any stage to remove a node from the list.
By default, a ring created with the ring node-list command is of type SRP. If the ring is to be SRP-inner or SRP-outer, use the inner or outer keywords.
Examples
The following example defines the new ring ring2 and adds the nodes nod1, nod2, and nod3 to this ring.
ons15194(rconf)# node create srp nod1 l1/1 l2/2 oc48
OC48 SRP node nod1 created.
ons15194(rconf)# node create srp nod2 l2/3 l1/3 oc48
OC48 SRP node nod2 created.
ons15194(rconf)# node create srp nod3 l1/2 l2/1 oc48
OC48 SRP node nod3 created.
ons15194(rconf)# ring ring2 node-list
SRP ring ring2 created.
Ring ring2 node list cleared.
Enter '?' at any point for help. Use 'Ctrl-Z' to complete ring configuration.
Use 'Ctrl-T' to view current node list.
node: nod1
Node nod1 connected.
node: nod2
Node nod2 connected.
node: nod3
Node nod3 connected.
node:
ons15194(rconf)#
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (rconf configuration) Displays information about the current draft configuration, including the defined rings and their respective nodes. (rconf configuration) Adds a node to a ring, one node at a time. (rconf configuration) Defines a new node.
Command
Description
To rename a ring, use the ring rename rconf configuration command.
ring ring-name rename ring-name2
Syntax Description
ring-name Ring identifier. ring-name2 New ring identifier.
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194.
This command renames a ring to the new name ring-name2. You must use the apply command before any configuration changes take affect.
Examples
The following example changes the name of ring-t2 to ring-ny.
ons15194(rconf)# ring ring-t2 rename ring-ny
Ring ring-t2 renamed to ring-ny.
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. (rconf configuration) Displays information about the current draft configuration, including the defined rings and their respective nodes. (rconf configuration) Configures a new ring.
Command
Description
To remove an existing directory in a Class C Flash memory file system, use the rmdir EXEC command.
rmdir file-system
Syntax Description
file-system Keyword of the directory or file system.
The file system must be one of the keywords as shown in Table 5-23.
| Keyword | Description |
|---|---|
disk0: | Remove directory from disk0: file system. This is the disk in the first PCMCIA card slot. |
disk1: | Remove directory from disk1: file system. This is the disk in the second PCMCIA card slot. |
flash: | Remove directory from flash: file system. |
Command Modes
Privileged EXEC
Usage Guidelines
You are prompted for the name of the directory to delete.
Related Commands
(privileged EXEC) Displays a list of files on a file system. (privileged EXEC) Creates a directory in a Class C Flash file system.
Command
Description
To send messages to one or all Telnet sessions, use the send privileged EXEC command.
send {session-number | *} message
Syntax Description
session-number Session number of the telnet session to which the message will be sent. * Sends the message to all Telnet sessions. message Message to be sent enclosed in quotes.
Command Modes
Privileged EXEC
Usage Guidelines
This command is a subset of the send command that first appeared in Cisco IOS Release 11.2.
The message text must be enclosed in quotes.
Examples
The following example sends a message to the first Telnet session on the ONS 15194:
ons15194# send 0 "The system will be shut down in 10 minutes for repairs"
The following message is then sent to the first Telnet session:
**** Incoming Message ****
The system will be shut down in 10 minutes for repairs
**************************
To initially configure the network parameters and the privileged EXEC secret and initial configuration, use the setup privileged EXEC command.
setupSyntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
When you enter this command, a setup wizard guides you through the initial setup of the ONS 15194. Information you will need to enter includes the host name of the ONS 15194, the IP address of the ONS 15194, the desired privileged EXEC secret, and a decision on whether to perform an autoconnect or use the existing configuration file. You may abort the setup wizard at any time by pressing Ctrl-C. When the wizard has received all required information, the configuration is displayed for your confirmation.
Examples
Sample output from the setup command follows:
ons15194# setup
--- System Configuration Dialog ---
Refer to the 'ONS 15194 documentation' Guide for additional help.
Use ctrl-c to abort configuration dialog at any prompt.
Default settings are in square brackets '[]'.
Would you like to enter the initial configuration dialog?[yes]:yes
Configuring global parameters:
Enter host name [ons15194]:ons15194
The enable secret is a one-way cryptographic secret.
Enter enable secret:xxxxx
Configuring interface Ethernet0:
Is this interface in use? [yes]:yes
IP address for this interface [10.52.19.22]:10.52.19.22
Number of bits in subnet field [6]:6
6 subnet bits; mask is 255.255.255.0
Start SRP/POS nodes discovery procedure[yes]:yes
Configuration contains SRP rings definition, and may be discarded.
Continue? y
Sniff configuration:
Sniffer Interface Sniffed node Interface
-------------------- ---------- -------------------- ----------
No sniffer nodes.
POS connections:
Node IP Address Interfaces Type Other
-------------------- --------------- -------------- ---- -------------------
No POS connections.
Ring configuration (nodes in order of outer ring):
No AB rings defined.
No Inner rings defined.
No Outer rings defined.
Free SRP/Fiber nodes:
No Free AB nodes.
No Free Inner nodes.
No Free Outer nodes.
No Free Fiber nodes.
Node GSR_Left is connected only to interface L1/1.
Node GSR_Back_Right is connected only to interface L1/2.
Node GSR_Back_Left is connected only to interface L2/1.
Node GSR_Right is connected only to interface L2/2.
Node GSR_Left was not detected, discarding.
Node GSR_Back_Right was not detected, discarding.
Node GSR_Back_Left was not detected, discarding.
Node GSR_Right was not detected, discarding.
Apply configuration? Y
Building configuration...
[OK]
Press RETURN to get started!
To display information about ONS 15194 chassis population and operation, use the show 15194 EXEC command.
show 15194 [chassis-info | fans]
Syntax Description
chassis-info Displays information about the chassis. fans Displays the status of the fans.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194. The output from this command with no parameters displays a schematic of the ONS 15194 with the status of each interface in each line card. The descriptions of the fields in the show 15194 command when the chassis-info and fans keywords are used are given in Table 5-24.
Examples
Sample output from the show 15194 chassis-info command follows:
ons15194# show 15194 chassis-info
Backplane info:
Description: ONS15190 series chassis
Catalog number: ONS15190
Serial number: 1377-032
Board version: B1
The following is sample output from the show 5194 fans command:
ons15194# show 15194 fans
Fans status:
Fan 1 [Fantray 1]: Operational
Fan 2 [Fantray 1]: Operational
Fan 3 [Fantray 1]: Operational
Fan 4 [Fantray 1]: Operational
Fan 5 [Fantray 1]: Operational
Fan 6 [Fantray 1]: Operational
The following is sample output from the show 15194 command with no parameters.
ons15194> show 15194
+----+----+----+----+----+----+----+----+----+----+----+----+----+----+----+
|CTRL|LINE|LINE|LINE|LINE| SW | SW | SW | SW | SW |LINE|LINE|LINE|LINE|CTRL|
| 1 | 1 | 2 | 3 | 4 | 1 | 2 | 3 | 4 | 5 | 5 | 6 | 7 | 8 | 2 |
+----+----+----+----+----+----+----+----+----+----+----+----+----+----+----+
|OPER|OPER|OPER|OPER|OPER|OPER|OPER|OPER|OPER|OPER|OPER|OPER|OPER|OPER|OPER|
|MIPS|OC48|OC48|OC48|OC48| | | | | |OC48|OC48|OC48|OC48|MIPS|
|----|----|----|----|----|----|----|----|----|----|----|----|----|----|----|
|ACT |L1/1|L2/1|L3/1|L4/1| | | | | |L5/1|L6/1|L7/1|L8/1| |
| |OPER|OPER|OPER|OPER| | | | | |OPER|OPER|OPER|OPER| |
|THIS|LINK|LINK|LINK|LINK| | | | | |LINK| |LINK|LINK| |
|CTRL|UNEQ|UNEQ|UNEQ|UNEQ| | | | | |UNEQ|UNEQ| | | |
| | | | | | | | | | | | | | | |
| |L1/2|L2/2|L3/2|L4/2| | | | | |L5/2|L6/2|L7/2|L8/2| |
| |OPER|OPER|OPER|OPER| | | | | |OPER|OPER|OPER|OPER| |
| |LINK|LINK|LINK|LINK| | | | | |LINK| | | | |
| |UNEQ|UNEQ|UNEQ|UNEQ| | | | | |UNEQ|UNEQ|UNEQ|UNEQ| |
| | | | | | | | | | | | | | | |
| |L1/3|L2/3|L3/3|L4/3| | | | | |L5/3|L6/3|L7/3|L8/3| |
| |OPER|OPER|OPER|OPER| | | | | |OPER|OPER|OPER|OPER| |
| |LINK|LINK|LINK|LINK| | | | | | |LINK|LINK|LINK| |
| |UNEQ|UNEQ|UNEQ|UNEQ| | | | | |UNEQ| | | | |
| | | | | | | | | | | | | | | |
| |L1/4|L2/4|L3/4|L4/4| | | | | |L5/4|L6/4|L7/4|L8/4| |
| |OPER|OPER|OPER|OPER| | | | | |OPER|OPER|OPER|OPER| |
| |LINK|LINK|LINK|LINK| | | | | | | | | | |
| |UNEQ|UNEQ|UNEQ|UNEQ| | | | | |UNEQ|UNEQ|UNEQ|UNEQ| |
| | | | | | | | | | | | | | | |
| |L1/5|L2/5|L3/5|L4/5| | | | | |L5/5|L6/5|L7/5|L8/5| |
| |OPER|OPER|OPER|OPER| | | | | |OPER|OPER|OPER|OPER| |
| |LINK|LINK|LINK|LINK| | | | | |LINK| | | | |
| |UNEQ|UNEQ|UNEQ|UNEQ| | | | | | |UNEQ|UNEQ|UNEQ| |
| | | | | | | | | | | | | | | |
| |L1/6|L2/6|L3/6|L4/6| | | | | |L5/6|L6/6|L7/6|L8/6| |
| |OPER|OPER|OPER|OPER| | | | | |OPER|OPER|OPER|OPER| |
| |LINK|LINK|LINK|LINK| | | | | | | | |LINK| |
| |UNEQ|UNEQ|UNEQ|UNEQ| | | | | |UNEQ|UNEQ|UNEQ| | |
| | | | | | | | | | | | | | | |
| |L1/7|L2/7|L3/7|L4/7| | | | | |L5/7|L6/7|L7/7|L8/7| |
| |OPER|OPER|OPER|OPER| | | | | |OPER|OPER|OPER|OPER| |
| |LINK|LINK|LINK|LINK| | | | | | |LINK| | | |
| |UNEQ|UNEQ|UNEQ|UNEQ| | | | | |UNEQ| |UNEQ|UNEQ| |
| | | | | | | | | | | | | | | |
| |L1/8|L2/8|L3/8|L4/8| | | | | |L5/8|L6/8|L7/8|L8/8| |
| |OPER|OPER|OPER|OPER| | | | | |OPER|OPER|OPER|OPER| |
| |LINK|LINK|LINK|LINK| | | | | |LINK| | |LINK| |
| |UNEQ|UNEQ|UNEQ|UNEQ| | | | | | |UNEQ|UNEQ| | |
| | | | | | | | | | | | | | | |
+----+----+----+----+----+----+----+----+----+----+----+----+----+----+----+
To display status information for the specified APS node, use the show aps node EXEC command.
show aps node [node-name]
Syntax Description
node-name Optional. Node identifier of the node about which to display the status information. If no node is specified, the status of all APS nodes is displayed.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
This command displays status information about APS nodes only. If other nodes are specified, an error message appears.
Related Commands
node create aps (rconf configuration) Defines a new APS node. (rconf configuration) Specifies switching control for APS nodes.
Command
Description
To display the entries in the ARP table, use the show arp EXEC command.
show arpSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command is the same as the show arp command that first appeared in Cisco IOS Release 10.0.
Examples
The following example shows the output from the show arp command.
ons15194> show arp
LINK LEVEL ARP TABLE
destination gateway flags Refcnt Use Interface
--------------------------------------------------------------------------
10.52.19.1 00:01:96:3a:97:1 405 1 0 ei0
--------------------------------------------------------------------------
Related Commands
(privileged EXEC) Deletes all dynamic entries from the ARP cache.
Command
Description
To display the status of the autotrack capability, use the show autotrack EXEC command.
show autotrackSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command displays whether the autotrack option is enabled or not.
Examples
Sample output from the show autotrack command follows:
ons15194> show autotrack
Autotracking is off.
Related Commands
(privileged EXEC) Enables or disables the autotracking capabilities of the ONS 15194.
Command
Description
To display the current settings of the MOTD banner, use the show banner motd EXEC command.
show banner motdSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194. Use this command to display the current contents of the MOTD banner and indicate whether the MOTD is enabled or not.
Related Commands
(global configuration) Copies the contents of a text file to be used as the login message. (global configuration) Enables the display of the MOTD.
Command
Description
To display the contents of the BOOT environment variable and the name of the configuration file pointed to by the CONFIG_FILE environment variable, use the show bootvar EXEC command.
show banner motdSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command is similar to the show bootvar command that first appeared in Cisco IOS Release 11.3.
Examples
Sample output from the show bootvar command follows:
ons15194# show bootvar
BOOT variable = flash:/ver1.0.23
CONFIG_FILE variable =
Related Commands
(EXEC) Displays the configuration of the ONS 15194 hardware.
Command
Description
To display the calendar hardware setting, use the show calendar EXEC command:
show calendarSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command is the same as the show calendar command that first appeared in Cisco IOS Release 10.0.
The calendar is the same as the ONS 15194 clock.
Examples
In the following example, the date is shown to be Wednesday, November 28, 2001.
ons15194> show calendar
Controller Uptime: 6d, 3:02:06.336
Controller Active time: 6d, 3:00:42.003
System time: WED NOV 28 14:40:31 2001
Related Commands
(privileged EXEC) Sets the ONS 15194 calendar. (privileged EXEC) Sets the ONS 15194 clock.
Command
Description
To display the SONET indications, use the show controllers EXEC command.
show controllers [{pos | srp} interface]
Syntax Description
pos Optional. Displays the packet over SONET (POS) framer state for a particular interface. srp Optional. Displays the SRP controller information for a particular interface. interface Specifies the interface for which to display the SONET indications.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194. Use the command show controllers with no keywords to display the SONET indications for all interfaces.
Examples
The following example displays the SONET indications for all interfaces
ons15194> show controllers
Rx SONET/SDH Indications :
- SECTION - ------ LINE ------ -------- PATH ---------
I/F LOS LOF OOF AIS RDI REI SF SD AIS LOP RDI REI UNE PLM
---- --- --- --- --- --- --- --- --- --- --- --- --- --- ---
L1/1 ON______________________________________________________
L1/2 ON______________________________________________________
L1/3 ________________________________________________________
L1/4 ________________________________________________________
L1/5 ________________________________________________________
L1/6 ________________________________________________________
L1/7 ________________________________________________________
L1/8 ________________________________________________________
L2/1 ________________________________________________________
L2/2 ________________________________________________________
L2/3 ________________________________________________________
L2/4 ________________________________________________________
L2/5 ON______________________________________________________
L2/6 ON______________________________________________________
L2/7 ON______________________________________________________
L2/8 ON______________________________________________________
The following example displays the SRP controller information for interface L1/2:
ons15194>show controllers srp l1/2
show controllers srp l1/2
Rx SONET/SDH Indications:
Section LOS - ON.
Section LOF - OFF.
Section OOF - OFF.
Line AIS - OFF.
Line RDI - OFF.
Line REI - OFF.
Line SF - OFF.
Line SD - OFF.
Path AIS - OFF.
Path LOP - OFF.
Path RDI - OFF.
Path REI - OFF.
Path Unequipped - OFF.
Path Payload Label Mismatch - OFF.
C2 byte - n.a.
Framing - n.a.
S1 byte - n.a.
The show controllers fields are described in Table 5-25:
| Field | Description |
|---|---|
Interface | Interface in the ONS 15194. |
S-LOS | Section loss of signal. |
S-LOF | Section loss of framing. |
S-OOF | Section out of framing. |
L-AIS | Line alarm indication signal. |
L-RDI | Line remote defect indication. |
L-SF | Line signal failure. |
L-SD | Line signal degration. |
P-AIS | Path alarm indication signal. |
P-LOP | Path low order path. |
P-RDI | Path remote defect indication. |
P-UNE | Path unequipped. |
P-PLM | Path label mismatch. |
Related Commands
(privileged EXEC) Clears the SONET and POS counters.
Command
Description
To show whether the enhanced intelligent protection switching (E-IPS) option is enabled or not and to display the specified wait-to-restore time, use the show eips EXEC command.
show eipsSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
Examples
The following example indicates that the E-IPS option is enabled and that the wait-to-restore time is 10 seconds:
ons15194# show eips
EIPS state = enabled
wtr = 10 seconds
Related Commands
(global configuration) Enables the E-IPS option for the ONS 15194. (global configuration) Specifies the amount of time to wait before returning a bypassed node to the ring.
Command
Description
To display the status and temperature of all cards in the ONS 15194, use the show environment EXEC command.
show environmentSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
Examples
Sample output from the show environment command follows:
ons15194# show environment
Sample Point Status Temperature Sensor1 Temperature Sensor2
--------------------------------------------------------------------------------
Controller Card 1 Normal 36.0 degC (96.8 degF) 36.5 degC (97.7 degF)
Line Card 1 Normal 44.5 degC (112.1 degF) 43.5 degC (110.3 degF)
Line Card 2 Normal 46.0 degC (114.8 degF) 56.0 degC (132.8 degF)
Line Card 3 Normal 35.5 degC (95.9 degF) 42.0 degC (107.6 degF)
Line Card 4 Normal 35.0 degC (95.0 degF) 35.5 degC (95.9 degF)
Switch Card 1 Normal 27.5 degC (81.5 degF) 25.0 degC (77.0 degF)
Switch Card 2 Normal 27.5 degC (81.5 degF) 25.0 degC (77.0 degF)
Switch Card 3 Normal 26.5 degC (79.7 degF) 25.5 degC (77.9 degF)
Switch Card 4 Normal 27.0 degC (80.6 degF) 27.5 degC (81.5 degF)
Switch Card 5 Normal 31.0 degC (87.8 degF) 26.0 degC (78.8 degF)
Line Card 5 Normal 34.5 degC (94.1 degF) 37.5 degC (99.5 degF)
Line Card 6 Normal 36.0 degC (96.8 degF) 37.5 degC (99.5 degF)
Line Card 7 Normal 41.5 degC (106.7 degF) 48.5 degC (119.3 degF)
Line Card 8 Normal 41.0 degC (105.8 degF) 49.0 degC (120.2 degF)
Controller Card 2 Normal N/A N/A
Fantray Card 1 Normal 27.5 degC (81.5 degF) N/A
Related Commands
(EXEC) Displays status information about specific cards.
Command
Description
To display information about the ONS 15194 file systems, use the show file systems EXEC command.
show file systemsSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command is similar to the show file systems command that first appeared in Cisco IOS Release 11.3.
Examples
The following is sample output from the show file systems command:
ons15194# show file systems
Size(b) Free(b) Type Flags Prefixes
15982592 15974400 disk1 rw disk1:
* 98398208 83976192 flash rw flash:
6266880 6256640 system rw system:
- - network rw tftp:
- - network rw ftp:
Related Commands
(privileged EXEC) Displays the contents of a file system.
Command
Description
To list the commands you entered in the current EXEC session, use the show history EXEC command.
show history [number]
Syntax Description
number Optional. Decimal number of commands to display.
Defaults
20 commands are displayed
Command Modes
EXEC
Usage Guidelines
This command is similar to the show history command that first appeared in Cisco IOS Release 10.0.
If no number is specified, the command displays the last 40 commands (0 to 39), where 39 is the last command used. A previously used command can be displayed by typing * followed by the history number.
Examples
The following example displays use of the history command:
ons15194# show history
0 en
1 show controllers srp l1/2
2 show controllers
3 show history
ons15194# *1
show controllers srp l1/2
Rx SONET/SDH Indications:
Section LOS - ON.
Section LOF - OFF.
Section OOF - OFF.
Line AIS - OFF.
Line RDI - OFF.
Line REI - OFF.
Line SF - OFF.
Line SD - OFF.
Path AIS - OFF.
Path LOP - OFF.
Path RDI - OFF.
Path REI - OFF.
Path Unequipped - OFF.
Path Payload Label Mismatch - OFF.
C2 byte - n.a.
Framing - n.a.
S1 byte - n.a.
To display status information about a specific card or all cards in the ONS 15194, use the show hw-module EXEC command.
show hw-module [status] [slot slot-id] [details]
Syntax Description
status Optional. Displays status of specified card. If status is not specified, a wide variety of information is displayed about the card. slot Optional. Displays information about a card in a specific slot in the ONS 15194. slot-id Specifies the slot identifier of the slot about which to display the information details Optional. Displays additional hardware related information about the cards.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
If you use the status keyword, only the status of the slot is displayed. Otherwise, identifying information and the temperature status is displayed. If you use the details keyword, additional hardware information is displayed.
Examples
The following example displays all information concerning the controller card in slot C1:
ons15194# show hw-module slot c1
Controller Card 1 (This controller):
Subtype: Controller (CPU) card
State: Operational
Active state: Active
Catalog number: RS-CTL
Serial number: 000104
Board version: B1-B0
CPU type: i960jx
RAM size (MB): 16
Flash size (MB): 20
Temperature Status: Normal
Temperature 1: 36.0 degC (96.8 degF)
Temperature 2: 33.5 degC (92.3 degF)
The following example displays all information concerning line card L1:
ons15194# show hw-module slot L1
Line Card 1:
Subtype: 8xOC48/8xSTM16, 8 SR, SM PORTS
# of interfaces: 8
State: Operational
Catalog number: OC48/STM16-8SR
Serial number: SAK0519001H
Board version: 02
Temperature Status: Normal
Temperature 1: 46.0 degC (114.8 degF)
Temperature 2: 42.0 degC (107.6 degF)
The following example displays all information concerning the switch card S1:
ons15194# show hw-module slot s1
Switch Card 1:
Subtype: Switch card
State: Operational
Catalog number: RS-SWT
Serial number: 1029-011
Board version: B1
Temperature Status: Normal
Temperature 1: 30.0 degC (86.0 degF)
Temperature 2: 29.5 degC (85.1 degF)
The following example indicates that the controller card located in slot C1 is enabled:
ons15194# show hw-module status slot c1
Controller Card 1 slot:
Status: Enabled
The show hw fields are described in Table 5-26:
| Field | Description |
|---|---|
Subtype | Type of card contained in the slot. |
State | Operational status of the card. |
Catalog number | Catalog number of the card. |
Serial number | Serial number of the card. |
Board version | Hardware version of the card. |
CPU type | Type of CPU.1 |
RAM size | Size of RAM.1 |
Flash size | Size of Flash memory.1 |
Temperature status | Indicates whether the temperature of the card is within normal range. |
Temperature 1 and 2 | Temperature readings of the card. |
| 1For controller cards only |
Related Commands
(global configuration) Disables the specified slot in the ONS 15194. (privileged EXEC) Resets the card within the specified slot.
Command
Description
To display the current status for all interfaces or for a specific interface, use the show interfaces EXEC command:
show interfaces [interface-id]
Syntax Description
interface-id Optional. Interface identifier of the format Lcard/interface where card is the card number (1 to 8) and interface is the interface number (1 to 8). If no interface-id is specified, the status of all interfaces is displayed.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
Examples
The following example displays status information for interface L1/1:
ons15194# show interfaces l1/1
Interface L1/1:
General:
Type: OC48
State: Operational
Configuration:
Enabled: Yes
Internal data source: -
Side: None
Framing: SONET
Protocol: SRP
Coding: NRZ
SES Threshold: Bellcore 1991
Clock Source: Internal
SF Threshold: 1e-5
SD Threshold: 1e-6
AIS Setting: Auto
Status:
Link: Down
Current TX status: UNEQ Generated
Loopback: None
Clock source - HW: Internal
Tx Laser: on
To display the traffic counters for a specific interface or all interfaces, use the show interfaces data EXEC command.
show interfaces data current {all | bytes | errors | frames | rate} [interface-id]
Syntax Description
current Displays the counters for the current 15-minute interval. history Displays the counters for prior time intervals. total Displays the accumulated information to date, since the last reset or use of the clear counters command. all Displays the accumulated bytes, errors, frames, and rate data that were received or transmitted. bytes Displays the accumulated statistics data in bytes. errors Displays the accumulated errored frames. frames Displays the accumulated statistics data in frames. rate Displays the averate data rate over a 15-minute interval in Mbps. interface-id Interface of the format Lcard/interface where card is the card number (1 to 8) and interface is the interface number (1 to 8). If no interface-id is specified, the counters for all interfaces are displayed. interval Time intervals for which to display the counters. Up to 96 time intervals can be displayed, where 1 is the 15-minute interval before the current interval, and 96 is 24 hours ago. Statistics are displayed for all time intervals from 1 up to and including the specified interval.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
Examples
The following example displays the current statistics in bytes for inteface L5/2:
ONS15194# show interfaces data current bytes L5/2
5 min 13 seconds since interval start time: TUE SEP 11 09:10:14 2001
I/F RX Bytes ~Mbps TX Bytes ~Mbps
---- ----------------- ------- ----------------- -------
L5/2 135,377,986,959 234.23 18,446,032,682 1,234.4
The following example displays the current statistics in frames for inteface L1/1. Av.len represents the average length of the frames in bytes and Av.fps represents the average rate of frames in frames per second.
ONS15194# show interfaces data current frames L1/1
10 min 39 second since interval start time
I/F RX frames Av.len ~Av.fps TX frames Av.len ~Av.fps
---- ----------------- ------ ---------- ---------------- ------ ----------
L1/1 6,133,244 16 9,598 6,133,151 16 9,598
The following example displays the counters for the last 2 intervals for interface L1/1:
ONS15194> show interfaces data history all 2 L1/1
Interface L1/1 data history all:
-------------------------------
Interval #1 Start Time: TUE SEP 11 09:10:14 2001
RX Statistics:
Bytes = 135,377,986,959
Frames = 190,045,798
Av. rate (Mbps) = 1,203.35
RX Errors:
FCS-Error Frames = 0
Dropped = 0
Too Short = 0
Too Long = 0
Aborted = 0
TX Statistics:
Bytes = 18,446,032,682
Frames = 200,496,949
Av. rate (Mbps) = 163.96
TX Errors:
User-Aborted = 0
Underruns = 0
Interval #2 Start Time: TUE SEP 11 08:55:14 2001
RX Statistics:
Bytes = 135,377,986,959
Frames = 190,045,798
Av. rate (Mbs) = 1203.35
RX Errors:
FCS-Error Frames = 0
Dropped = 0
Too Short = 0
Too Long = 0
Aborted = 0
TX Statistics:
Bytes = 18,446,032,682
Frames = 200,496,949
Av. rate (Mbs) = 163.96
TX Errors:
User-Aborted = 0
Underruns = 0
The following example displays a subset of the output of the counters for the last three intervals in bytes:
ons15194# show interfaces data history bytes 3
I/F # Interval Start Time RX Bytes ~Mbps TX Bytes ~Mbps
---- -- ------------------- -------------- --------- --------------- ---------
L1/1 1 MON NOV 05 18:50:12 138,314,973 1.22 138,321,197 1.22
2 MON NOV 05 18:35:12 138,314,975 1.22 138,321,115 1.22
3 MON NOV 05 18:20:12 137,884,111 1.22 120,318,171 1.06
L1/2 1 MON NOV 05 18:50:12 138,320,047 1.22 138,316,109 1.22
2 MON NOV 05 18:35:12 138,319,981 1.22 138,316,109 1.22
3 MON NOV 05 18:20:12 137,893,527 1.22 137,890,115 1.22
L1/3 1 MON NOV 05 18:50:12 138,299,855 1.22 138,336,235 1.22
2 MON NOV 05 18:35:12 138,299,855 1.22 138,336,253 1.22
3 MON NOV 05 18:20:12 137,870,562 1.22 137,900,642 1.22
L1/4 1 MON NOV 05 18:50:12 50,934,813,517 452.75 115,741,604,768 1,028.81
2 MON NOV 05 18:35:12 50,936,369,583 452.76 115,744,113,270 1,028.83
3 MON NOV 05 18:20:12 44,147,241,237 392.41 100,549,896,635 893.77
.
.
.
The following example displays a portion of the output of the total accumulated bytes for all interfaces. The Duration is the amount of time since the clear counters command was used. In other words, this indicates the amount of time upon which the total statistics computation is based.
ons15194> show interfaces data total bytes
Accumulated bytes statistics:
I/F Duration RX Bytes TX Bytes
---- -------------- --------------------------- ---------------------------
L1/1 6d, 03:29:41 118,788,815,579 121,009,192,704
L1/2 6d, 03:29:41 119,152,895,909 121,370,596,964
L1/3 6d, 03:29:41 118,755,086,560 123,227,627,879
L1/4 6d, 03:29:41 156,886,902,723,362 156,887,212,508,886
L1/5 6d, 03:29:41 118,921,222,043 120,411,209,532
L1/6 6d, 03:29:41 0 0
L1/7 6d, 03:29:41 0 0
L1/8 6d, 03:29:41 0 0
L2/1 6d, 03:29:41 121,390,814,065 119,139,346,223
L2/2 6d, 03:29:41 120,437,650,123 118,211,719,256
L2/3 6d, 03:29:41 123,207,425,874 118,768,647,663
L2/4 6d, 03:29:41 156,887,198,842,934 156,887,625,000,755
L2/5 6d, 03:29:41 121,009,204,560 118,788,827,419
.
.
.
To display information about the Ethernet interface, use the show interfaces ethernet EXEC command.
show interfaces ethernet 0
Syntax Description
0 The interface identifier for the Ethernet interface.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
Examples
The following example shows the output from the show interfaces ethernet command:
ons15194# show interfaces ethernet 0
Hardware is Ethernet ei (unit number 0):
Flags: (0x8063) UP BROADCAST MULTICAST ARP RUNNING
Type: ETHERNET_CSMACD
Internet address: 10.52.19.21
Broadcast address: 10.52.19.63
Netmask 0xff000000 Subnetmask 0xffffffc0
Ethernet address is 00:d0:04:00:01:04
Metric is 0
Maximum Transfer Unit size is 1500
13002 packets received; 6297 packets sent
6896 multicast packets received
105 multicast packets sent
0 input errors; 0 output errors
0 collisions; 0 dropped
Related Commands
interface ethernet (global configuration) Configures the Ethernet interface.
Command
Description
To display the laser monitor status of the various interfaces, use the show interfaces laser EXEC command.
show interfaces laserSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
Examples
The following example shows the output from the show interfaces laser command for interface L5/1:
ons15194# show interfaces laser l5/1
Optical Power Monitor (values in dBm):
Interface Type Output Power Input Power
---------- ----- ------------ -----------------
L5/1 OC48 -11.1 No Rx signal (Link Down)
To display the packet monitoring counters for a specific interface or all interfaces, use the show interfaces performance-monitor EXEC command.
show interfaces performance-monitor current [interface-id]
Syntax Description
current Displays the packet monitor counters for the current 15-minute interval. interface-id Interface identifier of the format Lcard/interface where card is the card number (1 to 8), and interface is the interface number (1 to 8). If no interface-id is specified, the packet monitor counters for all interfaces are displayed. history Displays the packet monitor counters for prior time intervals. time-interval Time interval for which to display the packet monitor counters. Up to 96 time intervals may be displayed, where 1 is the 15 minute interval before the current interval, and 96 is 24 hours ago.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
Examples
The following example displays the current packet monitor counters for interface L3/2:
ons15194> show interfaces performance-monitor current L3/2
Sonet current statistics
Elapsed time = 195, Valid intervals 96
Interval Start Time: MON FEB 12 12:49:16 2001
Section Statistics :
Errored Seconds = 0 Severely Errored Seconds = 0
Coding violations (B1) = 0 Severely Err. Framing Sec. = 0
Line Statistics :
Errored Seconds = 0 Severely Errored Seconds = 0
Coding violations (B2) = 0 Unavailable Seconds = 0
Far-End Line Statistics :
Errored Seconds = 0 Severely Errored Seconds = 0
Coding violations (M0) = 0 Unavailable Seconds = 195
Path Statistics :
Errored Seconds = 0 Severely Errored Seconds = 0
Coding violations (B3) = 0 Unavailable Seconds = 0
Far-End Path Statistics :
Errored Seconds = 0 Severely Errored Seconds = 0
Coding violations (G1) = 0 Unavailable Seconds = 195
To display received pathtrace messages, use the show interfaces rx-pathtrace EXEC command.
show interfaces rx-pathtrace [interface-id]
Syntax Description
interface-id Specifies the optional interface of the format Lcard/interface where card is the card number (1 to 8), and interface is the interface number (1 to 8). If no interface-id is specified, the received pathtrace messages for all interfaces are displayed.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
Related Commands
(global configuration) Specifies that the pathtrace reflect that of the connected device and not the ONS 15194. (EXEC) Displays the transmitted pathtrace message.
Command
Description
To display the time since the last SRR message was received on an interface, use the show interfaces srr EXEC command.
show interfaces srr [interface-id]
Syntax Description
interface-id Specifies the optional interface of the format Lcard/interface where card is the card number (1 to 8) and interface is the interface number (1 to 8). If no interface-id is specified, the received pathtrace messages for all interfaces are displayed.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194. This command displays the amount of time that elapsed since the last SRR message was received on an interface.If no SRR messages are received for 10 minutes or more, the message Signal fail is displayed for the interface. To display SRR information for all nodes on the ONS 15194, use the show srr command.
Related Commands
(EXEC) Displays SRR information for all nodes on the ONS 15194.
Command
Description
To display transmitted pathtrace messages, use the show interfaces tx-pathtrace EXEC command.
show interfaces tx-pathtrace [interface-id]
Syntax Description
interface-id Specifies the optional interface of the format Lcard/interface where card is the card number (1 to 8), and interface is the interface number (1 to 8). If no interface-id is specified, the received pathtrace messages for all interfaces are displayed.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
Examples
Following is sample output of the show interfaces tx-pathtrace command:
ons15194# show interfaces tx-pathtrace L1/1
Transmitted Path Trace Message:
Hostname: ons15194
IP: 10.51.113.162
Protocol: SRP
Interface: L1/1
Side: A
Related Commands
(global configuration) Specifies that the pathtrace reflect that of the connected device and not the ONS 15194. (privileged EXEC) Temporarily changes the transmited pathtrace message. (EXEC) Displays the received pathtrace message.
Command
Description
To display the current state of the routing table, use the show ip route EXEC command.
show ip routeSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command is similar to the show ip route command that first appeared in Cisco IOS Release 10.0.
Examples
The following example shows the output from the show ip route command.
ons15194> show ip route
ROUTE NET TABLE
destination gateway flags Refcnt Use Interface
----------------------------------------------------------------------------
0.0.0.0 192.168.1.4 3 4 19694 ei0
192.168.1.0 192.168.1.1 101 0 0 ei0
----------------------------------------------------------------------------
ROUTE HOST TABLE
destination gateway flags Refcnt Use Interface
----------------------------------------------------------------------------
192.168.1.0 192.168.1.1 5 1 70626 sl0
192.168.1.1 192.168.1.1 5 0 0 lo0
172.16.1.0 172.16.1.1 5 0 0 lo0
----------------------------------------------------------------------------
Related Commands
(interface configuration) Specifies the IP address for an interface. (global configuration) Specifies the default-gateway for the ONS 15194. (global configuration) Specifies the domain name that the ONS 15194 uses to complete unqualified host names.
Command
Description
To display the log of the copy command when the destination is the running configuration, use the show log-of-copy-to-running EXEC command.
show log-of-copy-to-runningSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command displays the log of the copy command when a copy is made to the running configuration. In this way, you can determine if there are errors or inconsistencies in the running configuration file that will not otherwise be displayed to the screen.
Related Commands
(privileged EXEC) Copies a source file to a destination file.
Command
Description
To display the contents of the logging buffer, use the show logging EXEC command.
show logging [remote] [amount]
Syntax Description
remote Optional. Specifies to display the contents of the logging buffer of the standby controller. If this keyword is not specified, the contents of the logging buffer of the active controller are displayed. amount Optional. Number of messages to display.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194. When the amount value is specified, it designates the number of the most recent messages to display. The last message displayed is the most recent.
Examples
The following example displays the last three messages:
ons15194> show logging 3
MON MAR 19 13:16:15 2001 Interface L5/3 - Operational.
MON MAR 19 13:16:15 2001 Interface L5/4 - Operational.
MON MAR 19 13:16:15 2001 Line Card 5 - Operational.
Related Commands
(global configuration) Specify to log messages to Flash memory.
Command
Description
To display statistics about memory, including memory-free pool statistics, use the show memory EXEC command.
show memorySyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
The show memory command displays information about memory available after the ONS 15194 image decompresses and loads.
To display basic information about the configuration of the node, use the show nodes EXEC command.
show nodes [node-id]
Syntax Description
node-id Optional. String that represents the name of the node.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194. If no node-id is specified, the information for all nodes is displayed.
Examples
The following is sample output from the show nodes command for the node named gsr_right48:
ons15194> show nodes gsr_right48
Node GSR_Right48:
Type: SRP Inner
Int: L6.1
Port Type: OC48
Mode: SONET
Clock Source: Internal
SD Threshold: 1e-6
SF Threshold: 1e-3
AIS Setting: Auto
Related Commands
node The various node commands are used to create and configure nodes within the ONS 15194.
Command
Description
To display the average net data rate per node and ring, use the show nodes data EXEC command.
show nodes data current rate [node-id]
Syntax Description
current Displays the counters for the current 15-minute interval. history Displays the counters for prior time intervals. rate Displays the averate data rate over a 15-minute interval in Mbps. interval Time intervals for which to display the counters. Up to 96 time intervals can be displayed, where 1 is the 15-minute interval before the current interval, and 96 is 24 hours ago. Statistics are displayed for all time intervals from 1 up to and including the specified interval. node-id Optional. String that represents the name of the node. If a node identifier is not specified, statstics for all nodes are displayed.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194. If no node-id is specified, the information for all nodes is displayed. Information displayed includes the date and time that the interval begins, the data rate for the inner ring, and the data rate for the outer ring. The rate is the net rate for the node, meaning that if more data is transmitted than recieved on the node, the rate will be a positive value. On the other hand, if less data is transmitted than received on the node for a certain ring, the rate will be a negative value. Use the rate value to determine if data is being passed through the node, data is originating in the node, or data is exiting via the node. If the same amount of data is transmitted and received, the rate value should be equal to zero.
Examples
The following example displays the rate for the last three intervals for all nodes:
ONS15194> show nodes data current rate
Positive (negative) rate indicates that node is net source (sink)
8 min 57 second since interval start time.
Node Inner(Mbps) Outer(Mbps)
------------------------ ------------ ------------
GSR-5 27.00 623.00
GSR-2 -456.00 .00
Guliver 456.00 .00
ROUTER3 -1,027.61 451.46
Gandi 1,000.61 -1074.46
Related Commands
(rconf) Creates nodes within the ONS 15194.
Command
Description
To display your current level of privilege, use the show privilege EXEC command.
show privilegeSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
Use this command to display your current level of privilege.
Examples
The following is sample output from the show privilege command:
ons15194# show privilege
Current privilege level is 15
To display information about the active processes, use the show processes EXEC command.
show processesSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Examples
The following is sample output from the show processes command:
ons15194# show processes
show processes
NAME ENTRY TID PRI STATUS PC SP ERRNO DELAY
---------- ------------ -------- --- ---------- -------- -------- ------- -----
tExcTask 802467d8 83f78fe0 0 PEND 802c8794 83f78ef0 3d0001 0
tLogTask 8024acc0 83f76430 0 PEND 802c8794 83f76348 0 0
tWatchDog 801a2790 83359600 1 PEND 80212140 833595a0 0 0
tRingTran 80151f80 833744e0 10 PEND 802c8794 83374350 0 0
tEIPS 801030e0 8335f570 13 PEND 802c8794 8335f3d0 0 0
tCIGMain 801ae3a0 8336efd0 15 PEND 80212140 8336ef68 0 0
tLogger 801319f8 833e4390 20 PEND 802c8794 833e3f68 0 0
tPcmciad 8001a888 83f74bb0 22 PEND 802c8794 83f74ac0 d0003 0
tSlAnCtrl0 801557f4 83318190 22 DELAY 80265b3c 83318110 0 22
tSlAnSwch0 801557f4 83313250 22 DELAY 80265b3c 833131d0 0 22
tSlAnSwch1 801557f4 83310fb0 22 DELAY 80265b3c 83310f30 0 21
tSlAnSwch2 801557f4 8330ed10 22 DELAY 80265b3c 8330ec90 0 19
tSlAnSwch3 801557f4 8330ca70 22 DELAY 80265b3c 8330c9f0 0 19
tSlAnSwch4 801557f4 8330a7d0 22 DELAY 80265b3c 8330a750 0 19
tSlAnLine0 801557f4 83308530 22 DELAY 80265b3c 833084b0 0 19
tSlAnLine1 801557f4 83306290 22 DELAY 80265b3c 83306210 0 18
tSlAnLine2 801557f4 83303ff0 22 DELAY 80265b3c 83303f70 0 17
To display information concerning the current configuration, that was last applied (using the apply command), use the show rconf running rconf configuration command.
show rconf running [raw]
Syntax Description
raw Optional. Displays physical low-level connections in terms of interfaces.
Command Modes
EXEC
Usage Guidelines
This command only applies to the ONS 15194. This command displays information about the currently running configuration only. Use the raw keyword to display the actual physical connections to the interfaces on the ONS 15194. This command displays the same output as the display running rconf configuration command.
Related Commands
(rconf) Copies the draft configuration to become the running configuration. (rconf) Displays information concerning the running configuration.
Command
Description
To display information concerning the redundancy status of the ONS 15194, use the show redundancy EXEC command.
show redundancySyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command is similar to the show redundancy command that first appeared in Cisco IOS Release 11.3.
Examples
The following is an sample output from the show redundancy command:
ons15194> show redundancy
Redundancy status:
Controller :fully redundant
switch (oc48) :fully redundant
switch (oc192) :not present
pem :fully redundant
Related Commands
(EXEC) Displays information about which cards are installed in the ONS 15194 chassis.
Command
Description
To display the running configuration, use the show running-config privileged EXEC command:
show running-configSyntax Description
This command has no arguments or keywords
Command Modes
Privileged EXEC
Usage Guidelines
This command displays the contents of the currently running configuration file.
Examples
The following is an sample output of the show running-config command.
ons15194# show running-config
Building configuration...
Current configuration:
!
hostname ons15194
!
enable secret 5 $1$QD3.$By.2Cs4oceLDADz560d.f.
!
!
eips enable
!
interface Ethernet 0
ip address 10.52.19.25 255.255.255.192
!
ip default-gateway 10.52.19.1
!
pathtrace-mode pos transparent
pathtrace-mode sniff transparent
no pathtrace-mode srp transparent
!
logging console warnings
logging maint warnings
logging buffered warnings
logging trap notifications
logging monitor errors
sntp server 10.52.19.33 time-zone +2:00:00
!
no snmp-server enable traps
!
snmp-server chassis-id "Description"
snmp-server location "Location"
!
!
line console 0
exec-timeout 0
speed 9600
line maint 0
exec-timeout 5
speed 9600
line vty 0 4
exec-timeout 0
!
end
Related Commands
(rconf) Displays draft configuration (which has not yet been applied). (rconf) Displays running configuration (within rconf mode).
Command
Description
To display a list of SNMP servers to which the ONS 15194 sends SNMP traps, use the show snmp EXEC command.
show snmpSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command is similar to the show snmp EXEC command that first appeared in Cisco IOS Release 10.0.
Related Commands
(global configuration) Adds the SNMP server to the list of servers to receive SNMP traps.
Command
Description
To display the current SNTP server address, time and time zone, use the show sntp EXEC command.
show sntpSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
Examples
The following is sample output from the show sntp command:
ons15194# show sntp
SNTP server IP address : 144.254.49.149
UTC time : MON FEB 12 13:10:01 2001
UTC Time Zone : +03:00:00
Related Commands
Configures the ONS 15194 to use SNTP.
Command
Description
To display the current SNTP server address, time and time zone, use the show sntp EXEC command.
show sntpSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
Examples
The following is sample output from the show sntp command:
ons15194# show sntp
SNTP server IP address : 144.254.49.149
UTC time : MON FEB 12 13:10:01 2001
UTC Time Zone : +03:00:00
Related Commands
Configures the ONS 15194 to use SNTP.
Command
Description
To display the amount of time that has elapsed since the last SRR message was received on a node, use the show srr EXEC command.
show srrSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
For each node, this command displays the amount of time elapsed since the last SRR message was received. If no SRR messages are received for 10 minutes or more, the message Signal fail is displayed for the interface. To display SRR information by interface, use the show interfaces srr command.
Related Commands
Displays SRR information for particular interfaces.
Command
Description
To display information about the active SSH sessions on the ONS 15194, use the show ssh user EXEC command.
show ssh [line-number]
Syntax Description
line-number (Optional) SSH connection number (0-4). If no line number is specified, SSH connections on all lines are displayed.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194. This command only displays the SSH connections to the ONS 15194. Use the show users EXEC command to display a list of all users. The output displays whether the SSH encryption method is 3DES or DES.
Examples
The following example displays sample output from the show ssh command:
ons15194# show ssh
Vty Ver Encr IP Address Port State Status
1 1.5 3DES 192.168.113.28 1869 Session started CONN_OK
2 1.5 3DES 192.168.113.29 1870 Session started CONN_OK
3 1.5 DES 192.168.113.30 1872 Session started CONN_OK
Related Commands
show users (EXEC) Displays all users connected to the ONS 15194.
Command
Description
To display the startup configuration currently saved to the Flash memory, use the show startup-config privileged EXEC command:
show startup-configSyntax Description
This command has no arguments or keywords
Command Modes
Privileged EXEC
Usage Guidelines
This command displays the contents of the startup configuration file currently saved to Flash. This is the configuration file that will be used to boot the ONS 15194 if the software is rebooted.
Examples
The following is an sample output of the show startup-config command.
ons15194# show running-config
Building configuration...
Current configuration:
!
hostname ons15194
!
enable secret 5 $1$QD3.$By.2Cs4oceLDADz560d.f.
!
!
eips enable
!
interface Ethernet 0
ip address 10.52.19.25 255.255.255.192
!
ip default-gateway 10.52.19.1
!
pathtrace-mode pos transparent
pathtrace-mode sniff transparent
no pathtrace-mode srp transparent
!
logging console warnings
logging maint warnings
logging buffered warnings
logging trap notifications
logging monitor errors
sntp server 10.52.19.33 time-zone +2:00:00
!
no snmp-server enable traps
!
snmp-server chassis-id "Description"
snmp-server location "Location"
!
line console 0
exec-timeout 0
speed 9600
line maint 0
exec-timeout 5
speed 9600
line vty 0 4
exec-timeout 0
!
end
Related Commands
(rconf configuration) Displays draft configuration (which has not yet been applied). (rconf configuration) Displays running configuration (within rconf mode).
Command
Description
To display general information about the ONS 15194 when reporting a problem, use the show tech-support EXEC command.
show tech-supportSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command is similar to the show tech-support command that first appeared in Cisco IOS Release 11.2.
This command displays a huge amount of information to the console. Log the results of this display to a text file and send it to a technical support engineer together with any requests for assistance.
To determine whether or not the temperature protection mechanism is enabled for the ONS 15194, use the show temperature-protect EXEC command.
show temperature-protectSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
Examples
The following example indicates that the temperature protection capability is enabled for the line and switch cards, but disabled for the fan tray:
ons15194# show temperature-protect
Automatic line and switch card temperature protection is enabled.
Automatic fantray temperature protection is disabled.
Related Commands
(global configuration) Enables or disables the temperature protection feature for the ONS 15194.
Command
Description
To obtain information about the terminal configuration parameter settings for the current terminal line, use the show terminal EXEC command.
show terminalSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command is similar to the show terminal command that first appeared in Cisco IOS Release 10.0.
Examples
The following is sample output from the show terminal command. There is one Telnet session.
ons15194> show terminal
Telnet CLI:
[0] 10.3.21.99
Session times out after 40 minutes.
Related Commands
(line configuration) Specifies the timeout for a Telnet session.
Command
Description
To display the status of the Telnet daemon, use the show tnetd user EXEC command.
show tnetdSyntax Description
This command has no arguments or keywords.
Command Modes
User EXEC
Usage Guidelines
This command displays whether the Telnet daemon is active or not.
Examples
The following is sample output from the show tnetd command:
ons15194> show tnetd
telnet daemon is: on
To display information about the active lines and line mirroring on the ONS 15194, use the show users user EXEC command.
show usersSyntax Description
This command has no arguments or keywords.
Command Modes
User EXEC
Usage Guidelines
This command is similar to the show users command that first appeared in a release prior to Cisco IOS Release 10.0.
This command displays the session number and the terminal location (IP address) for all users, including SSH and Telnet. To view only SSH sessions, use the show ssh EXEC command.
Examples
In the following example there are two users connected to the ONS 15194:
ons15194> show users
open vty sessions (max allowed: 5):
[ 0] 192.168.113.185
[ 1] 192.168.113.238
Related Commands
line vty Configures the Telnet lines. show ssh Displays active SSH sessions.
Command
Description
To display the configuration of the ONS 15194 hardware, the software version, the names and sources of configuration files, and the boot images, use the show version EXEC command.
show versionSyntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Usage Guidelines
This command is similar to the show version command that first appeared in Cisco IOS Release 10.0.
Examples
The following is sample output from the show version command:
ons15194# show version
Controller Uptime: 6d, 2:58:58.732
Controller Active time: 6d, 2:57:34.399
System time: WED NOV 28 14:37:24 2001
Name: ons15194
Description:
Location:
Contact:
Running image:
File path: flash:/ver1.1.3
Release: 1.1
Created on: Wed Nov 21 19:39:42 2001
Created by: Cisco Systems
Length: 1791082
Signature: 0x78DFF740
Software build: 1.1.3
Software created on: Nov 21 2001, 19:36:11
Bootstrap version: 1.2/20
The show version fields are described in Table 5-27:
| Field | Description |
|---|---|
Controller Uptime | Amount of time since the controller was reloaded (days, hours:minutes:seconds). |
Controller Active time | Amount of time that the controller is active (days, hours:minutes:seconds). |
System time | System clock or calendar. |
Name | Name of ONS 15194 specified by the hostname command. |
Description | Description of ONS 15194 specified by the snmp-server command. |
Location | Location of ONS 15194 specified by the snmp-server command. |
Contact | ONS 15194 contact specified by the snmp-server command. |
Running image | Summarizes information about the current running configuration. |
Release | Software release currently running on the ONS 15194. |
Created on | Date software release was compiled. |
Created by | Company who compiled the software release. |
Length | Size of software build in bytes. |
Signature | Signature of software build for verification of software ID. |
Software build | Software version currently running on the ONS 15194. |
Software created on | Date software version was compiled. |
Bootstrap version | Version of boot application |
Related Commands
(privileged EXEC) Resets the active controller.
Command
Description
To configure a node to be monitored by a sniff node, use the sniff connect rconf configuration command. To end the monitoring of a node, use the no form of this command.
sniff connect sniff-node node-id interface-side
Syntax Description
sniff-node Identifies node to be used to monitor another node connected to the ONS 15194. node-id Identifies node to be monitored. interface-side Indicates which data stream to monitor. Options follow: The rx/tx indications are from the point of view of the node. That is, for SRP nodes, if b-rx is indicated, the stream transmitted from the ONS 15194 to the B-side of the node will be duplicated.
Command Modes
rconf configuration
Usage Guidelines
This command is only applicable to the ONS 15194.
Examples
The following example connects the sniff node sniffer to monitor the POS node node-ny on the receive side:
ons15194(rconf)# node create sniff sniffer l1/1
OC48 Sniff node sniffer created.
ons15194(rconf)# sniff connect sniffer node-ny rx
Sniffer connected.
The following example ends monitoring by the sniff node sniffer:
ons15194(rconf)# no sniff connect sniffer
Sniffer disconnected.
Related Commands
(rconf configuration) Copies the draft configuration to become the running configuration. node create sniff (rconf configuration) Configures a new sniff node.
Command
Description
To set up the community access string to permit access to the simple network management protocol (SNMP), use the snmp-server community global configuration command.
snmp-server community string
Syntax Description
string Community string that acts like a password and permits access to the SNMP protocol.
Command Modes
Global configuration
Usage Guidelines
Use this command to enable SNMP. By default, SNMP is disabled.
Related Commands
no sntp server (global configuration) Disables support for SNMP.
Command
Description
To set the ONS 15194 contact, use the snmp-server contact global configuration command.
snmp-server contact contact
Syntax Description
contact String that describes the ONS 15194 contact information.
Command Modes
Global configuration
Usage Guidelines
This command is the same as the snmp-server contact command that first appeared in Cisco IOS Release 10.0.
Examples
The following example sets the ONS 15194 contact to be jopopulas_ta:
ons15194# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
ons15194(config)# snmp-server contact jopopulas_ta
Related Commands
(global configuration) Specifies a description for the ONS 15194. (global configuration) Specifies a location of the ONS 15194.
Command
Description
To set the text for the MIB object ONS 15194 description, use the snmp-server description global configuration command.
snmp-server description description
Syntax Description
description String that describes the ONS 15194.
Command Modes
Global configuration
Usage Guidelines
This command is the same as the snmp-server description command that first appeared in Cisco IOS Release 10.0.
Related Commands
(global configuration) Specifies a location of the ONS 15194.
Command
Description
To enable the ONS 15194 to send SNMP traps, use the snmp-server enable traps global configuration command. To disable SNMP notifications, use the no form of this command.
snmp-server enable trapsSyntax Description
This command has no arguments or keywords.
Defaults
SNMP traps are disabled by default.
Command Modes
Global configuration
Usage Guidelines
This command is similar to the snmp-server enable traps command that first appeared in Cisco IOS Release 11.1.
This command is useful for disabling notifications that are generating a large amount of uninteresting or useless noise.
The snmp-server enable traps command is used in conjunction with the snmp-server host command. Use the snmp-server host command to specify which host or hosts receive SNMP notifications. In order to send notifications, you must configure at least one snmp-server host command.
Examples
The following example enables the ONS 15194 to send all traps to the host at IP address 192.168.10.1:
ons15194(config)# snmp-server enable traps
ons15194(config)# snmp-server host 192.168.10.1
Related Commands
(global configuration) Specifies a location for the SNMP traps to be sent.
Command
Description
To specify the recipient of an SNMP notification operation, use the snmp-server host global configuration command. To remove the specified host, use the no form of this command.
snmp-server host host
Syntax Description
host Name or Internet address of the host.
Command Modes
Global configuration
Usage Guidelines
This command is similar to the snmp-server host command that first appeared in Cisco IOS Release 10.0.
If you do not enter an snmp-server host command, no notifications are sent.
The snmp-server host command is used in conjunction with the snmp-server enable command. Use the snmp-server enable command to specify which SNMP notifications are sent globally. For a host to receive most notifications, the snmp-server enable command and the snmp-server host command for that host must be enabled.
Examples
The following example enables the ONS 15194 to send all traps to the host at IP address 192.168.10.1:
ons15194(config)# snmp-server enable traps
ons15194(config)# snmp-server host 192.168.10.1
Related Commands
(global configuration) Enables the sending of SNMP traps.
Command
Description
To set the ONS 15194 location string, use the snmp-server location global configuration command. To delete the ONS 15194 location string, use the no form of this command.
snmp-server location location
Syntax Description
location String that describes the ONS 15194 location information.
Command Modes
Global configuration
Usage Guidelines
This command is the same as the snmp-server location command that first appeared in Cisco IOS Release 10.0.
If the string contains spaces, use quotes to deliminate the string.
Examples
The following example illustrates a ONS 15194 location string:
ons15194(config)# snmp-server location "Building 3/Room 214"
Related Commands
(global configuration) Specifies a contact for the ONS 15194. (global configuration) Specifies a description for the ONS 15194.
Command
Description
Use the sntp server global configuration command to configure the ONS 15194 to use the Simple Network Time Protocol (SNTP) to request and accept Network Time Protocol (NTP) traffic from a time server. To remove a server from the list of NTP servers, use the no form of this command.
sntp server address time-zone
Syntax Description
address Specifies the SNTP server to retrieve the coordinated universal time (UTC). time-zone Specifies the UTC time zone, in the format ±HH:MM:SS, where + indicates ahead of GMT and - indicates behind GMT.
Command Modes
Global configuration
Usage Guidelines
This command is similar to the sntp server command that appeared in Cisco IOS Release 11.2.
SNTP is a compact, client-only version of the Network Time Protocol (NTP). SNMP can only receive the time from NTP servers; it cannot be used to provide time services to other systems.
Enter this command once for each NTP server.
You must configure the ONS 15194 with this command in order enable SNTP.
Examples
The following example enables the ONS 15194 to request and accept NTP packets from the server at 121.54.9.29 and displays sample output from the show sntp command:
ons15194# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
ons15194(config)# sntp server 121.54.9.29 +03:00:00
ons15194(config)# exit
ons15194# show sntp
SNTP server IP address : 121.54.9.29
UTC time : MON FEB 05 15:59:00 2001
UTC Time Zone : +03:00:00
Related Commands
(EXEC) Displays the SNTP server and UTC time zone information.
Command
Description
To set the terminal baud rate, use the speed line configuration command. This command sets both the transmit (to terminal) and receive (from terminal) speeds.
speed bps
Syntax Description
bps Baud rate in bits per second (bps).
Command Modes
Line configuration
Usage Guidelines
This command is similar to the speed command that first appeared in Cisco IOS Release 10.0.
Set the speed to match the transmission rate of whatever device you have connected to the port. Valid baud rates are 9600, 19200, 38400, 57600, and 115200.
Examples
The following example sets the speed of the maintenance line to be 19200 bps:
ons15194(config)# line maint 0
ons15194(config-line)# speed 19200
To specify a TACACS+ host, use the tacacs-server host command in global configuration mode. To delete the specified address, use the no form of this command.
tacacs-server host hostname [port integer] [timeout integer] [key string]
Syntax Description
hostname IP address of the TACACS+ server. port Optional. Indicates that a port number is being specified. This option overrides the default, which is port 49. integer Decimal TCP port number to be used when making a connection to the TACACS+ daemon. Valid port numbers range from 1 to 65535. timeout Optional. Indicates that a timeout value is being specified. This overrides the global timeout value set with the tacacs-server timeout command for this server only. integer Period of time (in seconds) that the ONS 15194 waits for a response from a TACACS+ daemon before it times out and declares an error. Valid values range from 1 to 1000. key Optional. Indicates that an encryption key is being specified. Specifying this key overrides the key set by the global command tacacs-server key for this server only. string Character string specifying encryption key. This must match the key used by the TACACS+ daemon.
Defaults
No TACACS+ host is specified.
Command Modes
Global configuration
Usage Guidelines
This command is a subset of the tacacs-server host command that first appeared in Cisco IOS Release 10.0.
You can use multiple tacacs-server host commands to specify additional hosts. The Cisco IOS software searches for hosts in the order that you specify them. Use the port, timeout, and key options only when running a AAA/TACACS+ server.
Because some of the parameters of the tacacs-server host command override global settings made by the tacacs-server timeout and tacacs-server key commands, you can use this command to enhance security on your network by uniquely configuring individual routers.
Examples
The following example specifies a TACACS+ host of IP address 10.52.34.5:
ons15194# tacacs-server host 10.52.34.5
Related Commands
(global configuration) Specifies an encryption key for the ONS 15194 communications with all TACACS+ servers. (global configuration) Specifies a timeout value for a response from the TACACS+ daemon. (global configuration) Enables AAA authentication. (global configuration) Sets parameters that restrict access to specific commands.
Command
Description
To set the authentication encryption key used for all TACACS+ communications between the ONS 15194 and the TACACS+ daemon, use the tacacs-server key global configuration command. To disable the key, use the no form of this command.
tacacs-server key string
Syntax Description
string Key used to set encryption. This key must match the key used on the TACACS+ daemon.
Defaults
No default behavior or values.
Command Modes
Global configuration
Usage Guidelines
This command is a subset of the tacacs-server key command that first appeared in Cisco IOS Release 11.1.
The key entered at the ONS 15194 must match the key used on the TACACS+ daemon. The key must consist of alphanumeric characters; spaces are not allowed.
Examples
The following example sets the authentication and encryption key to dare-to-go:
ons15194# tacacs-server key dare-to-go
Related Commands
(global configuration) Specifies a TACACS+ host. (global configuration) Enables AAA authentication. (global configuration) Sets parameters that restrict network access to a user.
Command
Description
To specify a TACACS+ timeout, use the tacacs-server timeout command in global configuration mode. Use the no form of this command to delete the specified timeout.
tacacs-server timeout timeout
Syntax Description
timeout Period of time (in seconds) that the ONS 15194 waits for a response from a TACACS+ daemon before it times out and declares an error. Valid values range from 1 to 1000.
Defaults
No TACACS+ timeout is specified.
Command Modes
Global configuration
Usage Guidelines
The tacacs-server timeout command globally sets the timeout for all TACACS+ hosts. You can override the timeout for a specific host by using the tacacs-server host command with the timeout keyword.
Examples
The following example specifies a TACACS+ timeout of 60 seconds:
ons15194# tacacs-server timeout 60
Related Commands
(global configuration) Specifies a TACACS+ host. (global configuration) Specifies an encryption key for the ONS 15194 communications with all TACACS+ servers. (global configuration) Enables AAA authentication. (global configuration) Sets parameters that restrict access to specific commands.
Command
Description
To log on to a host that supports Telnet, use the telnet EXEC command.
telnet host [port]
Syntax Description
host Host name or IP address. port Optional. Decimal TCP port number; the default is the Telnet router port (decimal 23) on the host.
Command Modes
EXEC
Usage Guidelines
This command is a subset of the telnet command that first appeared in Cisco Release 10.0.
Examples
The following example creates a Telnet connection with the host at 10.1.0.11:
ons15194# telnet 10.1.0.11
Related Commands
(EXEC) Connects to the specified IP address via Telnet.
Command
Description
To enable or disable the temperature-protection capability of the ONS 15194, use the temperature-protect global configuration command. Use the no form of this command to reverse the temperature protection capability to its default.
temperature-protect {disable | fantray enable}
Syntax Description
disable Disables the temperature protection capability for the line and switch cards. fantray enable Enables the temperature protection capability for the fan tray.
Command Modes
Global configuration
Usage Guidelines
This command is only applicable to the ONS 15194. By default, the temperature-protect is enabled for the line and switch cards but not for the fan tray.
Examples
The following example disables the temperature protection capability for the line and switch cards:
ons15194# configure terminal
Enter configuration commands, one per line. End with CNTL/Z.
ons15194(config)# temperature-protect disable
Automatic card temperature protection disabled.
Related Commands
(EXEC) Display indicates whether the temperature protection capability is enabled.
Command
Description
To set the number of lines on the current terminal screen for the current session, use the terminal length EXEC command.
terminal monitor screen-length
Syntax Description
screen-length Your desired number of lines on the screen. The ONS 15194 uses this value to determine when to pause during multiple-screen output. A value of zero prevents the ONS 15194 from pausing between screens of output. When the output exceeds the screen length, it scrolls past.
Defaults
40 lines
Command Modes
Privileged EXEC
Usage Guidelines
Some types of terminal sessions do not require you to specify the screen length because the screen length specified can be learned by some remote hosts. For example, the rlogin protocol uses the screen length to set up terminal parameters on a remote UNIX host.
Examples
The following example prevents the ONS 15194 from pausing between multiple screens of output:
ons15194# terminal length 0
To display debug command output and system error messages for the current terminal and session, use the terminal monitor EXEC command.
terminal monitorSyntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Usage Guidelines
All terminal parameter-setting commands are set locally and do not remain in effect after a session is ended. You must perform this task at the privileged-level EXEC prompt at each session to see the debugging messages. The logging monitor command affects all terminal sessions, while the terminal monitor command affects only the current session.
Examples
The following example displays debug command output and error messages during the current terminal session:
ons15194# terminal monitor
To begin or end mirroring a Telnet session, use the tnetd set mirror privileged EXEC command.
tnetd set mirror {session | off}
Syntax Description
session Session number to mirror. off End to mirroring.
Command Modes
Privileged EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
When a session is mirrored, all commands entered and executed by that session are displayed. This feature may be helpful to instruct users at remote locations.
Related Commands
(EXEC) Displays all Telnet users and their session numbers.
Command
Description
To enable or disable additional Telnet sessions to the ONS 15194, use the tnetd set state privileged EXEC command.
tnetd set state {on | off}
Syntax Description
on Specifies whether to enable or disable additional Telnet sessions to the ONS 15194.
off
Command Modes
Privileged EXEC
Usage Guidelines
This command is only applicable to the ONS 15194.
Examples
The following example disables any additional Telnet sessions:
ons15194# tnetd set state off
Related Commands
(privileged EXEC) Specifies to begin mirroring a Telnet session.
Command
Description
To discover the routes that packets will actually take when traveling to their destination, use the traceroute privileged EXEC command.
traceroute ip-address
Syntax Description
ip-address IP address of destination location.
Command Modes
Privileged EXEC
Usage Guidelines
The trace command works by taking advantage of the error messages generated by routers when a datagram exceeds its time-to-live (TTL) value.
The trace command starts by sending probe datagrams with a TTL value of one. This causes the first router to discard the probe datagram and send back an error message. The trace command sends several probes at each TTL level and displays the round-trip time for each.
The trace command sends out one probe at a time. Each outgoing packet may result in one or two error messages. A "time exceeded" error message indicates that an intermediate router has seen and discarded the probe. A "destination unreachable" error message indicates that the destination node has received the probe and discarded it because it could not deliver the packet. If the timer goes off before a response comes in, trace prints an asterisk (*).
To verify the checksum of a file on a Flash memory file system, use the verify privileged EXEC command.
verify file-url
Syntax Description
file-url The location of the file to be verified as indicated in Table 5-28.
The file-url must be one of the keywords as shown in Table 5-28.
| Keyword | Description |
|---|---|
disk0: | Copy from disk0: file system. This is the disk in the first PCMCIA card slot. |
disk1: | Copy from disk1: file system. This is the disk in the second PCMCIA card slot. |
flash: | Copy from flash: file system. |
Command Modes
Privileged EXEC
Usage Guidelines
When you enter the file system of the file to be verified, you are prompted for the name of the file.
Use the verify command to verify the checksum of a file before using it.
Each software image that is distributed on disk uses a single checksum for the entire image. This checksum is displayed only when the image is copied into Flash memory; it is not displayed when the image file is copied from one disk to another.
The README file, that is included with the image on the disk, lists the name, file size, and checksum of the image. Review the contents of the README file before loading or duplicating the new image so that you can verify the checksum when you copy it into Flash memory or onto a server.
To display the contents of a file system, use the dir command.
Related Commands
(privileged EXEC) Displays the contents of a file system.
Command
Description
To write the currently running configuration to Flash memory, use the write or write memory privileged EXEC command.
writeSyntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Usage Guidelines
This command is the same as the copy running-config startup-config command that first appeared in Cisco IOS Release 11.3. The write command must be executed to save any changes to the running configuration to the startup configuration. Any unsaved changes will be lost when the ONS 15194 is reset or powered down.
Related Commands
copy running-config startup-config (privileged EXEC) Copies the contents of the running configuration to the startup configuration.
Command
Description
To erase all ONS 15194 configurations and reset the factory defaults, use the write erase privileged EXEC command.
write eraseSyntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Usage Guidelines
This command is the same as the erase startup-config command.
Related Commands
(privileged EXEC) Erases the startup configuration file.
Command
Description
To write the contents of the running configuration file to a TFTP server, use the write network privileged EXEC command.
write network address
Syntax Description
address TFTP server address of the format tftp://host[/dir]/file, where host is a host name, dir is the directory within the host, and file is the file name to which to write.
Command Modes
Privileged EXEC
Usage Guidelines
The write network command is used to upload a configuration file to a TFTP server. This is useful to back up the configuration file in the event the configuration file is subsequently damaged or changed inadvertently. This command is the same as the copy running-config privileged EXEC command.
Examples
The following example writes the configuration file to the file conf.bac on the server at location 192.186.10.1:
ons15194# write network tftp://192.186.10.1/conf.bac
Related Commands
copy startup-config (privileged EXEC) Saves the contents of the startup configuration file to a TFTP server.
Command
Description
To write the contents of the running configuration to the terminal, use the write terminal privileged EXEC command.
write terminalSyntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Usage Guidelines
The command is the same as the show running-config privileged EXEC command.
Examples
To display the running configuration, use the command as in the following example:
ons15194# write terminal
Related Commands
(EXEC) Displays the currently running configuration to the terminal.
Command
Description
Posted: Sun Oct 6 02:25:51 PDT 2002
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.