Tools

Syntax

dump

Context

tools

Description

This command enables the context to display information for debugging purposes.

Default

n/a

Syntax

auto-discovery [detail] [log]

Context

tools>dump

Description

This command allows you to view all progress and event logs stored by ADP.

Default

n/a

Parameters

detail

displays detailed information about the system, ports, and ADP instructions

log

displays all detailed progress and event logs with timestamps

Syntax

cflowd

Context

tools>dump

Description

This command enables dump tools for cflowd.

Default

n/a

Syntax

cache aggregate {src-dst-proto | src-dst-proto-port} family {ipv4 | ipv6}

cache all family {ipv4 | ipv6}

Context

tools>dump>cflowd

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

all

displays the raw active cache flow data with no aggregation.

aggregate

displays the aggregated active cache flow data

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

family

specifies which IP address family flow data should be displayed

ipv4 — displays the IPv4 flow data

ipv6 — displays the IPv6 flow data

Output

The following output is an example of cflowd cache information, and Tools Dump Cflowd Cache Field Descriptions describes the fields.

*A:NOK1>config>router# /tools dump cflowd cache aggregate src-dst-proto family ipv4 
Cache dump aggregation in progress, please wait...
Current time: 03/21/2019 17:15:46
--------------------------------------------------------------------------------
Proto     Source Address                         Pkt-Cnt    Start
          Destination Address                    Byte-Cnt
--------------------------------------------------------------------------------
TCP       10.40.1.5                              11741      03/21/2019 17:13:35
          3.1.38.1                               2700430   
--------------------------------------------------------------------------------

Syntax

packet-size protocol [clear]

Context

tools>dump>cflowd

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

protocol

specifies the type of cflowd packet information to display

Values

ipv4 | ipv6 | mpls | mcast-ipv4 | mcast-ipv6

clear

clears the cache after the packet size statistics are displayed

Output

The following output is an example of cflowd packet size information.

NOK-12# tools dump cflowd packet-size ipv4
 IP packet size distribution (801600 total packets):
   1-32   64   96  128  160  192  224  256  288  320  352  384  416  448  480
   .000 .250 .000 .000 .010 .100 .500 .090 .000 .000 .000 .000 .000 .000 .000

    512  544  576 1024 1536 2048 2560 3072 3584 4096 4608 9000
   .000 .000 .000 .050 .000 .000 .000 .000 .000 .000 .000 .000

Syntax

top-flows protocols [clear]

Context

tools>dump>cflowd

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

protocols

specifies the type of cflowd packet information to display

Values

ipv4 | ipv6 | mpls | mcast-ipv4 | mcast-ipv6

clear

clears the cache after the packet size statistics are displayed

Output

The following output is an example of cflowd top flow information, and Tools Dump Cflowd Top Flows Field Descriptions describes the fields.

*A:7705:Dut-A# tools dump cflowd top-flows ipv4
The top 20 IPv4 unicast flows seen by cflowd are:
     Current Time: 04/01/2019 17:44:17
Last Cleared Time: 04/01/2019 17:38:36
   ifIndexContext: global
Intf/Ingr  SrcIP             Intf/Egr  DstIP                         Pro     ToS
I-vRtrID   S-Port Msk AS     E-vRtrID  D-Port Msk AS                Flgs    Pkts
                                       NextHop                  Pkt-Size    Time
--------------------------------------------------------------------------------
2          150.2.1.2         1         150.1.1.2                       6    0x00
1          10     /24 300    1         20     /24 200               0x00      25
                                       1.20.1.2                       46       0
--------------------------------------------------------------------------------

*A:7705:Dut-A# tools dump cflowd top-flows ipv6
The top 20 IPv6 unicast flows seen by cflowd are:
     Current Time: 04/01/2019 17:44:24
Last Cleared Time: 04/01/2019 17:38:36
   ifIndexContext: global
SrcIP                                      Intf/Ingr    S-Port   I-vRtrID    ToS
DstIP                                      Intf/Egr     D-Port   E-vRtrID  Flags
Nexthop                                   Pkts         Pkt-Size Proto      Time
--------------------------------------------------------------------------------
::9602:102                                 2            10       1          0x03
::9601:102                                 1            20       1          0x00
::114:102                                 25            60       6             0
--------------------------------------------------------------------------------
*A:7705:Dut-

Syntax

top-protocols protocols [clear]

Context

tools>dump>cflowd

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

protocols

specifies the type of cflowd packet information to display

Values

ipv4 | ipv6 | mpls | mcast-ipv4 | mcast-ipv6

clear

clears the cache after the packet size statistics are displayed

Output

The following output is an example of cflowd top protocol traffic information, and Tools Dump Cflowd Top Protocols Field Descriptions describes the fields.

NOK1# tools dump cflowd top-protocols 

The top 20 IPv4 protocols seen by cflowd are:
      Current Time: 08/29/2011 15:36:15
Last Cleared Time: 08/29/2011 15:35:08
Protocol ID     Total   Flows   Packets   Bytes   Packets   Duration   % Total
--------        Flows    /Sec     /Flow    /Pkt      /Sec      /Flow   Bandwidth
--------------------------------------------------------------------------------
UDP                 2       0         6     100         0          6         75%
pr1                 1       0         6      64         0          6         24%
--------------------------------------------------------------------------------
TOTALS              3       0         6      88         0          6        100%

Syntax

control-queues failures

Context

tools>dump

Description

This command displays information about failed control queues.

Default

n/a

Output

The following output is an example of control queue failures, and Control Queues Failures Field Descriptions describes the fields.

*A:NOK1# /tools dump control-queues failures

Ingress SF queue          Size    Free    Buf Alloc Failures
------------------------------------------------------------
MDA Startup               1250    1250                     0
SF Large High priority    1024    1024                     0
SF Small High priority    8192    8192                     0
SF Large Med priority     1024    1024                     0
SF Small Med priority     8192    8192                     0
SF Large Low priority     1024    1024                     0
SF Small Low priority     8192    8192                     0
SF Cflowd                 8192    8192                     0

Syntax

eth-ring ring-index [clear]

Context

tools>dump

Description

This command displays Ethernet ring information.

Default

n/a

Parameters

ring-index

specifies an Ethernet ring index

clear

clears stored information for the specified Ethernet ring

Syntax

gnss port-id

Context

tools>dump

Description

This command displays GNSS satellite signal strength information.

Default

n/a

Parameters

port-id

specifies the port ID in the format slot/mda/port

Output

The following output is an example of GNSS information.

A:ALU-1># tools dump gnss 1/3/1
======================
Satellites
======================
SVID  Signal-Strength
      C/No (dB-Hz)
----------------------
31    50
23    48
29    47
26    45
16    45
3     45
9     44
14    42
74    40
27    40
22    40
75    33
65    31
83    26
84    24
----------------------
Entries found: 15
======================
A:ALU-1>#

Syntax

lag lag-id lag-id

Context

tools>dump

Description

This command displays Link Aggregation Group (LAG) information.

Default

n/a

Parameters

lag-id

the LAG identifier, expressed as a decimal integer

Values

1 to 32

Syntax

ldp-treetrace {prefix ip-prefix/mask | manual-prefix ip-prefix/mask} [path-destination ip-address] [trace-tree]

Context

tools>dump

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

ip-prefix/mask

specifies the IP prefix and subnet mask

Values

ip-prefix:        a.b.c.d (host bits must be 0)

mask:              0 to 32

ip-address

specifies the destination IP address

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.

*A:ALU-1># tools dump ldp-treetrace prefix 10.12.12.10/32
Discovered Paths:
===================

Id   PathDst           Egr-NextHop       Reply-Rtr-Addr    DisCovery-Time 
       discoveryTtl      ProbeState        ProbeTmOutCnt     RtnCode 
===  ================  ================  ================  ===============
001       10.1.0.5         10.10.1.2       10.12.12.10 12/19/2006 05:11:01
                 007                OK                00          EgressRtr
002       10.1.0.9         10.10.1.2       10.12.12.10 12/19/2006 05:11:01
                 007                OK                00          EgressRtr
003       10.1.0.15        10.10.1.2       10.12.12.10 12/19/2006 05:11:01
                 007                OK                00          EgressRtr
004       10.1.0.19        10.10.1.2       10.12.12.10 12/19/2006 05:11:01
                 007                OK                00          EgressRtr
005       10.1.0.24        10.10.1.2       10.12.12.10 12/19/2006 05:11:01
                 007                OK                00          EgressRtr
