5. Tools
5.1. Tools Command Reference
5.1.1. Command Hierarchies
5.1.1.1. Tools Dump Commands
5.1.1.2. Tools Perform Commands
5.1.1.3. Tools ADP Commands
5.1.2. Command Descriptions
5.1.2.1. Tools Generic Commands
tools
Syntax
Context
Description
This command enables the context to use tools for debugging purposes.
Default
n/a
5.1.2.2. Tools Dump Commands
5.1.2.2.1. Dump Commands
dump
Syntax
Context
Description
This command enables the context to display information for debugging purposes.
Default
n/a
auto-discovery
Syntax
Context
Description
This command allows you to view all progress and event logs stored by ADP.
Default
n/a
Parameters
cflowd
Syntax
Context
Description
This command enables dump tools for Cflowd.
Default
n/a
cache
Syntax
Context
Description
This command displays the contents of the Cflowd active cache. This information can be displayed either in raw form where every flow entry is displayed or in an aggregated form.
Default
n/a
Parameters
src-dst-proto — aggregates the active flow cache based on the source and destination IP address and the IP protocol value
src-dst-proto-port — aggregates the active flow cache based on the source and destination IP address, IP protocol value, and the source and destination port numbers
ipv4 — displays the IPv4 flow data
ipv6 — displays the IPv6 flow data
Output
The following output is an example of Cflowd cache information, and Table 39 describes the fields.
Table 39: Tools Dump Cflowd Cache Field Descriptions
Label | Description |
Proto | The IPv4 or IPv6 protocol type |
Source Address | The source IP address of the flow (IPv4 or IPv6) |
Destination Address | The destination IP address of the flow (IPv4 or IPv6) |
Intf/Ingr | The ingress interface associated with the sampled flow (only displayed with the raw (all) output) |
Intf/Egr | The egress interface associated with the sampled flow (only displayed with the raw (all) output) |
S-Port | The source protocol port number |
D-Port | The destination protocol port number |
Pkt-Cnt | The total number of packets sampled for the associated flow |
Byte-Cnt | The total number of bytes of traffic sampled for the associated flow |
Start | The system time when the first packet was sampled for the associated flow |
Flags | The IP flag value from the sampled IP flow header (only displayed with the raw (all) output) |
ToS | The ToS byte values from the sampled IP flow header (only displayed with the raw (all) output) |
(Src) Mask | The IP route mask for the route to the flow source IP address associated with the flow (only displayed with the raw (all) output) |
(Dst) Mask | The IP route mask for the route to the flow destination IP address associated with the flow (only displayed with the raw (all) output) |
(Src) AS | The ASN associated with the route to the flow source IP address associated with the flow (only displayed with the raw (all) output) |
(Dst) AS | The ASN associated with the route to the flow destination IP address associated with the flow (only displayed with the raw (all) output) |
vRtr-ID | The Virtual Router ID associated with the reported IP flow (only displayed with the raw (all) output) |
packet-size
Syntax
Context
Description
This command displays packet size distribution for sampled IP traffic. Values are displayed in decimal format (1.0 = 100%, .500 = 50%). Separate statistics are maintained and shown for IPv4 and IPv6 traffic.
The clear option clears the cache after the packet size statistics are displayed.
Default
n/a
Parameters
Output
The following output is an example of Cflowd packet size information.
top-flows
Syntax
Context
Description
This command displays the top 20 (highest traffic volume) flows for IPv4, IPv6, or MPLS traffic types collected since the Cflowd top-flow table was last cleared or initialized.
The clear option clears the cache after the packet size statistics are displayed.
Default
n/a
Parameters
Output
The following output is an example of Cflowd top flow information, and Table 40 describes the fields.
Table 40: Tools Dump Cflowd Top Flows Field Descriptions
Label | Description |
Intf/Ingr | The ingress interface ID |
SrcIP | The source IP address of the flow (IPv4 or IPv6) |
Intf/Egr | The egress interface ID |
DstIP | The destination IP address of the flow (IPv4 or IPv6) |
Pro | The protocol type for the flow |
ToS | The Type of Service/DSCP bits field markings |
Flgs | The protocol flag markings |
Pkts | The total number of packets sampled for this flow since the statistics were last cleared |
I-vRtr-ID | The vRouter context the flow was sampled in |
S-Port | The source protocol port number |
Mask | The route prefix length for route to source IP address |
AS | The autonomous systems number for the source route (the AS is either the originating AS or peer AS depending on the Cflowd configuration) |
D-Port | The destination protocol port number |
Mask | The route prefix length for route to destination IP address (forwarding route) |
AS | The autonomous systems number for the destination route (the AS is either the originating AS or peer AS depending on the Cflowd configuration) |
NextHop | The next-hop address used to forward traffic associated with the flow |
Pkt-Size | The average packet size of sampled traffic associated with this flow (total number of packets sampled/volume of traffic sampled) |
Time | The number of seconds the flow has been active |
top-protocols
Syntax
Context
Description
This command displays the summary information for the top 20 protocol traffic flows in the Cflowd cache. All statistics are calculated based on the data collected since the last clearing of the Cflowd statistics.
If the clear option clears the cache after the top protocol statistics are displayed.
Default
n/a
Parameters
Output
The following output is an example of Cflowd top protocol traffic information, and Table 41 describes the fields.
Table 41: Tools Dump Cflowd Top Protocols Field Descriptions
Label | Description |
Protocol ID | The IPv4 or IPv6 protocol type. The protocol ID is either the protocol name or the decimal protocol number. |
Total Flows | The total number of flows recorded since the last clearing of Cflowd statistics with this protocol type |
Flows/Sec | The average number of flows detected for the associated protocol type (Total flows/number of seconds since last clear) |
Packets/Flow | The average number of packets per flow (Total number of packets/total flows) |
Bytes/Pkt | The average number of bytes per packet for the associated protocol type (Total number of bytes for the associated protocol/total number of packets for the associated protocol) |
Packets/Sec | The average number of packets for the associated protocol type (Number of packets/number of seconds since last clear) |
Duration/Flow | The average lifetime of a flow for the associated protocol type (Number of seconds since last clear/total flows) |
% Total Bandwidth | The percentage of bandwidth consumed by the associated protocol type (Total protocol bytes/total bytes of all flows) |
control-queues
Syntax
Context
Description
This command displays information about failed control queues.
Default
n/a
Output
The following output is an example of control queue failures, and Table 42 describes the fields.
Table 42: Control Queues Failures Field Descriptions
Label | Description |
Ingress SF queue | The ingress control queue |
Size | The size of the control queue, in packets |
Free | The remaining space in the control queue |
Buf Alloc Failures | The number of recorded control queue failures |
eth-ring
Syntax
Context
Description
This command displays Ethernet ring information.
Default
n/a
Parameters
gnss
Syntax
Context
Description
This command displays GNSS satellite signal strength information.
Default
n/a
Parameters
Output
The following output is an example of GNSS information.
lag
Syntax
Context
Description
This command displays Link Aggregation Group (LAG) information.
Default
n/a
Parameters
ldp-treetrace
Syntax
Context
Description
This command displays treetrace information. The prefix command displays automated treetrace results only if ldp-treetrace is enabled at the oam-test level. The manual-prefix command displays results discovered by a previously run ldp-treetrace manual test.
Path information displayed by the ldp-treetrace command supports SNMP. The 7705 SAR stores this information in the TIMETRA-OAM-TEST-MIB tmnxOamLTraceHopInfoTable object.
Default
n/a
Parameters
Output
The following outputs are examples of ldp-treetrace information.
Note: The tools dump ldp-treetrace prefix command displays entries only if ldp-treetrace is enabled using the configure test-oam ldp-treetrace no shutdown CLI command.
The following example shows automated ldp-treetrace results. This command collects all information but displays a summary of the ECMP paths indexed by the path destination (PathDst), which is the IP address used in the LSP Ping message to probe a specific ECMP path to the destination FEC.
The following example shows an automated ldp-treetrace with a path destination. This command displays the details of the label stack at each hop by filtering on a specific ECMP path.
mpls-resources
Syntax
Context
Description
This command displays FEC-to-NHLFE (next hop label forwarding entry) and ILM (incoming label message) information for MPLS.
Default
n/a
persistence
Syntax
Context
Description
This command enables the context to display persistence information.
Default
n/a
dhcp-server
Syntax
Context
Description
This command displays persistence information for the DHCP server.
Default
n/a
Parameters
Output
The following output is an example of DHCP server persistence information, and Table 43 describes the fields.
Table 43: DHCP Server Persistence Field Descriptions
Label | Description |
Filename | The name and location of the persistence information file |
ClientDescr | The description of the client |
UserDataSize | The size of the user data, in bytes |
DataPadding | The size of the data padding, in bytes |
NumberOfEntries | The number of entries in the persistence information file It is a combination of leases given and may also contain DHCP servers configured |
FileSize | The total size of records in the persistence information file, in blocks of 512 bytes |
Version | The version of the persistence information file |
Entries in use | The number of entries currently in use |
State | The state of the persistence information file |
Key | The record key number |
Last Update | The date and time of the last record update |
Action | The action taken during the last record update |
Data | |
service Id | The service ID number |
server | The DHCP server name |
IP | The IP address of the lease |
MAC | The MAC address associated with the lease |
XID | The transaction ID (XID) used in DHCPDISCOVER packets |
start time | The start time and date of the current lease |
expires | The expiry time and date of the current lease |
failctrl | The failure control (not supported on the 7705 SAR) |
opt60 len | The length of the DHCP option 60 message |
opt82 len | The length of the DHCP option 82 message |
summary
Syntax
Context
Description
This command displays persistence summary information.
Default
n/a
Output
The following output is an example of persistence summary information, and Table 44 describes the fields.
Table 44: Persistence Summary Field Descriptions
Label | Description |
Client | The name of the client |
Location | The name and location of the persistence information file |
Entries in use | The number of entries in use |
Status | The status of the persistence information file |
port
Syntax
Context
Description
This command displays invalid Layer 2 packets that have been discarded for the specified port. Reasons for packet discards include an invalid VLAN identifier or an invalid Etype. The CLI shows the header for the invalid VLAN identifier and invalid Etype.
Default
n/a
Parameters
ppp
Syntax
Context
Description
This command displays PPP information for a port.
Default
n/a
Parameters
Syntax: port-id slot/mda/port[.channel]
bundle bundle-type-slot/mda.bundle-num
bundle keyword
type ima, ppp
bundle-num 1 to 32
service
Syntax
Context
Description
This command enables the context to display service information.
Default
n/a
evpn
Syntax
Context
Description
This command displays the consumed EVPN resources for the system or for a specified service.
Output
The following output is an example of EVPN usage for the system and a specified service.
For the system:
For a specific service:
id
Syntax
Context
Description
This command enables the context to display information for the specified service.
Default
n/a
Parameters
evpn-mpls
Syntax
Context
Description
This command displays the EVPN-MPLS data for the specified service.
Parameters
ip-transport
Syntax
Context
Description
This command enables the context to display information for a specific IES or VPRN IP transport subservice.
Default
n/a
Parameters
remote-host
Syntax
Context
Description
This command displays information for a TCP connection check to a remote host for the specified service.
Default
n/a
Parameters
loopback
Syntax
Context
Description
This command displays loopback information for a SAP or an SDP bind for the specified service.
Default
n/a
sap
Syntax
Context
Description
This command displays loopback information for a specified SAP in the specified service.
Default
n/a
Parameters
null | [port-id | bundle-id | lag-id | aps-id | mw-link-id] |
dot1q | [port-id | lag-id | aps-id | mw-link-id]:qtag1 |
qinq | [port-id | lag-id]:qtag1.qtag2 |
port-id | slot/mda/port[.channel] |
lag-id | lag-id lag keyword id 1 to 32 |
qtag1 | *, 0 to 4094 |
qtag2 | *, 0 to 4094 |
sdp
Syntax
Context
Description
This command displays loopback information for a specified SDP binding in the specified service.
Default
n/a
Parameters
sap
Syntax
Context
Description
This command displays SAP information for the specified service.
Default
n/a
Parameters
null | [port-id | bundle-id | lag-id | aps-id | mw-link-id] |
dot1q | [port-id | lag-id | aps-id | mw-link-id]:qtag1 |
qinq | [port-id | lag-id]:qtag1.qtag2 |
atm | [port-id | aps-id][:vpi/vci |vpi | vpi1.vpi2] |
frame | [port-id | aps-id]:dlci |
cisco-hdlc | slot/mda/port.channel |
cem | slot/mda/port.channel |
ipcp | slot/mda/port.channel |
ima-grp | bundle-id[:vpi/vci | vpi | vpi1.vpi2] |
hdlc | slot/mda/port.channel |
port-id | slot/mda/port[.channel] |
SCADA bridge | slot/mda/bridge-id.branch-id bridge-id 1 to 16 branch-id 1 to 32 |
bundle-id | bundle-type-slot/mda.bundle-num bundle keyword type ima, ppp bundle-num 1 to 32 |
aps-id | aps-group-id[.channel] aps keyword group-id 1 to 24 |
mw-link-id | mw-link-id id 1 to 24 |
lag-id | lag-id lag keyword id 1 to 32 |
qtag1 | *, 0 to 4094 |
qtag2 | *, 0 to 4094 |
vpi | NNI 0 to 4095 UNI 0 to 255 |
vci | 1, 2, 5 to 65535 |
dlci | 16 to 1022 |
tunnel-id | tunnel-id.[private | public]:tag tunnel keyword id 1 to 16 (“1” is the only valid value) tag 0 to 4094 |
Output
The following output is an example of the discard statistics, and Table 45 describes the fields.
Table 45: Service SAP Field Descriptions
Label | Description |
total number of discarded packets | The total number of discarded ingress or egress packets for the specified SAP or SDP binding |
total number of discarded bytes | The total number of discarded ingress bytes for the specified SAP or SDP binding |
number of discards due to source suppression | The total number of ingress discards due to source suppression for the specified SAP or SDP binding |
number of discards due to split horizon | The total number of ingress discards due to split horizon for the specified SAP or SDP binding |
number of discards due to mesh to mesh | The total number of ingress discards due to mesh-to-mesh forwarding for the specified mesh SDP |
number of discards due to unknown DA | The total number of ingress discards due to an unknown destination address for the specified SAP or SDP binding |
number of discards due to unknown SA | The total number of ingress discards due to an unknown source address for the specified SAP or SDP binding |
number of discards due to service MTU | The total number of ingress discards due to the packet size exceeding the configured maximum transmission unit for the specified SAP or SDP binding |
number of discards due to STP not in fwding state | The total number of ingress discards due to an inactive VPLS endpoint determined by the Spanning Tree Protocol for the specified SAP |
number of other discards | The total number of ingress or egress discards that do not match a listed category |
number of unicast discards due to pool exhaustion | The total number of egress unicast discards due to pool exhaustion for the specified SAP or SDP binding |
number of multicast discards due to pool exhaustion | The total number of egress multicast discards due to pool exhaustion for the specified SAP or SDP binding |
number of unicast discards due to queue overflow | The total number of egress unicast discards due to queue overflow for the specified SAP or SDP binding |
number of multicast discards due to queue overflow | The total number of egress multicast discards due to queue overflow for the specified SAP or SDP binding |
sdp
Syntax
Context
Description
This command displays SDP binding information for the specified service.
Default
n/a
Parameters
ipsec-tunnel
Syntax
Context
Description
This command displays the IPSec tunnel information.
Parameters
Output
The following output is an example of IPSec tunnel information, and Table 46 describes the fields.
Table 46: IPSec Tunnel Field Descriptions
Field | Description |
Outbound Discard Stats: | |
Security policy misses | The number of outbound packets discarded because of a security policy miss that can occur when a clear text packet source or destination IP address does not match any security policy entry for the IPSec tunnel. Discards are due to either an incorrect policy configuration or a packet that should have been denied entry to the tunnel. |
Invalid security association | The number of outbound packets discarded because of an invalid security association (SA). Discards can be due to an IKE failure to negotiate the SA, an incorrect configuration in the SA for manual keying, or incomplete IPSec tunnel negotiation. |
Sequence number wrap errors | The number of outbound packets discarded because the IPSec tunnel anti-replay sequence number has exceeded the maximum value allowed prior to completion of an SA re-keying |
Buffer exhaustion errors | The number of outbound packets discarded because buffers were not available before packets were sent to the encryption engine queue. This condition can occur when the encrypting MDA is experiencing buffer congestion. |
IP-frag buffer exhaustion errors | The number of outbound packets discarded because buffers were not available when fragmentation occurred before encryption on the packet. This condition can occur when the encrypting MDA is experiencing buffer congestion. |
Enqueue errors | The number of outbound packets discarded because the encryption engine queue was full. This condition can occur when the encrypting MDA is experiencing buffer congestion. |
Tunnel peer-ip-address not reachable | The number of outbound packets discarded because a route to the peer gateway IP address cannot be found. This can occur due to a network design issue or a temporary network outage. |
Tunnel peer-ip-address next-hop not reachable via IP | The number of outbound packets discarded because the IPSec tunnel peer gateway route next hop is not in the supported IP next-hop or MPLS tunnel next-hop list. This can occur due to a network design issue or a temporary network outage. |
Egress uplink interface does not support encryption | The number of outbound packets discarded because the outgoing interface for this IPSec tunnel is on an MDA that does not have encryption hardware. This can be due to a network design issue. |
Drop Too Big/Df-set Pkts | The number of outbound packets discarded because a clear text packet cannot be fragmented when the do-not-fragment (DF) flag is set in the IP packet header and the outgoing IP interface MTU is too small for the encrypted packet |
Other discards | The number of outbound packets discarded because of miscellaneous internal errors related to:
|
Inbound Discard Stats: | |
Authentication failures | The number of inbound packets discarded because of an inability to authenticate the packet with the current authentication key |
Security policy misses | The number of inbound packets discarded because either:
|
NATT UDP ports mismatch (src/dst) | The number of inbound packets discarded because the source or destination UDP port for NAT-T is different from the configured UDP port |
IP Proto mismatch | The number of inbound packets discarded because of an IP protocol mismatch that can occur when NAT-T is configured and the protocol is not UDP or when NAT-T is not configured and the protocol is not ESP |
Tunnel and SPI cross validation errors | The number of inbound packets discarded because the source or destination IP address of an encrypted packet does not match the expected IPSec gateway source or destination IP address for the SPI |
IP fragmented packets (Unsupported) | The number of inbound packets discarded because the encrypted packet was fragmented. Fragmentation is not supported on IPSec encrypted packets. |
Padding failures | The number of inbound packets discarded because a padding error was detected on the encrypted packet |
NULL SeqNum | The number of inbound packets discarded because the sequence number is 0 (invalid as per RFC 4303) |
Enqueue errors | The number of inbound packets discarded because the decryption engine queue is full. This condition can occur when the decrypting MDA is experiencing buffer congestion. |
Sequence number too old in window (Anti-Replay) | The number of inbound packets discarded because the sequence number is lower than the lowest sequence number in the anti-replay window and therefore is considered too old |
Duplicated sequence number in window (Anti-Replay) | The number of inbound packets discarded because a packet’s sequence number is duplicated. Duplicate sequence numbers are not allowed in an anti-replay window. |
Buffer exhaustion errors | The number of inbound packets discarded because buffers were not available before packets were sent to the decryption engine queue. This condition can occur when the decrypting MDA is experiencing buffer congestion. |
Other discards | The number of inbound packets discarded because of miscellaneous internal errors related to:
|
loopback
Syntax
Context
Description
This command displays all active Ethernet SAP loopbacks on the node. Only internal loopback mode is supported.
Default
n/a
system
Syntax
Context
Description
This command enables the context for service system information.
bgp-evpn
Syntax
Context
Description
This command enables the context for BGP-EVPN service system information.
ethernet-segment
Syntax
Context
Description
This command displays information on the computed DF PE for a specified EVI.
Parameters
Output
The following output is an example of Ethernet segment information.
vpls-fdb-stats
Syntax
Context
Description
This command displays the VPLS FDB statistics.
Parameters
Output
The following output is an example of VPLS FDB statistics, and Table 47 describes the fields.
system-limits
Syntax
Context
Description
This command displays the resource limits of the current system configuration.
 | Note: The system-limits command is only available on the following 7705 SAR systems:
|
Default
n/a
Output
The following output is an example of system limits information, and Table 47 describes the fields.
Table 47: System-Limits Field Descriptions
Label | Description |
IPv4 FIB Table Size | The maximum number of IPv4 addresses allowed in the forwarding information base table (FIB). IPv4 router interfaces that are on cards equipped with hardware to support larger tables will have a higher maximum number of addresses than on cards that are not equipped with this hardware. |
IPv6 FIB Table Size | The maximum number of IPv6 addresses allowed in the forwarding information base table (FIB). IPv6 router interfaces that are on cards equipped with hardware to support larger tables will have a higher maximum number of addresses than on cards that are not equipped with this hardware. |
Max Number of Network Interfaces | The maximum number of IPv4 network interfaces allowed on an adapter card |
Max Number of Service Interfaces | The maximum number of IPv4 service interfaces allowed on an adapter card |
Max Number of Total Interfaces | The maximum number of total IPv4 interfaces allowed on a system |
Max Number of IPv6 Network Interfaces | The maximum number of IPv6 network interfaces allowed on an adapter card |
Max Number of IPv6 Service Interfaces | The maximum number of IPv6 service interfaces allowed on an adapter card |
Max Number of IPv6 Total Interfaces | The maximum number of total IPv6 interfaces allowed on a system |
VPRN Instances Supported | The total number of VPRN instances that are supported |
VPLS Instances Supported | The total number of VPLS instances that are supported |
Max Number of BGP Peers | The maximum number of BGP peers |
Max Number of IP/Mac Filters | The maximum number of IP/MAC filters |
system-resources
Syntax
Context
Description
This command displays system resource information.
Default
n/a
Parameters
Output
The following output is an example of system resources information, and Table 48 describes the fields.
Table 48: System-Resources Field Descriptions
Label | Description |
Access Ingress Queues | The number of access ingress queues allowed on an adapter card (total, allocated, and free) |
Egress Queues | The number of egress queues allowed on an adapter card (total, allocated, and free) |
Access Egress Queues | The number of access egress queues allowed on an adapter card (total, allocated, and free) |
Network Egress Queues | The number of network egress queues allowed on an adapter card (total, allocated, and free) |
SAP Objects | The number of SAP objects allowed on an adapter card (total, allocated, and free) |
VPLS SAP Objects | The number of VPLS SAP objects allowed on an adapter card (total, allocated, and free) |
Network Interfaces | The number of network interfaces allowed on an adapter card (total, allocated, and free) |
Filters | The number of filters allowed on an adapter card (total, allocated, and free) |
Service Interfaces | The number of service interfaces allowed on an adapter card (total, allocated, and free) |
IpV6 Network Interfaces | The number of IPv6 network interfaces allowed on an adapter card (total, allocated, and free) |
IpV6 Service Interfaces | The number of IPv6 service interfaces allowed on an adapter card (total, allocated, and free) |
Shaper Groups | The number of shaper groups allowed on an adapter card (total, allocated, and free) |
testhead
Syntax
Context
Description
This command displays Y.1564 test head debug statistics.
Default
n/a
Parameters
5.1.2.2.2. Dump Test-OAM Commands
test-oam
Syntax
Context
Description
This command enables the context to display operations, administration, and maintenance information.
Default
n/a
testhead
Syntax
Context
Description
This command displays Y.1564 test head debug statistics.
Default
n/a
Parameters
twamp
Syntax
Context
Description
This command displays server information, specifically the number of protocol errors, for the TWAMP server. The output includes statistics for dropped connections, dropped connection states, rejected sessions, and dropped test packets.
Default
n/a
5.1.2.2.3. Dump Router Commands
router
Syntax
Context
Description
This command enables tools for the router instance.
Default
n/a
Parameters
bgp
Syntax
Context
Description
This command enables dump tools for BGP.
Default
n/a
routes
Syntax
Context
Description
This command displays information for BGP routes.
Default
n/a
Parameters
file-url: | local-url | remote-url | |
local-url: | [cflash-id/][file-path] 200 chars max, including cflash-id directory length 99 chars max each | |
remote-url: | [{ftp:// | tftp://}login:pswd@remote- locn][file-path] 255 chars max directory length 99 chars max each | |
remote-locn: | [hostname | ipv4-address | ipv6-address] | |
ipv4-address: | a.b.c.d | |
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 chars max, for link local addresses | |
cflash-id: | (7705 SAR-18) cf1: | cf1-A: | cf1-B: | cf2: | cf2-A: | cf2-B: | cf3: | cf3-A: | cf3-B: (7705 SAR-8 Shelf V2) cf3: | cf3-A: | cf3-B: (7705 SAR fixed platforms) cf3: | cf3-A: |
fib
Syntax
Context
Description
This command displays information for the FIB.
Default
n/a
Parameters
ldp
Syntax
Context
Description
This command enables dump tools for LDP.
Default
n/a
fec
Syntax
Context
Description
This command displays information for an LDP FEC.
Default
n/a
Parameters
VC types are derived according to IETF draft-martini-l2circuit-trans-mpls.
instance
Syntax
Context
Description
This command displays information for an LDP instance.
Default
n/a
interface
Syntax
Context
Description
This command displays information for an LDP interface.
Default
n/a
Parameters
memory-usage
Syntax
Context
Description
This command displays memory usage information for LDP.
Default
n/a
peer
Syntax
Context
Description
This command displays information for an LDP peer.
Default
n/a
Parameters
session
Syntax
Context
Description
This command displays information for an LDP session.
Default
n/a
Parameters
sockets
Syntax
Context
Description
This command displays information for all sockets being used by the LDP protocol.
Default
n/a
timers
Syntax
Context
Description
This command displays timer information for LDP.
Default
n/a
mpls
Syntax
Context
Description
This command enables the context to display MPLS information.
Default
n/a
ftn
Syntax
Context
Description
This command displays FEC-to-NHLFE (FTN) dump information for MPLS. (NHLFE is the acronym for Next Hop Label Forwarding Entry.)
Default
n/a
Parameters
ilm
Syntax
Context
Description
This command displays incoming label map (ILM) information for MPLS.
Default
n/a
Parameters
lspinfo
Syntax
Context
Description
This command displays LSP information for MPLS.
Default
n/a
Parameters
memory-usage
Syntax
Context
Description
This command displays memory usage information for MPLS.
Default
n/a
ospf
Syntax
Context
Description
This command enables the context to display tools information for OSPF.
Default
n/a
ospf3
Syntax
Context
Description
This command enables the context to display tools information for OSPFv3.
Default
n/a
abr
Syntax
Context
Description
This command displays area border router (ABR) information for OSPF.
Default
n/a
Parameters
area-range
Syntax
Context
Description
This command displays area range information for OSPF.
Default
n/a
asbr
Syntax
Context
Description
This command displays autonomous system boundary router (ASBR) information for OSPF.
Default
n/a
Parameters
bad-packet
Syntax
Context
Description
This command displays information about bad packets for OSPF.
Default
n/a
Parameters
leaked-routes
Syntax
Context
Description
This command displays information about leaked routes for OSPF.
Default
summary
Parameters
memory-usage
Syntax
Context
Description
This command displays memory usage information for OSPF.
Default
n/a
Parameters
request-list
Syntax
Context
Description
This command displays request list information for OSPF.
Default
n/a
Parameters
retransmission-list
Syntax
Context
Description
This command displays dump retransmission list information for OSPF.
Default
n/a
Parameters
route-summary
Syntax
Context
Description
This command displays dump route summary information for OSPF.
Default
n/a
route-table
Syntax
Context
Description
This command displays dump information about routes learned through OSPF.
Default
n/a
Parameters
sham-bad-packet
Syntax
Context
Description
This command displays OSPFv2 sham link bad packets.
Parameters
sr-adjacencies
Syntax
Context
Description
This command displays OSPFv2 segment routing (SR) adjacency information.
Parameters
sr-database
Syntax
Context
Description
This command displays OSPFv2 segment routing (SR) database information.
Parameters
pim
Syntax
Context
Description
This command enables the context to display PIM information.
Default
n/a
iom-failures
Syntax
Context
Description
This command displays information about failures in programming IOMs.
Unlike the 7750 SR, when the maximum number of groups per node is exceeded, any additional groups are not stored at the CSM layer and an alarm is raised immediately.
Default
n/a
Parameters
rsvp
Syntax
Context
Description
This command enables the context to display tools information for RSVP.
Default
n/a
neighbor
Syntax
Context
Description
This command displays neighbor information for RSVP.
Default
n/a
Parameters
psb
Syntax
Context
Description
This command displays path state block (PSB) information for RSVP.
When a PATH message arrives at an LSR, the LSR stores the label request in the local PSB for the LSP. If a label range is specified, the label allocation process must assign a label from that range.
The PSB contains the IP address of the previous hop, the session, the sender, and the TSPEC. This information is used to route the corresponding RESV message back to LSR 1.
Default
n/a
Parameters
rsb
Syntax
Context
Description
This command displays RSVP Reservation State Block (RSB) information.
Default
n/a
Parameters
segment-routing
Syntax
Context
Description
This command enables the context to display tools information for segment routing.
tunnel
Syntax
Context
Description
This command displays segment routing tunnel information.
static-route
Syntax
Context
Description
This command enables the context to display tools information for static routes.
Default
n/a
ldp-sync-status
Syntax
Context
Description
This command displays the status of the LDP synchronization timers for static routes.
Default
n/a
te-database
Syntax
Context
Description
This command displays information for the traffic engineering database.
Default
n/a
Parameters
isis
Syntax
Context
Description
This command displays information for the IS-IS traffic engineering database.
Default
n/a
Parameters
ospf
Syntax
Context
Description
This command displays information for the OSPF traffic engineering database.
Default
n/a
Parameters
5.1.2.3. Tools Perform Commands
5.1.2.3.1. Perform Commands
perform
Syntax
Context
Description
This command enables the context to specify tools to perform specific tasks.
Default
n/a
aps
Syntax
Context
Description
This command enables the context to perform APS operations.
Default
n/a
clear
Syntax
Context
Description
This command removes all APS operational commands.
Default
n/a
Parameters
exercise
Syntax
Context
Description
This command performs an exercise request on the protection or working circuit.
Default
n/a
Parameters
force
Syntax
Context
Description
This command forces a switch to either the protection or working circuit.
Default
n/a
Parameters
lockout
Syntax
Context
Description
This command locks out the protection circuit in the specified APS group.
Default
n/a
Parameters
request
Syntax
Context
Description
This command requests a manual switch to either the protection or working circuit.
Default
n/a
Parameters
cron
Syntax
Context
Description
This command enables the context to perform CRON (scheduling) control operations.
Default
n/a
action
Syntax
Context
Description
This command enables the context to stop the execution of a script started by CRON action. See the stop command.
Default
n/a
stop
Syntax
Context
Description
This command stops execution of a script started by CRON action.
Default
n/a
Parameters
cflowd
Syntax
Context
Description
This command enables the context to perform Cflowd control operations.
Default
n/a
manual-export
Syntax
Context
Description
This command manually exports Cflowd flow data.
eth-ring
Syntax
Context
Description
This command enables the context to perform Ethernet ring operations.
Default
n/a
clear
Syntax
Context
Description
This command is used for the following operations on an Ethernet ring node:
- clearing an active local administrative command (for example, forced switch or manual switch)
- triggering reversion before the WTR or WTB timer expires in case of revertive operation
- triggering reversion in case of non-revertive operation
Default
n/a
Parameters
force
Syntax
Context
Description
This command forces a block on the ring port where the command is issued.
Default
n/a
Parameters
manual
Syntax
Context
Description
In the absence of a failure or FS, this command forces a block on the Ethernet ring port where the command is issued.
Default
n/a
Parameters
ima
Syntax
Context
Description
This command enables the context to perform IMA operations.
Default
n/a
reset
Syntax
Context
Description
This command resets an IMA bundle in the startup state.
Default
n/a
Parameters
Syntax: bundle-ima-slot/mda.bundle-num
bundle-ima keyword
bundle-num 1 to 32
lag
Syntax
Context
Description
This command configures tools to control LAG.
Default
n/a
clear-force
Syntax
Context
Description
This command clears a forced status.
Default
n/a
Parameters
force
Syntax
Context
Description
This command forces an active or standby status.
Default
n/a
Parameters
lcr
Syntax
Context
Description
This command enables the context to perform T1/E1 Line Card Redundancy (LCR) operations.
Default
n/a
clear
Syntax
Context
Description
This command removes all LCR operational commands from either the protection adapter card or the working adapter card in the specified LCR group.
Default
n/a
Parameters
force
Syntax
Context
Description
This command forces activity away from either the protection adapter card or the working adapter card in the specified LCR group.
Default
n/a
Parameters
lockout
Syntax
Context
Description
This command locks out the protection adapter card. Locking out the protection card means that activity can not be switched to the protection card even if the working adapter card has failed.
Default
n/a
Parameters
log
Syntax
Context
Description
This command enables event logging tools.
Default
n/a
test-event
Syntax
Context
Description
This command generates a test event.
Default
n/a
mda-table-refresh
Syntax
Context
Description
This command causes a complete FIB refresh. The command can be used to restore a FIB that is in a failed state. For information on FIB failures, refer to the 7705 SAR Router Configuration Guide, “Troubleshooting the FIB”.
Default
n/a
mw
Syntax
Context
Description
This command enables the context to perform microwave operations.
Default
n/a
clear
Syntax
Context
Description
This command removes all microwave link operational commands.
Default
n/a
Parameters
force
Syntax
Context
Description
This command forces the spare MPR-e radio to become the main MPR-e radio in a 1+1 HSB configuration, even though it might not be in a fit state to assume the role. Once a forced switch operation is issued, it overrides any manual switch or automatic switch operation that is already in place.
Default
n/a
Parameters
lockout
Syntax
Context
Description
This command prevent the spare MPR-e radio in a 1+1 HSB configuration from ever becoming the main radio, even when the main MPR-e radio fails.
Default
n/a
Parameters
manual
Syntax
Context
Description
This command attempts to switch the main/spare status of an MPR-e radio in a 1+1 HSB configuration; however, should certain operational conditions pertaining to the radio channel or radio hardware not allow the switchover (such as port failures, equipment failures, and reception failures), an automatic switch operation overriding the manual switch attempt is triggered.
Default
n/a
Parameters
software-download
Syntax
Context
Description
This command performs a software download to all MPR-e radios in the system that are not currently running the correct software. The software is downloaded to the inactive software bank of the MPR-e radios, in preparation of a software upgrade (the command does not activate a system upgrade).
This command allows operators to minimize outage times during a 7705 SAR system software upgrade (with Microwave Awareness). Before the software upgrade is performed, the operator runs this command to download the software to the radios while they are in service. Next, the operator performs the software upgrade. During the 7705 SAR system reboot, the new radio software is activated at the same time as the new system software, thus allowing both the system software and the MPR-e radio software to boot into the new load simultaneously.
Default
n/a
Parameters
ptp
Syntax
Context
Description
This command resets a PTP clock that is transmitting and receiving PTP messages using IPv4 or IPv6 encapsulation or using Ethernet encapsulation.
Default
n/a
Parameters
security
Syntax
Context
Description
This command provides tools for testing security.
Default
n/a
authentication-server-check
Syntax
Context
Description
This command checks connection to the RADIUS server.
Default
n/a
Parameters
ipv4-address | a.b.c.d |
ipv6-address | x:x:x:x:x:x:x:x (eight 16-bit pieces) x:x:x:x:x:x:d.d.d.d x: [0 to FFFF]H d: [0 to 255]D |
file-url: | local-url | remote-url | |
local-url: | [cflash-id/][file-path] 200 chars max, including cflash-id directory length 99 chars max each | |
remote-url: | [{ftp:// | tftp://}login:pswd@remote- locn][file-path] 255 chars max directory length 99 chars max each | |
remote-locn: | [hostname | ipv4-address | ipv6-address] | |
ipv4-address: | a.b.c.d | |
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 chars max, for link local addresses | |
cflash-id: | (7705 SAR-18) cf1: | cf1-A: | cf1-B: | cf2: | cf2-A: | cf2-B: | cf3: | cf3-A: | cf3-B: (7705 SAR-8 Shelf V2) cf3: | cf3-A: | cf3-B: (7705 SAR fixed platforms) cf3: | cf3-A: |
service
Syntax
Context
Description
This command enables the context to configure tools for services.
id
Syntax
Context
Description
This command enables the context to configure tools for a specific service.
Parameters
endpoint
Syntax
Context
Description
This command enables the context to configure tools for a specific service endpoint.
Parameters
force-switchover
Syntax
Context
Description
This command forces a switch of the active spoke SDP for the specified service.
Parameters
ip-transport
Syntax
Context
Description
This command enables the context to configure tools for a specific IES or VPRN IP transport subservice.
Parameters
remote-host
Syntax
Context
Description
This command establishes a TCP connection to the remote host. The connection is torn down upon being successfully established. This command does not abide by the max-retries or retry-interval configured for the IP transport subservice; only one connection attempt, with a timeout of 5 seconds, is made when this command is executed.
If a TCP connection is already established to the remote host, this command does not impact that connection. It returns a successful status indication, with an explanation that a TCP connection was already established.
Default
n/a
Parameters
sap
Syntax
Context
Description
This command performs a one-time ADC analysis on a TDM PW without having to shut down the service. This analysis is done with live traffic (that is, not with all-ones or the idle-payload-fill value). If the difference between the calculated average latency and the expected latency is greater than the threshold-repeat value configured with the asym-delay-control command, octets are added or dropped as necessary.
The service must already be enabled for ADC. If ADC repeat is also enabled on the service when this command is run, the timer for the next repeat period starts when the on-demand analysis ends.
Default
n/a
Parameters
cem | port-id|bridge-id |
port-id | slot/mda/port |
bridge-id | slot/mda/bridge.branch |
system
Syntax
Context
Description
This command enables the context to use tools that control the system.
script-control
Syntax
Context
Description
This command enables the script-control context to access script policy commands.
script-policy
Syntax
Context
Description
This command enables the script-policy context to access script policy tools.
stop
Syntax
Context
Description
This command stops the execution of scripts.
Parameters
5.1.2.3.2. Perform Router Commands
router
Syntax
Context
Description
This command enables tools for the router instance.
Default
n/a
Parameters
isis
Syntax
Context
Description
This command enables the context to perform specific IS-IS tasks.
Default
n/a
Parameters
mpls
Syntax
Context
Description
This command enables the context to perform specific MPLS tasks.
Default
n/a
cspf
Syntax
Context
Description
This command computes a CSPF path with specified user constraints.
Default
n/a
Parameters
resignal
Syntax
Context
Description
This command resignals specified LSP paths. The minutes parameter is used to configure the global timer to resignal all LSPs. The resignal timer is the time before resignaling occurs after the resignal condition occurs. If only lsp-name and path-name are provided, the specified LSP is resignaled immediately. For the delay option to work, the resignal time in the config>router>mpls context must be set.
Default
n/a
Parameters
resignal-bypass
Syntax
Context
Description
This command performs a manual reoptimization of a specific dynamic or manual bypass LSP or of all dynamic bypass LSPs.
The manual bypass LSP name is user-configured. The dynamic bypass LSP name is shown in the output of the show>router>mpls>bypass-tunnel dynamic detail command.
The delay option triggers the global reoptimization of all dynamic bypass LSPs at the expiry of the specified delay. This option forces the global bypass resignal timer to expire after an amount of time equal to the value of the delay parameter.This option does not apply to a manual bypass LSP.
When a bypass LSP name is specified, that dynamic or manual bypass LSP is not signaled and the associations are not evaluated even if the new bypass LSP path has the same cost as the current one. This is a different behavior from the resignal command for the primary or secondary path of an LSP, because a bypass LSP can have a large number of PSB associations.
If the specified LSP is a manual bypass LSP with no PSB associations, the LSP is torn down and resignaled using the new path provided by CSPF. If there are one or more PSB associations but the PLR is not active, the command fails and the user is asked to explicitly enter the force option. In this case, the manual bypass LSP is torn down and resignaled, leaving the associated LSP primary paths temporarily unprotected. If there are any active PLRs associated with the manual bypass LSP, the command fails
Default
n/a
Parameters
sr-te-cspf
Syntax
Context
Description
This command computes and returns the segment routing label stack for any user-specified MPLS path to a destination router.
MPLS passes the specified path information to the TE-DB, which converts the list of hops into a label stack by scanning the database for adjacency and node SID information that belongs to the router or link identified by each hop address. If the conversion is successful, the database will return the actual selected hop SIDs plus labels, as well as the configured path hop addresses that were used as the input for this conversion.
Parameters
trap-suppress
Syntax
Context
Description
This command modifies thresholds for trap suppression. The command is used to suppress traps after the specified number of traps has been raised within the specified period of time.
Default
n/a
Parameters
update-path
Syntax
Context
Description
This command instructs MPLS to replace the path of a primary or secondary LSP. The primary or secondary LSP path is indirectly identified with the current-path-name value. The same path name cannot be used more than once for an LSP name.
This command applies to both a CSPF LSP and a non-CSPF LSP. The command only works when the specified current-path-name has the adaptive option enabled. The adaptive option can be enabled at the LSP level or the path level.
The new path must have been configured in the CLI or provided via SNMP. The CLI command for entering the path is config>router>mpls>path path-name.
The command fails if any of the following conditions exist:
- the specified current-path-name of this LSP does not have the adaptive option enabled
- the specified new-path-name value does not correspond to a previously defined path
- the specified new-path-name value exists but is being used by any path of the same LSP, including this one
When you execute this command, MPLS performs the following procedures.
- MPLS performs a single MBB attempt to move the LSP path to the new path.
- If the MBB is successful, MPLS updates the new path.
- MPLS writes the corresponding NHLFE in the data path if this path is the current backup path for the primary path.
- If the current path is the active LSP path, MPLS will update the path and write the new NHLFE in the data path, which will cause traffic to switch to the new path.
- If the MBB is not successful, the path retains its current value.The update-path MBB has the same priority as the manual resignal MBB.
Parameters
ospf
Syntax
Context
Description
This command enables the context to perform specific OSPF tasks.
Default
n/a
ldp-sync-exit
Syntax
Context
Description
This command terminates IGP-LDP synchronization. OSPF or IS-IS then advertises the actual cost value of the link for all interfaces that have IGP-LDP synchronization enabled, if the currently advertised cost is different.
Default
n/a
refresh-lsas
Syntax
Context
Description
This command refreshes LSAs for OSPF.
Default
n/a
Parameters
run-manual-spf
Syntax
Context
Description
This command runs the shortest path first (SPF) algorithm for OSPF or IS-IS.
The externals-only parameter applies only to OSPF.
Default
n/a
Parameters
5.1.2.4. Tools ADP Commands
auto-discovery
Syntax
Context
Description
This command is used to control ADP while it is running.
The retry keyword restarts ADP if it has been halted due to errors. Executing this command clears the rejected DHCP server list for all ports and retries any processing that failed.
The terminate keyword terminates ADP and removes the ADP keyword from the BOF. The router returns to normal operations and any temporary configuration is removed. Network configuration and remote access remain enabled to allow the router to be manually provisioned remotely. ADP will not run again on future system restarts unless it is re-enabled via the CLI.
Default
n/a
Parameters
auto-discovery echo
Syntax
Context
Description
This command enables ADP echoing, which sends periodic updates to the console. The default is for ADP to echo progress summaries and major events. For troubleshooting, the optional debugger parameter causes ADP to echo detailed progress reports with events and timestamps. The command reverts to the default settings each time ADP is run on the system.
The no form of this command disables ADP echoing.
Default
auto-discovery echo