4.9. MPLS Forwarding Policy Show Command Reference

4.9.1. Command Hierarchies

4.9.1.1. Show Commands

show
— router
— mpls
— forwarding-policies
binding-label [label] [detail]
binding-label [label] egress-stats
binding-label [label] ingress-stats
endpoint [{ip-address | ipv6-address}] [detail]
endpoint [{ip-address | ipv6-address}] egress-stats
forwarding-policy [policy] [detail]
status

4.9.1.2. Clear Commands

clear
— router
— mpls
— forwarding-policies
forwarding-policy name egress-stats

4.9.1.3. Monitor Commands

monitor
— router
— mpls
— forwarding-policies
— forwarding-policy plcy egress-stats [interval seconds] [repeat repeat] [{absolute | rate}]

4.9.2. Command Descriptions

4.9.2.1. Show Commands

Note:

The command outputs in this chapter are examples only; actual displays may differ depending on supported functionality and user configuration.

binding-label

Syntax 
binding-label [label] [detail]
binding-label [label] egress-stats
binding-label [label] ingress-stats
Context 
show>router>mpls>forwarding-policies
Description 

This command displays the MPLS forwarding policy binding label information.

Parameters 
label—
Specifies the label value.
Values—
32 to 1048575

 

detail
Displays detailed information of the binding label.
egress-stats
Displays the egress statistics, if any, of all the instances of the specified forwarding policy.
ingress-stats
Displays ingress statistics information.
Output 

Table 49 describes MPLS binding label output fields.

Table 49:  MPLS Binding Label Output Fields 

Label

Description  

Label

Specifies the label number.

Preference

Specifies the preference.

Oper State

Specifies the operational state (up | down).

Policy Name

Specifies the MPLS forwarding policies binding label name.

No. of Binding Labels

Specifies the number of binding labels.

OperDown Reason

Specifies the reason for being operationally down.

Down Time

Specifies the downtime date and time.

NumNextHopGrps

Specifies the number of next-hop groups.

Ingress Stats

Specifies if ingress stats are enabled for collection (disabled | enabled).

IngOperState

Specifies the ingress operational state (up | down)

Revert Timer

Specifies the revert timer value.

Retry Count

Specifies the retry count.

Next Retry In

Specifies the next retry value.

Next-hop Group

Specifies the next-hop group.

Resolution Type

Specifies the resolution type (direct | indirect).

Num Revert

Specifies the number of reverts.

Num Failover

Specifies the number of failovers.

Next Revert In

Specifies the next revert interval.

Primary nexthop

Specifies the IP address of the primary next-hop.

Resolved

Specifies the resolved status (false | true).

NHopDownReason

Specifies the reason for the next-hop down.

Backup nexthop

Specifies the IP address of the backup next-hop.

StatsOperState

Specifies if a statistic index is allocated to the next-hop.

EgrStatsState

Specifies if all next-hops have a statistic index allocated.

Sample Output
===============================================================================
*A:Dut-C> show router mpls forwarding-policies binding-label 
  - binding-label [<label>] [detail]
*A:Dut-C> show router mpls forwarding-policies binding-label 
===============================================================================
Binding Label
===============================================================================
   Label                      Preference               Oper State
Policy Name                                            
-------------------------------------------------------------------------------
   33                         253                      Down
indirect1
-------------------------------------------------------------------------------
No. of Binding Labels: 1
===============================================================================
*A:Dut-C> show router mpls forwarding-policies binding-label detail 
===============================================================================
Binding Label (Detail)
===============================================================================
Label          : 33                     Preference     : 253
Policy Name    : indirect1
Oper State     : Down                   OperDownReason : notApplicable
Down Time      : 09/28/2018 19:53:33    NumNextHopGrps : 1
Ingress Stats  : Disabled               IngrOperState  : Down
Revert Timer   : 600                    
Retry Count    : 0                      Next Retry In  : 0
Next-hop Group : 1                      Resolution Type: indirect
Oper State     : Down                   OperDownReason : notApplicable
Num Revert     : 0                      Num Failover   : 0
Next Revert In : 0                      
Primary nexthop: 4.4.4.4
Resolved       : False                  NHopDownReason : notApplicable
Backup nexthop : 3.3.3.3
Resolved       : False                  NHopDownReason : notApplicable
-------------------------------------------------------------------------------
show router mpls forwarding-policies binding-label 400001 egress-stats
===============================================================================
Binding Label (Detail)
===============================================================================
Label          : 400001                Preference        : 255 
Policy Name    : cc                    Oper State        : Up
EgrStatsState  : Up
 Next-hop Group   : 1                      
  Primary nexthop : 10.10.5.5  
   StatsOperState : Up
   Aggr Pkts: 11000                    Aggr Octets: 11550000           
  Backup nexthop  : 10.10.11.4  
   StatsOperState : Up
   Aggr Pkts: 11000                    Aggr Octets: 11550000           
 Next-hop Group   : 2                      
  Primary nexthop : 10.10.5.5  
   StatsOperState : Up
   Aggr Pkts: 11000                    Aggr Octets: 11550000             
  Backup nexthop  : 10.10.11.4  
   StatsOperState : Up
   Aggr Pkts: 11000                    Aggr Octets: 11550000 
