Cisco Nexus 7000 Series NX-OS MPLS Command Reference
S Commands
Downloads: This chapterpdf (PDF - 265.0KB) The complete bookPDF (PDF - 5.67MB) | Feedback

S Commands

Table Of Contents

S Commands

send-lifetime

session protection

set

set mpls experimental imposition

shutdown (LDP configuration mode)

shutdown (TE configuration mode)

signalling advertise explicit-null

signalling client batch-time

signalling hello graceful-restart

signalling hello graceful-restart refresh interval

signalling hello graceful-restart refresh misses

signalling hello graceful-restart send recovery-time

signalling hello graceful-restart send restart-time

signalling hello reroute

signalling initial-retransmit-delay

signalling patherr state-removal

signalling rate-limit

signalling refresh interval

signalling refresh misses

signalling refresh reduction

signalling refresh reduction ack-delay

signalling refresh reduction bundle-max-size


S Commands


This chapter describes the Cisco NX-OS Multiprotocol Label Switching commands that begin with S.

send-lifetime

To configure the send lifetime of a key, use the send-lifetime command. To return to the default setting, use the no form of this command.

send-lifetime {start-time | local start-time} {duration seconds | end-time | infinite}

no send-lifetime {start-time | local start-time} {duration seconds | end-time | infinite}

Syntax Description

start-time

Time to start. hh:mm:ss is the time format. The range is from 0 to 23: 0 and from 59: 0 to 59. The maximum size is 8 alphanumeric characters.

local start-time

Specifies the time in the local time zone. hh:mm:ss is the time format.

duration

Sets the send lifetime duration as follows:

Enter the number of days from 1 to 31.

Enter the name of the month.

Enter the year from 1993 to 2035.

seconds

Seconds. The range is from 1 to 2147483646 seconds.

end-time

Time to stop.

infinite

Allows the send lifetime period to never expire.


Defaults

None

Command Modes

Keychain key configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

If the no accept-lifetime value is defined, the associated receive password is valid for authenticating incoming TCP segments.

This command requires the MPLS Services license.

Examples

This example shows how to configure the send lifetime of a key:

switch# configure terminal
switch(config)# key chain keychain1
switch(config-keychain)# key 10
switch(config-keychain-key)# send-lifetime 10:00:00 Jan 13 2010 10:00:00 Jun 13 2010
switch(config-keychain-key)#

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


session protection

To enable Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP) session protection, use the session protection command. To return to the default setting, use the no form of this command.

session protection [for prefix-list] [duration {seconds | infinite}]

no session protection [for prefix-list] [duration {seconds | infinite}]

Syntax Description

for

(Optional) Specifies the prefix list that should be protected.

prefix-list

(Optional) Prefix list for label switched path (LDP) peers.

duration

(Optional) Specifies the period to sustain the session protection after the loss has been discovered by the link discovery process.

seconds

(Optional) Holdup time in seconds. The range is from 30 to 2147483.

infinite

(Optional) Specifies to protect the session forever after the loss has been discovered by the link discovery process.


Defaults

None

Command Modes

LDP configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to enable MPLS LDP session protection:

switch# configure terminal
switch(config)# mpls ldp configuration
switch(config-ldp)# session protection for prefix1 duration 100
switch(config-ldp)#

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


set

To define a mapping of values between two quality of services (QoS) types, use the set command. To return to the default setting, use the no form of this command.

set to-field from field table table-map-name

no set to-field from field table table-map-name

Syntax Description

to-filed

EXP field on the outer (topmost) label (mpls-exp-topmost).

from-field

EXP field to be applied on all imposed labels (mpls-exp-imposition).

table

Specifies the table that defines the mapping from the input to the output.

table-map-name

Name of a system-defined table map or an existing table map.


Defaults

None

Command Modes

Class-map configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

The following example shows how to define a mapping of values between two QoS:

switch# configure terminal
switch(config)# policy-map Policy1
switch(config-pmap-qos)# class Class2
switch(config-pmap-c-qos)# set cos mpls-exp-topmost table dscp-cos-mapset 
switch(config-pmap-c-qos)# end

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


