5.21. Show, Clear, Debug, and Tools Command Reference
5.21.1. Command Hierarchies
5.21.1.1. Show Commands
5.21.1.2. Clear Commands
5.21.1.3. Debug Commands
5.21.1.4. Tools Commands
5.21.2. Command Descriptions
5.21.2.1. Show Commands
The command outputs in the following sections are examples only; actual displays may differ depending on supported functionality and user configuration.
alarm-contact-input
Syntax
Context
Description
This command displays the alarm contact input information.
Parameters
Output
Table 43: Alarm Contact Input Field Descriptions
Label | Description |
Alarm Contact Input Power | Indicates if the +24VDC output pin (optionally used to provide power for the alarm inputs) is enabled |
Current State | Indicate the configured administrative state of the input Disabled — the alarm-contact-input is disabled (shutdown) and log events will not be generated for changes to the input pin status Enabled — the alarm-contact-input is enabled (no shutdown) and log events will be generated for changes to the input pin status (as long as the log events are not suppressed in event-control configuration) |
Alarm Output Pin Used | Indicates the configured severity of the associated CHASSIS log event (for example, for pin 3: "configure log event-control" chassis" tmnxSasAlarminput3StateChanged) |
Alarm Raised | Indicates if the input pin is 'triggered' or not |
Last State Change | Indicates when the input pin last changed state |
card
Syntax
Context
Description
This command enables the context to display card information.
cpu
Syntax
Context
Description
This command displays CPU utilization per task over a sample period.
Parameters
Output
The following output is an example of CPU information, and Table 44 describes the output fields.
Table 44: System CPU Field Descriptions
Label | Description |
CPU Utilization | The total amount of CPU time. |
Name | The process or protocol name. |
CPU Time (uSec) | The CPU time each process or protocol has used in the specified time. |
CPU Usage | The sum of CPU usage of all the processes and protocols. |
Capacity Usage | Displays the level the specified service is being utilized. When this number hits 100%, this part of the system is busied out. There may be extra CPU cycles still left for other processes, but this service is running at capacity. This column does not reflect the true CPU utilization value; that data is still available in the CPU Usage column. This column is the busiest task in each group, where busiest is defined as either actually running or blocked attempting to acquire a lock. |
connections
Syntax
Context
Description
This command displays UDP and TCP connection information.
If no command line options are specified, a summary of the TCP and UDP connections displays.
Parameters
ipv4-address: | a.b.c.d (host bits must be 0) | |
ipv6-address: | x:x:x:x:x:x:x:x[-interface] | |
x:x:x:x:x:x:d.d.d.d[-interface] | ||
x: | [0 to FFFF]H | |
d: | [0 to 255]D | |
interface: 32 characters maximum, mandatory for link local addresses | ||
Output
Table 45: System Connections Field Descriptions
Label | Description |
Proto | Displays the socket protocol, either TCP or UDP. |
RecvQ | Displays the number of input packets received by the protocol. |
TxmtQ | Displays the number of output packets sent by the application. |
Local Address | Displays the local address of the socket. The socket port is separated by a period. |
Remote Address | Displays the remote address of the socket. The socket port is separated by a period. |
State | Listen — The protocol state is in the listen mode. Established — The protocol state is established. vRtrID — The virtual router identifier.
MSS — The TCP maximum segment size. |
cpu
Syntax
Context
Description
This command displays CPU utilization per task over a sample period.
Parameters
Output
The following output is an example of system CPU information, and Table 46 describes the output fields.
Table 46: System CPU Field Descriptions
Label | Description |
CPU Utilization | The total amount of CPU time. |
Name | The process or protocol name. |
CPU Time (uSec) | The CPU time each process or protocol has used in the specified time. |
CPU Usage | The sum of CPU usage of all the processes and protocols. |
Capacity Usage | Displays the level the specified service is being utilized. When this number hits 100%, this part of the system is busied out. There may be extra CPU cycles still left for other processes, but this service is running at capacity. This column does not reflect the true CPU utilization value; that data is still available in the CPU Usage column. This column is the busiest task in each group, where busiest is defined as either actually running or blocked attempting to acquire a lock. |
memory-pools
Syntax
Context
Description
This command displays the memory pools for the card.
cron
Syntax
Context
Description
This command enters the show CRON context.
action
Syntax
Context
Description
This command displays cron action parameters.
Parameters
Output
The following output is an example of cron action information, and Table 47 describes the output fields.
Table 47: Cron Action Field Descriptions
Label | Description |
Action | Displays the name of the action. |
Action owner | The name of the action owner. |
Administrative status | Enabled — Administrative status is enabled Disabled — Administrative status is disabled |
Script | The name of the script |
Script owner | The name of the script owner. |
Script source location | Displays the location of scheduled script. |
Max running allowed | Displays the maximum number of allowed sessions. |
Max completed run histories | Displays the maximum number of sessions previously run. |
Max lifetime allowed | Displays the maximum amount of time the script may run. |
Completed run histories | Displays the number of completed sessions. |
Executing run histories | Displays the number of sessions in the process of executing. |
Initializing run histories | Displays the number of sessions ready to run/queued but not executed. |
Max time run history saved | Displays the maximum amount of time to keep the results from a script run. |
Last change | Displays the system time a change was made to the configuration. |
schedule
Syntax
Context
Description
This command displays cron schedule parameters.
Parameters
Output
The following output is an example of cron schedule information, and Table 48 describes the output fields.
Table 48: Cron Schedule Field Descriptions
Label | Description |
Schedule name | Displays the schedule name. |
Schedule owner | Displays the owner name of the action. |
Description | Displays the schedule’s description. |
Administrative status | Enabled — The administrative status is enabled. Disabled — Administratively disabled. |
Operational status | Enabled — The operational status is enabled. Disabled — Operationally disabled. |
Action | Displays the action name |
Action owner | Displays the name of action owner. |
Script | Displays the name of the script. |
Script owner | Displays the name of the script. |
Script owner | Displays the name of the of script owner. |
Script source location | Displays the location of scheduled script. |
Script results location | Displays the location where the script results have been sent. |
Schedule type | Periodic — Displays a schedule which ran at a given interval. Calendar — Displays a schedule which ran based on a calendar. Oneshot — Displays a schedule which ran one time only. |
Interval | Displays the interval between runs of an event. |
Next scheduled run | Displays the time for the next scheduled run. |
Weekday | Displays the configured weekday. |
Month | Displays the configured month. |
Day of Month | Displays the configured day of month. |
Hour | Displays the configured hour. |
Minute | Displays the configured minute. |
Number of scheduled runs | Displays the number of scheduled sessions. |
Last scheduled run | Displays the last scheduled session. |
Number of scheduled failures | Displays the number of scheduled sessions that failed to execute. |
Last scheduled failure | Displays the last scheduled session that failed to execute. |
Last failure time | Displays the system time of the last failure. |
information
Syntax
Context
Description
This command displays general system information including basic system, SNMP server, last boot and DNS client information.
Output
The following output is an example of system information, and Table 49 describes the output fields.
The following is an example of the 7750 SR:
Table 49: System Information Field Descriptions
Label | Description |
System Name | The configured system name. |
System Contact | A text string that describes the system contact information. |
System Location | A text string that describes the system location. |
System Coordinates | A text string that describes the system coordinates. |
System Up Time | The time since the last boot. |
SNMP Port | The port number used by this node to receive SNMP request messages and to send replies. |
SNMP Engine ID | The SNMP engineID to uniquely identify the SNMPv3 node. |
SNMP Max Message Size | The maximum SNMP packet size generated by this node. |
SNMP Admin State | Enabled — SNMP is administratively enabled and running. Disabled — SNMP is administratively shutdown and not running. |
SNMP Oper State | Enabled — SNMP is operationally enabled. Disabled — SNMP is operationally disabled. |
SNMP Index Boot Status | Persistent — System indexes are saved between reboots. Not Persistent — System indexes are not saved between reboots. |
Telnet/SSH/FTP Admin | Displays the administrative state of the Telnet, SSH, and FTP sessions. |
Telnet/SSH/FTP Oper | Displays the operational state of the Telnet, SSH, and FTP sessions. |
BOF Source | The location of the BOF. |
Image Source | Primary — Indicates that the directory location for runtime image file was loaded from the primary source. Secondary — Indicates that the directory location for runtime image file was loaded from the secondary source. Tertiary — Indicates that the directory location for runtime image file was loaded from the tertiary source. |
Config Source | Primary — Indicates that the directory location for configuration file was loaded from the primary source. Secondary — Indicates that the directory location for configuration file was loaded from the secondary source. Tertiary — Indicates that the directory location for configuration file was loaded from the tertiary source. |
DNS Resolve Preference | ipv4-only — Dns-names are queried for A-records only. ipv6-first — Dns-server will be queried for AAAA-records first and a successful reply is not received, the dns-server is queried for A-records. |
Last Booted Config File | The URL and filename of the last loaded configuration file. |
Last Boot Cfg Version | The date and time of the last boot. |
Last Boot Config Header | Displays header information such as image version, date built, date generated. |
Last Boot Index Version | The version of the persistence index file read when this card was last rebooted. |
Last Boot Index Header | The header of the persistence index file read when this card was last rebooted. |
Last Saved Config | The location and filename of the last saved configuration file. |
Time Last Saved | The date and time of the last time configuration file was saved. |
Changes Since Last Save | Yes — There are unsaved configuration file changes. No — There are no unsaved configuration file changes. |
Time Last Modified | The date and time of the last modification. |
Max Cfg/BOF Backup Rev | The maximum number of backup revisions maintained for a configuration file. This value also applies to the number of revisions maintained for the BOF file. |
Cfg-OK Script | URL — The location and name of the CLI script file executed following successful completion of the boot-up configuration file execution. |
Cfg-OK Script Status | Successful/Failed — The results from the execution of the CLI script file specified in the Cfg-OK Script location. Not used — No CLI script file was executed. |
Cfg-Fail Script | URL — The location and name of the CLI script file executed following a failed boot-up configuration file execution. Not used — No CLI script file was executed. |
Cfg-Fail Script Status | Successful/Failed — The results from the execution of the CLI script file specified in the Cfg-Fail Script location. Not used — No CLI script file was executed. |
Management IP Addr | The management IP address and mask. |
DNS Server | The IP address of the DNS server. |
DNS Domain | The DNS domain name of the node. |
BOF Static Routes | To — The static route destination. Next Hop — The next hop IP address used to reach the destination. Metric — Displays the priority of this static route versus other static routes. None — No static routes are configured. |
lldp
Syntax
Context
Description
This command displays neighbor information for all configured ports without having to specify each individual port ID.
Parameters
Output
The following output is an example of LLDP neighbor information.
load-balancing-alg
Syntax
Context
Description
This command displays system load balancing settings.
Parameters
Output
The following output is an example of load balancing information.
memory-pools
Syntax
Context
Description
This command displays system memory status.
Output
The following output is an example of memory pool information, and Table 50 describes the output fields.
Table 50: System Memory-Pools Field Descriptions
Label | Description |
Name | The name of the system or process. |
Max Allowed | Integer — The maximum allocated memory size. No Limit — No size limit. |
Current Size | The current size of the memory pool. |
Max So Far | The largest amount of memory pool used. |
In Use | The current amount of the memory pool currently in use. |
Current Total Size | The sum of the Current Size column. |
Total In Use | The sum of the In Use column. |
Available Memory | The amount of available memory. |
ntp
Syntax
Context
Description
This command displays NTP protocol configuration and state.
Parameters
Output
The following output is an example of NTP information, and Table 51 describes the output fields.
Table 51: Show NTP Field Description
Label | Description |
Configured | |
Admin Status | yes — Administrative state is enabled. no — Administrative state is disabled. |
Server Enabled | |
Stratum | Displays stratum level of this node. |
Oper Status | yes — The operational state is enabled. no — The operational state is disabled. |
Auth Check | |
Clock Source | |
Displays the number of authentication errors. | |
Auth Errors Ignored | Displays the number of authentication errors ignored. |
Displays the number of key identification errors. | |
Auth Key Type Errors | Displays the number of authentication key type errors. |
Current Date & Time | |
vRouter | |
Router | |
Interface | |
Address | |
Type | |
Remote | The IP address of the remote NTP server or peer with which this local host is exchanging NTP packets. |
Reference ID | When stratum is between 0 and 15 this field shows the IP address of the remote NTP server or peer with which the remote is exchanging NTP packets. For reference clocks, this field shows the identification assigned to the clock, such as, “.GPS.” For an NTP server or peer, if the client has not yet synchronized to a server/peer, the status cannot be determined and displays the following codes: Peer Codes: ACST — The association belongs to any cast server. AUTH — Server authentication failed. Please wait while the association is restarted. AUTO — Autokey sequence failed. Please wait while the association is restarted. BCST — The association belongs to a broadcast server. CRPT— Cryptographic authentication or identification failed. The details should be in the system log file or the cryptostats statistics file, if configured. No further messages will be sent to the server. DENY — Access denied by remote server. No further messages will be sent to the server. DROP — Lost peer in symmetric mode. Please wait while the association is restarted. RSTR — Access denied due to local policy. No further messages will be sent to the server. INIT — The association has not yet synchronized for the first time. MCST — The association belongs to a manycast server. NKEY — No key found. Either the key was never installed or is not trusted. RATE — Rate exceeded. The server has temporarily denied access because the client exceeded the rate threshold. RMOT — The association from a remote host running ntpdc has had unauthorized attempted access. STEP — A step change in system time has occurred, but the association has not yet resynchronized. System Codes INIT — The system clock has not yet synchronized for the first time. STEP — A step change in system time has occurred, but the system clock has not yet resynchronized. |
St | Stratum level of this node. |
A | y — Authentication is enabled. n — Authentication is disabled. |
Poll | Polling interval. |
Offset | The time between the local and remote UTC time, in milliseconds. |
Time Last Request Rx | The time at which the last request was received from the client. |
port-topology
Syntax
Context
Description
Parameters
Output
ptp
Syntax
Context
Description
These commands display Precision Time Protocol (PTP) configuration and state information. This information can be displayed for the entire node or on a per router instance basis.
Output
The following output is an example of PTP information, and Table 52 describes the output fields.
Table 52: System PTP Field Descriptions
Label | Description |
Pending | When the SR/ESS has initiated a request to a peer but has not yet received a response. |
Granted | When the SR/ESS has initiated a request to a peer and it was granted OR a peer has made a request of the SR/ESS and it was granted. |
Denied | When the SR/ESS has initiated a request to a peer but it was rejected. |
Canceled | When a cancel message has been received from or transmitted toward a peer. |
Expired | When a unicast session between the SR/ESS and the peer has expired without being renewed. |
peer
Syntax
Context
Description
Parameters
Output
peers
Syntax
Context
Description
Parameters
Output
port
Syntax
Context
Description
Parameters
Output
standby
Syntax
Context
Description
Output
statistics
Syntax
Context
Description
Output
unicast
Syntax
Context
Description
Parameters
Output
The following output is an example of PTP unicast information.
rollback
Syntax
Context
Description
This command displays rollback configuration and state.
Parameters
Output
satellite
Syntax
Context
Description
Output
eth-sat
Syntax
Context
Description
Parameters
Output
tdm-sat
Syntax
Context
Description
Parameters
Output
port-map
Syntax
Context
Description
Parameters
Output
sync-if-timing
Syntax
Context
Description
Output
sntp
Syntax
Context
Description
This command displays SNTP protocol configuration and state.
Output
The following output is an example of SNTP information, and Table 53 describes the output fields.
Table 53: System SNTP Field Descriptions
Label | Description |
SNTP Server | The SNTP server address for SNTP unicast client mode. |
Version | The SNTP version number, expressed as an integer. |
Preference | Normal — When more than one time server is configured, one server can be configured to have preference over another. Preferred — Indicates that this server has preference over another. |
Interval | The frequency, in seconds, that the server is queried. |
thresholds
Syntax
Context
Description
This command displays system monitoring thresholds. The Threshold Events Log table will keep only the last 201 entries.
Output
The following output is an example of system threshold information, and Table 54 describes the output fields.
Table 54: System Thresholds Field Descriptions
Label | Description |
Variable | Displays the variable OID. |
Alarm Id | Displays the numerical identifier for the alarm. |
Last Value | Displays the last threshold value. |
Rising Event Id | Displays the identifier of the RMON rising event. |
Threshold | Displays the identifier of the RMON rising threshold. |
Falling Event Id | Displays the identifier of the RMON falling event. |
Threshold | Displays the identifier of the RMON falling threshold. |
Sample Interval | Displays the polling interval, in seconds, over which the data is sampled and compared with the rising and falling thresholds. |
SampleType | Displays the method of sampling the selected variable and calculating the value to be compared against the thresholds. |
Startup Alarm | Displays the alarm that may be sent when this alarm is first created. |
Owner | Displays the owner of this alarm. |
Description | Displays the event cause. |
Event Id | Displays the identifier of the threshold event. |
Last Sent | Displays the date and time the alarm was sent. |
Action Type | log — An entry is made in the RMON-MIB log table for each event occurrence. trap — A TiMOS logger event is generated. The TiMOS logger utility then distributes the notification of this event to its configured log destinations, which may be CONSOLE, telnet session, memory log, cflash file, syslog, or SNMP trap destinations logs. both — Both an entry in the RMON-MIB logTable and a TiMOS logger event are generated. none — No action is taken |
Owner | Displays the owner of the event. |
time
Syntax
Context
Description
This command displays the system time and zone configuration parameters.
Output
The following output is an example of system time information, and Table 55 describes the output fields.
Table 55: System Time Field Descriptions
Label | Description |
Date & Time | The system date and time using the current time zone. |
DST Active | Yes — Daylight Savings Time is currently in effect. No — Daylight Savings Time is not currently in effect. |
Zone | The zone names for the current zone, the non-DST zone, and the DST zone if configured. |
Current Time Zone | Indicates the process currently controlling the system time. SNTP, NTP, PTP or NONE. |
Zone type | Non-standard — The zone is user-defined. Standard — The zone is system defined. |
Offset from UTC | The number of hours and minutes added to universal time for the zone, including the DST offset for a DST zone. |
Offset from Non-DST | The number of hours (always 0) and minutes (0 to 60) added to the time at the beginning of Daylight Saving Time and subtracted at the end Daylight Saving Time. |
Starts | The date and time Daylight Saving Time begins. |
Ends | The date and time Daylight Saving Time ends. |
time
Syntax
Context
Description
This command displays the current day, date, time and time zone.
The time is displayed either in the local time zone or in UTC depending on the setting of the root level time-display command for the console session.
Output
The following output is an example of time information.
redundancy
Syntax
Context
Description
This command enables the context to show redundancy information.
mgmt-ethernet
Syntax
Context
Description
This command shows the management Ethernet port redundancy status. The show router “management” interface command also shows the CPM Ethernet port used by the management interface. If the primary CPM’s port is active, then it shows “A/1” under the Port field,. If the secondary CPM’s port is active, then it shows “B/1 -> A/1”in the Port field.
Output
The following output is an example of redundancy mgmt-Ethernet information, and Table 56 describes the output fields.
Show Router “Management” Interface Detail Output
The following is a sample output that shows “A/1” when the primary CPM’s Ethernet port is active and “B/1 ->A/1” if the secondary CPM’s port is active.
Table 56: Redundancy Mgmt-ethernet Field Descriptions
Label | Description |
Admin Status | Enabled — Administrative status is enabled. Disabled — Administratively disabled. |
Oper Status | Displays the CPM on which the management Ethernet port is operating. |
Revert Time | Displays the revert time. |
multi-chassis
Syntax
Context
Description
This command enables the context to show multi-chassis redundancy information.
all
Syntax
Context
Description
This command displays brief multi-chassis redundancy information.
Output
The following output is an example of multi-chassis all information, and Table 57 describes the output fields.
Table 57: Redundancy multi-chassis all Field Descriptions
Label | Description |
Peer IP Address | Displays the multi-chassis redundancy peer. |
Description | The text string describing the peer. |
Authentication | If configured, displays the authentication key used between this node and the MC peer. |
Source IP Address | Displays the source address used to communicate with the MC peer. |
Admin State | Displays the administrative state of the peer. |
mc-endpoint
Syntax
Context
Description
This command displays multi-chassis endpoint information.
Parameters
Output
The following output is an example of multi-chassis endpoint information.
mc-lag
Syntax
Context
Description
This command displays multi-chassis LAG information.
Parameters
Output
The following output is an example of mc-lag peer information, and Table 58 describes the output fields.
Table 58: Redundancy Multi-chassis MC-Lag Peer Field Descriptions
Label | Description |
Last Changed | Displays date and time of the last mc-lag peer. |
Admin State | Displays the administrative state of the mc-lag peer. |
Oper State | Displays the operation state of the mc-lag peer. |
KeepAlive | Displays the length of time to keep alive the mg-lag peer. |
Hold On Ngbr Failure | Specifies how many “keepalive” intervals the standby SR will wait for packets from the active node before assuming a redundant-neighbor node failure. |
The following output is an example of multi-chassis mc-lag peer statistics information, and Table 59 describes the output fields.
Table 59: Redundancy Multi-chassis MC-Lag Peer Statistics Field Descriptions
Label | Description |
Packets Rx | Indicates the number of MC-Lag packets received from the peer. |
Packets Rx Keepalive | Indicates the number of MC-Lag keepalive packets received from the peer. |
Packets Rx Config | Indicates the number of received MC-Lag configured packets from the peer. |
Packets Rx Peer Config | Indicates the number of received MC-Lag packets configured by the peer. |
Packets Rx State | Indicates the number of MC-Lag “lag” state packets received from the peer. |
Packets Dropped State Disabled | Indicates the number of packets that were dropped because the peer was administratively disabled. |
Packets Dropped Packets Too Short | Indicates the number of packets that were dropped because the packet was too short. |
Packets Dropped Tlv Invalid Size | Indicates the number of packets that were dropped because the packet size was invalid. |
Packets Dropped Tlv Invalid LagId | Indicates the number of packets that were dropped because the packet referred to an invalid or non multi-chassis lag. |
Packets Dropped Out of Seq | Indicates the number of packets that were dropped because the packet size was out of sequence. |
Packets Dropped Unknown Tlv | Indicates the number of packets that were dropped because the packet contained an unknown TLV. |
Packets Dropped MD5 | Indicates the number of packets that were dropped because the packet failed MD5 authentication. |
Packets Tx | Indicates the number of packets transmitted from this system to the peer. |
Packets Tx Keepalive | Indicates the number of keepalive packets transmitted from this system to the peer. |
Packets Tx Peer Config | Indicates the number of configured packets transmitted from this system to the peer. |
Packets Tx Failed | Indicates the number of packets that failed to be transmitted from this system to the peer. |
mc-ring
Syntax
Context
Description
This command displays multi-chassis ring information.
Parameters
Output
See the following sections for show command output:
The following output is an example of ip-address ring information, and Table 60 describes the output fields.
Table 60: Mc-ring peer ip-address Ring Field Descriptions
Label | Description |
Sync Tag | Displays the synchronization tag that was used while synchronizing this port with the multi-chassis peer. |
Oper State | noPeer — The peer has no corresponding ring configured. connected — The in-band control connection with the peer is operational. broken — The in-band control connection with the peer has timed out. conflict — The in-band control connection with the peer has timed out but the physical connection is still OK; the failure of the in-band signaling connection is caused by a misconfiguration. For example, a conflict between the configuration of this system and its peer, or a misconfiguration on one of the ring access node systems. testingRing — The in-band control connection with the peer is being set up. Waiting for result. waitingForPeer — Verifying if this ring is configured on the peer. configErr — The ring is administratively up, but a configuration error prevents it from operating properly. halfBroken — The in-band control connection indicates that the ring is broken in one direction (towards the peer). localBroken — The in-band control connection with the peer is known to be broken due to local failure or local administrative action. |
Oper state | shutdown — The ring is shutdown. |
Failure Reason | Displays the reason of the failure of the operational state of a MC ring. |
No. of MC Ring entries | Displays the number of MC ring entries. |
The following output is an example of multi-chassis ring peer statistics information, and Table 61 describes the output fields.
Table 61: Redundancy Multi-Chassis Ring Peer Statistics Field Descriptions
Label | Description |
Message | Displays the message type. |
Received | Indicates the number of valid MC-ring signaling messages received from the peer. |
Transmitted | Indicates the number of valid MC-ring signaling messages transmitted from the peer. |
MCS ID Request | Displays the number of valid MCS ID requests were received from the peer. |
MCS ID Response | Displays the number of valid MCS ID responses were received from the peer. |
Ring Exists Request | Displays the number of valid 'ring exists' requests were received from the peer. |
Ring Exists Response | Displays the number of valid ring exists' responses were received from the peer. |
Keepalive | Displays the number of valid MC-ring control packets of type 'keepalive' were received from the peer. |
The following output is an example of MC-ring information, and Table 62 and Table 63 describe the output fields.
Table 62: Mc-ring ring-node Command Field Descriptions
Label | Description |
Oper State | Displays the state of the connection verification (both local and remote). notProvisioned — Connection verification is not provisioned. configErr — Connection verification is provisioned but a configuration error prevents it from operating properly. notTested — Connection verification is administratively disabled or is not possible in the current situation. testing — Connection Verification is active, but no results are yet available. connected — The ring node is reachable. disconnected — Connection verification has timed out. |
In Use | Displays “True” if the ring node is referenced on an e-pipe or as an inter-dest-id on a static host or dynamic lease. |
Table 63: Mc-ring global-statistics Command Field Descriptions
Label | Description |
Rx | Displays the number of MC-ring signaling packets were received by this system. |
Rx Too Short | Displays the number of MC-ring signaling packets were received by this system that were too short. |
Rx Wrong Authentication | Displays the number of MC-ring signaling packets were received by this system with invalid authentication. |
Rx Invalid TLV | Displays the number of MC-ring signaling packets were received by this system with invalid TLV. |
Rx Incomplete | Displays the number of MC-ring signaling packets were received by this system that were incomplete. |
Rx Unknown Type | Displays the number of MC-ring signaling packets were received by this system that were of unknown type. |
Rx Unknown Peer | Displays the number of MC-ring signaling packets were received by this system that were related to an unknown peer. |
Rx Unknown Ring | Displays the number of MC-ring signaling packets were received by this system that were related to an unknown ring. |
Rx Unknown Ring Node | Displays the number of MC-ring signaling packets were received by this system that were related to an unknown ring node. |
Tx | Displays the number of MC-ring signaling packets were transmitted by this system. |
Tx No Buffer | Displays the number of MC-ring signaling packets could not be transmitted by this system due to a lack of packet buffers. |
Tx Transmission Failed | Displays the number of MC-ring signaling packets could not be transmitted by this system due to a transmission failure. |
Tx Unknown Destination | Displays the number of MC-ring 'unknown destination' signaling packets were transmitted by this system. |
Missed Configuration Events | Displays the number of missed configuration events on this system. |
Missed BFD Events | Displays the number of missed BFD events on this system. |
sync
Syntax
Context
Description
This command displays synchronization information.
Parameters
Output
See the following sections for sample output:
The following output is an example of multi-chassis sync information, and Table 64 describes the output fields.
Table 64: Redundancy Multi-chassis Sync Field Descriptions
Label | Description |
Peer IP Address | Displays the multi-chassis redundancy peer. |
Description | The text string describing the peer. |
Authentication | If configured, displays the authentication key used between this node and the multi-chassis peer. |
Source IP Address | Displays the source address used to communicate with the multi-chassis peer. |
Admin State | Displays the administrative state of the peer. |
Client Applications | Displays the list of client applications synchronized between SRs. |
Sync Admin State | Displays the administrative state of the synchronization. |
Sync Oper State | Displays the operation state of the synchronization. |
DB Sync State | Displays the database state of the synchronization. |
Num Entries | Displays the number of entries on local router. |
Lcl Deleted Entries | Displays the number of deleted entries made at the local router. |
Alarm Entries | Displays the alarm entries on the local router. |
Rem Num Entries | Displays the number of entries on the remote router. |
Rem Lcl Deleted Entries | Displays the number of locally deleting entries made by the remote router. |
Rem Alarm Entries | Displays alarm entries on the remote router. |
The following output is an example of multi-chassis sync peer information, and Table 65 describes the output fields.
Table 65: Redundancy Multi-chassis Sync Peer Field Descriptions
Label | Description |
Peer IP Address | Displays the multi-chassis redundancy peer. |
Description | The text string describing the peer. |
Authentication | If configured, displays the authentication key used between this node and the multi-chassis peer. |
Source IP Address | Displays the source address used to communicate with the multi-chassis peer. |
Admin State | Displays the administrative state of the peer. |
Client Applications | Displays the list of client applications synchronized between SRs. |
Sync Admin State | Displays the administrative state of the synchronization. |
Sync Oper State | Displays the operation state of the synchronization. |
DB Sync State | Displays the database state of the synchronization. |
Num Entries | Displays the number of entries on local router. |
Lcl Deleted Entries | Displays the number of deleted entries made at the local router. |
Alarm Entries | Displays the alarm entries on the local router. |
Rem Num Entries | Displays the number of entries on the remote router. |
Rem Lcl Deleted Entries | Displays the number of locally deleting entries made by the remote router. |
Rem Alarm Entries | Displays alarm entries on the remote router. |
The following output is an example of multi-chassis sync detail information, and Table 66 describes the output fields.
Table 66: Redundancy Multi-chassis Sync Peer Detail Field Descriptions
Label | Description |
Peer IP Address | Displays the multi-chassis redundancy peer. |
Description | The text string describing the peer. |
Authentication | If configured, displays the authentication key used between this node and the multi-chassis peer. |
Source IP Address | Displays the source address used to communicate with the multi-chassis peer. |
Admin State | Displays the administrative state of the peer. |
Client Applications | Displays the list of client applications synchronized between routers. |
Sync Admin State | Displays the administrative state of the synchronization. |
Sync Oper State | Displays the operation state of the synchronization. |
DB Sync State | Displays the database state of the synchronization. |
Num Entries | Displays the number of entries on local router. |
Lcl Deleted Entries | Displays the number of deleted entries made at the local router. |
Alarm Entries | Displays the alarm entries on the local router. |
Rem Num Entries | Displays the number of entries on the remote router. |
Rem Lcl Deleted Entries | Displays the number of locally deleting entries made by the remote router. |
Rem Alarm Entries | Displays alarm entries on the remote router. |
synchronization
Syntax
Context
Description
This command displays redundancy synchronization times.
Output
script-control
Syntax
Context
Description
This command enables the context to display script information.
script
Syntax
Context
Description
This command displays script parameters.
Parameters
Output
Table 67: Show Script Output
Label | Description |
Script | Displays the name of the script. |
Script owner | Displays the owner name of script. |
Administrative status | Enabled — Administrative status is enabled. Disabled — Administratively disabled. |
Operational status | Enabled — Operational status is enabled. Disabled — Operationally disabled. |
Script source location | Displays the location of scheduled script. |
Last script error | Displays the system time of the last error. |
Last change | Displays the system time of the last change. |
script-policy
Syntax
Context
Description
This command displays script policy information.
Parameters
Output
Table 68: Script Policy Output
Label | Description |
Script policy | Displays the name of the script policy. |
Script policy owner | The name of the script policy owner. |
Administrative status | Enabled — Administrative status is enabled. Disabled — Administrative status is disabled. |
Script | The name of the script. |
Script owner | The name of the script owner. |
Script source location | Displays the location of scheduled script. |
Max running allowed | Displays the maximum number of allowed sessions. |
Max completed run histories | Displays the maximum number of sessions previously run. |
Max lifetime allowed | Displays the maximum amount of time the script may run. |
Completed run histories | Displays the number of completed sessions. |
Executing run histories | Displays the number of sessions in the process of executing. |
Initializing run histories | Displays the number of sessions ready to run/queued but not executed. |
Max time tun history saved | Displays the maximum amount of time to keep the results from a script run. |
Last change | Displays the system time a change was made to the configuration. |
uptime
Syntax
Context
Description
This command displays the time since the system started.
Output
Table 69: Uptime Output
Label | Description |
System Up Time | Displays the length of time the system has been up in days, hr:min:sec format. |
switch-fabric
Syntax
Context
Description
This command displays switch fabric information.
Parameters
Output
The following is an example for the 7750 SR:
Table 70: Switch Fabric Output
Label | Description |
Slot/MDA | Displays the fabric slot within a chassis in the system. The CPM cards and XCM/IOM cards cannot be physically inserted into the switch fabric card slots. |
Min. Forwarding Capacity | Displays the minimum forwarding capacity of the slot and XMA/MDA as a percentage. |
Max. Forwarding Capacity | Displays the maximum forwarding capacity of the slot and XMA/MDA as a percentage. |
sync-if-timing
Syntax
Context
Description
This command displays synchronous interface timing operational information.
Parameters
Output
The following system example shows:
- sync-if timing, or
- sync-if-timing “A” when the SETS reference on the active CPM-A locks to BITS A, or
- sync-if-timing “B” when the SETS reference on the active CPM-B locks to BITS A
 | Note: The following output applies only to the 7750 SR-1e/2e/3e and 7950 XRS-16/20/40 platforms. |
The following system example shows:
- sync-if timing standby, or
- sync-if-timing “B” when the SETS reference on the standby CPM-B locks to Mate CPM (BITS A), or
- sync-if-timing “A” when the SETS reference on the standby CPM-A locks to Mate CPM (BITS A)
| Note: The following output applies only to the 7750 SR-1e/2e/3e and 7950 XRS-16/20/40 platforms. |
The following system example shows:
- sync-if timing, or
- sync-if-timing “A” when the SETS reference on the active CPM-A locks to BITS B, or
- sync-if-timing “B” when the SETS reference on the active CPM-B locks to BITS B
| Note: The following output applies only to the 7750 SR-1e/2e/3e and 7950 XRS-16/20/40 platforms. |
The following system example shows:
- sync-if timing standby, or
- sync-if-timing “B” when the SETS reference on the standby CPM-B locks to Mate CPM (BITS B), or
- sync-if-timing “A” when the SETS reference on the standby CPM-A locks to Mate CPM (BITS B)
| Note: The following output applies only to the 7750 SR-1e/2e/3e and 7950 XRS-16/20/40 platforms. |
Table 71: System Timing Output
Label | Description |
System Status CPM A/B | Indicates the present status of the synchronous timing equipment subsystem (SETS). Not Present — Only shown on systems without central clocks (7450 ESS-1) Master Freerun — The clock is in free-run because it hasn’t had a qualified input reference to lock to Master Holdover — The clock was locked to an input reference but has lost all qualified input references and is in holdover. Master Locked — The clock is locked to an input reference Acquiring — The clock is training to a qualified input reference. |
Reference Input Mode | Revertive — Indicates that for a re-validated or a newly validated reference source which has a higher priority than the currently selected reference has reverted to the new reference source. Non-revertive — The clock cannot revert to a higher priority clock if the current clock goes offline. |
Quality Level Selection | Indicates whether the ql-selection command has been enabled or disabled. If this command is enabled, then the reference is selected first using the QL value, then by the priority reference order. If this command is not enabled, then the reference is selected by the priority reference order. |
Reference Selected | Indicates which reference has been selected:
|
| |
System Quality Level | Indicates the quality level being generated by the system clock. |
Current Frequency Offset | (value) The frequency offset of the currently selected timing reference in parts per million. |
Reference Order | ref1, ref2, bits — Indicates that the priority order of the timing references. |
Reference Mate CPM | Data within this block represents the status of the timing reference provided by the Mate CPM. This will be the BITS input from the standby CPM. |
Admin Status | down — The ref1 or ref2 configuration is administratively shutdown. up — The ref1 or ref2 configuration is administratively enabled. diag — Indicates the reference has been forced using the force-reference command. |
Quality Level Override | Indicates whether the QL value used to determine the reference was configured directly by the user. |
Rx Quality Level | Indicates the QL value received on the interface.
|
Qualified for Use | Indicates whether the reference has been qualified to be used as a source of timing for the node. |
Not Qualified Due To | Indicates the reason why the reference has not been qualified:
|
Selected for Use | Indicates whether the method is presently selected. |
Not Selected Due To | Indicates the reason why the method is not selected:
|
Source Port | Identifies the Source port for the reference. |
Interface Type | The interface type configured for the BITS port. |
Framing | The framing configured for the BITS port. |
Line Coding | The line coding configured for the BITS port. |
Line Length | The line length value of the BITS output. |
Output Admin Status | down — The BITS output is administratively shutdown. up — The BITS output is administratively enabled. |
Output Source | The source to be used to provide the signal on the BITS output port. line reference — unfiltered recovered line reference. internal clock — filtered node clock output. |
Output Reference Selected | The reference selected as the source for the BITS output signal (ref1, ref2, or PTP). |
TX Quality Level | QL value for BITS output signal. |
synchronization
Syntax
Context
Description
This command displays redundancy synchronization times.
Output
Table 72: Synchronization Output
Label | Description |
Standby Status | Displays the status of the standby CPM. |
Last Standby Failure | Displays the timestamp of the last standby failure. |
Standby Up Time | Displays the length of time the standby CPM has been up. |
Failover Time | Displays the timestamp when the last redundancy failover occurred causing a switchover from active to standby CPM. If there is no redundant CPM card in this system or no failover has occurred since the system last booted, the value will be 0. |
Failover Reason | Displays a text string giving an explanation of the cause of the last redundancy failover. If no failover has occurred, an empty string displays. |
Boot/Config Sync Mode | Displays the type of synchronization operation to perform between the primary and secondary CPMs after a change has been made to the configuration files or the boot environment information contained in the boot options file (BOF). |
Boot/Config Sync Status | Displays the results of the last synchronization operation between the primary and secondary CPMs. |
Last Config File Sync Time | Displays the timestamp of the last successful synchronization of the configuration files. |
Last Boot Env Sync Time | Displays the timestamp of the last successful synchronization of the boot environment files. |
5.21.2.2. Debug Commands
sync-if-timing
Syntax
Context
Description
The context to debug synchronous interface timing references.
force-reference
Syntax
Context
Description
This command allows an operator to force the system synchronous timing output to use a specific reference.
The debug sync-if-timing force-reference command should only be used to test and debug problems. Network synchronization problems may appear if network elements are left with this manual override setting. Once the system timing reference input has been forced, it may be cleared using the no force-reference command.
The CPM clock can be forced to use a specific input reference using the force-reference command.
When the command is executed, the CPM clock on the active CPM immediately switches its input reference to that specified by the command. If the specified input is not available (shutdown), or in a disqualified state, the CPM clock shall use the next qualified input reference based on the selection rules.
This command also affects the BITS output port on the active CPM. If the BITS output port selection is set to line-reference and the reference being forced is not the BITS input port, then the system uses the forced reference to generate the signal out the BITS output port. If the BITS output port selection is set to internal-clock, then the system uses the output of the CPM clock to generate the signal for the BITS output port.
On a CPM activity switch, the force command is cleared and normal reference selection is determined.
Debug configurations are not saved between reboots.
The 7750 SR-c4 has two BITS input ports on the CFM. The force reference command on this system allows the selection of the specific port.
7750 SR-c4 CLI Syntax: debug>sync-if-timing>force-reference {ref1 | ref2 | bits | bits1 | bits a | bits b}
Parameters
system
Syntax
Context
Description
This command displays system debug information.
http-connections
Syntax
Context
Description
This command displays HTTP connections debug information.
Parameters
- x:x:x:x:x:x:x:x: (eight 16-bit pieces)
- x:x:x:x:x:x:d.d.d.d
- d [0 to 255] D
ntp
Syntax
Context
Description
This command enables and configures debugging for NTP.
The no form of the command disables debugging for NTP.
Parameters
persistence
Syntax
Context
Description
This command displays persistence debug information.
Parameters
ACNP | |
application-as | application-assurance |
dhcp-server | local DHCP server |
nat-fwds | NAT port forwarding |
submgt | subscriber management |
5.21.2.3. Tools Commands
redundancy
Syntax
Context
Description
This command enables the context to dump redundancy parameters.
multi-chassis
Syntax
Context
Description
This command enables the context to dump multi-chassis parameters.
mc-endpoint
Syntax
Context
Description
This command dumps multi-chassis endpoint information.
Parameters
Output
The following output is an example of multi-chassis peer endpoint information.
mc-ring
Syntax
Context
Description
This command dumps multi-chassis ring information.
Parameters
srrp-sync-database
Syntax
Context
Description
This command dumps SRRP database information and applies to the 7450 ESS.
Parameters
sync-database
Syntax
Context
Description
This command dumps MCS database information.
Parameters
dhcp-server: | local dhcp server |
igmp: | Internet group management protocol |
igmp-snooping: | igmp-snooping |
mc-ring | multi-chassis ring |
L2TP | |
mld-snooping: | multicast listener discovery-snooping |
srrp: | simple router redundancy protocol |
sub-host-trk: | subscriber host tracking |
mc-ipsec | multi-chassis IPsec |
python | Python cache |
diameter-proxy | diameter proxy |
pim-snpg-sap | protocol independent multicast snooping for SAP |
pim-snpg-sdp | protocol independent multicast snooping for SDP |
src-bmac-lsb
Syntax
Context
Description
resource-usage
Syntax
Context
Description
This command enables the context to display system resource information, such as policers, including data for total, available, and free numbers for each resource.
card
Syntax
Context
Description
This command displays resource information for cards.
Parameters
fp
Syntax
Context
Description
This command displays resource information for FPs.
Parameters
mda
Syntax
Context
Description
This command displays resource information for MDAs.
Parameters
system
Syntax
Context
Description
This command displays resource information for resources that are managed at the system level.
Parameters
system-resources
Syntax
Context
Description
The system-resources command has been deprecated and replaced by the tools>dump>resource-usage command. The system-resources command continues to be supported in the current release, but it is recommended to use the resource-usage command instead.
This command displays system resource information.
Parameters
chassis
Syntax
Context
Description
The following command performs chassis maintenance operations.
Parameters
set-role
Syntax
Context
Description
This command sets the role of the 7950 XRS chassis from which the command is invoked.
- When run on a standalone chassis this will update the EEPROM on the (one) Chassis backplane.
- Master and Extension chassis are blocked if any SFMs are configured as type sfm-x20 (must be sfm-x20-b). The following message displays:
- When the extension option is specified, the chassis will immediately reboot as part of the command. The following warning and prompt will be provided:WARNING: You are about to provision the chassis as an XRS-40 Extension chassis.This chassis will immediately reboot after the command is executed. No CLI shell isavailable directly on an Extension chassis. An Extension chassis will not completelyboot up unless it is properly cabled to and controlled by an XRS-40 Masterchassis. Do you wish to proceed (yes/no) ?
- When the master option is specified, the chassis will immediately reboot as part of the command. The Operational mode is not changed until a reboot is performed. The following warning and prompt will be provided:WARNING: You are about to provision the chassis as an XRS-40 Master chassis. This chassis will immediately reboot after the command isexecuteDo you wish to proceed (yes/no) ?
- When the master or extension options are specified and the chassis has any SFM slots with a configured type of sfm-x20, then the command will fail with the following message:Configured sfm-type of sfm-x20 is not compatible with XRS-40 mode operation.If you want to change the role of the chassis anyways, you can deconfigure the SFMs and then change the role.
redundancy
Syntax
Context
Description
forced-single-sfm-overload
Syntax
Context
Description
issu-post-process
Syntax
Context
Description
mgmt-ethernet
Syntax
Context
Description
This command triggers redundancy mode, just as if the management Ethernet port of the primary CPM has gone down. The router will revert if the management Ethernet port of the primary CPM has been up for the revert duration.
mixed-mode-upgrade
Syntax
Context
Description
This command initiates the upgrade process to enable mixed-mode in a 7450 ESS-7 or ESS-12.
Executing this command will (as one action), enable the system state of mixed-mode and enable SR capabilities on the IOMs or IMMs located in the slots specified in the slot list. This will result in rebooting of the IOMs and IMMs located in the specified slots.
If any of the slots contain 7450 ESS IOMs, this command will fail.
This command can only be used to enable the mixed-mode state. It can not be used to reverse the state.
Parameters
system
Syntax
Context
Description
sfm-interco-test
Syntax
Context
Description
Use this command to run inter-chassis SFM loopback tests for the 7950 XRS.
Run on an out-of-service standalone chassis that will later become the Extension chassis of an XRS-40 system. The out of service chassis (Chassis 1 – future Master chassis) must be connected by means of SFM interconnect links (cable bundles) before this test is run. This test operates without requiring any XCMs in either chassis, but they can be present.
The test should not be initiated from Chassis 1.
The following conditions must be satisfied for the test to be permitted:
- The system must be in standalone mode; error message:
- The system must have only XRS-40 compatible SFMs provisioned; error message:
- All provisioned SFMs must be operational; error message:
- The same test cannot be running in another session (i.e. only one test can be executed at a time); error message:
Other notes (which are also relayed to the operator when the test is attempted):
- All provisioned XCMs will be reset at the start of the test and will be held in the booting state until the test has completed.
- All SFMs will be cleared when the operator exits the test. This will trigger a reset of the XCMs and the standby CPM.
Output
script-control
Syntax
Context
Description
script-policy
Syntax
Context
Description
stop
Syntax
Context
Description
This command stops the execution of scripts.
Parameters
set-fabric-speed
Syntax
Context
Description
This command sets fabric speed for the 7750 SR. With the introduction of SFM5-12e and the mini-SFM5-12e, a new tools command (set-fabric-speed) was added to set the fabric operating speed. (tools command does not apply to SFM4-12e) fabric-speed-a).
Parameters
snmp
Syntax
Context
Description
walk
Syntax
Context
Description
This command performs SNMP MIB walk.
Parameters
- x:x:x:x:x:x:x:x [-interface]
- x:x:x:x:x:x:d.d.d.d [-interface]
- d – [0 to 255] D
xmpp
Syntax
Context
Description
vsd-refresh
Syntax
Context
Description
5.21.2.4. Clear Commands
application-assurance
Syntax
Context
Description
This command clears application assurance commands.
group
Syntax
Context
Description
This command clears application assurance group data.
Parameters
statistics
Syntax
Context
Description
status
Syntax
Context
Description
redundancy
Syntax
Context
Description
This command enables the context to clear redundancy parameters.
multi-chassis
Syntax
Context
Description
This command enables the context to clear multi-chassis parameters.
mc-endpoint
Syntax
Context
Description
This command clears multi-chassis endpoint statistics.
Parameters
mc-lag
Syntax
Context
Description
This command clears multi-chassis Link Aggregation Group (LAG) information.
Parameters
mc-ring
Syntax
Context
Description
This command clears multi-chassis ring data.
debounce
Syntax
Context
Description
This command clears multi-chassis ring operational state debounce history.
Parameters
ring-nodes
Syntax
Context
Description
This command clears multi-chassis ring unreferenced ring nodes.
Parameters
statistics
Syntax
Context
Description
This command clears multi-chassis ring
global
Syntax
Context
Description
This command clears multi-chassis ring global statistics.
peer
Syntax
Context
Description
This command clears multi-chassis ring peer statistics.
Parameters
ring
Syntax
Context
Description
This command clears multi-chassis ring statistics.
Parameters
ring-node
Syntax
Context
Description
This command clears multi-chassis ring statistics.
Parameters
sync-database
Syntax
Context
Description
This command clears multi-chassis sync database information.
Parameters
all: | All supported applications |
dhcp-server: | local dhcp server |
igmp: | internet group management protocol |
igmp-snooping: | igmp-snooping |
mc-ring: | multi-chassis ring |
mld-snooping: | multicast listener discovery-snooping |
srrp: | simple router redundancy protocol |
sub-host-trk | subscriber host tracking |
sub-mgmt: | subscriber management |
all | All supported applications |
igmp-snooping | igmp-snooping |
mc-ring | multi-chassis ring |
mld-snooping | multicast listener discovery-snooping |
sub-host-trk | subscriber host tracking |
sub-mgmt | subscriber management |
screen
Syntax
Context
Description
This command allows an operator to clear the Telnet or console screen.
system
Syntax
Context
Description
This command allows an operator to clear system information.
ptp
Syntax
Context
Description
This command enables the context to clear Precision Timing Protocol (PTP) information.
inactive-peers
Syntax
Context
Description
This command clears inactive peer information.
peer
Syntax
Context
Description
This command clears PTP peer information.
Parameters
port
Syntax
Context
Description
This command clears PTP port information.
Parameters
statistics
Syntax
Context
Description
This command clears all PTP statistics.
script-control
Syntax
Context
Description
This command enables the context to clear script information.
script-policy
Syntax
Context
Description
This command enables the context to clear script policy information.
completed
Syntax
Context
Description
This command clears completed script run history entries.
Parameters
statistics
Syntax
Context
Description
This command clears system specific statistics.
xmpp
Syntax
Context
Description
This command clears XMPP server statistics.
Parameters
sync-if-timing
Syntax
Context
Description
This command allows an operator to individually clear (re-enable) a previously failed reference. As long as the reference is one of the valid options, this command is always executed. An inherent behavior enables the revertive mode which causes a re-evaluation of all available references.
Parameters
trace
Syntax
Context
Description
This command clears commands for traces.