…….
051      10.1.0.243        10.10.1.2       10.12.12.10 12/19/2006 05:11:01
                 007                OK                00          EgressRtr
052      10.1.0.247        10.10.1.2       10.12.12.10 12/19/2006 05:11:01
                 007                OK                00          EgressRtr
053      10.1.0.252        10.10.1.2       10.12.12.10 12/19/2006 05:11:01
                 007                OK                00          EgressRtr
054      10.1.0.255        10.10.1.2       10.12.12.10 12/19/2006 05:11:01
 ldp-treetrace discovery state: Done  
 ldp-treetrace discovery status: ' OK '  
 Total number of discovered paths: 54 
 Total number of probe-failed paths: 0 
 Total number of failed traces: 0 

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.

tools dump ldp-treetrace prefix 10.12.12.10/32 path-destination 10.1.0.5
FEC: 10.12.12.10/32  PathDst: 10.1.0.5
==================================================
Protocol Legend: L - LDP, R - RSVP, U - Not Applicable 
 
HopId    HopAddr          TTL  Label1   Label2   Label3   Label4   Label5
=====   ================  ===  =======  =======  =======  =======  =======
277          10.12.12.10  007  000000L  000000U  000000U  000000U  000000U
223            10.1.1.17  006  001609L  000000U  000000U  000000U  000000U
196             10.2.1.2  005  001609L  000000U  000000U  000000U  000000U
187             10.2.1.1  004  001609L  000000U  000000U  000000U  000000U
184            10.1.1.11  003  001609L  000000U  000000U  000000U  000000U
183             10.1.1.1  002  001609L  000000U  000000U  000000U  000000U
182            10.10.1.2  001  001609L  000000U  000000U  000000U  000000U
 Total number of Hops: 7

Syntax

mpls-resources

Context

tools>dump

Description

This command displays FEC-to-NHLFE (next hop label forwarding entry) and ILM (incoming label message) information for MPLS.

Default

n/a

Syntax

persistence

Context

tools>dump

Description

This command enables the context to display persistence information.

Default

n/a

Syntax

dhcp-server [record record-key]

Context

tools>dump>persistence

Description

This command displays persistence information for the DHCP server.

Default

n/a

Parameters

record-key

specifies the record identification number

Output

The following output is an example of DHCP server persistence information, and DHCP Server Persistence Field Descriptions describes the fields.

A:7705# tools dump persistence dhcp-server
-----------------------------------
Persistency File Info
-----------------------------------
Filename          : cf3:\dhcp_serv.001
ClientDescr       : dhcp-server
UserDataSize      : 372
DataPadding       : 128
NumberOfEntries   : 4112
FileSize          : 8225
Version           : 0001
Entries in use    : 9
State             : ACTIVE

A:7705# tools dump persistence dhcp-server record 0x1
-----------------------------------
Persistency File Record
-----------------------------------
Filename          : cf3:\dhcp_serv.001
Key               : 00000001
Last Update       : 2013/07/12 11:45:37 (UTC)
Action            : ADD
Data
  service Id      : 0
  server          : defaultDhcpServer
  IP              : 10.1.1.20
  MAC             : 00:11:22:33:01:07
  XID             : 0x0cbe9d53
  start time      : 2013/07/12 11:45:37 (UTC)
  expires         : 2013/07/21 11:45:37 (UTC)
  failctrl        : local
  opt60 len       : 3
  opt82 len       : 0

Syntax

summary

Context

tools>dump>persistence

Description

This command displays persistence summary information.

Default

n/a

Output

The following output is an example of persistence summary information, and Persistence Summary Field Descriptions describes the fields.

A:7705# tools dump persistence summary
=====================================================================
Persistence Summary on Slot A
=====================================================================
Client         Location            Entries in use     Status
---------------------------------------------------------------------
dhcp-server    cf3:\dhcp_serv.001  2                  ACTIVE

=====================================================================
Persistence Summary on Slot B
=====================================================================
Client         Location            Entries in use     Status
---------------------------------------------------------------------
dhcp-server    cf3:\dhcp_serv.001  2                  ACTIVE

Syntax

port port-id discard [clear]

Context

tools>dump

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

port-id

specifies the port ID in the format slot/mda/port

clear

clears the packets after viewing

Syntax

ppp port-id

Context

tools>dump

Description

This command displays PPP information for a port.

Default

n/a

Parameters

port-id

specifies the port ID

Syntax:      port-id     slot/mda/port[.channel]

                                     bundle     bundle-type-slot/mda.bundle-num

                                                      bundle                   keyword

                                                      type                       ima, ppp

                                                      bundle-num          1 to 32

Syntax

service

Context

tools>dump

Description

This command enables the context to display service information.

Default

n/a

Syntax

evpn usage

Context

tools>dump>service

tools>dump>service>id

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:

*A:PE71# tools dump service evpn usage            

EVPN usage statistics at 000 02:01:03.810:

MPLS-TEP                                        :             5
VXLAN-TEP                                       :             0
Total-TEP                                       :      5/  8191

Mpls Dests (TEP, Egress Label + ES + ES-BMAC)   :            16
Vxlan Dests (TEP, Egress VNI)                   :             0
Total-Dest                                      :     17/131071

Sdp Bind +  Evpn Dests                          :     20/196607
ES L2/L3 PBR                                    :      0/ 32767
 *A:PE71# 

For a specific service:

*A:PE71#  tools dump service id 7 evpn usage

Evpn Tunnel Interface IP Next Hop: N/A

*A:PE71# 

Syntax

id service-id

Context

tools>dump>service

Description

This command enables the context to display information for the specified service.

Default

n/a

Parameters

service-id

specifies an existing service ID

Values

1 to 2147483647or a name string up to 64 characters long

Syntax

evpn-mpls [clear]

Context

tools>dump>service>id

Description

This command displays the EVPN-MPLS data for the specified service.

Parameters

clear

clears the EVPN-MPLS data for the specified service

Syntax

ip-transport ipt-id

Context

tools>dump>service>id

Description

This command enables the context to display information for a specific IES or VPRN IP transport subservice.

Default

n/a

Parameters

ipt-id

specifies the IP transport subservice physical port identifier

Values

value in the format slot/mda/port.channel

Syntax

remote-host host-id check-tcp

Context

tools>dump>service>id>ip-transport

Description

This command displays information for a TCP connection check to a remote host for the specified service.

Default

n/a

Parameters

host-id

specifies the remote host identifier

Values

1 to 2147483647or a name string up to 64 characters long

check-tcp

displays information for a TCP connection check to a remote host

Syntax

loopback

Context

tools>dump>service>id

Description

This command displays loopback information for a SAP or an SDP bind for the specified service.

Default

n/a

Syntax

sap sap-id

Context

tools>dump>service>id>loopback

Description

This command displays loopback information for a specified SAP in the specified service.

Default

n/a

Parameters

sap-id

specifies the SAP binding identifier

Values

(see list below)

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

Syntax

sdp sdp-id:vc-id

Context

tools>dump>service>id>loopback

Description

This command displays loopback information for a specified SDP binding in the specified service.

Default

n/a

Parameters

sdp-id

specifies the SDP binding identifier

Values

1 to 17407

vc-id

the virtual circuit identifier

Values

1 to 4294967295

Syntax

sap sdp-id stats [clear]

Context

tools>dump>service>id

Description

This command displays SAP information for the specified service.

Default

n/a

Parameters

sap-id

specifies the SAP binding identifier

Values

(see list below)

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

clear

clears statistics after viewing

stats

displays statistics associated with this SAP

Output

The following output is an example of the discard statistics, and Service SAP Field Descriptions describes the fields.

A:7705# tools dump service id 200 sap 1/X3/6:100 stats
===========================================================
Service Id 200 SAP 1/X3/6:100 VPLS Ingress Debug Stats
===========================================================
total number of discarded packets                   | 1
total number of discarded bytes                     | 996
number of discards due to source suppression        | 0
number of discards due to split horizon             | 0
number of discards due to mesh to mesh              | n/a
number of discards due to unknown DA                | 0
number of discards due to unknown SA                | 0
number of discards due to service MTU               | 0
number of discards due to STP not in fwding state   | 1
number of other discards                            | 0
===========================================================
Service Id 200 SAP 1/X3/6:100 VPLS Egress Debug Stats
===========================================================
total number of discarded packets                   | 0
number of unicast discards due to pool exhaustion   | 0
number of multicast discards due to pool exhaustion | 0
number of unicast discards due to queue overflow    | 0
number of multicast discards due to queue overflow  | 0
number of other discards                            | 0