set mpls experimental imposition

To set the value of the Multilprotocol Label Switching (MPLS) experimental field on all imposed label entries, use the set mpls experimental imposition command. To return to the default setting, use the no form of this command.

set mpls experimental imposition mpls-exp-value

no set mpls experimental imposition mpls-exp-value

Syntax Description

mpls-exp-value

Policy map to set the EXP value on all imposed labels of an MPLS header.


Defaults

None

Command Modes

Address family configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to create a policy map to set the EXP field to a value of 3 on all imposed labels of an MPLS header:

switch# configure terminal
switch(config)# policy-map Policy1
switch(config-pmap-qos)# class Class2
switch(config-pmap-c-qos)# set mpls experimental imposition 3
switch(config-pmap-c-qos)# end

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


shutdown (LDP configuration mode)

To shut down all Label Distribution Protocol (LDP) sessions, withdraw all outgoing labels from the forwarding plane, and free all local labels that have been allocated, use the shutdown command. To reactivate the LDP service, use the no form of this command.

shutdown

no shutdown

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

LDP configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to shut down all LDP sessions, withdraw all outgoing labels from the forwarding plane, and free all local labels that have been allocated:

switch# configure terminal
switch(config)# mpls traffic-eng configuration
switch(config-ldp)# shutdown
switch(config-ldp)#

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


shutdown (TE configuration mode)

To shut down the Multiprotocol Label Switching (MPLS) traffic engineering (TE) sessions, use the shutdown command. To return to the default settings, use the no form of this command.

shutdown

no shutdown

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

TE configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

The following example shows how to shutdown the Multiprotocol Label Switching (MPLS) traffic engineering (TE) sessions:

switch# configure terminal
switch(config)# mpls ldp configuration
switch(config-ldp)# shutdown
switch(config-ldp)#

Related Commands

Command
Description

mpls traffic-eng configuration

Configures the Multiprotocol Label Switching (MPLS) Traffic Engineering Protocol (MPLS-TE).


signalling advertise explicit-null

To advertise the explicit null label in signalling messages, use the signalling advertise explicit-null

command. To return to the default settings, use the no form of this command.

signalling advertise explicit-null

no signalling advertise explicit-null

Syntax Description

This command has no arguments or keywords.

Defaults

None

Command Modes

TE configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to advertise the explicit null label in signalling messages:

switch(config)# mpls traffic-eng configuration
switch(config-te)# signalling advertise explicit-null
switch(config-te)#

Related Commands

Command
Description

mpls traffic-eng configuration

Configures the Multiprotocol Label Switching (MPLS) Traffic Engineering Protocol (MPLS-TE).


signalling client batch-time

To configure the client batch timer, use the signalling client batch-time command. To return to the default settings, use the no form of this command.

signalling client batch-time msec

no signalling client batch-time msec

Syntax Description

msec

Milli seconds.The range is from 100 ms to 2000 msec.


Defaults

None

Command Modes

RSVP configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to configure the client batch timer:

switch(config)# ip rsvp
switch(config-ip-rsvp)# signalling refresh reduction
switch(config-ip-rsvp)#

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


signalling hello graceful-restart

To enable node-based hellos for a graceful restart at the global level, use the

signalling hello graceful-restart command. To disable the sending of hellos for a graceful restart, use the no form of this command.

signalling hello graceful-restart

no signalling hello graceful-restart

Syntax Description

This command has no arguments or keywords.

Defaults

ON

Command Modes

RSVP configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to enable node-based hellos for a graceful restart at the global level:

switch(config)# ip rsvp
switch(config-ip-rsvp)# signalling hello graceful-restart
switch(config-ip-rsvp)#

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


signalling hello graceful-restart refresh interval

To configure the interval at which Resource Reservation Protocol (RSVP) graceful-restart hello messages are sent to each neighbor, use the signalling hello graceful-restart refresh command. To return to the default settings, use the no form of this command.

signalling hello graceful-restart refresh interval time

no signalling hello graceful-restart refresh interval time

Syntax Description

time

Hello interval in seconds.The range is from 2000 to 300000.