Total Aggr        :
   Aggr Pkts: 44000                    Aggr Octets: 46200000
-------------------------------------------------------------------------------
===============================================================================

endpoint

Syntax 
endpoint [{ip-address | ipv6-address}] [detail]
endpoint [{ip-address | ipv6-address}] egress-stats
Context 
show>router>mpls>forwarding-policies
Description 

This command displays the MPLS forwarding policy endpoint information.

Parameters 
ip-address—
Specifies the IPv4 address of the endpoint up to 64 characters.
ipv6-address—
Specifies the IPv6 address of the endpoint up to 64 characters.
detail
Specifies detailed information for the endpoint.
egress-stats—
Displays the egress statistics, if any, of all the instances of the specified forwarding policy.
Output 

Table 50 describes MPLS endpoint output fields.

Table 50:  MPLS Endpoint Output Fields 

Label

Description

Endpoint

Specifies the endpoint IP address.

Preference

Specifies the preference.

Policy Name

Specifies the MPLS forwarding policies binding label name.

Active

Specifies the active state (Y | N).

InactiveReason

Specifies the inactive reason.

Last Updated

Specifies the date and time of the last update.

Num Grps

Specifies the number of groups.

OperState

Specifies the operational state (up | down).

Metric

Specifies the metric value.

TTM Preference

Specifies the TTM preference value.

Revert Timer

Specifies the revert timer value.

Path Pref

Specifies the path preference.

Retry Count

Specifies the retry count.

Next Retry In

Specifies the next retry value.

Next-hop Group

Specifies the next-hop group.

Resolution Type

Specifies the resolution type (direct | indirect).

Oper State

Specifies the operational state (down | up).

Oper Down Reas*

Specifies the reason for being operationally down.

Num Revert

Specifies the number of reverts.

Num Failover

Specifies the number of failovers.

Next Revert In

Specifies the next revert interval.

Weight

Specifies the weight value.

Primary

Specifies the IP address of the primary next-hop.

Resolved

Specifies the resolved status (false | true).

Down Reason

Specifies the down reason.

Backup

Specifies the IP address of the backup next-hop.

StatsOperState

Specifies if a statistic index is allocated to the next-hop.

EgrStatsState

Specifies if all next-hops have a statistic index allocated.

Sample Output
A:Dut-C# show router mpls forwarding-policies endpoint detail 
===============================================================================
Endpoint (Detail)
===============================================================================
Endpoint       : 10.20.1.2              Preference     : 255
Policy Name    : one
Active         : N                      InactiveReason : Not Applicable
Last Updated   : 09/27/2018 22:51:26    Num Grps       : 2
Metric         : 0                      TTM Preference : 255
Revert Timer   : 0                      Path Pref      : 255
Retry Count    : 0                      Next Retry In  : 0
Nexthop Group  : 1                      Resolution Type: direct
Oper State     : Down                   OperDownReason : Not Applicable
Num Revert     : 0                      Num Failover   : 0
Next Revert In : 0                      Weight         : 0
Primary        : 10.10.3.2
Resolved       : False                  Down Reason    : Not Applicable
Backup         : 10.10.12.2
Resolved       : False                  Down Reason    : Not Applicable
Nexthop Group  : 2                      Resolution Type: direct
Oper State     : Down                   OperDownReason : Not Applicable
Num Revert     : 0                      Num Failover   : 0
Next Revert In : 0                      Weight         : 45
Primary        : 10.10.3.3
Resolved       : False                  Down Reason    : Not Applicable
Backup         : 10.10.4.4
Resolved       : False                  Down Reason    : Not Applicable
-------------------------------------------------------------------------------
*A:Dut-B# show router mpls forwarding-policies endpoint          
===============================================================================
Endpoint Table
===============================================================================
Endpoint                      Preference               Active
-------------------------------------------------------------------------------
10.20.1.5                     2                        Y
-------------------------------------------------------------------------------
No. of Tunnels: 1
show router mpls forwarding-policies endpoint 10.20.1.5 egress-stats
===============================================================================
Endpoint (Detail)
===============================================================================
Endpoint       : 10.20.1.5             Preference        : 255 
Policy Name    : cc                    Oper State        : Up
EgrStatsState  : Up
 Next-hop Group   : 1                      
  Primary nexthop : 10.10.5.5  
   StatsOperState : Up
   Aggr Pkts: 11000                    Aggr Octets: 11550000           
  Backup nexthop  : 10.10.11.4  
   StatsOperState : Up
   Aggr Pkts: 11000                    Aggr Octets: 11550000           
 Next-hop Group   : 2                      
  Primary nexthop : 10.10.5.5  
   StatsOperState : Up
   Aggr Pkts: 11000                    Aggr Octets: 11550000             
  Backup nexthop  : 10.10.11.4  
   StatsOperState : Up
   Aggr Pkts: 11000                    Aggr Octets: 11550000 