Syntax

sap sdp-id[:vc-id] stats [clear]

Context

tools>dump>service>id

Description

This command displays SDP binding information for the specified service.

Default

n/a

Parameters

sdp-id

specifies the SDP binding identifier

Values

1 to 17407

vc-id

specifies the virtual circuit identifier

Values

1 to 4294967295

clear

clears statistics after viewing

stats

displays statistics associated with the specified SDP

Syntax

network-latency-measurement

Context

tools>dump>service>id

Description

This command displays minimum, current, and maximum latency measurement values.

Default

n/a

Output

The following output is an example of network latency measurement information.

A:SAR18-11-2# tools dump service id 100 network-latency-measurement
------------------------------------------------------------------------------------
Path Average Latency Measurements (us)
------------------------------------------------------------------------------------
Spoke-sdp                Min          Current          Max         Last update
121:100                  450            500            600         02/21/23 20:17:14
122:200                  350            600            800         02/21/23 20:17:14
.... 

The following is an example of network latency measurement information where the far-end timestamp is earlier than the near-end timestamp, resulting in a negative latency that is displayed as "Too Low".

Output Example

===============================================================================
Path Average Latency Measurements (us)
-------------------------------------------------------------------------------
Spoke-sdp         Min       Cur        Max          Last update
-------------------------------------------------------------------------------
321:1200          N/A       Too Low    N/A          Never
===============================================================================

Syntax

ipsec-tunnel ipsec-tunnel-name stats

Context

tools>dump>service

Description

This command displays the IPSec tunnel information.

Parameters

ipsec-tunnel-name

the name of the IPSec tunnel

stats

displays statistics associated with the IPSec tunnel

Output

The following output is an example of IPSec tunnel information, and IPSec Tunnel Field Descriptions describes the fields.

*A:7705:Dut-A# tools dump service ipsec-tunnel tunnelPrivateSide_1.1 stats 

=================================================================
Discard Stats for Ipsec-Tunnel tunnelPrivateSide_1.1 (tunnelId 1 svcId 1001) 
=================================================================
Outbound Discard Stats:
     Security policy misses                              | 0
     Invalid security association                        | 0
     Sequence number wrap errors                         | 0
     Buffer exhaustion errors                            | 0
     IP-frag buffer exhaustion errors                    | 0
     Enqueue errors                                      | 0
     Tunnel peer-ip-address not reachable                | 0
     Tunnel peer-ip-address next-hop not reachable via IP| 0
     Egress uplink interface does not support encryption | 0
     Drop Too Big/Df-set Pkts                            | 0
     Other discards                                      | 0
=================================================================
Inbound Discard Stats:
     Authentication failures                             | 0
     Security policy misses                              | 0
     NATT UDP ports mismatch (src/dst)                   | 0
     IP Proto mismatch                                   | 0
     Tunnel and SPI cross validation errors              | 0
     IP fragmented packets (Unsupported)                 | 0
     Padding failures                                    | 0
     NULL SeqNum                                         | 0
     Enqueue errors                                      | 0
     Sequence number too old in window (Anti-Replay)     | 0
     Duplicated sequence number in window (Anti-Replay)  | 0
     Buffer exhaustion errors                            | 0
     Other discards                                      | 0
=================================================================

Syntax

loopback

Context

tools>dump>service

Description

This command displays all active Ethernet SAP loopbacks on the node. Only internal loopback mode is supported.

Default

n/a

Syntax

bgp-evpn

Context

tools>dump>service

Description

This command enables the context for service system information.

Syntax

bgp-evpn

Context

tools>dump>service>system

Description

This command enables the context for BGP-EVPN service system information.

Syntax

ethernet-segment name evi value df

Context

tools>dump>service>system>bgp-evpn

Description

This command displays information on the computed DF PE for a specified EVI.

Parameters

name

specifies the name of the Ethernet segment

value

specifies the EVI

Values

1 to 65535

df

keyword for designated forwarder

Output

The following output is an example of Ethernet segment information.

*A:PE2# tools dump service system bgp-evpn ethernet-segment "ESI-71" evi 1 df 
[07/15/2015 21:52:08] Computed DF: 192.0.2.72 (Remote) (Boot Timer Expired: Yes) 

Syntax

vpls-fdb-stats [clear]

Context

tools>dump>service

Description

This command displays the VPLS FDB statistics.

Parameters

clear

clears the VPLS FDB statistics after viewing

Output

The following output is an example of VPLS FDB statistics, and System-Limits Field Descriptions describes the fields.

*A:Sar18 Dut-B# tools dump service vpls-fdb-stats

Service Manager VPLS FDB info at 042 02:39:08.680:
Statistics last cleared at 000 00:00:00.000

      Statistic           |    Count
--------------------------+-------------
          FdbEntriesInUse |          0
          TotalFdbEntries |      65535
       FdbMimDestIdxInUse |          0
TotalFdbMimDestIdxEntries |        511
          FdbIsidIdxInUse |          0
TotalFdbMimIsidIdxEntries |      16384
               MacAddMsgs |          0
            MacDeleteMsgs |          0
             MacQueryMsgs |          0
              UnknownMsgs |          0
            MalformedMsgs |          0
               FailedMsgs |          0
           FdbHwTableFull |          0
       FdbHwLimitExceeded |          0
             FdbTableFull |          0
         FdbLimitExceeded |          0
   FdbMimDestIdxExhausted |          0
               MacAddReqs |          0
            DupMacAddReqs |          0
        DroppedMacAddReqs |          0
         FailedMacAddReqs |          0
               MacDelReqs |          0
            DupMacDelReqs |          0
        DroppedMacDelReqs |          0
         FailedMacDelReqs |          0

Syntax

system-limits

Context

tools>dump

Description

This command displays the resource limits of the current system configuration.

Default

n/a

Output

The following output is an example of system limits information, and System-Limits Field Descriptions describes the fields.

A:7705# tools dump system-limits
                                      | Limit
--------------------------------------+-----------
                  IPv4 FIB Table Size | 65536
                  IPv6 FIB Table Size | 32768
     Max Number of Network Interfaces | 256
     Max Number of Service Interfaces | 1024
       Max Number of Total Interfaces | 1024
Max Number of IPv6 Network Interfaces | 255
Max Number of IPv6 Service Interfaces | 384
  Max Number of IPv6 Total Interfaces | 384
             VPRN Instances Supported | 62
             VPLS Instances Supported | 64
              Max Number of BGP Peers | 320
         Max Number of IP/Mac Filters | 512

Syntax

system-resources slot-number

Context

tools>dump

Description

This command displays system resource information.

Default

n/a

Parameters

slot-number

specifies a specific slot to view system resources information

Output

The following output is an example of system resources information, and System-Resources Field Descriptions describes the fields.

*A:7705# tools>dump system-resources 1/1
Mda-1/1 Resource Usage
                                 |   Total   | Allocated |    Free
  -------------------------------+-----------+-----------+------------
           Access Ingress Queues |     2048  |        0  |     2048
                   Egress Queues |     2112  |        0  |     2112
            Access Egress Queues |     2048  |        0  |     2048
           Network Egress Queues |     2048  |        0  |     2048
                     SAP Objects |      512  |        0  |      512
                VPLS SAP Objects |      128  |        0  |      128
                         (1/1/1) |      128  |        0  |      128
                         (1/1/2) |      128  |        0  |      128
                         (1/1/3) |      128  |        0  |      128
                         (1/1/4) |      128  |        0  |      128
                         (1/1/5) |      128  |        0  |      128
                         (1/1/6) |      128  |        0  |      128
                         (1/1/7) |      128  |        0  |      128
                         (1/1/8) |      128  |        0  |      128
              Network Interfaces |      128  |        0  |      128
                         Filters |       32  |        0  |       32
              Service Interfaces |      512  |        0  |      512
         IpV6 Network Interfaces |      128  |        0  |      128
         IpV6 Service Interfaces |      512  |        0  |      512
                   Shaper Groups |       64  |        0  |       64

Syntax

testhead test-name test-name [test-owner test-owner]

Context

tools>dump

Description

This command displays Y.1564 test head debug statistics.

Default

n/a

Parameters

test-name

specifies a Y.1564 test by name

test-owner

specifies a Y.1564 test owner

Syntax

test-oam