Defaults

100000 seconds

Command Modes

RSVP configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to configure the interval at which RSVP graceful-restart hello messages are sent to each neighbor:

switch(config)# ip rsvp
switch(config-ip-rsvp)# signalling hello graceful-restart interval 2200
switch(config-ip-rsvp)#

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


signalling hello graceful-restart refresh misses

To configure the number of consecutive missed hello messages before a neighbor is declared down or unreachable, use the signalling hello graceful-restart refresh misses command. To return to the default settings, use the no form of this command.

signalling hello graceful-restart refresh misses refresh-misses

no signalling hello graceful-restart refresh misses refresh-misses

Syntax Description

refresh-misses

Number of missed hello messages. The range is from 4 to 10.


Defaults

4

Command Modes

RSVP configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to configure the number of consecutive missed hello messages before a neighbor is declared down or unreachable:

switch(config)# ip rsvp
switch(config-ip-rsvp)# signalling hello graceful-restart refresh misses 5
switch(config-ip-rsvp)#

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


signalling hello graceful-restart send recovery-time

To configure the recovery time that is advertised in the restart-capability object in hello messages, use the

signalling hello graceful-restart send recovery-time command. To return to the default settings, use the no form of this command.

signalling hello graceful-restart send recovery-time time

no signalling hello graceful-restart send recovery-time time

Syntax Description

time

Hello interval in seconds.The range is from 2000 to 300000.


Defaults

120 seconds

Command Modes

RSVP configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to configure the recovery time that is advertised in the hello messages:

switch(config)# ip rsvp
switch(config-ip-rsvp)# signalling hello graceful-restart send recovery-time 130
switch(config-ip-rsvp)#

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


signalling hello graceful-restart send restart-time

To configure the restart time that is advertised in the restart-capability object in hello messages, use the

signalling hello graceful-restart send restart-time command. To return to the default settings, use the no form of this command.

signalling hello graceful-restart send restart-time time

no signalling hello graceful-restart send restart-time time

Syntax Description

time

Hello interval in seconds.The range is from 2000 to 300000.


Defaults

30 seconds

Command Modes

RSVP configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to configure the restart time that is advertised in the hello messages:

switch(config)# ip rsvp
switch(config-ip-rsvp)# signalling hello graceful-restart send restart-time 130
switch(config-ip-rsvp)#

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


signalling hello reroute

To reroute the use of hello messages, use the signalling hello reroute command. To disable the sending of reroute hellos, use the no form of this command.

signalling hello reroute

no signalling hello reroute

Syntax Description

This commands has no arguments or keywords.

Defaults

OFF

Command Modes

RSVP configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to configure the reroute hello messages:

switch(config)# ip rsvp
switch(config-ip-rsvp)# signalling hello reroute
switch(config-ip-rsvp)#

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


signalling initial-retransmit-delay

To configure the minimum amount of time that Resource Reservation Protocol (RSVP) waits for an acknowledgement before retransmitting the same message, use the signalling initial-retransmit-delay command. To return to the default settings, use the no form of this command.

signalling initial-retransmit-delay time

no signalling initial-retransmit-delay time

Syntax Description

time

Hello interval in seconds.The range is from 2000 to 300000.


Defaults

1 second

Command Modes

RSVP configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to configure the minimum amount time that RSVP waits for an acknowledgement before retransmitting the same message:

switch(config)# ip rsvp
switch(config-ip-rsvp)# signalling initial-retransmit-delay 4
switch(config-ip-rsvp)#

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


signalling patherr state-removal

To delete a path state automatically when forwarding a PATH-ERROR message, use the signalling patherr state-removal command. To return to the default settings, use the no form of this command.

signalling patherr state-removal

no signalling patherr state-removal

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

RSVP configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to delete a path state automatically when forwarding a PATH-ERROR message:

switch(config)# ip rsvp
switch(config-ip-rsvp)# signalling patherr state-removal
switch(config-ip-rsvp)#

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


signalling rate-limit

To rate limit the number of messages being sent to a neighboring router, use the signalling rate-limit

command. To return to the default settings, use the no form of the command.

