|
|
The Command Line Interface (CLI) enables displaying and setting the various ONS 15190 options and general management of the system. This includes definition of nodes and configuration of logical rings, as well as viewing the status of the system. All available commands are described in this chapter. Use of these commands to configure your ONS 15190 and examples of their use are presented in the chapter "Configuring the ONS 15190".
The ONS 15190 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 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
Use the following keyboard commands to move the cursor between commands:
Keyboard command | Action |
|---|---|
|
|
|
|
|
|
Use these commands to edit at the command line:
Command | Action |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
The Help feature in the CLI is context sensitive, activated by using keyboard characters. The help information provided often depends on the location where the characters are typed.
Action | Result |
|---|---|
|
|
|
|
|
|
|
|
The following example illustrates how the context-sensitive help feature enables you to create a new node using the rconf command. To list all possible keywords and a brief explanation of each, enter rconf at the system prompt, followed by space, and a question mark (?).
admin>rconf ? apply Apply current configuration changes default Reset connection configuration to factory default discard Discard current connection configuration changes node Node configuration pos POS connection configuration raw Raw (low-level) configuration ring Ring configuration show Show configuration sniff Sniffing configuration
Each successive keyword can be followed by a question mark (?) to determine the format of the options to follow.
admin>rconf node ? all All nodes autodetect Auto-detect nodes delete Delete node new Create new node NODE Node identifier srp1 pos1 pos2 snif1 snif2 admin>rconf node new ? aps APS node fiber Fiber node pos POS node sniff Sniffer node srp SRP node STRING SRP node name admin>rconf node new srp ? STRING SRP node name
Similar to UNIX systems, the ONS 15190 CLI supports some shell processing, such as history and modification commands.
Action | Result |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
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.
The remaining commands are available for both users and administrators. However, users can only display the information for each command, while administrators can also modify it. The only command that users can execute is the password command.
Configuration management commands are used to configure the unit into a logical ring. Entering any of these commands followed by ? will display all available options for the command.
Command | Action |
|---|---|
| |
| |
| |
| |
| |
| |
| |
| |
|
Security management commands provide the security framework for the system. Enter the command at the system prompt and you will be prompted for any required information.
Command | Action |
|---|---|
| |
| |
|
The network management commands following enable network communications and the use of various networking protocols.
Command | Action |
|---|---|
| |
| |
| |
| |
| |
| |
|
|
The utility commands following display various information or assist in using the system.
Command | Action |
|---|---|
|
|
|
|
|
|
|
|
Use the autoconnect command to automatically detect all SRP nodes that are physically connected to the ONS 15190 and to configure them into default rings. There are no options for the autoconnect command. When executed, all detected nodes are displayed, and you are prompted to apply the configuration.
autoconnect |
Note The autoconnect command ignores all non-SRP nodes. |
|
Note If the trace-mode is set to transparent for SRP nodes, and the ONS 15190 unit that you perform the autoconnect command on is connected to a second ONS 15190 unit, any nodes connected to the second ONS 15190 unit will not be identified. |
Examples
Following is an illustration of the results of running the command autoconnect.
admin> autoconnect
Sniff configuration:
Sniffer Port Sniffed node Port
-------------------- ----- -------------------- ----------
No sniffer nodes.
POS connections:
Node IP Address Ports Type Other
-------------------- --------------- -------------- ---- ----------
12000_left-2 11.1.1.2 L5.1 OC12
12000_Right-2 11.1.1.1 L7.1 OC12
Ring configuration (nodes in order of outer ring):
Ring Name Nodes IP Address A-Port B-Port Type Other
---------- ------------- ------------- ------ ------ ---- ---------
ring1 12000_left 10.1.1.2 L1.2 L1.1 OC12
12000_Right 10.1.1.1 L4.1 L2.1 OC12
7200_center 10.1.1.5 L4.2 L8.1 OC12
7200_left 10.1.1.4 L5.2 L6.1 OC12
Apply configuration? y
Configuration applied.
Use the card command to reset or display information about specific cards in the system.
card slot {reset | show status}
Syntax Description
slot Card identifier according to the slot occupied within the chassis, as follows: reset Resets the card. show status Provides status information about the card.
S1-S5—Switch cards.
L1-L8—Line cards.
Examples
The following example illustrates the command card show status for card L1:
admin> card l1 show status Line Card 1: Subtype: Single Mode Int. Reach SRP # of ports: 2 State: Operational Catalog number OC12/STM4-SM-IR Serial number: 1018-002 Board version: A0 Temperature Status: Normal Temperature 1: 30.0 degC Temperature 2: 28.0 degC
Use the eips command to enable the enhanced intelligent protection switching capability of the ONS 15190. When enabled, the ONS 15190 can detect and bypass a faulty node, which is defined as an SRP node in which both of its ports (A and B) have failed. Without the E-IPS functionality, in the event of a router failure, all remaining routers will be connected by a single wrapped ring according to the SRP protocol. With the E-IPS functionality, if there is a signal failure on both sides of a connected router, the ONS 15190 will bypass the failed node.
Failed nodes are removed from the ring within 5 mSec of detection. A bypassed node is returned to the ring after a wait-to-restore period (WTR) seconds has passed since the node was detected as being functional.
eips {enable | disable | set wtr decimal | show}
Syntax Description
enable Enables the E-IPS functionality for the ONS 15190 system. disable Disables the E-IPS functionality for the ONS 15190 system. set wtr decimal Specifies the wait-to-restore (WTR) time, which is the number of seconds (decimal) that the system waits after a bypassed node becomes functional before integrating it once again into the ring. show Indicates whether the E-IPS option is enabled or not and displays the specified WTR time.
Examples
In the following example, the wait-to-restore time is 10 seconds, but the E-IPS option is disabled.
admin> eips show EIPS state = disabled wtr = 10 seconds
Related Commands
rconf show applied Indicate whether any nodes have been bypassed and display the currently specified wait-to-restore (WTR) time.
Command
Description
Use the l-aps command for dynamic status display and user initiated switching of APS nodes. Such nodes should be previously defined and configured using the rconf node command. Also, the trace-mode of APS nodes should be set to transparent (default).
To display the status of APS nodes, use the following command syntax:
l-aps {all | aps-node} show status orTo specify a change in the switching control for an APS node, use the following command syntax:
l-aps aps-node request {lockout | forced link | manual link}To clear the manual switching settings for an APS node, use the following command syntax:
l-aps aps-node request clear {lockout | forced link | manual link}
Syntax Description
all | aps-node Specifies whether the command is executed on all nodes or a specific APS node. show status Displays the status information for the specified node(s). request Requests a change in the switching control. Options are to switch control either away from the working link (link=1) to the protection link or away from the protection link (link=0) to the working link. lockout Lockout of protection, that is, the working link is forced to be active, irrespective of the condition of the links. forced Forces a switch away from the specified link link. When P is the forced link, the working link 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. link The link to switch away from, where 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. clear Clears any of the above. You must designate whitch of the switching commands to clear (lockout, forced, or manual) and the link (1=working, 0=protection).
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.
Examples
The command l-aps aps-node request forced 0 causes a switch away from the protection (0) link to the working (1) link. In this case, the working link remains active irrespective of the condition of its link.
Related Commands
rconf node new aps Defines a new APS node. rconf pos connect Connects two defined APS nodes. system set trace-mode pos transparent Specifies the trace-mode for APS nodes to be transparent for optimal switching times. Transparent is the default trace-mode for APS nodes.
Command
Description
Use the motd command to create a new message-of-the-day (MOTD). An MOTD is before someone logs into the system. To create a new MOTD, create a text file with the desired text and download the file to the ONS 15190 using TFTP.
motd {enable | disable | show | clear}
Syntax Description
enable Enables display of the downloaded MOTD before someone can log in to the system disable Disables display of the MOTD at login. show Displays the current MOTD. clear Deletes the currently saved MOTD.
Related Commands
tftp Download an MOTD file to the ONS 15190.
Commands
Description
Use the port command to specify or display information concerning a specific port or all ports in the system. A port is a pair of optical fiber connectors on a line card. Ports are identified according to the slot of the line card in the chassis as well as the port number (1 for uppermost, 4 for lowest). For example, port L3.1 is the upper port on line card 3.
port {all | port} {blink decimal | clear sonet current | loopback {facility | none | terminal} | reset}
Syntax Description
all | port Specifies all ports or the port identifier of the port. The all option is only applicable to clear sonet current. blink Causes all five LEDs associated with a particular port to blink. This command may be useful to identify ports for technicians at a remote location. decimal The amount of time in seconds that the LEDs blink. If no time is specified, the default is 10 seconds. clear sonet current Clears the SONET (current) counters for the specified port port or all ports. loopback Specifies whether the port is set to loopback mode or not. Options follow: facility External loopback; data received by the port is mirrored back out. none No loopback. terminal Internal loopback; data that should have been transmitted by the port is looped back in as if received from an outside source. reset Resets the port. Resetting the port does not reset the counters or statistics.
Related Commands
port show Displays port information.
Commands
Description
|
Note Enter the command port followed by ? at the command prompt to display all options for the command. In the display, the option Lc.p refers to the port identifier where c is the card number, and p is the port number. |
Use the port show command to display specific information about one or more ports.
port {all | port} show pos {current | history | total {bytes | frames | errors}} or
Syntax Description
all | port Specifies all ports or the port identifier of the port. current Displays PoS or SONET counters for the current 15-minute interval. This option is only applicable to a specific port. history Displays the PoS or SONET counters for prior time intervals. 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. This option is only applicable to a specific port port. total Displays the accumulated PoS information to date, since the last reset. When information for all ports is to be displayed, you must specify whether to display bytes, frames, or errors. sonet Displays the SONET counters. indications Displays the SONET port indications. laser Displays the input and output power of the laser in dBm. The input power is read from the hardware and has a resolution of 0.5 dBm. The output power is as read in the BOL (beginning of life) and has a resolution of 0.n dBm. status Displays the current status for all ports or a specific port. trace Displays the path trace message for all ports or a specific port.
bytes | frames | errors
Related Commands
port Specifies information for a specific port or all ports.
Commands
Description
Examples
The following example illustrates the trace for port L1.1:
admin> port L1.1 show trace Received Path Trace Message: Hostname: 7200_right IP: 10.1.1.3 Interface: SRP5/0 Side: A
This example illustrates the current status for port L1.1:
admin> port l1.1 show status Port L1.1: General: Type: Unknown Internal number: 0 Physical location: Linecard 1, port 1 (L1.1) State: Inactive Configuration: Enabled: Yes Internal data source: - Side: None Mode: SONET Protocol: SRP Coding: NRZ SES Threshold: Bellcore 1991 Clock Source: Internal SF Threshold: 1e-3 SD Threshold: 1e-6 AIS Setting: Auto
Use the rconf command to display and control the ring configuration. After the ONS 15190 unit is physically connected, use this command to configure rings:
rconf {apply | discard | default | show {applied [raw] | current}
Syntax Description
apply Applies the current configuration changes to the system. discard Discards all current connection configuration changes. The ring configuration will be as defined the last time the configuration was applied. default Resets the connection configuration to the factory defaults. show Displays connection information. applied Displays information concerning the configuration that was last applied (using the command rconf apply). raw Displays the actual settings of ports and internal connections that are derived from the applied configuration. current Displays information concerning the current configuration that has not yet been applied.
Note The configuration only becomes operational after it is applied. If the active controller card is reset or malfunctions before the configuration is applied, all changes will be lost.
Note The factory default contains no nodes/rings. Execution of this command will completely reset all connection configurations.
Related Commands
rconf node Defines and configures nodes. rconf pos Defines PoS connections. rconf ring Defines and configures SRP rings. rconf sniff Defines sniff connections. rconf raw Defines low-level (raw) connections.
Commands
Description
Use the rconf node command to display, rename, delete, and automatically detect nodes. To define new nodes or set node parameters, refer to the rconf node new and rconf node set command sections.
rconf node {autodetect | delete node | node ports port1 port2 | node rename string | node show}
Syntax Description
autodetect Detects the current node configuration. Nodes that were previously defined are retained if they do not contradict newly detected nodes. All physically connected node configurations are retained. delete Deletes node information for a specific node. node Node identifier. ports Modifies the node information so that port1 and port2 become the new ports to which the node node is connected. An example of a port is L1.1. rename Renames the node named node to the new name string. show Displays information about the specific node node.
Note If the trace-mode is set to transparent and the ONS 15190 unit that you perform the autodetect command on is connected to a second ONS 15190 unit, any nodes connected to the second ONS 15190 unit will not be detected.
Related Commands
rconf node new Defines new nodes. rconf node set Configures node parameters. rconf apply Applies the current configuration. Configuration changes must be applied before they become active.
Commands
Description
Examples
The following example illustrates the rconf node show command for the node named pos1:
admin> rconf node pos1 show Node pos1: Type: POS Port: L1.1 Port Type: OC12 Mode: SONET Clock Source: Internal SD Threshold: 1e-6 SF Threshold: 1e-3 AIS Setting: Auto
Use the rconf node new command to configure a new node. Nodes are defined according to their use in the network (APS, PoS, SRP, and so forth.). Each new node is given a name, and the physical port or ports to which it is connected in the ONS 15190 unit must be specified.
rconf node new {aps | fiber | pos | sniff | srp} string port1 port2 {oc12 | oc48}
Syntax Description
aps Automatic protection switching node. APS nodes are connected to the ONS 15190 via 2 ports where port1 is the working link and port2 is the protection link. It is necessary to physically connect the device correctly to the W and P ports. Once defined, an APS node may be connected to another APS or PoS node using the command rconf pos. fiber Node definition to be used in the future for cascading multiple ONS 15190 units together. pos Packet over SONET (PoS) node. PoS nodes are connected via a single port port1. Once defined, a PoS node may be connected to another APS or PoS node using the command rconf pos. sniff Sniffer node for monitoring traffic through a particular port in the ONS 15190. Sniff nodes are connected through a single port port1. To define which port is to be monitored (sniffed), use the command rconf sniff. srp SRP node. SRP nodes are connected via 2 ports: port1 and port2 (connected to the A and B sides of the node, respectively). After the nodes are defined, they can be connected into ring(s) by executing the command rconf ring. string Node identifier. port1 port2 Port(s) to which the node is physically connected. oc12 | oc48 Speed of the node. If the line cards to which the node is to be connected are present, the node speed is set automatically. Otherwise, you must specify the speed of the node.
Related Commands
rconf pos Connects two previously created PoS nodes. rconf sniff Configures a port to be sniffed by a sniff node. rconf ring Defines and configures SRP rings. rconf apply Applies the current configuration. Configuration changes must be applied before they become active.
Commands
Description
Use the rconf node set command to specify various parameters for specific nodes. You must execute the command rconf apply before any of these configuration changes take affect.
|
Note Node properties remain with a node even if the node is moved to different ports. |
Syntax Description
node Node identifier. ais Specifes the AIS properties for the node. apsmode Specifies the mode for APS nodes to be bidirectional, so that both sides always use the same link (P or W). autotrack Enable (on) or disable (off) the capability of automatically tracking a node even if it is moved from one port to another. The autotracker is by default disabled. When nodes are removed from the system, traps are sent to the control panel to indicate the changes. clock-source Specifies clock source for node. mode Specifies whether the node ports are configured for SDH or SONET. sd-threshold Specifies the BER threshold to be used to define a signal degrade (sd). Options are from 1x10-5 (5) to 1x10-9 (9). sf-threshold Specifies the BER threshold to be used to define a signal failure (sf). Options are from 1x10-3 (3) to 1x10-5 (5). switching Specifies for APS nodes whether control returns to the working link (W) when the link is functional again (revertive), or control remains wherever it is as long as the link is functional (non-revertive). decimal Wait-to-restore (WTR) period, that is, the number of minutes the system waits once the working link is functional before reverting to it. The default WTR is 5 minutes.
auto—The node ports mirror the AIS signal automatically.
never—The node ports never generate an AIS signal.
Note Currently, only bidirectional mode for APS nodes is supported.
Note The trace-mode must be set to normal for those nodes with which you want the autotracker option to work properly (for example, srp, pos).
line—line-recovered clock.
Related Commands
rconf apply Applies any configuration changes. The command rconf apply must be executed before any of the configuration changes made with rconf node set become affective. rconf node new Configures new nodes.
Commands
Description
Use the rconf pos command to connect PoS or APS nodes that are created using the rconf node new command.
rconf pos {connect node1 node2 | disconnect node}
Syntax Description
connect node1 node2 Connects two previously defined PoS nodes together. Node1 and node2 are the node identifiers. disconnect node Disconnects the node node from a PoS connection. It is sufficient to disconnect one of the nodes from the connection.
Related Commands
rconf node new Defines new PoS nodes rconf apply Applies the current configuration. Configuration changes must be applied before they become active.
Commands
Description
Use the rconf ring command to define and configure SRP rings. To delete a ring or create a new ring, use the following command syntax:
rconf ring {delete ring | new string}To add nodes, reorder nodes or remove modes to an existing ring, use the following command syntax:
rconf ring ring {add {all | node} | autoorder | nodes node1 [node2...] | remove {all | node} | rename string}
Syntax Description
delete ring Deletes the ring ring. The ring must be empty. new string Creates a new ring named string. add Adds nodes to the ring ring. Use the all option to add all free nodes to the ring; or specify which specific node node to add to the ring. autoorder Optimizes the node order for maximum redundancy. nodes Specifies the nodes of the ring and/or specifies the order of the nodes in the ring according to the outer ring order. Nodes can not be removed implicitly using this command. To remove nodes, use the remove option. remove Removes nodes from the ring. Use the all option to remove all nodes from the ring ring; or specify which node node to remove from the ring. rename string Renames the ring to name string.
Related Commands
rconf node new Create new nodes. Nodes must be created before they can be added to a ring. rconf apply Applies the current configuration. Configuration changes must be applied before they become active.
Commands
Description
Use the rconf sniff command to configure a node to be sniffed by a defined sniff node. Sniff nodes are defined using the command rconf node new.
rconf sniff {connect sniff-node node port | disconnect sniff-node}
Syntax Description
connect sniff-node node Defines a node node to be monitored by the node sniff-node. port 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 15190 to the B-side of the node will be duplicated. disconnect sniff-node Stops monitoring a node via the sniff node sniff-node.
Note When four-port line cards are used, only one node can be monitored by a sniff-node.
Related Commands
rconf node new Defines new sniff nodes.
Commands
Description
Use the rconf raw command to manually define connections and port settings.
|
Note Defining low level (raw) connections clears all high-level (node/pos/ring/sniff) configurations. The command rconf raw can be executed only after executing the command rconf raw enable. |
Syntax Description
enable Enables the raw option. Before the ONS 15190 can be configured with the rconf raw command, the enable option must be executed. This will clear any existing high-level configurations that were previously set using the node, pos, ring, or sniff options. The current internal connections and port settings that were derived from the high-level configuration are retained. disable Disables the raw configuration and erases all raw configurations that were made. clear Disconnects all ports connect port1 port2 Bidirectionally connects two ports: port1 to port2. direct Directs the source port port1 to the destination port port2 (in one direction only). disconnect port Disconnects the source of port port.
Note You must execute the command rconf apply before the execution of the commands rconf raw enable or rconf raw disable become active.
Related Commands
rconf apply Applies the raw configuration. If this command is not executed, no raw configuration changes will be made. rconf raw set Configure raw connections.
Commands
Description
|
Note If a source port (for example, L1.1) is directed to two separate destination ports (for example, for port monitoring), the second port on the source port pair (for example, L1.2) cannot also be duplicated to two destination ports. |
When using the raw option, all configurations must be defined manually. Therefore, the command rconf raw set provides the ability to set various port parameters, that generally are specified according to node. These are very similar to the high-level options set with the rconf node set command.
rconf raw set {all | port } {ais {always | auto | never} | clock-source {internal | line} | mode {sdh | sonet} | protocol {pos | srp} | sd-threshold {5 | 6 | 7 | 8 | 9} | sf-threshold {3 | 4 | 5}}
Syntax Description
all | port Sets all ports or a specific port port. ais Specifes the AIS properties for the port. clock-source Specifies clock source for the port. mode Specifies whether the port is configured for SDH or SONET. protocol Specifies whether the port is to use pos (Packet over SONET) or srp (Spatial Resuse Protocol). sd-threshold Specifies the BER threshold to be used to define a signal degrade (sd) . Options are from 1x10-5 (5) to 1x10-9 (9). sf-threshold Specifies the BER threshold to be used to define a signal failure (sf). Options are from 1x10-3 (3) to 1x10-5 (5).
auto—The node ports mirror the AIS signal automatically.
never—The node ports never generate an AIS signal.
line—line-recovered clock.
Related Commands
rconf raw Enables the use of raw options and defines low-level connections. You must execute the command rconf raw enabled before you can make any of these changes. rconf applied Applies the raw configuration. If this command is not executed, no raw configuration changes will be made.
Commands
Description
Use the slot command to view information concerning specific slots, or to disable or enable specific slots within the chassis. The slot refers to the physical location within the ONS 15190 chassis, irrespective of the specific card located in the slot at any particular time.
slot {slot {disable | enable | show status} | all show status}
Syntax Description
slot Slot identifier. Slots may be C1, C2 (controllers), S1-S5 (switch cards), and L1-L8 (line cards). disable Disables a particular slot. enable Enables a slot that was previously disabled. show status Indicates whether a particular slot or all slots are enabled or not.
Examples
The following example illustrates the all show status option for the slot command:
admin> slot all show status Controller Card 1 : Enabled Line Card 1 : Enabled Line Card 2 : Enabled Line Card 3 : Enabled Line Card 4 : Enabled Switch Card 1 : Enabled Switch Card 2 : Enabled Switch Card 3 : Enabled Switch Card 4 : Enabled Switch Card 5 : Enabled Line Card 5 : Enabled Line Card 6 : Enabled Line Card 7 : Enabled Line Card 8 : Enabled Controller Card 2 : Enabled
Use the system command to set or display system information. See the system set and system show commands as well.
system {reset | sync | tech-support}
Syntax Description
reset Resets the active controller. Before executing this command, it is recommended to perform the command system sync to synchronize the two controllers to ensure that any recent configuration changes are synchronized. sync Synchronizes the redundant controller to the current settings of the active controller. It is recommended to perform this command before executing the command system reset. tech-support Displays a dump of system information. Log the results of this dump to a text file and send it to a technical support engineer together with any requests for assistance.
Related Commands
system set Specifies the various system parameters. system show Displays the various system information.
Commands
Description
Use the system set command to specify various system-wide parameters.
system set {contact string | description string | location string | name string | prompt string | session timeout decimal | temp-protect {disable | enable} | time month day year time | trace-mode {pos | raw | sniff | srp } {normal | transparent} | factory default}
Syntax Description
contact string Specifies the system contact information string. description string Specifies a description string for the system. location string Specifies a system location string. name string Specifies a name string for the system. prompt string Specifies a prompt string for the command line. To reset the prompt, enter two quotations marks with nothing between them. session timeout decimal Specifies a timeout value for the telnet session. The session ends after decimal number of minutes; a value of 0 indicates that the session never terminates. temp-protect Overrides the temperature protection mechanism. When enabled (default), any card whose temperature rises above 167°F (75°C) automatically stops operation. This is to protect the cards from damage arising from adverse heat which can occur if the fan mechanism malfunctions. Disable this option to turn off the temperature protection mechanism, but beware that the cards are only guaranteed to operate according to safety specifications at a temperature under 167°F (75°C). time Sets the system time. Month is a decimal from 01 to 12; day is a decimal from 01 to 31; year is a four digit number between 1970 to 2030; time is in the format HH:MM:SS. trace-mode Sets the path trace message (PTM) of the the specified nodes to be either normal or transparent. When node A is connected to node B via the ONS 15190 in transparent mode, the path trace message delivered to B will be that of A and not that of the ONS 15190. In normal mode, the ONS 15190 sends its own path trace message to each connected node. {pos | raw | sniff | srp} Specifies the node type for which to set the trace-mode. SRP and raw nodes are by default set to normal; pos and sniff nodes are by default set to transparent. Pos includes APS nodes. factory default Resets the entire configuration to the factory defaults. This command will only take effect after a system reset is performed.
Note If the trace-mode is set to transparent, and you execute either autoconnect or rconf node autodetect on an ONS 15190 unit that is connected to a second ONS 15190 unit, any nodes connected to the second ONS 15190 unit will not be detected.
Note This command completely resets the system configurations.
Use the system show command to display the system parameters.
system show {box | chassis | info | redundancy | session | temp-protect | trace-mode}
Syntax Description
box Displays the chassis with the inserted cards. chassis Displays general information about the chassis. info Displays general system information. redundancy Displays information concerning the redundancy status of the system components. session Displays the session parameters. temp-protect Indicates whether the card temperature protection mechanism is enabled for the system. trace-mode Indicates whether the path trace message of the node types is transparent or not. By default, SRP and raw nodes are set to normal path-trace mode, that is, the ONS 15190 sends its own path trace message. By default, PoS, APS, and sniff nodes are set to transparent path-trace.
Examples
The following example illustrates the system show box command:
admin> system show box +----+----+----+----+----+----+----+----+----+----+----+----+----+----+----+ |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| |i960|OC12|OC12|OC48|OC48| | | | | |OC12|OC12|OC48|OC48|i960| |----|----|----|----|----|----|----|----|----|----|----|----|----|----|----| |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| | | | |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| | | |UNEQ|UNEQ|UNEQ|UNEQ| | | | | | |UNEQ|UNEQ|AIS | | | | | | | | | | | | | | | | | |+----+----+----+----+----+----+----+----+----+----+----+----+----+----+----+
This example illustrates the system show info command:
admin> system show info System uptime: 4:18:30.126 System time: TUE MAY 09 15:31:54 2000 Name: Description: Location: Contact: Running image: Release: 2.5 Created on: Wed May 03 20:09:48 2000 Created by: Cisco Systems Length: 3053739 Signature: 0x1E9BA6E0 Software version: 2.5.11 Software created on: May 3 2000, 20:09:01 Bootstrap version: 3.0
Use the password command to set a new password for user or admin.
password {user | admin}
Syntax Description
user | admin Specifies which password to change. User can only change the user password, while admin can change either user or admin passwords. If you enter only password, you will be prompted to change the password for the username with which you are currently logged in.
The net command is used to display and modify the current IP configuration. The IP, subnet mask and default gateway must be set properly before you can log in using telnet. Use the following command syntax to delete the sntp server:
net delete sntp serverUse the following command syntax to set the IP configuration:
net set {arp flush | dns ip1 ip2 domain | ip ip mask gateway}Use the following command syntax to display the IP configuration.
net show {all | arp | dns | ip | route | sntp}
Syntax Description
delete sntp server Stops retrieving the UTC time from the SNTP server. set arp flush Flushes the ARP entries. set dns ip1 ip2 domain Specifies the DNS configuration, where ip1 is the primary DNS IP address; ip2 is the secondary DNS IP address; domain is the default domain. set ip ip mask gateway Specifies the IP address and subnet mask, where ip is the IP address of the system; mask is the subnet mask; gateway is the default gateway IP address (use 0 if there is no default gateway). showt all Displays information about the ARP, DNS, IP, route, and SNTP settings. show arp Displays the ARP table. show dns Displays the domain name servers. show ip Displays the IP address and subnet mask. show router Displays the routing tables. show sntp Displays the SNTP server and current UTC time.
Related Commands
sntp Specifies an SNTP server.
Commands
Description
Examples
The following example illustrates the net show all command:
admin> net show all Interface : ei 0IP address : 192.168.10.235 Subnet mask : 255.255.255.0 Physical address : 00:D0:04:00:00:0D Primary DNS : 0.0.0.0 Secondary DNS : Domain Name : ROUTE NET TABLE destination gateway flags Refcnt Use Interface --------------------------------------------------------------- 0.0.0.0 192.168.10.1 3 0 1 ei0 192.168.10.0 192.168.10.235 101 0 0 ei0 ---------------------------------------------------------------- ROUTE HOST TABLE destination gateway flags Refcnt Use Interface ---------------------------------------------------------------- 10.1.1.0 10.1.1.0 5 0 0 lo0 10.1.1.1 10.1.1.0 5 0 2010 sl0 127.0.0.1 127.0.0.1 5 0 0 lo0 ---------------------------------------------------------------- LINK LEVEL ARP TABLE destination gateway flags Refcnt Use Interface ---------------------------------------------------------------- 192.168.10.1 00:60:97:b4:41:be 405 1 0 ei0 192.168.10.20 00:90:27:36:a8:7f 405 1 134 ei0 192.168.10.33 00:10:5a:6c:1d:d7 405 0 7 ei0 192.168.10.47 00:50:04:09:e3:fa 405 1 996 ei0 192.168.10.58 00:50:04:35:5e:1c 405 2 932 ei0 ----------------------------------------------------------------
The next example illustrates the net set ip command:
admin> net set ip 169.192.10.105 255.255.255.0 169.192.10.1
Use the sntp command to specify an Simple Network Time Protocol (SNTP) server to be used to retrieve the Coordinated Universal Time (UTC). When activated, the ONS 15190 attempts to retrieve the UTC (time) every 5 minutes, in order to update its UTC clock.
sntp {set server string utc_time_zone | delete server | show server}
Syntax Description
set server string utc_time_zone Specifies the SNTP server (at address string) to retrieve the UTC. utc_time_zone is the UTC zone of format +/-HH:MM:SS. delete server Stops retrieving the UTC from the SNTP server. show server Displays the current UTC and SNTP server.
Examples
The following example illustrates the sntp show server command.
admin> sntp show server SNTP server IP address : 140.142.16.34 UTC time : MON MAY 01 14:24:05 2000 UTC Time Zone : +03:00:00
Use the tnetd command to display and modify the telnet daemon configuration.
tnetd {abort {all | decimal} | send {all | decimal} string} or
Syntax Description
abort {all | decimal} Ends an incoming telnet session. Use all to end all telnet sessions, or specify the session number (decimal) of the session to end. send {all | decimal} Sends a message (string) to another telnet session. Use all to send to all telnet sessions, or specify the session number (decimal) of the session to which to send. set mirror Specifies the IP address (string) or session number (decimal) of a session to mirror. When a session is mirrored, you can view all commands entered and executed by that session. This feature may be helpful to instruct users at emote locations. Use off to turn off mirroring. set state {off | on} Specifies the current telnet state. Use off to allow no additional sessions. Use on to allow additional sessions. show session View all active telnet sessions. show state View the current state of the telnet session.
{off | decimal | string}
Use the tftp command to retrieve or place a file using tftp. Only configuration, image and motd files can be downloaded to the system. Image files contain system software and must be retrieved in order to perform a software upgrade. Conf files are configuration files containing the user-defined configurations defined during system sessions.
tftp get ip fname {conf | image | motd} or
Syntax Description
get Downloads a file from a server to the system. Ip is the IP address of the TFTP server; fname is the file name of the file to retrieve. Specify whether the file is a configuration file (conf), image file (image), or message of the day file (motd). When a configuration file is downloaded it only becomes active after you execute the command system reset or physically reset the controller cards (see "Monitoring the Laser Power" in the chapter "Configuring the ONS 15190" for more information). put Uploads a configuration file to a TFTP server. Ip is the IP address of the TFTP server; fname is the name of the remote file name. This option is useful to back up the configuration file in the event the configuration file is subsequently damaged or changed inadvertently.
Related Commands
motd Specifies a system message to be displayed at login.
Commands
Description
Use the ping command to ping a host.
ping ip-address
Syntax Description
ip-address Host name or IP address to ping.
Use the snmp command to display or modify the SNMP parameters.
snmp {show | trap {add | remove} string}
Syntax Description
show Displays the current SNMP trap IP addresses. trap add Adds or removes the trap browser IP address specified by string.
trap remove
Use the telnet command to start a telnet session.
telnet ip-address [decimal]
Syntax Description
ip-address IP address of the location to which the connection is to be made. decimal Port number (optional).
Use the help command to print all keyboard bindings to the screen.
help bindingsUse the history command to display the past few commands entered into the command line.
history [decimal]
Syntax Description
decimal Specifies the number of commands to display, up to the number of commands currently available on the system. When no decimal value is entered, the command displays the last 40 commands (0 to 39), where 39 is the last command used.
Use the log command to change or display the logger configuration.
log set ip ip or
Syntax Description
set ip ip Specifies the IP address of the remote logging station. set device clear Ends the logging for the device device. set device module Specifies the module to log. Use all to log all modules; alternatively, specify the decimal number of the module to log. set device state Toggles the status of the device to enabled (on) or disabled (off). set device threshold Specifies a severity threshold for the device (decimal). show Displays the logger configuration. Use the all option to display all of the logger configuration. Use ip to get the remote logging station IP address. Specify the device name (device) to display the log of a specific device (input is the input filter).
Examples
The following example illustrates the log show all command:
admin> log show all device state threshold module trap ---------------------------------------------------------------- input on 11 all on conLog on 4 all on maintLog on 4 all on memLog on 6 all on sysLog on 5 all on fileLog on 4 all on eventLog on 11 12 on tlntLog0 on 3 all on
Use the serial command to display or modify the baud rate for the two serial ports.
serial show or
Syntax Description
show Displays the baud rates for the two serial ports. set Specifies the baud rate for either the console or maintenance port on the controller card, where the decimal value designated is the baud rate.
Posted: Thu Sep 21 08:51:24 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.