Context

tools>dump

Description

This command enables the context to display operations, administration, and maintenance information.

Default

n/a

Syntax

testhead test-name test-name [test-owner test-owner]

Context

tools>dump>test-oam

Description

This command displays Y.1564 test head debug statistics.

Default

n/a

Parameters

name-of-the-test

the name of the Y.1564 test

owner-of-the-test

the owner of the Y.1564 test

Syntax

server error-counters

Context

tools>dump>test-oam

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

Syntax

router router-instance

router service-name service-name

Context

tools>dump

Description

This command enables tools for the router instance.

Default

n/a

Parameters

router-instance

specifies the router name and service ID

Values

router-name:      Base, management

service-id:          1 to 2147483647

Default

Base

service-name

specifies the service name

Syntax

bgp

Context

tools>dump>router

Description

This command enables dump tools for BGP.

Default

n/a

Syntax

routes [family] received [url file-url]

Context

tools>dump>router>bgp

Description

This command displays information for BGP routes.

Default

n/a

Parameters

received

displays information about received routes

family

specifies the family for which information is displayed

Values

ipv4, vpn-ipv4, ipv6, vpn-ipv6, or mvpn-ipv4

url file-url

the URL of the file

Values

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:

Syntax

fib slot-number [ipv4 | ipv6] summary

Context

tools>dump>router

Description

This command displays information for the FIB.

Default

n/a

Parameters

slot-number

specifies the slot number, always ‟1”

ipv4 | ipv6

specifies the IP family

summary

displays summary information

Syntax

ldp

Context

tools>dump>router

Description

This command enables dump tools for LDP.

Default

n/a

Syntax

fec vc-type vc-type agi agi

fec p2mp-id identifier root ip-address

fec root ip-address source ip-address group mcast-address inner-root ip-address

fec prefix ip-address[/mask]

fec root ip-address source ip-address group mcast-address [rd rd]

fec vc-type vc-type vc-id vc-id

fec p2mp-id identifier root ip-address [rd rd] inner-root ip-address

Context

tools>dump>router>ldp

Description

This command displays information for an LDP FEC.

Parameters

vc-type

specifies the VC type

Values

ethernet, vlan, framerelay, atm-all5, atm-cell, hdlc, ppp, cem, atm-vcc, atm-vpc, ipipe, atm-vcc-1-1, atm-vpc-1-1, atm-aal5-pdu, fr, cep, e1-satop, t1-satop, e3-satop, t3-satop, cesopsn, tdmoip, cesopsn-cas, tdmoip-cas, fr-dlci, mirror

agi

specifies the attachment group identifier TLV associated with this service FEC

Values

ip-addr:comm-val | 2byte-asnumber:ext-comm-val | 4byte-asnumber:comm-val

ip-addr                             : a.b.c.d

comm-val                        : 0 to 65535

2byte-asnumber              : 1 to 65535

ext-comm-val                  : 0 to 4294967295

4byte-asnumber             :  1 to 4294967295

null - means all value is 0

identifier

specifies the identifier of the LDP point-to-multipoint LSP

Values

0 to 4294967295

root ip-address

specifies the root IP address

source ip-address

specifies the source IP address

group mcast-address

specifies the group multicast address

inner-root ip-address

specifies the inner root IP address of the FEC

ip-address[/mask]

specifies the IP prefix and prefix length associated with the prefix FEC

Values

ipv4-prefix:	a.b.c.d
ipv4-prefix-length:	32
ipv6-prefix:	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
ipv6-prefix-length:	128

rd

specifies the route distinguisher value

Values

ip-addr:comm-val | 2byte-asnumber:ext-comm-val | 4byte-asnumber:comm-val

vc-id

specifies the VC identifier

Values

1 to 4294967295

Output

The following output is an example of LDP FEC information.

A:Dut-A# tools dump router ldp fec root 10.20.1.3 source 10.0.101.10 group
192.168.1.1 inner-root 10.20.1.6
P2MP: root: 10.20.1.3, T: 7, L: 21 (InnerRoot: 10.20.1.6 T: 3, L:8, Src:
10.0.101.10, Grp: 192.168.1.1)
  Create Time   : 01/27/16 16:39:04.097 (elapsed: 0d 03:20:24)
  Last Mod. Time: 01/27/16 16:39:04.097 (elapsed: 0d 03:20:24)
  FEC Flags     : Pop UprStitched
  TunlIfId: 73728   (OperState : up)
  LSP ID        : 0
  LSP ID Acct.  : 0
  isIngressMttm : No         HasLeaf     : Yes
  isIngrItermdte: No
  CanProgIngress: No
  InPhopFrr     : No
  isStitchedUpr : Yes
  RslvdPhop(p)  : 10.20.1.2:0 (seqNum 2)
  RslvdPhop(b)  : 0.0.0.0:0 (seqNum 0)
  pri Upstream  : 10.20.1.2:0, AdvLabel 262139
  mbb Upstream  : None
  bkp Upstream  : None
  AdvInLabel(p) : 262139
  AdvInLabel(b) : 0
  PrgInLabel(p) : 1
  Num Resolved   Nhops  : 1
  Num MBB Req.   Nhops  : 0
  Num Programmed Nhops  : 1
    Programmed Nhop[01] : 0.0.0.0:0, OutLabel 0 (Leaf)(StitchedFec)
  Metric        : 0          Mtu         : 0
  Num of Peers : 1
  FEC Peer: 10.20.1.2:0
    Peer Flags: none  (0x0)
    ModTime   : 01/27/16 16:39:04.097 (elapsed.: 0d 03:20:24)
    ->Num Egress Labels:
      None
    <-Num Ingress Labels:
      <- (Label: 262139    Status: UsePop)
      Rej Status: OK
      Flow Label Tx: no, Rx: no
      Flow Label Tx Sent: no, Rx Sent: no
    <Resolved as CUR Upstream>

Syntax

instance

Context

tools>dump>router>ldp

Description

This command displays information for an LDP instance.

Default

n/a

Syntax

interface [ip-int-name | ip-address]

Context

tools>dump>router>ldp

Description

This command displays information for an LDP interface.

Default

n/a

Parameters

ip-int-name

specifies the interface name

ip-address

specifies the IP address

Syntax

memory-usage

Context

tools>dump>router>ldp

Description

This command displays memory usage information for LDP.

Default

n/a

Syntax

peer ip-address

Context

tools>dump>router>ldp

Description

This command displays information for an LDP peer.

Default

n/a

Parameters

ip-address

specifies the IP address

Syntax

session [ip-address |:label space] [connection | peer | adjacency]

Context

tools>dump>router>ldp

Description

This command displays information for an LDP session.

Default

n/a

Parameters

ip-address

specifies the IP address of the LDP peer

label-space

specifies the label space identifier that the router is advertising on the interface

connection

displays connection information

peer

displays peer information

adjacency

displays hello adjacency information

Syntax

sockets

Context

tools>dump>router>ldp

Description

This command displays information for all sockets being used by the LDP protocol.

Default

n/a

Syntax

timers

Context

tools>dump>router>ldp

Description

This command displays timer information for LDP.

Default

n/a

Syntax

mpls

Context

tools>dump>router

Description

This command enables the context to display MPLS information.

Default

n/a

Syntax

ftn [endpoint endpoint | sender sender | nexthop nexthop | lsp-id lsp-id | tunnel-id tunnel-id | label start-label end-label]

Context

tools>dump>router>mpls

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

endpoint

specifies the IP address of the last hop

Values

a.b.c.d

sender

specifies the IP address of the sender

Values

a.b.c.d

nexthop

specifies the IP address of the next hop

Values

a.b.c.d

lsp-id

specifies the label switched path that is signaled for this entry

Values

0 to 65535

tunnel-id

specifies the SDP ID

Values

0 to 65535

start-label end-label

specifies the label range for the information dump

Values

start-label — 32 to 131071

end-label — 32 to 131071

Syntax

ilm [endpoint endpoint | sender sender | nexthop nexthop | lsp-id lsp-id | tunnel-id tunnel-id | label start-label end-label]

Context

tools>dump>router>mpls

Description

This command displays incoming label map (ILM) information for MPLS.

Default

n/a

Parameters

endpoint

specifies the IP address of the last hop

Values

a.b.c.d

sender

specifies the IP address of the sender

Values

a.b.c.d

nexthop

specifies the IP address of the next hop

Values

a.b.c.d

lsp-id

specifies the label switched path that is signaled for this entry