Total Aggr        :
   Aggr Pkts: 44000                    Aggr Octets: 46200000
-------------------------------------------------------------------------------
===============================================================================

forwarding-policy

Syntax 
forwarding-policy [policy] [detail]
Context 
show>router>mpls>forwarding-policies
Description 

This command displays the MPLS forwarding policy information.

Parameters 
policy—
Specifies the policy name.
detail
Specifies detailed information.
Output 

Table 51 describes MPLS forward-policy output fields.

Table 51:  MPLS Forward-policy Output Fields 

Label

Description  

Policy Name

Specifies the MPLS forwarding policy name.

Binding Label

Specifies the binding label number.

Admin

Specifies the administrative state (up | down).

OperState

Specifies the operational state (up | down).

No. of Forwarding Policies

Specifies the number of forwarding policies.

Type

Specifies the type.

Binding Label

Specifies the binding label number.

Last Change

Specifies the date and time of the last change.

Sample Output
A*A:Dut-B>config>router>mpls# /show router mpls forwarding-policies forwarding-
policy
===============================================================================
MPLS Forwarding Policy
===============================================================================
Policy Name                                  Binding Label      Admin   Oper
-------------------------------------------------------------------------------
smallername!pol1                             0                  Down    Down
policy1-32chars-policy1-32chars              33                 Up      Down
fwdpolicyName!!ThisNameIs32chars             111                Up      Down
-------------------------------------------------------------------------------
No. of Forwarding Policies: 3
===============================================================================
*A:Dut-B>show>router>mpls# forwarding-policies forwarding-policy detail 
===============================================================================
Forwarding Policy Status (Detail)
===============================================================================
-------------------------------------------------------------------------------
Type : Label
-------------------------------------------------------------------------------
Policy Name      : smallername!pol1
Admin State      : Down                 Oper State       : Down
Binding Label    : 0                    Preference       : 2
Binding Label    : 0                    
Last Change      : 03/28/2018 23:52:45  
Ingress Stats    : Disabled             
 
-------------------------------------------------------------------------------
Type : Label
-------------------------------------------------------------------------------
Policy Name      : policy1-32chars-policy1-32chars
Admin State      : Up                   Oper State       : Down
Binding Label    : 33                   Preference       : 254
Binding Label    : 33                   
Last Change      : 03/28/2018 23:57:33  
Ingress Stats    : Disabled             
 
Next-hop Group   : 20                   
Admin State      : Up                   Oper State       : Down
Resolution Type  : direct               
Last Change      : 03/28/2018 23:57:32  
 
Primary
Oper State       : Down                 NH Addr          : 2.2.2.2
Last Change      : 03/28/2018 23:57:32  
Backup
Oper State       : Down                 NH Addr          : 3.3.3.3
Last Change      : 03/28/2018 23:57:32  
===============================================================================

status

Syntax 
status
Context 
show>router>mpls>forwarding-policies
Description 

This command displays MPLS Forwarding status information

Output 

Table 52 describes MPLS forward-policy status output fields.

Table 52:  MPLS Forward-policy Status Output Fields 

Label

Description  

Reserved label bl

Specifies the MPLS reserved label block name.

Sample Output
*A:Dut-B>show>router>mpls# forwarding-policies status 
===============================================================================
Forwarding Policy Status
===============================================================================
Admin Status     : Up                   Oper Status             : Down
Reserved label bl: reservedlabel!!!blockname32chars
===============================================================================

4.9.2.2. Clear Commands

forwarding-policy

Syntax 
forwarding-policy name egress-stats
Context 
clear>router>mpls>forwarding-policies
Description 

This command clears the egress statistics of the specified forwarding policy instance.

Parameters 
name—
Specifies the forwarding policy name up to 64 characters.
egress-stats
Clears the egress statistics of the specified forwarding policy.

4.9.2.3. Monitor Commands

forwarding-policy

Syntax 
forwarding-policy plcy egress-stats [interval seconds] [repeat repeat] [{absolute | rate}]
Context 
monitor>router>mpls>forwarding-policies
Description 

This command clears the egress statistics of the specified forwarding policy instance.

Parameters 
plcy—
Specifies the forwarding policy up to 64 characters.
egress-stats
Monitors the egress statistics of the specified forwarding policy.
seconds—
Configures the interval for each display in seconds.
Values—
3 to 60

 

repeat—
Configures how many times the command is repeated.
Values—
1 to 999

 

absolute—
Displays the absolute statistics of the specified forwarding policy.
rate—
Displays the rate statistics of the specified forwarding policy.