signalling rate-limit {[interval msec] [limit messages]}

no signalling rate-limit {[interval msec] [limit messages]}

Syntax Description

interval

(Optional) Specifies the scheduling interval.

msec

Interval in milliseconds. The range is from 250 to 2000.

limit

(Optional) Specifies the message limit per scheduling interval.

messages

Message limit value. The range is from 1 to 500.


Defaults

The default are as follows:

Interval— The default is 1000.

Limit— The default is 100.

Command Modes

RSVP configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to rate limit the number of messages that are being sent to a neighboring router:

switch(config)# ip rsvp
switch(config-ip-rsvp)# signalling rate-limit interval 300
switch(config-ip-rsvp)#

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


signalling refresh interval

To configure how often the Resource Reservation Protocol (RSVP) state is refreshed, use the signalling refresh interval command. To return to the default settings, use the no form of this command.

signalling refresh interval time

no signalling refresh interval time

Syntax Description

time

Hello interval in seconds.The range is from 2000 to 300000.


Defaults

30 seconds

Command Modes

RSVP configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to configure how often the RSVP state is refreshed:

switch(config)# ip rsvp
switch(config-ip-rsvp)# signalling refresh interval 35
switch(config-ip-rsvp)#

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


signalling refresh misses

To configure the number of refresh messages that can be missed before the Resource Reservation Protocol (RSVP) determines that a state is to expire, use the signalling refresh misses command. To return to the default

settings, use the no form of this command.

signalling refresh misses refresh-missed

no signalling refresh misses refresh-missed

Syntax Description

time

Hello interval in seconds.The range is from 2000 to 300000.


Defaults

4 seconds.

Command Modes

RSVP configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to configure the number of refresh messages that can be missed before RSVP determines that a state is to expire:

switch(config)# ip rsvp
switch(config-ip-rsvp)# signalling refresh misses 5
switch(config-ip-rsvp)#

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


signalling refresh reduction

To enable the Resource Reservation Protocol (RSVP) refresh reduction, use the signalling refresh reduction command. To disable RSVP refresh reduction, use the no form of the command.

signalling refresh reduction

no signalling refresh reduction

Syntax Description

This command has no arguments or keywords.

Defaults

Enabled

Command Modes

RSVP configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to enable RSVP refresh reduction:

switch(config)# ip rsvp
switch(config-ip-rsvp)# signalling refresh reduction
switch(config-ip-rsvp)#

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


signalling refresh reduction ack-delay

To configure the maximum amount of time the Resource Reservation Protocol (RSVP) holds on to an acknowledgement before sending it, use the signalling refresh reduction ack-delay command. To return to the default settings, use the no form of the command.

signalling refresh reduction ack-delay time

no signalling refresh reduction ack-delay time

Syntax Description

time

Hello interval in seconds.The range is from 2000 to 300000.


Defaults

0.25 second.

Command Modes

RSVP configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to configure the maximum amount of time RSVP holds on to an

acknowledge ment before sending it:

switch(config)# ip rsvp
switch(config-ip-rsvp)# signalling refresh reduction ack-delay
switch(config-ip-rsvp)#

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).


signalling refresh reduction bundle-max-size

To configure the bundle maximum send message size, use the signalling refresh reduction bunde-max-size command. To return to the default settings, use the no form of the command.

signalling refresh reduction bundle-max-size value

no signalling refresh reduction bundle-max-size value

Syntax Description

value

Bundle size in bytes. The range is from 0 to 65000.


Defaults

4096 bytes

Command Modes

RSVP configuration mode

Supported User Roles

network-admin
vdc-admin

Command History

Release
Modification

5.2(1)

This command was introduced.


Usage Guidelines

This command requires the MPLS Services license.

Examples

This example shows how to configure the bundle maximum send message size:

switch(config)# ip rsvp
switch(config-ip-rsvp)# signalling refresh reduction bundle-max-size 30
switch(config-ip-rsvp)#

Related Commands

Command
Description

mpls ldp configuration

Configures the Multiprotocol Label Switching (MPLS) Label Distribution Protocol (LDP).