Values

0 to 65535

tunnel-id

specifies the SDP ID

Values

0 to 65535

start-label end-label

specifies the label range for the information dump

Values

start-label — 32 to 131071

end-label — 32 to 131071

Syntax

lspinfo [lsp-name] [detail]

Context

tools>dump>router>mpls

Description

This command displays LSP information for MPLS.

Default

n/a

Parameters

lsp-name

the LSP identifier

Values

up to 32 characters (must be unique)

detail

displays detailed LSP information

Syntax

memory-usage

Context

tools>dump>router>mpls

Description

This command displays memory usage information for MPLS.

Default

n/a

Syntax

ospf

Context

tools>dump>router

Description

This command enables the context to display tools information for OSPF.

Default

n/a

Syntax

ospf3

Context

tools>dump>router

Description

This command enables the context to display tools information for OSPFv3.

Default

n/a

Syntax

abr [detail]

Context

tools>dump>router>ospf

tools>dump>router>ospf3

Description

This command displays area border router (ABR) information for OSPF.

Default

n/a

Parameters

detail

displays detailed information about the ABR

Syntax

area-range

Context

tools>dump>router>ospf

tools>dump>router>ospf3

Description

This command displays area range information for OSPF.

Default

n/a

Syntax

asbr [detail]

Context

tools>dump>router>ospf

tools>dump>router>ospf3

Description

This command displays autonomous system boundary router (ASBR) information for OSPF.

Default

n/a

Parameters

detail

displays detailed information about the ASBR

Syntax

bad-packet interface-name

Context

tools>dump>router>ospf

tools>dump>router>ospf3

Description

This command displays information about bad packets for OSPF.

Default

n/a

Parameters

interface-name

displays only the bad packets identified by this interface name

Syntax

leaked-routes [summary | detail]

Context

tools>dump>router>ospf

tools>dump>router>ospf3

Description

This command displays information about leaked routes for OSPF.

Default

summary

Parameters

summary

displays a summary of information about leaked routes for OSPF

detail

displays detailed information about leaked routes for OSPF

Syntax

memory-usage [detail]

Context

tools>dump>router>ospf

tools>dump>router>ospf3

Description

This command displays memory usage information for OSPF.

Default

n/a

Parameters

detail

displays detailed information about memory usage for OSPF

Syntax

request-list [neighbor ip-address] [detail]

request-list virtual-neighbor ip-address area-id area-id [detail]

request-list [detail]

request-list neighbor [interface-name] [router-id] [detail]

request-list virtual-neighbor router-id transit-area transit-area [detail]

Context

tools>dump>router>ospf

tools>dump>router>ospf3

Description

This command displays request list information for OSPF.

Default

n/a

Parameters

neighbor ip-address

displays OSPF neighbor information only for the neighbor identified by the IP address

neighbor interface-name

displays OSPFv3 neighbor information only for the neighbor identified by the IP interface name

detail

displays detailed information about the neighbor or virtual neighbor

virtual-neighbor ip-address

displays OSPF information about the virtual neighbor identified by the IP address

virtual-neighbor router-id

displays OSPFv3 information about the virtual neighbor identified by the IP router identifier

area-id area-id

displays OSPF information about the area identified by the area ID, expressed in dotted-decimal notation or as a 32-bit decimal integer

transit-area transit-area

displays OSPFv3 information about the transit area identified by the router ID, expressed in dotted-decimal notation or as a 32-bit decimal integer

Syntax

retransmission-list [neighbor ip-address] [detail]

retransmission-list virtual-neighbor ip-address area-id area-id [detail]

retransmission-list [detail]

retransmission-list neighbor [ip-int-name] [router-id] [detail]

retransmission-list virtual-neighbor router-id transit-area transit-area [detail]

Context

tools>dump>router>ospf

tools>dump>router>ospf3

Description

This command displays dump retransmission list information for OSPF.

Default

n/a

Parameters

neighbor ip-address

displays OSPF neighbor information only for the neighbor identified by the IP address

neighbor ip-int-name

displays OSPFv3 neighbor information only for the neighbor identified by the IP interface name

detail

displays detailed information about the neighbor or virtual neighbor

virtual-neighbor ip-address

displays OSPF information about the virtual neighbor identified by the IP address

virtual-neighbor router-id

displays OSPFv3 information about the virtual neighbor identified by the router identifier

area-id area-id

displays the OSPF information about the area ID, expressed in dotted-decimal notation or as a 32-bit decimal integer

transit-area transit-area

displays the OSPFv3 information about the transit area ID, expressed in dotted-decimal notation or as a 32-bit decimal integer

Syntax

route-summary

Context

tools>dump>router>ospf

tools>dump>router>ospf3

Description

This command displays dump route summary information for OSPF.

Default

n/a

Syntax

route-table [ip-prefix/mask] [type] [detail] [alternative]

route-table [ipv6-prefix/prefix-length] [type] [detail] [alternative]

Context

tools>dump>router>ospf

tools>dump>router>ospf3

Description

This command displays dump information about routes learned through OSPF.

Default

n/a

Parameters

ip-prefix/mask

the IPv4 prefix and mask for routes learned through OSPF

Values

ip-prefix             a.b.c.d   (host bits must be 0)

mask                 0 to 32

ipv6-prefix/prefix-length

the IPv6 prefix and prefix length for routes learned through OSPFv3

Values

ipv6-prefix         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

prefix-length      0 to 128

type

the type of route table to display information about

Values

intra-area, inter-area, external-1, external-2, nssa-1, nssa-2

detail

displays detailed information about learned routes

alternative

displays LFA details

Syntax

sham-bad-packet interface-name

Context

tools>dump>router>ospf

Description

This command displays OSPFv2 sham link bad packets.

Parameters

interface-name

displays only the sham link bad packets identified by this interface name

Syntax

sr-adjacencies [ip-int-name | ip-address] [detail]

sr-adjacencies [remote ip-address] [detail]

Context

tools>dump>router>ospf

Description

This command displays OSPFv2 segment routing (SR) adjacency information.

Parameters

ip-int-name

the IP interface name, 32 characters maximum

ip-address

the IP address of the neighbor

Values

a.b.c.d

detail

displays detailed information about SR adjacencies

Syntax

sr-database [sid sid] [detail]

Context

tools>dump>router>ospf

Description

This command displays OSPFv2 segment routing (SR) database information.

Parameters

sid

the segment routing identifier

Values

0 to 524287

detail

displays detailed information about learned routes

Syntax

pim

Context

tools>dump>router

Description

This command enables the context to display PIM information.

Default

n/a

Syntax

iom-failures [detail]

Context

tools>dump>router>pim

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

detail

displays detailed information about IOM failures

Syntax

rsvp

Context

tools>dump>router

Description

This command enables the context to display tools information for RSVP.

Default

n/a

Syntax

neighbor [ip-address] [detail]

Context

tools>dump>router>rsvp

Description

This command displays neighbor information for RSVP.

Default

n/a

Parameters

ip-address

the IP address of the neighbor

Values

a.b.c.d

detail

displays detailed information about the neighbor

Syntax

psb [endpoint endpoint-address] [sender sender-address] [tunnelid tunnel-id] [lspid lsp-id]

Context

tools>dump>router>rsvp

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

endpoint-address

specifies the IP address of the last hop

sender-address

specifies the IP address of the sender

tunnel-id

specifies the SDP ID

Values

0 to 4294967295

lsp-id

specifies the label switched path that is signaled for this entry

Values

1 to 65535

Syntax

rsb [endpoint endpoint-address] [sender sender-address] [tunnelid tunnel-id] [lspid lsp-id]

Context

tools>dump>router>rsvp

Description

This command displays RSVP Reservation State Block (RSB) information.

Default

n/a

Parameters

endpoint-address

specifies the IP address of the last hop

sender-address

specifies the IP address of the sender

tunnel-id

specifies the SDP ID

Values

0 to 4294967295

lsp-id

specifies the label switched path that is signaled for this entry

Values

1 to 65535

Syntax

segment-routing

Context

tools>dump>router

Description

This command enables the context to display tools information for segment routing.

Syntax

tunnel

Context

tools>dump>router>segment-routing

Description

This command displays segment routing tunnel information.

Syntax

static-route

Context

tools>dump>router

Description

This command enables the context to display tools information for static routes.

Default

n/a

Syntax

ldp-sync-status

Context

tools>dump>router>static-route

Description

This command displays the status of the LDP synchronization timers for static routes.

Default

n/a

Syntax

te-database [adv-router adv-router] [neighbor neighbor] [detail]

Context

tools>dump>router

Description

This command displays information for the traffic engineering database.

Default

n/a

Parameters

adv-router

ip-address or isis-system-id

neighbor

ip-address or isis-system-id

detail

displays detailed information about the neighbor

Syntax

isis [instance isis-instance] [level level]

Context

tools>dump>router>te-database

Description

This command displays information for the IS-IS traffic engineering database.

Default

n/a

Parameters

isis-instance

0 to 31

level

1 or 2

Syntax

ospf [area area-id] [instance ospf-instance]

Context

tools>dump>router>te-database

Description

This command displays information for the OSPF traffic engineering database.

Default

n/a

Parameters

area-id

ip-address or (0 to 4294967295)

ospf-instance

a unique integer that identifies a specific instance of a version of the OSPF protocol running in the router instance specified by the virtual router identifier

Values

0 to 31

Syntax

perform

Context

tools

Description

This command enables the context to specify tools to perform specific tasks.

Default

n/a

Syntax

aps

Context

tools>perform

Description

This command enables the context to perform APS operations.

Default

n/a

Syntax

clear aps-id {protect | working}

Context

tools>perform>aps

Description

This command removes all APS operational commands.

Default

n/a

Parameters

aps-id

the specified APS group

protect

the physical port acting as a protection circuit for the APS group

working

the physical port acting as a working circuit for the APS group

Syntax

exercise aps-id {protect | working}

Context

tools>perform>aps

Description

This command performs an exercise request on the protection or working circuit.

Default

n/a

Parameters

aps-id

the specified APS group

protect

the physical port acting as a protection circuit for the APS group

working

the physical port acting as a working circuit for the APS group

Syntax

force aps-id {protect | working}

Context

tools>perform>aps

Description

This command forces a switch to either the protection or working circuit.

Default

n/a

Parameters

aps-id

the specified APS group

protect

the physical port acting as a protection circuit for the APS group

working

the physical port acting as a working circuit for the APS group

Syntax

lockout aps-id

Context

tools>perform>aps

Description

This command locks out the protection circuit in the specified APS group.

Default

n/a

Parameters

aps-id

the specified APS group

Syntax

request aps-id {protect | working}

Context

tools>perform>aps

Description

This command requests a manual switch to either the protection or working circuit.

Default

n/a

Parameters

aps-id

the specified APS group

protect

the physical port acting as a protection circuit for the APS group

working

the physical port acting as a working circuit for the APS group

Syntax

cron

Context

tools>perform

Description

This command enables the context to perform CRON (scheduling) control operations.

Default

n/a

Syntax

action

Context

tools>perform>cron

Description

This command enables the context to stop the execution of a script started by CRON action. See the stop command.

Default

n/a

Syntax

stop [action-name] [owner action-owner] [all]

Context

tools>perform>cron>action

Description

This command stops execution of a script started by CRON action.

Default

n/a

Parameters

action-name

specifies the action name

Values

maximum 32 characters

action-owner

specifies the owner name

Default

TiMOS CLI

all

specifies to stop all CRON scripts

Syntax

cflowd

Context

tools>perform

Description

This command enables the context to perform cflowd control operations.

Default

n/a

Syntax

manual-export

Context

tools>perform>cflowd

Description

This command manually exports cflowd flow data.

Syntax

eth-ring

Context

tools>perform

Description

This command enables the context to perform Ethernet ring operations.

Default

n/a

Syntax

clear ring-index

Context

tools>perform>eth-ring

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

ring-index

specifies the Ethernet ring index

Values

1 to 128

Syntax

clear ring-index path {a | b}

Context

tools>perform>eth-ring

Description

This command forces a block on the ring port where the command is issued.

Default

n/a

Parameters

ring-index

specifies the Ethernet ring index

Values

1 to 128

path {a | b}

displays information for the specified path

Syntax

clear ring-index path {a | b}

Context

tools>perform>eth-ring

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

ring-index

specifies the Ethernet ring index

Values

1 to 128

path {a | b}

displays information for the specified path

Syntax

ima

Context

tools>perform

Description

This command enables the context to perform IMA operations.

Default

n/a

Syntax

reset bundle-id

Context

tools>perform>ima

Description

This command resets an IMA bundle in the startup state.

Default

n/a

Parameters

bundle-id

specifies the IMA bundle ID

Syntax:          bundle-ima-slot/mda.bundle-num

                        bundle-ima          keyword

                        bundle-num        1 to 32

Syntax

lag

Context

tools>perform

Description

This command configures tools to control LAG.

Default

n/a

Syntax

clear-force all-mc

clear-force lag-id lag-id [sub-group sub-group-id]

clear-force peer-mc ip-address

Context

tools>perform>lag

Description

This command clears a forced status.

Default

n/a

Parameters

all-mc

clears all multi-chassis LAG information

lag-id

specifies an existing LAG ID

Values

1 to 32

sub-group-id

specifies a LAG subgroup

Values

1 or 2 (for access ports), 1 to 4 (for network ports)

ip-address

specifies the IP address of a multi-chassis peer

Syntax

force all-mc {active | standby}

force lag-id lag-id [sub-group sub-group-id] {active | standby}

force peer-mc peer-ip-address {active | standby}

Context

tools>perform>lag

Description

This command forces an active or standby status.

Default

n/a

Parameters

all-mc

forces an active or standby status for all multi-chassis LAGs

peer-ip-address

specifies a multi-chassis peer by its IP address

lag-id

specifies an existing LAG ID

Values

1 to 32

sub-group-id

specifies a LAG subgroup

Values

1 or 2 (for access ports), 1 to 4 (for network ports)

active

forces the specified LAG, LAG subgroup, multi-chassis LAG peer, or all multi-chassis LAGs to active status

standby

forces the specified LAG, LAG subgroup, multi-chassis LAG peer, or all multi-chassis LAGs to standby status

Syntax

lcr

Context

tools>perform

Description

This command enables the context to perform T1/E1 Line Card Redundancy (LCR) operations.

Default

n/a

Syntax

clear lcr-id {protect | working}

Context

tools>perform>lcr

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

lcr-id

the specified LCR group, from 1 to 6

protect

clears operational commands from the adapter card acting as a protection card for the LCR group

working

clears operational commands from the adapter card acting as a working card for the LCR group

Syntax

force lcr-id {protect | working}

Context

tools>perform>lcr

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

lcr-id

the specified LCR group, from 1 to 6

protect

forces activity away from the adapter card acting as a protection card for the LCR group

working

forces activity away from the adapter card acting as a working card for the LCR group

Syntax

lockout lcr-id

Context

tools>perform>lcr

Description

This command locks out the protection adapter card. Locking out the protection card means that activity cannot be switched to the protection card even if the working adapter card has failed.

Default

n/a

Parameters

lcr-id

the specified LCR group, from 1 to 6

Syntax

log

Context

tools>perform

Description

This command enables event logging tools.

Default

n/a

Syntax

test-event

Context

tools>perform>log

Description

This command generates a test event.

Default

n/a

Syntax

mda-table-refresh

Context

tools>perform

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, see the 7705 SAR Router Configuration Guide, ‟Troubleshooting the FIB”.

Default

n/a

Syntax

mw

Context

tools>perform

Description

This command enables the context to perform microwave operations.

Default

n/a

Syntax

clear mw-link-id {main | spare} {eps | tps | rps}

Context

tools>perform>mw

Description

This command removes all microwave link operational commands.

Default

n/a

Parameters

mw-link-id

specifies an existing microwave link ID

Values

id = 1 to 24

main

specifies that the role of the MPR-e radio in a 1+1 HSB configuration is main

spare

specifies that the role of the MPR-e radio in a 1+1 HSB configuration is spare

eps

specifies that the protection scheme in a 1+1 HSB configuration is Equipment Protection Switching

tps

specifies that the protection scheme in a 1+1 HSB configuration is Transmission Protection Switching

rps

specifies that the protection scheme in a 1+1 HSB configuration is Radio Protection Switching

Syntax

force mw-link-id {eps | tps | rps}

Context

tools>perform>mw

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

mw-link-id

specifies an existing microwave link ID

Values

id = 1 to 24

eps

specifies that the protection scheme in a 1+1 HSB configuration is Equipment Protection Switching

tps

specifies that the protection scheme in a 1+1 HSB configuration is Transmission Protection Switching

rps

specifies that the protection scheme in a 1+1 HSB configuration is Radio Protection Switching

Syntax

lockout mw-link-id {eps | tps | rps}

Context

tools>perform>mw

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

mw-link-id

specifies an existing microwave link ID

Values

id = 1 to 24

eps

specifies that the protection scheme in a 1+1 HSB configuration is Equipment Protection Switching

tps

specifies that the protection scheme in a 1+1 HSB configuration is Transmission Protection Switching

rps

specifies that the protection scheme in a 1+1 HSB configuration is Radio Protection Switching

Syntax

manual mw-link-id {main | spare} {eps | tps | rps}

Context

tools>perform>mw

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

mw-link-id

specifies an existing microwave link ID

Values

id = 1 to 24

main

specifies that the role of the MPR-e radio in a 1+1 HSB configuration is main

spare

specifies that the role of the MPR-e radio in a 1+1 HSB configuration is spare

eps

specifies that the protection scheme in a 1+1 HSB configuration is Equipment Protection Switching

tps

specifies that the protection scheme in a 1+1 HSB configuration is Transmission Protection Switching

rps

specifies that the protection scheme in a 1+1 HSB configuration is Radio Protection Switching

Syntax

software-download [force]

Context

tools>perform>mw

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

force

forces a software download to all MPR-e radios regardless of the software version that they are currently running

Syntax

ptp reset-clk-rec clock-id clock-id

Context

tools>perform

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

clock-id

specifies the PTP clock ID

Values

1 to 16 for PTP clocks that use IPv4 or IPv6 encapsulation

csm for a PTP clock that uses Ethernet encapsulation

Syntax

security

Context

tools>perform

Description

This command provides tools for testing security.

Default

n/a

Syntax

authentication-server-check server-address ip-address [port port] {{user-name user-name password password} | attr-from-file file-url}} secret key [source-address ip-address] [timeout seconds] [router router-instance | service-name service-name]

Context

tools>perform>security

Description

This command checks connection to the RADIUS server.

Default

n/a

Parameters

ip-address

specifies the source IP address of the DHCP relay messages

Values

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

port

specifies the port ID

Values

1 to 65535

user-name

specifies the DHCP client

Values

253 characters maximum

password

specifies the CLI access password

Values

64 characters maximum

key

specifies the authentication key

Values

20 characters maximum

seconds

specifies the timeout in seconds

Values

1 to 90

router-instance

specifies the router name or service ID

Values

router-name:      Base, management

service-id:          1 to 2147483647

Default

Base

service-name

specifies the service name

file-url

the URL of the file

Values

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:

Syntax

service

Context

tools>perform

Description

This command enables the context to configure tools for services.

Syntax

id service-id

Context

tools>perform>service

Description

This command enables the context to configure tools for a specific service.

Parameters

service-id

specifies an existing service ID

Values

1 to 2147483647or a name string up to 64 characters long

Syntax

endpoint endpoint-name

Context

tools>perform>service>id

Description

This command enables the context to configure tools for a specific service endpoint.

Parameters

endpoint-name

specifies an existing service endpoint name

Syntax

force-switchover sdp-id:vc-id

no force-switchover

Context

tools>perform>service>id

Description

This command forces a switch of the active spoke SDP for the specified service.

Parameters

sdp-id:vc-id

specifies an existing spoke SDP for the service

Values

sdp-id:          1 to 17407

vc-id:            1 to 4294967295

Syntax

ip-transport ipt-id

Context

tools>perform>service>id

Description

This command enables the context to configure tools for a specific IES or VPRN IP transport subservice.

Parameters

ipt-id

specifies the IP transport subservice physical port identifier

Values

value in the format slot/mda/port.channel

Syntax

remote-host host-id check-tcp

Context

tools>perform>service>id>ip-transport

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

host-id

the remote host identifier

Values

1 to 2147483647or a name string up to 64 characters long

check-tcp

establishes a TCP connection to the remote host

Syntax

sap sap-id cem asym-delay-adjust

Context

tools>perform>service>id

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

sap-id

the Cpipe SAP ID

Values

cem	port-id|bridge-id
port-id	slot/mda/port
bridge-id	slot/mda/bridge.branch

cem asym-delay-adjust

performs an ADC analysis on the service

Syntax

system

Context

tools>perform

Description

This command enables the context to use tools that control the system.

Syntax

management-interface

Context

tools>perform>system

Description

This command enables access to the management interface tools.

Syntax

snmp

Context

tools>perform>system>management-interface

Description

This command enables access to the SNMPv3 tools.

Syntax

change-key authentication authentication-protocol old-authentication-key new-authentication-key

change-key authentication authentication-protocol privacy privacy-protocol old-privacy-key new-privacy-key

Context

tools>perform>system>management-interface>snmp

Description

This command generates KeyChange strings to change SNMPv3 authentication or privacy keys. The SNMP engine ID is not needed because localized keys are required as input. The KeyChange algorithm uses a random string so the output is different each time the command is run.

Parameters

authentication-protocol

specifies the SNMPv3 authentication protocol

Values

hmac-md5-96 — specifies use of the HMAC-MD5-96 authentication protocol

hmac-sha1-96 — specifies use of the HMAC-SHA1-96 authentication protocol

hmac-sha2-224 — specifies use of the HMAC-SHA2-224 authentication protocol

hmac-sha2-256 — specifies use of the HMAC-SHA2-256 authentication protocol

hmac-sha2-384 — specifies use of the HMAC-SHA2-384 authentication protocol

hmac-sha2-512 — specifies use of the HMAC-SHA2-512 authentication protocol

old-authentication-key

specifies the old localized authentication key

new-authentication-key

specifies the new localized authentication key

privacy-protocol

specifies the SNMPv3 privacy protocol

Values

cbc-des — specifies use of the CBC-DES privacy protocol; this parameter is not available in FIPS-140-2 mode

cfb128-aes-128 — specifies use of the CFB128-AES-128 privacy protocol

cfb128-aes-192 — specifies use of the CFB128-AES-192 privacy protocol

cfb128-aes-256 — specifies use of the CFB128-AES-256 privacy protocol

old-privacy-key

specifies the old localized privacy key

new-privacy-key

specifies the new localized privacy key

Syntax

generate-key authentication authentication-protocol authentication-password [privacy privacy-protocol privacy-password] [engine-id identifier]

Context

tools>perform>system>management-interface>snmp

Description

This command generates localized SNMPv3 authentication and privacy keys, which are a hash of the SNMP engine ID and a password. The SNMP engine ID can be displayed with the show system information | match "SNMP Engine ID" command and does not need to be entered. If keys are being generated for a different system, its SNMP engine ID must be specified.

Parameters

authentication-protocol

specifies the SNMPv3 authentication protocol

Values

hmac-md5-96 — specifies use of the HMAC-MD5-96 authentication protocol

hmac-sha1-96 — specifies use of the HMAC-SHA1-96 authentication protocol

hmac-sha2-224 — specifies use of the HMAC-SHA2-224 authentication protocol

hmac-sha2-256 — specifies use of the HMAC-SHA2-256 authentication protocol

hmac-sha2-384 — specifies use of the HMAC-SHA2-384 authentication protocol

hmac-sha2-512 — specifies use of the HMAC-SHA2-512 authentication protocol

authentication-password

specifies the password used to generate the authentication key, from 8 to 255 characters

privacy-protocol

specifies the SNMPv3 privacy protocol

Values

cbc-des — specifies use of the CBC-DES privacy protocol; this parameter is not available in FIPS-140-2 mode

cfb128-aes-128 — specifies use of the CFB128-AES-128 privacy protocol

cfb128-aes-192 — specifies use of the CFB128-AES-192 privacy protocol

cfb128-aes-256 — specifies use of the CFB128-AES-256 privacy protocol

privacy-password

specifies the privacy password, from 8 to 255 characters

identifier

specifies an SNMP engine ID; must be a hexadecimal string from 10 to 64 digits

Syntax

script-control

Context

tools>perform>system

Description

This command enables the script-control context to access script policy commands.

Syntax

script-policy

Context

tools>perform>system>script-control

Description

This command enables the script-policy context to access script policy tools.

Syntax

stop [policy-name] [owner policy-owner] [all]

Context

tools>perform>system>script-control>script-policy

Description

This command stops the execution of scripts.

Parameters

policy-name

specifies to only stop scripts with the specified script policy name

policy-owner

specifies to only stop scripts for script policies with the specified owner

all

specifies to stop all running scripts

Syntax

router router-instance

router service-name service-name

Context

tools>perform

Description

This command enables tools for the router instance.

Default

n/a

Parameters

router-instance

specifies the router name and service ID

Values

router-name:      Base, management

service-id:           1 to 2147483647

Default

Base

service-name

specifies the service name

Syntax

isis [isis-instance]

Context

tools>perform>router

Description

This command enables the context to perform specific IS-IS tasks.

Default

n/a

Parameters

isis-instance

specifies the IS-IS protocol instance ID. If no isis-instance is specified, instance 0 is used.

Values

1 to 31

Syntax

mpls

Context

tools>perform>router

Description

This command enables the context to perform specific MPLS tasks.

Default

n/a

Syntax

cspf to ip-addr [from ip-addr] [bandwidth bandwidth] [include-bitmap bitmap] [exclude-bitmap bitmap] [hop-limit limit] [exclude-address excl-addr [excl-addr...(up to 8 max)]] [use-te-metric] [strict-srlg] [srlg-group grp-id...(up to 8 max)] [exclude-node excl-node-id [excl-node-id...(up to 8 max)]] [skip-interface interface-name] [cspf-req-type req-type] [least-fill-min-thd thd]

Context

tools>perform>router>mpls

Description

This command computes a CSPF path with specified user constraints.

Default

n/a

Parameters

to ip-addr

the destination IP address

Values

a.b.c.d

from ip-addr

the originating IP address

Values

a.b.c.d

bandwidth

the amount of bandwidth in megabits per second (Mb/s) to be reserved

Values

0 to 4294967295 (values can be expressed in decimal, hexadecimal, or binary)

include-bitmap bitmap

specifies to include a bitmap that lists the admin groups that should be included during the CSPF computation

exclude-bitmap bitmap

specifies to exclude a bitmap that lists the admin groups that should be included during the CSPF computation

limit

the total number of hops an FRR bypass or detour LSP can take before merging back onto the main LSP path

Values

1 to 255

excl-addr

an IP address to exclude from the CSPF computation (up to a maximum of eight addresses in one command)

Values

a.b.c.d (outbound interface)

use-te-metric

specifies to use the traffic engineering metric used on the interface

strict-srlg

specifies to use strict frr-srlg to compute a new CSPF path

grp-id

specifies to use up to eight SRLGs to compute a new CSPF path

Values

0 to 4294967295

excl-node-id

a node to exclude from the CSPF computation (up to a maximum of eight nodes in one command)

Values

a.b.c.d (outbound interface)

interface-name

a local interface name (rather than the address) to exclude from the CSPF computation

Values

max 32 characters

req-type

the CSPF request type

Values

all – all ECMP paths

random – random ECMP paths

least-fill – specifies whether the use of the least-fill path selection method for the computation of the path for this CSPF request is enabled

thd

the percentage difference below which two links are considered equal for least-fill bandwidth comparison. When comparing the percentages of least available link bandwidth across available paths, whenever two percentages differ by less than the value configured as the least-fill minimum threshold, CSPF considers them to be equal and applies a random number generator to select the path.

Values

1 to 100

Syntax

resignal {lsp lsp-name path path-name | delay minutes}

resignal {sr-te-lsp srte-lsp-name path path-name | sr-te-delay minutes}

Context

tools>perform>router>mpls

Description

This command resignals specified LSP paths. If the lsp or sr-te-lsp parameters are used, the specified LSP path is resignaled immediately. The delay or sr-te-delay parameter is used to override the global timer to resignal all LSPs of the corresponding type. The resignal timer is the time before resignaling occurs after the resignal condition occurs. For the delay option to work, the resignal time in the config>router>mpls context must be set.

The resignal timer is then reset to its configured value in the MPLS configuration. In this case, the new path is programmed in the datapath only if the metric of the new path is different from the metric of the current path.

Default

n/a

Parameters

lsp-name

specifies the name of an existing LSP

path-name

specifies the path name that is used for the LSP; this path must already have been configured

minutes

specifies the delay interval, in minutes, before all LSPs of the corresponding type are resignaled. If the value 0 is entered, all LSPs of the corresponding type are resignaled immediately.

Values

0 to 30

srte-lsp-name

specifies the name of an existing SR-TE LSP

Syntax

resignal-bypass delay minutes

resignal-bypass lsp bypass-lsp-name [force]

Context

tools>perform>router>mpls

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

minutes

the time that MPLS waits before attempting to resignal dynamic bypass LSP paths originated on the system

Values

0 to 30

bypass-lsp-name

the name of the dynamic or manual bypass LSP

force

required when the LSP is a manual bypass LSP with PSB associations

Syntax

sr-te-cspf [path-computation-method path-computation-method] to ip-address [path path-name] [from ip-address] [include-bitmap bitmap] [exclude-bitmap bitmap] [hop-limit limit] [metric-type-te] [strict-srlg] [srlg-group group-id] [local-sr-protection local-sr-protection] [ label-stack-reduction] [max-sr-labels label-stack-size]

Context

tools>perform>router>mpls

Description

This command computes and returns the segment routing label stack for any user-specified MPLS path to a destination router.

By default, or when the path-computation-method is set to ip-to-label, MPLS passes the path information specified with the to and from parameters to the TE-DB, which converts the list of hops to 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 returns the actual selected hop SIDs plus labels, as well as the configured path hop addresses that were used as the input for this conversion. None of the TE constraint parameters are used in this path computation method.

When the user specifies the value of local-cspf for the path-computation-method parameter, MPLS passes all parameters of the tools command, including the TE constraint parameters. In this case, a full local CSPF is run using these parameters.

When the user specifies a path name with this command, CSPF returns a single path, which is selected randomly similar to a configured SR-TE LSP, with the path-computation-method local-cspf command enabled. When no path name is specified with this command, CSPF returns the set of candidate ECMP paths.

Parameters

path-computation-method

specifies the path computation method of the LSP path

Values

ip-to-label, local-cspf

to ip-address

specifies the destination IP address

path-name

specifies the path name

from ip-address

specifies the originating IP address

bitmap

specifies a decimal, hexadecimal, or binary bit-map of the admin groups that should be included in or excluded from the path computation

Values

0 to 4294967295

hop-limit

specifies the maximum number of hops for the path

Values

0 to 255

metric-type-te

specifies the use of the traffic engineering metric to optimize the path. By default, the link IGP metric is used.

strict-srlg

specifies the computation of a path that is strictly disjoint from links which are members of the entered SRLG

group-id

specifies up to eight SRLGs that path computation should avoid, or must avoid if the strict-srlg option is enabled

Values

0 to 4294967295

local-sr-protection

specifies the local LFA protection for the CSPF-computed explicit path with adjacency SIDs

Values

preferred, mandatory, none

label-stack-reduction

applies label stack reduction to the CSPF-computed explicit path with adjacency SIDs

label-stack-size

specifies the maximum label stack size of the CSPF-computed path with or without label stack reduction

Values

1 to 11

Syntax

trap-suppress number-of-traps time-interval

Context

tools>perform>router>mpls

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

number-of-traps

specifies the number of traps in multiples of 100. An error message is generated if an invalid value is entered.

Values

100 to 1000

time-interval

specifies the time interval in seconds

Values

1 to 300

Syntax

update-path {lsp lsp-name path current-path-name new-path new-path-name}

Context

tools>perform>router>mpls

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

lsp-name

specifies the administrative name for this LSP

current-path-name

specifies the name of the current path

new-path-name

specifies the name of the new path

Syntax

ospf

Context

tools>perform>router

Description

This command enables the context to perform specific OSPF tasks.

Default

n/a

Syntax

ldp-sync-exit

Context

tools>perform>router>ospf

tools>perform>router>isis

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

Syntax

refresh-lsas [lsa-type] [area-id]

Context

tools>perform>router>ospf

Description

This command refreshes LSAs for OSPF.

Default

n/a

Parameters

lsa-type

the specified LSA type

Values

router, network, summary, asbr, extern, nssa, opaque

area-id

the OSPF area ID expressed in dotted-decimal notation or as a 32-bit integer

Values

0.0.0.0 to 255.255.255.255 (dotted-decimal), 0 to 4294967295 (decimal integer)

Syntax

run-manual-spf [externals-only]

Context

tools>perform>router>ospf

tools>perform>router>isis

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

externals-only

specifies the route preference for OSPF external routes