For feedback, use the following:
ipd_online_feedback@alcatel-lucent.com
Table of Contents Previous Next Index PDF


MPLS Configuration Commands
Generic Commands
shutdown
Syntax 
[no] shutdown
Context 
config>router>mpls
config>router>mpls>interface
config>router>mpls>lsp>primary
config>router>mpls>lsp>secondary
Description 
This command administratively disables an entity. When disabled, an entity does not change, reset, or remove any configuration settings or statistics.
MPLS is not enabled by default and must be explicitely enabled (no shutdown).
The operational state of the entity is disabled as well as the operational state of any entities contained within. Many objects must be shut down before they may be deleted.
The no form of this command places the entity into an administratively enabled state.
Default 
no shutdown
 
MPLS Commands
mpls
Syntax 
[no] mpls
Context 
config>router
Description 
This command enables the context to configure MPLS parameters. MPLS is not enabled by default and must be explicitely enabled (no shutdown). The shutdown command administratively disables MPLS.
The no form of this command deletes this MPLS protocol instance; this will remove all configuration parameters for this MPLS instance.
MPLS must be shutdown and all SDP bindings to LSPs removed before the MPLS instance can be deleted. If MPLS is not shutdown, when the no mpls command is executed, a warning message on the console displays indicating that MPLS is still administratively up.
admin-group
Syntax 
admin-group group-name group-value
no admin-group group-name
Context 
config>router>mpls
Description 
This command is used to define administrative groups or link coloring for an interface. The admin group names can signify link colors, such as red, yellow, or green. MPLS interfaces advertise the link colors the support. CSPF uses the information when paths are computed for constraint-based LSPs. CSPF must be enabled in order for admin groups to be relevant.
Network resources (links) based on zones, geographic location, link location, etc., can be classified using admin groups. MPLS interfaces must be explicitly assigned to an admin group.
Admin groups must be defined in the config>router>mpls context before they can be assigned to an MPLS interface. The IGP communicates the information throughout the area.
Up to 32 group names can be defined in the config>router>mpls context. The admin-group names must be identical across all routers in a single domain.
The no form of this command deletes the administrative group. All configuration information associated with this LSP is lost.
Default 
none
Parameters 
group-name
Specify the name of the administrative group within a virtual router instance.
group-value
Specify the group value associated with this administrative group. This value is unique within a virtual router instance.
Values
accounting-policy
Syntax 
accounting-policy acct-policy-id
no accounting-policy
Context
config>router>mpls>ingr-stats
config>router>mpls>lsp>egr-stats
config>router>mpls>lsp-template>egr-stats
Description 
This command associates an accounting policy to the MPLS instance.
An accounting policy must be defined before it can be associated else an error message is generated.
The no form of this command removes the accounting policy association.
Default 
none
Parameters 
acct-policy-id
Enter the accounting policy-id as configured in the config>log>accounting-policy context.
Values
collect-stats
Syntax 
[no] collect-stats
Context 
config>router>mpls>ingr-stats
config>router>mpls>lsp>egr-stats
config>router>mpls>lsp-template>egr-stats
Description 
This command enables accounting and statistical data collection. When applying accounting policies the data, by default, is collected in the appropriate records and written to the designated billing file.
When the no collect-stats command is issued the statistics are still accumulated by the forwarding engine. However, the CPU will not obtain the results and write them to the billing file. If a subsequent collect-stats command is issued then the counters written to the billing file include all the traffic while the no collect-stats command was in effect.
Default 
collect-stats
dynamic-bypass
Syntax 
dynamic-bypass [enable | disable]
no dynamic-bypass
Context 
config>router>mpls
Description 
This command disables the creation of dynamic bypass LSPs in FRR. One or more manual bypass LSPs must be configured to protect the primary LSP path at the PLR nodes.
Default 
enable
egress-statistics
Syntax 
[no] egress-statistics
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
This command configures statistics in the egress data path of an originating LSP at a head-end node. The user must execute the no shutdown for this command to effectively enable statistics.
The same set of counters is updated for packets forwarded over any path of the LSP and over the lifetime of the LSP. In steady state, the counters are updated for packets forwarded over the active path of the LSP. The active path can be the primary path, one of the secondary paths, the FRR detour path, or the FRR bypass path when the head-end node is also the PLR.
LSP statistics are not collected on a dynamic or a static bypass tunnel itself.
When a hierarchy of LSPs is in use, statistics collection on the outermost label corresponding to the tunneling LSP and on the inner labels, corresponding to the tunneled LSPs, are mutually exclusive. A consequence of this is that when the user enables statistics collection on an RSVP LSP which is also used for tunneling LDP FECs with the LDP over RSVP feature, then statistics will be collected on the RSVP LSP only. There will be no statistics collected from an LDP FEC tunneled over this RSVP LSP regardless if the user enabled statistics collection on this FEC. When, the user disables statistics collection on the RSVP LSP, then statistics collection, if enabled, will be performed on a tunneled LDP FEC.
The no form of this command disables the statistics in the egress data path and removes the accounting policy association from the RSVP LSP.
Default 
no egress-statistics
exponential-backoff-retry
Syntax 
exponential-backoff-retry
no exponential-backoff-retry
Context 
configure>router>mpls
Description 
This command enables the use of an exponential back-off timer when re-trying an LSP. When an LSP path establishment attempt fails, the path is put into retry procedures and a new attempt will be performed at the expiry of the user-configurable retry timer (config>router>mpls>lsp>retry-timer). By default, the retry time is constant for every attempt. The exponential back-off timer procedures will double the value of the user configured retry timer value at every failure of the attempt to adjust to the potential network congestion that caused the failure. An LSP establishment fails if no Resv message was received and the Path message retry timer expired or a PathErr message was received before the timer expired.
admin-group-frr
Syntax 
[no] admin-group-frr
Context 
config>router>mpls
Description 
This command enables the use of the admin-group constraints in the association of a manual or dynamic bypass LSP with the primary LSP path at a Point-of-Local Repair (PLR) node.
When this command is enabled, each PLR node reads the admin-group constraints in the FAST_REROUTE object in the Path message of the LSP primary path. If the FAST_REROUTE object is not included in the Path message, then the PLR will read the admin-group constraints from the Session Attribute object in the Path message.
If the PLR is also the ingress LER for the LSP primary path, then it just uses the admin-group constraint from the LSP and/or path level configurations.
The PLR node then uses the admin-group constraints along with other constraints, such as hop-limit and SRLG, to select a manual or dynamic bypass among those that are already in use.
If none of the manual or dynamic bypass LSP satisfies the admin-group constraints, and/or the other constraints, the PLR node will request CSPF for a path that merges the closest to the protected link or node and that includes or excludes the specified admin-group IDs.
If the user changes the configuration of the above command, it will not have any effect on existing bypass associations. The change will only apply to new attempts to find a valid bypass.
The no form of this command disables the use of administrative group constraints on a FRR backup LSP at a PLR node.
Default 
no frr-admin-group
frr-object
Syntax 
[no] frr-object
Context 
config>router>mpls
Description 
This command specifies whether fast reroute for LSPs using the facility bypass method is signalled with or without the fast reroute object using the one-to-one keyword. The value is ignored if fast reroute is disabled for the LSP or if the LSP is using one-to-one Backup.
Default 
frr-object — The value is by default inherited by all LSPs.
hold-timer
Syntax 
hold-timer seconds
no hold-timer
Context 
config>router>mpls
Description 
This command specifies the amount of time that the ingress node holds before programming its data plane and declaring the LSP up to the service module. This occurs anytime the ingress node brings up an LSP path or switches traffic from a working path to another working path of the same LSP.
The no form of the command reverts the hold-timer to the default value.
Parameters 
seconds
Specifies the time, in seconds, for which the ingress node holds before programming its data plane and declaring the LSP up to the service module.
Values
Default 
1 second
ingress-statistics
Syntax 
ingress-statistics
Context 
config>router>mpls
Description 
This command provides the context for the user to enter the LSP names for the purpose of enabling ingress data path statistics at the terminating node of the LSP, for example, egress LER.
Default 
none
least-fill-min-thd
Syntax 
least-fill-min-thd percent
no least-fill-min-thd
Context 
config>router>mpls
Description 
This parameter is used in the least-fill path selection process. When comparing the percentage of least available link bandwidth across the sorted paths, whenever two percentages differ by less than the value configured as the least-fill-min-thresh, CSPF will consider them equal and will apply a random number generator to select the path among these paths
The no form of the command resets this parameter to its default value.
Default 
5
Parameters 
percentage
Specifies the least fill minimum threshold value as a percentage.
Values
least-fill-reoptim-thd
Syntax 
least-fill-reoptim-thd percent
no least-fill-reoptim-thd
Context 
config>router>mpls
Description 
This parameter is used in the least-fill path selection method. During a timer-based re-signaling of an LSP path which has the least-fill option enabled, CSPF will first update the least-available bandwidth figure for the current path of this LSP. It then applies the least-fill path selection method to select a new path for this LSP. If the new computed path has the same cost as the current path, it will compare the least-available bandwidth figures of the two paths and if the difference exceeds the user configured optimization threshold, MPLS will generate a trap to indicate that a better least-fill path is available for this LSP. This trap can be used by an external SNMP based device to trigger a manual re-signaling of the LSP path since the timer-based re-signaling will not re-signal the path in this case. MPLS will generate a path update trap at the first MBB event which results in the re-signaling of the LSP path. This should clear the eligibility status of the path at the SNMP device.
The no form of this command resets this parameter to its default value.
Default 
10
Parameters 
percentage
Specifies the least fill reoptimization threshold value as a percentage.
Values
lsp
Syntax 
[no] lsp lsp-name sender sender-address
Context 
config>router>mpls>ingress-statistics
Description 
This command configures statistics in the ingress data path of a terminating RSVP LSP at an egress LER. The LSP name must correspond to the name configured by the operator at the ingress LER. It must not contain the special character “:” which is used as a field separator by the ingress LER for encoding the LSP and path names into the RSVP session name field in the session_attribute object. The operator must execute the no shutdown for this command to effectively enable statistics.
The same set of counters is updated for packets received over any path of this LSP and over the lifetime of the LSP. In steady-state, the counters are updated for packets received over the active path of the LSP. The active path can be the primary path, one of the secondary paths, the FRR detour path, or the FRR bypass path when the tail-end node is also the MP.
When a hierarchy of LSPs is in use, statistics collection on the outermost label corresponding to the tunneling LSP and on the inner labels, corresponding to the tunneled LSPs are mutually exclusive. A consequence of this is that when the operator enables statistics collection on an RSVP LSP which is also used for tunneling LDP FECs with the LDP over RSVP feature, then statistics will be collected on the RSVP LSP only. There will be no statistics collected for an LDP FEC tunneled over this RSVP LSP and also egressing on the same node regardless if the operator enabled statistics collection on this FEC. When, the operator disables statistics collection on the RSVP LSP, then statistics collection, if enabled, will be performed on a tunneled LDP FEC.
The operator can enable statistics collection on a manual bypass terminating on the egress LER. However all LSPs which primary path is protected by the manual bypass will not collect statistics when they activate forwarding over the manual bypass. When, the operator disables statistics collection on the manual bypass LSP, then statistics collection on the protected LSP, if enabled, will continue when the bypass LSP is activated.
The no form of this command disables statistics for this RSVP LSP in the ingress data path and removes the accounting policy association from the LSP.
Default 
none
Parameters 
sender-address ip-address
A string of 15 characters representing the IP address of the ingress LER for the LSP.
lsp-name
A string of up to 32 characters identifying the LSP name as configured at the ingress LER.
logger-event-bundling
Syntax 
[no] logger-event-bundling
Context 
configure>router>mpls
Description 
This feature merges two of the most commonly generated MPLS traps, vRtrMplsXCCreate and vRtrMplsXCDelete, which can be generated at both LER and LSR into a new specific trap vRtrMplsSessionsModified. In addition, this feature will perform bundling of traps of multiple RSVP sessions, i.e., LSPs, into this new specific trap.
The intent is to provide a tool for the user to minimize trap generation in an MPLS network. Note that the MPLS trap throttling will not be applied to this new trap.
The no version of this command disables the merging and bundling of the above MPLS traps.
lsp-template
Syntax 
lsp-template template-name [p2mp | one-hop-p2p | mesh-p2p]
no lsp-template template-name
Context 
config>router>mpls
Description 
This command creates a template construct that can be referenced by client application where dynamic LSP creation is required. The LSP template type p2mp, one-hop-p2p, or mesh-p2p is mandatory.
The no form of command deletes LSP template. LSP template cannot be deleted if a client application is using it.
Parameters 
lsp-template-name
Specifies the name of the LSP template. Any LSP template name and LSP name must not be the same.
p2mp | one-hop-p2p | mesh-p2p
Identifies the t ype of the LSP this template will signal.
 
lsp-init-retry-timeout
Syntax 
lsp-init-retry-timeout seconds
no lsp-init-retry-timeout
Context 
config>router>mpls
Description 
This command configures the initial LSP path retry-timer.
The new LSP path initial retry-timer is used instead of the retry-timer to abort the retry cycle when no RESV is received. The retry-timer will govern exclusively the time between two retry cycles and to handle retrying of an LSP path in a failure case with PATH errors or RESVTear.
The intent is that the user can now control how many refreshes of the pending PATH state can be performed before starting a new retry-cycle with a new LSP-id. This is all done without affecting the ability to react faster to failures of the LSP path, which will continue to be governed by the retry-timer.
The no form of this command returns the timer to the default value.
Parameters 
seconds
Specifies the value, in seconds, used as the fast retry timer for a secondary path.
Values
Default
lsp-template
Syntax 
lsp-template template-name [p2mp | one-hop-p2p | mesh-p2p]
no lsp-template template-name
Context 
config>router>mpls
Description 
This command creates a template construct that can be referenced by client application where dynamic LSP creation is required. The LSP template type p2mp, one-hop-p2p, or mesh-p2p is mandatory.
The no form of command deletes LSP template. LSP template cannot be deleted if a client application is using it.
Parameters 
lsp-template-name
Specifies the name to identify LSP template. ANy LSP template name and LSP name must not be the same.
p2mp | one-hop-p2p | mesh-p2p
Identifies the type of the LSP this template will signal.
propagate-admin-group
Syntax 
[no] propagate-admin-group
Context 
config>router>mpls>lsp>fast-reroute
config>router>mpls>lsp-template>fast-reroute
Description 
The command enables the signaling of the primary LSP path admin-group constraints in the FRR object at the ingress.
When this command is executed, the admin-group constraints configured in the context of the P2P LSP primary path, or the ones configured in the context of the LSP and inherited by the primary path, are copied into the FAST_REROUTE object. The admin-group constraints are copied into the ‘include-any’ or ‘exclude-any’ fields.
The ingress LER thus propagates these constraints to the downstream nodes during the signaling of the LSP to allow them to include the admin-group constraints in the selection of the FRR backup LSP for protecting the LSP primary path.
The ingress LER will insert the FAST_REROUTE object by default in a primary LSP path message. If the user disables the object using the following command, the admin-group constraints will not be propagated: configure>router>mpls>no frr-object .
Note that the same admin-group constraints can be copied into the Session Attribute object. They are intended for the use of an LSR, typically an ABR, to expand the ERO of an inter-area LSP path. They are also used by any LSR node in the path of a CSPF or non-CSPF LSP to check the admin-group constraints against the ERO regardless if the hop is strict or loose. These are governed strictly by the command:
configure>router>mpls>lsp>propagate-admin-group
In other words, the user may decide to copy the primary path admin-group constraints into the FAST_REROUTE object only, or into the Session Attribute object only, or into both. Note, however, that the PLR rules for processing the admin-group constraints can make use of either of the two object admin-group constraints.
This feature is supported with the following LSP types and in both intra-area and inter-area TE where applicable:
The no form of this command disables the signaling of administrative group constraints in the FRR object.
Default 
no propagate-admin-group
max-bypass-associations
Syntax 
max-bypass-associations integer
no max-bypass-associations
Context 
config>router>mpls
Description 
This command allows the user to set a maximum number of LSP primary path associations with each manual or dynamic bypass LSP that is created in the system.
By default, a Point of Local Repair (PLR) node will associate a maximum of 1000 primary LSP paths with a given bypass before using the next available manual bypass or signaling a new dynamic bypass.
Note that a new bypass LSP may need to be signaled if the constraint of a given primary LSP path is not met by an existing bypass LSP even if the max-bypass-associations for this bypass LSP has not been reached.
The no form of the command re-instates the default value of this parameter.
Default 
no max-bypass-associations
Values
resignal-timer
Syntax 
resignal-timer minutes
no resignal-timer
Context 
config>router>mpls
Description 
This command specifies the value for the LSP resignal timer. The resignal timer is the time, in minutes, the software waits before attempting to resignal the LSPs.
When the resignal timer expires, if the new computed path for an LSP has a better metric than the current recorded hop list, an attempt is made to resignal that LSP using the make-before-break mechanism. If the attempt to resignal an LSP fails, the LSP will continue to use the existing path and a resignal will be attempted the next time the timer expires.
The no form of the command disables timer-based LSP resignalling.
Default 
no resignal-timer
Parameters 
minutes
The time the software waits before attempting to resignal the LSPs.
Values
secondary-fast-retry-timer
Syntax 
secondary-fast-retry-timer seconds
no secondary-fast-retry-timer
Context 
config>router>mpls
Description 
This command specifies the value used as the fast retry timer for a secondary path. If the first attempt to set up a secondary path fails due to a path error, the fast retry timer will be started for the secondary path so that the path can be retried sooner. If the next attempt also fails, further retries for the path will use the configured value for LSP retry timer.
If retry-timer for the LSP is configured to be less than the MPLS secondary-fast-retry-timer, all retries for the secondary path will use the LSP retry-timer.
The no form of the command reverts to the default.
Default 
no secondary-fast-retry-timer
Parameters 
seconds
specifies the value, in seconds, used as the fast retry timer for a secondary path
Values
srlg-frr
Syntax 
srlg-frr [strict]
no srlg-frr
Context 
config>router>mpls
Description 
This command enables the use of the Shared Risk Loss Group (SRLG) constraint in the computation of FRR bypass or detour to be associated with any primary LSP path on this system.
When this option is enabled, CSPF includes the SRLG constraint in the computation of a FRR detour or bypass for protecting the primary LSP path.
CSPF prunes all links with interfaces which belong to the same SRLG as the interface which is being protected, i.e., the outgoing interface at the PLR the primary path is using. If one or more paths are found, the MPLS/RSVP task will select one based on best cost and will signal the bypass/detour. If not and the user included the strict option, the bypass/detour is not setup and the MPLS/RSVP task will keep retrying the request to CSPF. Otherwise, if a path exists which meets the other TE constraints, other than the SRLG one, the bypass/detour is setup.
A bypass or a detour LSP path is not guaranteed to be SRLG disjoint from the primary path. This is because only the SRLG constraint of the outgoing interface at the PLR the primary path is using is checked.
When the MPLS/RSVP task is searching for a SRLG bypass tunnel to associate with the primary path of the protected LSP, it will first check if any configured manual bypass LSP with CSPF enabled satisfies the SLRG constraints. The MPLS/RSVP skips any non-CSPF bypass LSP in the search as there is no ERO returned to check the SLRG constraint. If no path is found, it will check if an existing dynamic bypass LSP satisfies the SLRG and other primary path constraints. If not, then it will make a request to CSPF.
Once the primary path of the LSP is set up and is operationally up, any subsequent changes to the SRLG group membership of an interface the primary path is using would not be considered by the MPLS/RSVP task at the PLR for bypass/detour association until the next opportunity the primary path is re-signaled. The path may be re-signaled due to a failure or to a make-before break operation. Make-before break occurs as a result of a global revertive operation, a timer based or manual re-optimization of the LSP path, or a user change to any of the path constraints.
Once the bypass or detour path is setup and is operationally UP, any subsequent changes to the SRLG group membership of an interface the bypass/detour path is using would not be considered by the MPLS/RSVP task at the PLR until the next opportunity the association with the primary LSP path is re-checked. The association is re-checked if the bypass path is re-optimized. Detour paths are not re-optimized and are re-signaled if the primary path is down.
Enabling or disabling srlg-frr only takes effect after LSP paths are resignaled. This can be achieved by shutting down and re-enabling MPLS. Another option is using the tools perform router mpls resignal command. However, note that while the latter might be less service impacting, only originating LSPs can be resignaled with the tools command. If also local transit and bypass LSPs are to be resignaled, the tools command must be executed on all ingress nodes in the network. The same might be locally achieved by disabling and enabling using the configure router mpls dynamic-bypass command, but this can trigger the LSP to go down and traffic loss to occur in case detour or bypass LSP is in use.
An RSVP interface can belong to a maximum of 64 SRLG groups. The user configures the SRLG groups using the command config>router>mpls>srlg-group. The user configures the SRLG groups an RSVP interface belongs to using the srlg-group command in the config>router>mpls>interface context.
The no form of the command reverts to the default value.
Default 
no srlg-frr
Parameters 
strict
Specifies the name of the SRLG group within a virtual router instance.
Values
srlg-group
Syntax 
srlg-group group-name {value group-value}
no srlg-group group-name
Context 
config>router>mpls
Description
This command is used to define shared risk loss groups (SRLGs). An SRLG group represents a set of interfaces which could be subject to the same failures or defects and thus share the same risk of failing.
RSVP interfaces must be explicitly assigned to an SRLG group. SRLG groups must be defined in the config>router>mpls context before they can be assigned to an RSVP interface. Two different SRLG group names cannot share the same value. Once an SRLG group has been bound to an MPLS interface, its value cannot be changed until the binding is removed.
The IGP communicates the information throughout the area using the TE link state advertisement. CSPF uses the information when paths are computed for constraint-based LSPs. CSPF must be enabled in order for SRLG groups to be relevant.
Up to 1024 group names can be defined in the config>router>mpls context. The SRLG group names must be identical across all routers in a single domain.
The no form of this command deletes the SRLG group.
Default 
none
Parameters 
group-name
Specifies the name of up to 32 characters of the SRLG group within a virtual router instance.
value group-value
Specifies the group value associated with this SRLG group. This value is unique within a virtual router instance.
Values
user-srlg-db
Syntax 
user-srlg-db [enable | disable]
Context 
config>router>mpls
Description 
This command enables the use of CSPF by the user SRLG database. When the MPLS module makes a request to CSPF for the computation of an SRLG secondary path, CSPF will query the local SRLG and compute a path after pruning links that are members of the SRLG IDs of the associated primary path. When MPLS makes a request to CSPF for an FRR bypass or detour path to associate with the primary path, CSPF queries the user SRLG database and computes a path after pruning links that are members of the SRLG IDs of the PLR outgoing interface.
If an interface was not entered into the user SRLG database, it is assumed that it does not have any SRLG membership. CSPF will not query the TE database for IGP advertised interface SRLG information.
The disable keyword disables the use of the user SRLG database. CSPF will then resume queries into the TE database for SRLG membership information. The user SRLG database is maintained.
Default 
user-srlg-db disable
srlg-database
Syntax 
[no] srlg-database
Context 
config>router>mpls
Description 
This command provides the context for the user to enter manually the link members of SRLG groups for the entire network at any node that needs to signal LSP paths (for example, a head-end node).
The no form of the command deletes the entire SRLG database. CSPF will assume all interfaces have no SRLG membership association if the database was not disabled with the command config>router>mpls>user-srlg-db disable.
router-id
Syntax 
[no] router-id ip
Context 
config>router>mpls>srlg-database
Description 
This command provides the context for the user to manually enter the link members of SRLG groups for a specific router in the network. The user must also use this command to enter the local interface SRLG membership into the user SRLG database. Use by CSPF of all interface SRLG membership information of a specific router ID may be temporarily disabled by shutting down the node. If this occurs, CSPF will assume these interfaces have no SRLG membership association.
The no form of this command will delete all interface entries under the router ID.
Parameters 
ip-address
Specifies the router ID for this system. This must be the router ID configured under the base router instance, the base OSPF instance or the base IS-IS instance.
interface
Syntax 
interface ip-address srlg-group group-name [group-name...(up to 5 max)]
no interface ip-address [srlg-group group-name...(up to 5 max)]
Context 
config>router>mpls>srlg-database>router-id
Description 
This command allows the operator to manually enter the SRLG membership information for any link in the network, including links on this node, into the user SRLG database.
An interface can be associated with up to 5 SRLG groups for each execution of this command. The operator can associate an interface with up to 64 SRLG groups by executing the command multiple times.
CSPF will not use entered SRLG membership if an interface is not validated as part of a router ID in the routing table.
The no form of the command deletes a specific interface entry in this user SRLG database. The group-name must already exist in the config>router>mpls>srlg-group context.
Default 
none
Parameters 
ip-int-name
The name of the network IP interface. An interface name cannot be in the form of an IP address.
srlg-group group-name
Specifies the SRLG group name. Up to 1024 group names can be defined in the config>router>mpls context. The SRLG group names must be identical across all routers in a single domain.
 
 
MPLS Interface Commands
interface
Syntax 
[no] interface ip-int-name
Context 
config>router>mpls
Description 
This command specifies MPLS protocol support on an IP interface. No MPLS commands are executed on an IP interface where MPLS is not enabled. An MPLS interface must be explicitly enabled (no shutdown).
The no form of this command deletes all MPLS commands such as label-map which are defined under the interface. The MPLS interface must be shutdown first in order to delete the interface definition. If the interface is not shutdown, the no interface ip-int-name command does nothing except issue a warning message on the console indicating that the interface is administratively up.
Default 
shutdown
Parameters 
ip-int-name
The name of the network IP interface. An interface name cannot be in the form of an IP address. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.
Values
admin-group
Syntax 
[no] admin-group group-name [group-name...(up to 5 max)]
Context 
config>router>mpls>interface
Description 
This command defines admin groups that this interface supports.
This information is advertised as part of OSPF and IS-IS to help CSPF compute constrained LSPs that must include or exclude certain admin groups. An MPLS interface is assumed to belong to all the admin groups unless the ’admin-group’ command is issued under the interface config. Once an ’admin-group’ command is issued the interface is assumed to belong to only the specifically listed groups for that command.
Each single operation of the admin-group command allows a maximum of 5 groups to be specified at a time. However, a maximum of 32 groups can be specified per inteface through multiple operations.
Default 
no admin-group
Parameters 
group-name
Name of the group. The group names should be the same across all routers in the MPLS domain.
auto-bandwidth-multipliers
Syntax 
auto-bandwidth-multipliers sample-multiplier number1 adjust-multiplier number2
no auto-bandwidth-multipliers
Context 
config>router>mpls
Description 
This command specifies the number of collection intervals in the adjust interval.
Parameters 
sample-multiplier number1
Specifies the mulitplier for collection intervals in a sample interval.
Values
Default
adjust-multiplier number2
Specifies the number of collection intervals in the adjust interval.
Values
Default
auto-lsp
Syntax 
auto-lsp lsp-template template-name {policy peer-prefix-policy [peer-prefix-policy...(upto 5 max)] | one-hop}
no auto-lsp lsp-template template-name
Context 
config>router>mpls
Description 
This command enables the automatic creation of an RSVP point-to-point LSP to a destination node whose router-id matches a prefix in the specified peer prefix policy. This LSP type is referred to as auto-LSP of type mesh.
The user can associate multiple templates with same or different peer prefix policies. Each application of an LSP template with a given prefix in the prefix list will result in the instantiation of a single CSPF computed LSP primary path using the LSP template parameters as long as the prefix corresponds to a router-id for a node in the TE database. This feature does not support the automatic signaling of a secondary path for an LSP. If the user requires the signaling of multiple LSPs to the same destination node, s/he must apply a separate LSP template to the same or different prefix list that contains the same destination node. Each instantiated LSP will have a unique LSP-id and a unique tunnel-ID. This feature also does not support the signaling of a non-CSPF LSP. The selection of the no cspf option in the LSP template is thus blocked.
Up to five (5) peer prefix policies can be associated with a given LSP template at all times. Each time the user executes the above command with the same or different prefix policy associations, or the user changes a prefix policy associated with an LSP template, the system re-evaluates the prefix policy. The outcome of the re-evaluation will tell MPLS if an existing LSP needs to be torn down or if a new LSP needs to be signaled to a destination address that is already in the TE database.
If a /32 prefix is added to (removed from) or if a prefix range is expanded (shrunk) in a prefix list associated with a LSP template, the same prefix policy re-evaluation described above is performed.
The user must perform a no shutdown of the template before it takes effect. Once a template is in use, the user must shutdown the template before effecting any changes to the parameters except for those LSP parameters for which the change can be handled with the Make-Before-Break (MBB) procedures. These parameters are bandwidth and enabling fast-reroute without the hop-limit or node-protect options. For all other parameters, the user shuts down the template and once a it is added, removed or modified, the existing instances of the LSP using this template are torn down and re-signaled.
The trigger to signal the LSP is when the router with a router-id the matching a prefix in the prefix list appears in the Traffic Engineering database. The signaled LSP is installed in the Tunnel Table Manager (TTM) and is available to applications such as LDP-over-RSVP, resolution of BGP label routes, resolution of BGP, IGP, and static routes. It can also be used for provisioning an SDP is however not available to be used as a provisioned SDP for explicit binding or auto-binding by services.
Except for the MBB limitations to the configuration parameter change in the LSP template, MBB procedures for manual and timer based re-signaling of the LSP, for TE Graceful Shutdown and for soft pre-emption are supported.
The one-to-one option under fast-reroute, the LSP Diff-Serv class-type and backup-class-type parameters are not supported. If diffserv-te is enabled under RSVP, the auto-created LSP will still be signaled but with the default LSP class type.
If the one-hop option is specified instead of a prefix list, this command enables the automatic signaling of one-hop point-to-point LSPs using the specified template to all directly connected neighbors. This LSP type is referred to as auto-LSP of type one-hop. Although the provisioning model and CLI syntax differ from that of a mesh LSP only by the absence of a prefix list, the actual behavior is quite different. When the above command is executed, the TE database will keep track of each TE link that comes up to a directly connected IGP neighbor which router-id is discovered. It then instructs MPLS to signals an LSP with a destination address matching the router-id of the neighbor and with a strict hop consisting of the address of the interface used by the TE link. Thus, the auto-lsp command with the one-hop option will result in one or more LSPs signaled to the neighboring router.
An auto-created mesh or one-hop LSP can have egress statistics collected at the ingress LER by adding the egress-statistics node configuration into the LSP template. The user can also have ingress statistics collected at the egress LER using the same ingress-statistics node in CLI used with a provisioned LSP. The user must specify the full LSP name as signaled by the ingress LER in the RSVP session name field of the Session Attribute object in the received Path message.
The no form of this command deletes all LSP signaled using the specified template and prefix policy. When the one-hop option is used, it deletes all one-hop LSPs signaled using the specified template to all directly connected neighbors.
Parameters 
lsp-template template-name
Specifies an LSP template name up to 32 characters in length.
policy peer-prefix-policy
Specifies an peer prefix policy name up to 32 characters in length
srlg-group
Syntax 
[no] srlg-group group-name [group-name...(up to 5 max)]
Context 
config>router>mpls>interface
Description
This command defines the association of RSVP interface to an SRLG group. An interface can belong to up to 64 SRLG groups. However, each single operation of the srlg-group command allows a maximum of 5 groups to be specified at a time.
The no form of this command deletes the association of the interface to the SRLG group.
Default 
none
Parameters 
group-name
Specifies the name of the SRLG group within a virtual router instance up to 32 characters.
te-metric
Syntax 
te-metric value
no te-metric
Context 
config>router>mpls>interface
Description 
This command configures the traffic engineering metric used on the interface. This metric is in addition to the interface metric used by IGP for the shortest path computation.
This metric is flooded as part of the TE parameters for the interface using an opaque LSA or an LSP. The IS-IS TE metric is encoded as sub-TLV 18 as part of the extended IS reachability TLV. The metric value is encoded as a 24-bit unsigned integer. The OSPF TE metric is encoded as a sub-TLV Type 5 in the Link TLV. The metric value is encoded as a 32-bit unsigned integer.
When the use of the TE metric is enabled for an LSP, CSPF will first prune all links in the network topology which do not meet the constraints specified for the LSP path. Such constraints include bandwidth, admin-groups, and hop limit. Then, CSPF will run an SPF on the remaining links. The shortest path among the all SPF paths will be selected based on the TE metric instead of the IGP metric which is used by default.
The TE metric in CSPF LSP path computation can be configured by entering the command config>router>mpls>lsp>cspf>use-te-metric.
Note that the TE metric is only used in CSPF computations for MPLS paths and not in the regular SPF computation for IP reachability.
The no form of the command reverts to the default value.
Default 
no te-metric
The value of the IGP metric is advertised in the TE metric sub-TLV by IS-IS and OSPF.
Parameters 
value
Specifies the metric value.
Values
node-id-in-rro
Syntax 
[no] node-id-in-rro <include | exclude>
Context 
config>router>rsvp>
Description 
This command enables the option to include node-id sub-object in RRO. Node-ID sub-object propagation is required to provide fast reroute protection for LSP that spans across multiple area domains.
If this option is disabled, then node-id is not included in RRO object.
Default 
node-id-in-rro exclude
p2p-merge-point-abort-timer
Syntax 
p2p-merge-point-abort-timer [1.. 65535] seconds
no p2p-merge-point-abort-timer
Context 
config>router>rsvp
Description 
 
Default 
0 (disabled)
p2mp-merge-point-abort-timer
Syntax 
p2mp-merge-point-abort-timer [1.. 65535] seconds
no p2mp-merge-point-abort-timer
Context 
config>router>rsvp
Description 
 
Default 
0 (disabled)
p2p-active-path-fast-retry
Syntax 
p2p-active-path-fast-retry seconds [1..10] seconds
no p2p-active-path-fast-retry
Context 
config>router>rsvp
Description 
Default 
0 (disabled)
p2mp-s21-fast-retry
Syntax 
p2mp-s21-fast-retry seconds [1..10] seconds
no p2mp-s21-fast-retry
Context 
config>router>rsvp
Description 
Default 
0 (disabled)
preemption-timer
Syntax 
preemption-timer seconds
no preemption-timer
Context 
config>router>rsvp
Description 
This parameter configures the time in seconds a node holds to a reservation for which it triggered the soft pre-emption procedure.
The pre-empting node starts a separate preemption timer for each pre-empted LSP path. While this timer is on, the node should continue to refresh the Path and Resv for the pre-empted LSP paths. When the preemption timer expires, the node tears down the reservation if the head-end node has not already done so.
A value of zero means the LSP should be pre-empted immediately; hard pre-empted.
The no form of this command reverts to the default value.
Default 
300
Parameters 
seconds
Specifies the time, in seconds, of the preemption timer.
Values
label-map
Syntax 
[no] label-map in-label
Context 
config>router>mpls>interface
Description 
This command is used on transit routers when a static LSP is defined. The static LSP on the ingress router is initiated using the config router mpls static-lsp lsp-name command. An in-label can be associated with either a pop or a swap action, but not both. If both actions are specified, the last action specified takes effect.
The no form of this command deletes the static LSP configuration associated with the in-label.
Parameters 
in-label
Specifies the incoming MPLS label on which to match.
Values
pop
Syntax 
[no] pop
Context 
config>router>mpls>if>label-map
Description 
This command specifies that the incoming label must be popped (removed). No label stacking is supported for a static LSP. The service header follows the top label. Once the label is popped, the packet is forwarded based on the service header.
The no form of this command removes the pop action for the in-label.
Default 
none
shutdown
Syntax 
[no] shutdown
Context 
config>router>mpls>if>label-map
Description 
This command disables the label map definition. This drops all packets that match the specified in-label specified in the label-map in-label command.
The no form of this command administratively enables the defined label map action.
Default 
no shutdown
swap
Syntax 
swap {out-label | implicit-null-label} nexthop ip-address
no swap {out-label | implicit-null-label}
Context 
config>router>mpls>interface>label-map
Description 
This command swaps the incoming label and specifies the outgoing label and next hop IP address on an LSR for a static LSP.
The no form of this command removes the swap action associated with the in-label.
Default 
none
Parameters 
implicit-null-label
Specifies the use of the implicit label value for the outgoing label of the swap operation.
out-label
Specifies the label value to be swapped with the in-label. Label values 16 through 1,048,575 are defined as follows:
Label values 16 through 31 are reserved.
Label values 32 through 1,023 are available for static assignment.
Label values 1,024 through 2,047 are reserved for future use.
Label values 2,048 through 18,431 are statically assigned for services.
Label values 28,672 through 131,071 are dynamically assigned for both MPLS and services.
Label values 131,072 through 1,048,575 are reserved for future use.
Values
nexthop ip-address
The IP address to forward to. If an ARP entry for the next hop exists, then the static LSP will be marked operational. If ARP entry does not exist, software will set the operational status of the static LSP to down and continue to ARP for the configured nexthop. Software will continuously try to ARP for the configured nexthop at a fixed interval.
 
MPLS-TP Commands
mpls-tp
Syntax 
[no] mpls-tp
Context 
config>router>mpls
Description 
Generic MPLS-TP parameters and MPLS-TP trabsit paths are configured under this context. If a user configures no mpls, normally the entire mpls configuration is deleted. However, in the case of mpls-tp, a check is made that there is no other mpls-tp configuration (e.g., services or LSPs using mpls-tp on the node). The mpls-tp context cannot be deleted if MPLS-TP LSPs or SDPs exist on the system.
A shutdown of mpls-tp will bring down all MPLS-TP LSPs on the system.
Default 
no mpls-tp
tp-tunnel-id-range
Syntax 
tp-tunnel-id-range start-id end-id
no tp-tunnel-id-range
Context 
config>router>mpls>mpls-tp
Description 
This command configures the range of MPLS tunnel IDs reserved for MPLS-TP LSPs. The maximum difference between the start-id and end-id is 4K.
The tunnel ID referred to here is the RSVP-TE tunnel ID. This maps to the MPLS-TP Tunnel Number. There are some cases where the dynamic LSPs may have caused fragmentation to the number space such that contiguous range [end-id start-id] is not available. In these cases, the command will fail.
There are no default values for the start-id and end-id of the tunnel id range, and they must be configured to enable MPLS-TP.
Default 
no tunnel-id-range
Parameters 
start-id
Specifies the start ID.
Values
end-id
Specifies the end ID.
Values
oam-template
Syntax 
[no] oam-template name
Context 
config>router>mpls>mpls-tp
Description 
This command creates or edits an OAM template Generally applicable proactive OAM parameters are configured using templates. The top-level template is the OAM template.
Generic MPLS-TP OAM and fault management parameters are configured in the OAM Template.
Proactive CC/CV uses BFD and parameters such as Tx/Rx timer intervals, multiplier and other session/fault management parameters specific to BFD are configured using a BFD Template, which is referenced from the OAM template.
Default 
no oam-template
Parameters 
name
Specifies a text string name for the template of up to 32 characters in printable 7-bit ASCII, enclosed in double quotes. Named OAM templates are referenced from the MPLS-TP path MEP configuration.
hold-time-down
Syntax 
hold-time-down timer
no hold-time-down
Context 
config>router>mpls>mpls-tp>oam-template
Description 
This command configures the hold-down dampening timer. It is equivalent to a hold-off timer.
Default 
no hold-time-down
Parameters 
interval
Specifies the hold-down dampening timer interval.
Values
hold-time-up
Syntax 
hold-time-up timer
no hold-time-up
Context 
config>router>mpls>mpls-tp>oam-template
Description 
This command configures the hold-up dampening timer. This can be used to provide additional dampening to the state of proactive CC BFD sessions.
Default 
no hold-time-up
Parameters 
interval
Specifies the hold-up dampening timer interval.
Values
Default
bfd-template
Syntax 
bfd-template name
no bfd-template
Context 
config>router>mpls>mpls-tp>oam-template
Description 
This command configures a named BFD template to be referenced by an OAM template.
Default 
no bfd-template
Parameters 
name
Specifies the BFD template name as a text string up to 32 characters in printable 7-bit ASCII, enclosed in double quotes.
Values
protection-template
Syntax 
protection-template name
no protection-template
Context 
config>router>mpls>mpls-tp
Description 
Protection templates are used to define generally applicable protection parameters for MPLS-TP tunnels. Only linear protection is supported, and so the application of a named template to an MPLS-TP LSP implies that linear protection is used. A protection template is applied under the MEP context of the protect-path of an MPLS-TP LSP.
The protection-template command creates or edits a named protection template.
Default 
no protection-template
Parameters 
name
Specifies the protection template name as a text string of up to 32 characters in printable 7-bit ASCII, enclosed in double quotes.
revertive
Syntax 
[no] revertive
Context 
config>router>mpls>mpls-tp>protection-template
Description 
This command configured revertive behavior for MPLS-TP linear protection. The protect-tp-path MEP must be in the shutdown state for of the MPLS-TP LSPs referencing this protection template in order to change the revertve parameter.
Default 
revertive
wait-to-restore
Syntax 
wait-to-restore interval
no wait-to-restore
Context 
config>router>mpls>mpls-tp>protection-template
Description 
This command configures the WTR timer. It determines how long to wait until the active path of an MPLS-TP LSP is restored to the working path following the clearing of a defect on the working path. It is appliable to revertive mode, only.
Default 
no wait-to-restore
Parameters 
interval
Specifies the WTR timer interval.
Values
rapid-psc-timer
Syntax 
rapid-psc-timer interval
no rapid-psc-timer
Context 
config>router>mpls>mpls-tp>protection-template
Description 
This command configures the rapid timer value to be used for protection switching coordination (PSC) packets for MPLS-TP linear protection (RFC 6378).
Default 
no rapid-psc-timer
Parameters 
interval
Specifies the rapid timer interval.
Values
Default
slow-psc-timer
Syntax 
slow-psc-timer interval
no slow-psc-timer
Context 
config>router>mpls>mpls-tp>protection-template
Description 
This command configures the slow timer value to be used for protection switching coordination (PSC) packets for MPLS-TP linear protection (RFC 6378).
Default 
no rapid-psc-timer
Parameters 
interval
Specifies the slow timer interval.
Values
global-id
Syntax 
global-id global-id
no global-id
Context 
config>router>mpls>mpls-tp
Description 
This command configures the MPLS-TP Global ID for the node. This is used as the ‘from’ Global ID used by MPLS-TP LSPs originating at this node. If a value is not entered, the Global ID is taken to be Zero. This is used if the global-id is not configured. If an operator expects that inter domain LSPs will be configured, then it is recommended that the global ID should be set to the local ASN of the node, as configured under config>system. If two-byte ASNs are used, then the most significant two bytes of the global-id are padded with zeros.
In order to change the value of the global-id, config>router>mpls>mpls-tp must be in the shutdown state. This will bring down all of the MPLS-TP LSPs on the node. New values a propagated to the system when a no shutdown is performed.
Default 
no global-id
Parameters 
global-id
Specifies the global ID for the node.
Values
node-id
Syntax 
node-id node-id
no node-id
Context 
config>router>mpls>mpls-tp
Description 
This command configures the MPLS-TP Node ID for the node. This is used as the ‘from’ Node ID used by MPLS-TP LSPs originating at this node. The default value of the node-id is the system interface IPv4 address. The Node ID may be entered in 4-octed IPv4 address format, <a.b.c.d>, or as an unsigned 32 bit integer. Note that it is not treated as a routable IP address from the perspective of IP routing, and is not advertised in any IP routing protocols.
The MPLS-TP context cannot be administratively enabled unless at least a system interface IPv4 address is configured because MPLS requires that this value is configured.
Default 
no node-id
Parameters 
node-id
Specifies the MPLS-TP node ID for the node.
Values
Default
transit-path
Syntax 
transit-path path-name
no transit-path
Context 
config>router>mpls>mpls-tp
Description 
This command enables the configuration or editing of an MPLS-TP transit path at an LSR.
Default 
no transit-path
Parameters 
path-name
Specifies the template of up to 32 characters in printable 7-bit ASCII, enclosed in double quotes.
path-id
Syntax 
path-id {lsp-num lsp-num | working-path | protect-path [src-global-id src-global-id] src-node-id src-node-id src-tunnel-num src-tunnel-num [dest-global-id dest-global-id] dest-node-id dest-node-id [dest-tunnel-num dest-tunnel-num]}
no path-id
Context 
config>router>mpls>mpls-tp>transit-path
Description 
This command configures path ID for an MPLS-TP transit path at an LSR. The path ID is equivalent to the MPLS-TP LSP ID and is used to generate the maintenance entity group intermediate point (MIP) identifier for the LSP at the LSR. A path-id must be configured for on-demand OAM to verify an LSP at the LSR.
The path-id must contain at least the following parameters: lsp-num, src-node-id, src-global-id, src-tunnel-num, dest-node-id.
The path-id must be unique on a node. It is recommended that his is also configured to be a globally unique value.
The no form of the command removes the path ID from the configuration.
Default 
no path-id
Parameters 
lsp-num
Specifues the LSP number.
Values
1 — 65535, or working path, or protect-path. A working-path is equivalent to a lsp-num of 1, and a protect-path is an lsp-num of 2.
src-global-id
Specifies the source global ID.
Values
src-node-id
Specifies the source node ID.
Values
src-tunnel-num
Specifies the source tunnel number.
Values
dest-global-id
Specifies the destination global ID. If the destination global ID is not entered, then it is set to the same value as the source global ID.
Values
dest-node-id
Specifies the destination node ID.
Values
dest-tunnel-num
Specifies the destination tunnel number. If the destination tunnel number is not entered, then it is set to the same value as the source tunnel number.
Values
forward-path
Syntax 
[no] forward-path
Context 
config>router>mpls>mpls-tp>transit-path
Description 
This command enables the forward path of an MPLS-TP transit path to be created or edited.
The forward path must be created before the reverse path.
The no form of this command removes the forward path. The forward path cannot be removed if a reverse exists.
Default 
no forward-path
reverse-path
Syntax 
[no] reverse-path
Context 
config>router>mpls>mpls-tp>transit-path
Description 
This command enables the reverse path of an MPLS-TP reverse path to be created or edited.
The reverse path must be created after the forward path.
The no form of this command removes the reverse path. The reverse path must be removed before the forward path.
Default 
no reverse-path
in-label
Syntax 
in-label in-label out-label out-label out-link if-name [next-hop next-hop]
no in-label
Context 
config>router>mpls>mpls-tp>transit-path>forward-path
config>router>mpls>mpls-tp>transit-path>reverse-path
Description 
This command configures the label mapping associated with a forward path or reverse path of an MPLS-TP transit path to be configured.
The incoming label, outgoing label and outgoing interface must be configured, using the in-label, out-label and out-link parameters. If the out-link refers to a numbered IP interface, the user may optionally configure the next-hop parameter and the system will determine the interface to use to reach the configured next-hop, but will check that the user-entered value for the out-link corresponds to the link returned by the system. If they do not correspond, then the path will not come up.
Default 
no in-label
Parameters 
in-label
Specifies the in label.
Values
out-label
Specifies the out label.
Values
if-name
Specifies the name of the outgoing interface use for the path.
next-hop
Specifies the next-hop.
Values
shutdown
Syntax 
[no] shutdown
Context 
config>router>mpls>mpls-tp>transit-path
Description 
This command administratively enables or disables an MPLS-TP transit path.
Default 
no shutdown
 
 
LSP Commands
lsp
Syntax 
[no] lsp lsp-name [bypass-only | p2mp-lsp | mpls-tp src-tunnel-num]
Context 
config>router>mpls
Description 
This command creates an LSP that is either signaled dynamically by the router, or a statically provisioned MPLS-TP LSP.
When the LSP is created, the egress router must be specified using the to command and at least one primary or secondary path must be specified for signaled LSPs, or at least one working path for MPLS-TP LSPs. All other statements under the LSP hierarchy are optional.
LSPs are created in the administratively down (shutdown) state.
The no form of this command deletes the LSP. All configuration information associated with this LSP is lost. The LSP must be administratively shutdown and unbound from all SDPs before it can be deleted.
Default 
none
Parameters 
lsp-name
Name that identifies the LSP. The LSP name can be up to 32 characters long and must be unique.
bypass-only
Defines an LSP as a manual bypass LSP exclusively. When a path message for a new LSP requests bypass protection, the PLR first checks if a manual bypass tunnel satisfying the path constraints exists. If one if found, the router selects it. If no manual bypass tunnel is found, therouter dynamically signals a bypass LSP in the default behavior. The CLI for this feature includes a knob that provides the user with the option to disable dynamic bypass creation on a per node basis.
p2mp-lsp
Defines an LSP as a point-to-multipoint LSP. The following parameters can be used with a P2MP LSP: adaptive, adspec, cspf, exclude, fast-reroute, from, hop-limit, include, metric, retry-limit, retry-timer, resignal-timer. The following parameters cannot be used with a P2MP LSP: primary, secondary, to, dest-global-id, dest-tunnel-number, working-tp-path, protect-tp-path.
mpls-tp src-tunnel-num
Defines an LSP as an MPLS-TP LSP. The src-tunnel-num is a mandatory create time parameter for mpls-tp LSPs, and has to be assigned by the user based on the configured range of tunnel IDs. The following parameters can only be used with an MPLS-TP LSP: to, dest-global-id, dest-tunnel-number, working-tp-path, protect-tp-path. Other parameters defined for the above LSP types cannot be used.
adaptive
Syntax 
[no] adaptive
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
This command enables the make-before-break functionality for an LSP or LSP path. When enabled for the LSP, make-before-break will be performed for primary path and all the secondary paths of the LSP.
Default 
adaptive
adspec
Syntax 
[no] adspec
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
When enabled, the ADSPEC object will be included in RSVP messages for this LSP. The ADSPEC object is used by the ingress LER to discover the minimum value of the MTU for links in the path of the LSP. By default, the ingress LER derives the LSP MTU from that of the outgoing interface of the LSP path.
Note that a bypass LSP always signals the ADSPEC object since it protects both primary paths which signal the ADSPEC object and primary paths which do not. This means that MTU of LSP at ingress LER may change to a different value from that derived from the outgoing interface even if the primary path has ADSPEC disabled.
Default 
no adspec — No ADSPEC objects are included in RSVP messages.
auto-bandwidth
Syntax 
[no] auto-bandwidth
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
This command enables automatic adjustments of LSP or SDP bandwidth.
Auto-bandwidth at the LSP level cannot be executed unless cspf and adaptive are configured in the config>router>mpls>lsp context.
Auto-bandwidth at the SDP level cannot be executed unless the SDP type is MPLS, the SDP is comprised of only RSVP LSPs, all of the RSVP LSPs have auto-bandwidth enabled and the adjust-up, adjust-down and overflow-limit commands are not present in the auto-bandwidth configuration of any of the RSVP LSPs.
The no form of the command disables the automatic adjustments of LSP or SDP bandwidth.
adjust-down
Syntax 
adjust-down percent [bw mbps]
no adjust-down
Context 
config>router>mpls>lsp>auto-bandwidth
config>router>mpls>lsp-template>auto-bandwidth
Description 
This command configures the minimum threshold for decreasing the bandwidth of an LSP based on active measurement of LSP bandwidth.
The no form of this command is equivalent to adjust-down 5.
Default 
no adjust-down
Parameters 
percent
Specifies the minimum difference between the current bandwidth reservation of the LSP and the (measured) maximum average data rate, expressed as a percentage of the current bandwidth, for decreasing the bandwidth of the LSP.
Values
Default
mbps
Specifies the minimum difference between the current bandwidth reservation of the LSP and the (measured) maximum average data rate, expressed as an absolute bandwidth (mbps), for decreasing the bandwidth of the LSP.
Values
Default
adjust-up
Syntax 
adjust-up percent [bw mbps]
no adjust-up
Context 
config>router>mpls>lsp>auto-bandwidth
config>router>mpls>lsp-template>auto-bandwidth
Description 
This command configures the minimum threshold for increasing the bandwidth of an LSP based on active measurement of LSP bandwidth.
The no form of this command is equivalent to adjust-up 5.
Default 
no adjust-up
Parameters 
percent
Specifies the minimum difference between the current bandwidth reservation of the LSP and the (measured) maximum average data rate, expressed as a percentage of the current bandwidth, for increasing the bandwidth of the LSP.
1-100
Default 5
mbps
Specifies the minimum difference between the current bandwidth reservation of the LSP and the (measured) maximum average data rate, expressed as an absolute bandwidth (mbps), for increasing the bandwidth of the LSP
Values
Default
fc
Syntax 
fc fc-name sampling-weight sampling-weight
no fc
Context 
config>router>mpls>lsp-template>auto-bandwidth
Description 
This command configures the sampling weight.
max-bandwidth
Syntax 
max-bandwidth mbps
no max-bandwidth
Context 
config>router>mpls>lsp>auto-bandwidth
config>router>mpls>lsp-template>auto-bandwidth
Description 
This command configures the maximum bandwidth that auto-bandwidth allocation is allowed to request for an LSP or SDP.
The LSP maximum applies whether the bandwidth adjustment is triggered by normal adjust-timer expiry, the overflow limit having been reached, or manual request or SDP auto-bandwidth adjustment.
The SDP maximum applies to bandwidth adjustment caused by VLL CAC. The SDP maximum bandwidth must be less than or equal to the sum of the max-bandwidth parameters of the LSPs in the SDP.
This command is mandatory at the LSP level if an overflow-limit is configured.
The no form of the command means max-bandwidth is infinite (equivalent to 100 Gbps).
Default 
no max-bandwidth
Parameters 
mbps
Specifies the maximum bandwidth in mbps.
Values
Default
min-bandwidth
Syntax 
min-bandwidth mbps
no min-bandwidth
Context 
config>router>mpls>lsp>auto-bandwidth
config>router>mpls>lsp-template>auto-bandwidth
Description 
This command configures the minimum bandwidth that auto-bandwidth allocation is allowed to request for an LSP or SDP.
The LSP minimum applies whether the bandwidth adjustment is triggered by normal adjust-timer expiry or, manual request or SDP auto-bandwidth adjustment.
The no form of the command means min-bandwidth is zero.
Default 
no min-bandwidth
Parameters 
mbps
Specifies the minimum bandwidth in mbps.
Values
Default
monitor-bandwidth
Syntax 
[no] monitor-bandwidth
Context 
config>router>mpls>lsp>auto-bandwidth
config>router>mpls>lsp-template>auto-bandwidth
Description 
This command enables the collection and display of auto-bandwidth measurements, but prevents any automatic bandwidth adjustments from taking place, other than those caused by VLL CAC (through an SDP bandwidth change).
This command is mutually exclusive with the overflow-limit command.
The no form of the command the collection and display of auto-bandwidth measurements.
multipliers
Syntax 
multipliers sample-multiplier num1 adjust-multiplier num2
no multipliers
Context 
config>router>mpls>lsp>auto-bandwidth
config>router>mpls>lsp-template>auto-bandwidth
Description 
This command configures the number of collection intervals between measurements of the number of bytes that have been transmitted on the LSP. The byte counts include the layer 2 encapsulation of MPLS packets and represent traffic of all forwarding classes and priorities (in-profile vs, out-of-profile) belonging to the LSP.
The router calculates the average data rate in each sample interval. The maximum of this average data rate over multiple sample intervals is the measured bandwidth input to the auto-bandwidth adjustment algorithms.
The count is not allowed to be set a value greater than adjust-count.
The no form of this command instructs the system to take the value from the auto-bandwidth-defaults command.
Default 
no sample-count
Parameters 
number
The number of collection intervals in a sample interval.
Values
Default
overflow-limit
Syntax 
overflow-limit number threshold percent [bw mbps]
no overflow-limit
Context 
config>router>mpls>lsp>auto-bandwidth
config>router>mpls>lsp-template>auto-bandwidth
Description 
This command configures overflow-triggered auto-bandwidth adjustment. It sets the threshold at which bandwidth adjustment is initiated due to the configured number of overflow samples having been reached, regardless of how much time remains until the adjust interval ends.
A sample interval is counted as an overflow if the average data rate during the sample interval is higher than the currently reserved bandwidth by at least the thresholds configured as part of this command.
If overflow-triggered auto-bandwidth adjustment is successful the overflow count and adjust-timer are reset. If overflow-triggered auto-bandwidth adjustment fails then the overflow count is reset but the adjust-timer continues.
This command is mutually exclusive with the monitor-bandwidth command.
This command will fail if the max-bandwidth value at the config>router>mpls>lsp>auto-bandwidth level is not configured or if it is set to infinite (100 Gbps)zero.
The no form of this command disables overflow-triggered automatic bandwidth adjustment.
Default 
no overflow-limit
Parameters 
number
The number of overflow samples that triggers an overflow auto-bandwidth adjustment attempt.
Values
Default
percent
The minimum difference between the current bandwidth of the LSP and the sampled data rate, expressed as a percentage of the current bandwidth, for counting an overflow sample.
Values
Default
mbps
The minimum difference between the current bandwidth of the LSP and the sampled data rate, expressed as an absolute bandwidth (Mbps) relative to the current bandwidth, for counting an overflow sample.
Values
Default
bgp-transport-tunnel
Syntax 
bgp-transport-tunnel include | exclude
Context 
config>router>mpls>lsp
Description 
This command allows or blocks RSVP-TE LSP to be used as a transport LSP for BGP tunnel routes.
Default 
bgp-transport-tunnel include
Parameters 
include
Allows RSVP-TE LSP to be used as transport LSP from the ASBR to local PE router, from ingress PE to ASBR in the local AS or between multi-hop eBGP peers with ASBR to ASBR adjacency.
exclude
Blocks RSVP-TE LSP to be used as transport LSP from the ASBR to local PE router, from ingress PE to ASBR in the local AS or between multi-hop eBGP peers with ASBR to ASBR adjacency.
class-type
Syntax 
class-type ct-number
no class-type
Context 
config>router>mpls>lsp
config>router>mpls>lsp>primary
config>router>mpls>lsp>secondary
Description 
This command configures the Diff-Serv Class Type (CT) for an LSP, the LSP primary path, or the LSP secondary path. The path level configuration overrides the LSP level configuration. However, only one CT per LSP path will be allowed as per RFC 4124.
The signaled CT of a dynamic bypass is always be CT0 regardless of the CT of the primary LSP path. The setup and hold priorities must be set to default values, i.e., 7 and 0 respectively. This assumes that the operator configured a couple of TE classes, one which combines CT0 and a priority of 7 and the other which combines CTO and a priority of 0. If not, the bypass LSP will not be signaled and will go into the down state.
The operator cannot configure the CT, setup priority, and hold priority of a manual bypass. They are always signaled with CT0 and the default setup and holding priorities.
The signaled CT and setup priority of a detour LSP must match those of the primary LSP path it is associated with.
If the operator changes the CT of an LSP or of an LSP path, or changes the setup and holding priorities of an LSP path, the path will be torn down and retried.
An LSP which does not have the CT explicitly configured will behave like a CT0 LSP when Diff-Serv is enabled.
If the operator configured a combination of a CT and a setup priority and/or a combination of a CT and a holding priroty for an LSP path that are not supported by the user-defined TE classes, the LSP path will be kept in a down state and an error code will be displayed in the show command output for the LSP path.
The no form of this command reverts to the default value.
Default 
no class-type.
Parameters 
ct-number
The Diff-Serv Class Type number.
Values
Default
bandwidth
Syntax 
bandwidth rate-in-mbps
Context 
config>router>mpls>lsp>primary-p2mp-instance
config>router>mpls>lsp-template
Description 
This command specifies the amount of bandwidth to be reserved for the P2MP instance.
Parameters 
rate-in-mbps
specifies the bandwidth, in Mbps.
Values
cspf
Syntax 
[no] cspf [use-te-metric]
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
This command enables Constrained Shortest Path First (CSPF) computation for constrained-path LSPs. Constrained-path LSPs are the ones that take configuration constraints into account. CSPF is also used to calculate the detour routes when fast-reroute is enabled.
Explicitly configured LSPs where each hop from ingress to egress is specified do not use CSPF. The LSP will be set up using RSVP signaling from ingress to egress.
If an LSP is configured with fast-reroute frr-method specified but does not enable CSPF, then neither global revertive nor local revertive will be available for the LSP to recover.
Default 
no cspf
Parameters 
use-te-metric
Specifies to use the use of the TE metric for the purpose of the LSP path computation by CSPF.
dest-global-id
Syntax 
dest-global-id dest-global-id
no dest-global-id
Context 
config>router>mpls>lsp
Description 
This optional command configures the MPLS-TP Global ID of the far end node of the MPLS-TP LSP. This command is only allowed for MPLS-TP LSPs. Global ID values of 0 indicate that the local node’s configured global ID is used. If the local global-id is 0, then the dest-global-id must also be 0. The dest-global-id cannot be changed if an LSP is in use by an SDP.
Default 
0
Parameters 
dest-global-id
Specifies the destination global ID.
Values
Default
dest-tunnel-number
Syntax 
dest-tunnel-number dest-tunnel-number
no dest-tunnel-number
Context 
config>router>mpls>lsp
Description 
This optional command configures the MPLS-TP tunnel number of the LSP at the far end node of the MPLS-TP LSP. This command is only allowed for MPLS-TP LSPs. If it is not entered, then the system will take the dest-tunnel-number to be the same as the src-tunnel-num for the LSP.
Default 
The default value is the configured src-tunnel-num.
Parameters 
dest-tunnel-number
Specifies the destination tunnel number.
Values
Default
working-tp-path
Syntax 
[no] working-tp-path
Context 
config>router>mpls>lsp
Description 
This command creates or edits the working path for an MPLS-TP LSP. At least one working path (but not more than one working path) must be created for an MPLS-TP LSP. If MPLS-TP linear protection is also configured, then this is the path that is used as the default working path for the LSP, and it must be created prior to the protect path. The working-tp-path can only be deleted if no protect-tp-path exists for the LSP.
The following commands are applicable to the working-tp-path: lsp-num, in-label, out-label, mep, shutdown.
Default 
no working-tp-path
protect-tp-path
Syntax 
[no] protect-tp-path
Context 
config>router>mpls>lsp
Description 
This command creates or edits the protect path for an MPLS-TP LSP. At least one working path must exist before a protect path can be created for an MPLS-TP LSP. If MPLS-TP linear protection is also configured, then this is the path that is used as the default protect path for the LSP. The protect path must be deleted before the wokring path. Only one protect path can be created for each MPLS-TP LSP.
The following commands are applicable to the working-tp-path: lsp-num, in-label, out-label, mep, shutdown.
lsp-num
Syntax 
lsp-num lsp-num
no lsp-num
Context 
config>mpls>lsp>working-tp-path
config>mpls>lsp>protect-tp-path
Description 
This command configures the MPLS-TP LSP Number for the working TP path or the Protect TP Path.
Default 
no lsp-num
Parameters 
lsp-num
Specifies the LSP number.
Values
Default
in-label
Syntax 
in-label in-label
no in-label
Context 
config>mpls>lsp>working-tp-path
config>mpls>lsp>protect-tp-path
Description 
This command configures the incoming label for the reverse path or the working path or the protect path of an MPLS-TP LSP. MPLS-TP LSPs are bidirectional, and so an incoming label value must be specified for each path.
Default 
no in-label
Parameters 
in-label
Specifies the in label.
Values
out-label
Syntax 
out-label out-label out-link if-name [next-hop ip-address]
no out-label
Context 
config>mpls>lsp>working-tp-path
config>mpls>lsp>protect-tp-path
Description 
This command configureds the outgoing label value to use for an MPLS-TP working or protect path. The out-link is the outgoing interface on the node that this path will use, and must be specified. If the out-link refers to a numbered IP interface, the user may optionally configure the next-hop parameter and the system will determine the interface to use to reach the configured next-hop, but will check that the user-entered value for the out-link corresponds to the link returned by the system. If they do not correspond, then the path will not come up.
Default 
no out-label
Parameters 
out-label
Specifies the out label.
Values
if-name
Specifies the interface name.
ip-address
Specifies the IPv4 address in a.b.c.d
mep
Syntax 
[no] mep
Context 
config>mpls>lsp>working-tp-path
config>mpls>lsp>protect-tp-path
Description 
This command creates or edits an MPLS-TP maintenance entity group (MEG) endpoint (MEP) on and MPLS-TP path. MEPs reporesent the termination point for OAM flowing on the path, as well as linear protection for the LSP. Only one MEP can be configured at each end of the path.
The following commands are applicable to a MEP on an MPLS-TP working or protect path: oam-template, bfd-enable, and shutdown. In addition, a protection-template may be configured on a protect path.
The no form of the command removes a MEP from an MPLS-TP path.
oam-template
Syntax 
oam-template name
no oam-template
Context 
config>mpls>lsp>working-tp-path
config>mpls>lsp>protect-tp-path
Description 
This command applies a OAM template to an MPLS-TP working or protect path. It contains configuration paraeters for proactive OAM mechanisms that can be enabled on the path e.g. BFD. Configuration of an OAM template is optional.
The no form of the command removes the OAM template from the path.
Default 
no oam-template
Parameters 
name
Speciifes a text string name for the template up to 32 characters in printable 7-bit ASCII, enclosed in double quotes.
bfd-enable
Syntax 
bfd-enable [cc | cc_cv]
no bfd-enable
Context 
config>mpls>lsp>working-tp-path
config>mpls>lsp>protect-tp-path
Description 
The command associates the operational state of an MPLS-TP path with a BFD session whose control packets flow on the path. The BFD packets are encapsulated in a generic associated channel (G-ACh) on the path. The timer parameters of the BFD session are taken from the the OAM template of the MEP.
A value of cc means that the BFD session is only used for continuity check of the the MPLS-TP path. In this case, the cc timer parameters of the OAM template apply. A value of cv means that the BFD session is used for both continuity checking and connectivity verification, and the cv timers of the OAM template apply.
This form of the bfd-enable command is only applicable when it is configured under a MEP used on an MPLS-TP working or protect path.
Default 
no bfd-enable
Parameters 
cc | cc_cv
cc indicates that BFD runs in CC only mode. This mode uses GACh channel type 0x07. cc_cv indicates that BFD runs in combined CC and CV mode. This mode uses channel type 0x22 for MPLS-TP CC packets, and 0x23 for MPLS-TP CV packets.
protection-template
Syntax 
protection-template name
no protection-template
Context 
config>mpls>lsp>protect-tp-path
Description 
This command applies a protection template name to an MPLS-TP LSP that the protect path is configured under. If the template is applied, then MPLS-TP 1:1 linear protection is enabled on the LSP, using the parameters specified in the named template.
A named protection template can only be applied to the protect path context of an MPLS-TP LSP.
The no form of the command removes the template and thus disables mpls-tp linear protection on the LSP.
Default 
no protection-template
Parameters 
name
Specifies at text string for the template up to 32 characters in printable 7-bit ASCII, enclosed in double quotes.
exclude
Syntax 
[no] exclude group-name [group-name...(up to 5 max)]
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
This command specifies the admin groups to be excluded when an LSP is set up in the primary or secondary contexts. Each single operation of the exclude command allows a maximum of 5 groups to be specified at a time. However, a maximum of 32 groups can be specified per LSP through multiple operations. The admin groups are defined in the config>router>mpls>admin-group context.
Use the no form of the command to remove the exclude command.
Default 
no exclude
Parameters 
group-name
Specify the existing group-name to be excluded when an LSP is set up.
exclude-node
Syntax 
[no] exclude-node ip-address
Context 
config>router>mpls>lsp
Description 
This command enables the option to include XRO object in the bypass LSP PATH message object. The exclude-node option is required for manual bypass LSP with XRO to FRR protect ABR node in a multi-vendor network depolyment. This command must be configured on the PLR node that protects the ABR node. The ABR node IP address must be configured as exclude-node.
Default 
no exclude-node
fast-reroute
Syntax 
fast-reroute frr-method
no fast-reroute
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
This command creates a pre-computed detour LSP from each node in the path of the LSP. In case of failure of a link or LSP between two nodes, traffic is immediately rerouted on the pre-computed detour LSP, thus avoiding packet-loss.
When fast-reroute is enabled, each node along the path of the LSP tries to establish a detour LSP as follows:
If it is not possible to set up a detour LSP that avoids the immediate downstream node, a detour can be set up to the downstream node on a different interface.
The detour LSP may take one or more hops (see hop-limit) before merging back on to the main LSP path.
Fast reroute is available only for the primary path. No configuration is required on the transit hops of the LSP. The ingress router will signal all intermediate routers using RSVP to set up their detours. TE must be enabled for fast-reroute to work.
If an LSP is configured with fast-reroute frr-method specified but does not enable CSPF, then neither global revertive nor local revertive will be available for the LSP to recover.
The no form of the fast-reroute command removes the detour LSP from each node on the primary path. This command will also remove configuration information about the hop-limit and the bandwidth for the detour routes.
The no form of fast-reroute hop-limit command reverts to the default value.
Default 
no fast-reroute — When fast-reroute is specified, the default fast-reroute method is one-to-one.
Parameters 
one-to-one — In the one-to-one technique, a label switched path is established which intersects the original LSP somewhere downstream of the point of link or node failure. For each LSP which is backed up, a separate backup LSP is facility — This option, sometimes called many-to-one, takes advantage of the MPLS label stack. Instead of creating a separate LSP for every backed-up LSP, a single LSP is created which serves to backup up a set of LSPs. This LSP tunnel is called a bypass tunnel.
The bypass tunnel must intersect the path of the original LSP(s) somewhere downstream of the point of local repair (PLR). Naturally, this constrains the set of LSPs being backed-up via that bypass tunnel to those that pass through a common downstream node. All LSPs which pass through the PLR and through this common node which do not also use the facilities involved in the bypass tunnel are candidates for this set of LSPs.
bandwidth
Syntax 
bandwidth rate-in-mbps
no bandwidth
Context 
config>router>mpls>lsp>fast-reroute
config>router>mpls>lsp-template>fast-reroute
Description 
This command is used to request reserved bandwidth on the detour path. When configuring an LSP, specify the traffic rate associated with the LSP.
When configuring fast reroute, allocate bandwidth for the rerouted path. The bandwidth rate does not need to be the same as the bandwidth allocated for the LSP.
Default 
no bandwidth — Bandwidth is not reserved for a rerouted path.
Parameters 
rate-in-mbps
Specifies the amount of bandwidth in Mbps to be reserved for the LSP path.
hop-limit
Syntax 
hop-limit limit
no hop-limit
Context 
config>router>mpls>lsp>fast-reroute
config>router>mpls>lsp-template>fast-reroute
Description 
For fast reroute, how many more routers a detour is allowed to traverse compared to the LSP itself. For example, if an LSP traverses four routers, any detour for the LSP can be no more than ten router hops, including the ingress and egress routers.
Default 
16
Parameters 
limit
Specify the maximum number of hops.
Values
node-protect
Syntax 
[no] node-protect
Context 
config>router>mpls>lsp>fast-reroute
config>router>mpls>lsp-template>fast-reroute
Description 
This command enables or disables node and link protection on the specified LSP. Node protection ensures that traffic from an LSP traversing a neighboring router will reach its destination even if the neighboring router fails.
Default 
node-protect
from
Syntax 
from ip-address
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
This optional command specifies the IP address of the ingress router for the LSP. When this command is not specified, the system IP address is used. IP addresses that are not defined in the system are allowed. If an invalid IP address is entered, LSP bring-up fails and an error is logged.
If an interface IP address is specified as the from address, and the egress interface of the nexthop IP address is a different interface, the LSP is not signaled. As the egress interface changes due to changes in the routing topology, an LSP recovers if the from IP address is the system IP address and not a specific interface IP address.
Only one from address can be configured.
Default 
The system IP address
Parameters 
ip-address
This is the IP address of the ingress router. This can be either the interface or the system IP address. If the IP address is local, the LSP must egress through that local interface which ensures local strictness.
Default
Values
hop-limit
Syntax 
hop-limit number
no hop-limit
Context 
config>router>mpls>lsp
config>router>mpls>lsp>fast-reroute
config>router>mpls>lsp-template>fast-reroute
Description 
This command specifies the maximum number of hops that an LSP can traverse, including the ingress and egress routers. An LSP is not set up if the hop limit is exceeded. This value can be changed dynamically for an LSP that is already set up with the following implications:
If the new value is less than the current number of hops of the established LSP, the LSP is brought down. Software then tries to re-establish the LSP within the new hop-limit number. If the new value is equal to or greater than the current number hops of the established LSP, then the LSP is not affected.
The no form of this command returns the parameter to the default value.
Default 
255
Parameters 
number
The number of hops the LSP can traverse, expressed as an integer.
Values
Values
ldp-over-rsvp
Syntax 
ldp-over-rsvp [include | exclude]
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
This command specifies if this LSP will be included in LDP over RSVP.
Parameters 
include
Specifies that this LSP will be included in LDP over RSVP.
exclude
Specifies that this LSP will be excluded from LDP over RSVP.
igp-shortcut
Syntax 
igp-shortcut [lfa-protect | lfa-only] [relative-metric [offset]]
[no] igp-shortcut
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
This command enables the use of a specific RSVP LSP by IS-IS and OSPF routing protocols as a shortcut or as a forwarding adjacency for resolving IGP routes.
When the rsvp-shortcut or the advertise-tunnel-link option is enabled at the IGP instance level, all RSVP LSPs originating on this node are eligible by default as long as the destination address of the LSP, as configured in config>router>mpls>lsp>to, corresponds to a router-id of a remote node.
The lfa-protect option allows an LSP to be included in both the main SPF and the Loop-Free Alternate (LFA) SPF. For a given prefix, the LSP can be used either as a primary next-hop or as an LFA next-hop, but not both. If the main SPF computation selected a tunneled primary next-hop for a prefix, the LFA SPF will not select an LFA next-hop for this prefix and the protection of this prefix will rely on the RSVP LSP FRR protection. If the main SPF computation selected a direct primary next-hop, then the LFA SPF will select an LFA next-hop for this prefix but will prefer a direct LFA next-hop over a tunneled LFA next-hop.
The lfa-only option allows an LSP to be included in the LFA SPF only such that the introduction of IGP shortcuts does not impact the main SPF decision. For a given prefix, the main SPF always selects a direct primary next-hop. The LFA SPF will select a an LFA next-hop for this prefix but will prefer a direct LFA next-hop over a tunneled LFA next-hop.
When the relative-metric option is enabled, IGP will apply the shortest IGP cost between the endpoints of the LSP plus the value of the offset (instead of the LSP operational metric) when computing the cost of a prefix which is resolved to the LSP. The offset value is optional and it defaults to zero. The minimum net cost for a prefix is one (1) after applying the offset. Note that the TTM continues the show the LSP operational metric as provided by MPLS. In other words, applications such as LDP-over-RSVP (when IGP shortcut is disabled) and BGP and static route shortcuts will continue to use the LSP operational metric.
The relative-metric option is mutually exclusive with the lfa-protect or the lfa-only options. In other words, an LSP with the relative-metric option enabled cannot be included in the LFA SPF and vice-versa when the rsvp-shortcut option is enabled in the IGP.
Finally, the relative-metric option is ignored when forwarding adjacency is enabled in IS-IS or OSPF. In this case, IGP advertises the LSP as a point-to-point unnumbered link along with the LSP operational metric as returned by MPLS and capped to maximum link metric allowed in that IGP. Both the main SPF and the LFA SPFs will use the local IGP database to resolve the routes.
The no form of this command disables the use of a specific RSVP LSP by IS-IS and OSPF routing protocols as a shortcut or a forwarding adjacency for resolving IGP routes.
Default 
igp-shortcut. All RSVP LSPs originating on this node are eligible by default as long as the destination address of the LSP corresponds to a router-id of a remote node.
Parameters 
lfa-protect
An LSP is included in both the main SPF and the LFA SPF.
lfa-only
An LSP is included in the LFA SPF only.
relative-metric [offset]
The shortest IGP cost between the endpoints of the LSP plus the configured offset, instead of the LSP operational metric returned by MPLS, is used when calculating the cost of prefix resolved to this LSP. The offset parameter is an integer and is optional. An offset value of zero is used when the relative-metric option is enabled without specifying the offset parameter value.
Values
least-fill
Syntax 
[no] least-fill
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
This command enables the use of the least-fill path selection method for the computation of the path of this LSP.
When MPLS requests the computation of a path for this LSP, CSPF will find all equal cost shortest paths which satisfy the constraints of this path. Then, CSPF identifies the single link in each of these paths which has the least available bandwidth as a percentage of its maximum reservable bandwidth. It then selects the path which has the largest value of this percentage least available bandwidth figure. CSPF identifies the least available bandwidth link in each equal cost path after it has accounted for the bandwidth of the new requested path of this LSP.
CSPF applies the least-fill path selection method to all requests for a path, primary and secondary, of an LSP for which this option is enabled. The bandwidth of the path can be any value, including zero.
CSPF applies the least-fill criterion separately to each pre-emption priority in the base TE. A higher setup priority path can pre-empt lower holding priority paths.
CSPF also applies the least-fill criterion separately to each Diff-Serv TE class if Diff-Serv TE is enabled on this node. A higher setup priority path can pre-empt lower holding priority paths within a Class Type.
MPLS will re-signal and move the LSP to the new path in the following cases:
During a manual re-signaling of an LSP path, MPLS will always re-signal the path regardless of whether the new path is exactly the same or different than the current path and regardless or whether the metric of the new path is different or not from that of the current path.
During a timer-based re-signaling of an LSP path which has the least-fill option enabled, MPLS will only re-signal the path if the metric of the new path is different than the one of the current path.
The user deletes a specific node entry in this database by executing the no form of this command.
Default 
no least-fill. The path of an LSP is randomly chosen among a set of equal cost paths.
ldp-over-rsvp
Syntax 
[no] ldp-over-rsvp [include | exclude]
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
This command configures an LSP so that it can be used by the IGP to calculate its SPF tree.
The IGP (OSPF/ISIS) will subsequently provide LDP with all ECMP IGP next-hops and tunnel endpoints that it considers to be the lowest cost path to its destination.
If an IGP calculation and an LDP-over-RSVP indicate the same cost then LDP will always prefer an LDP-over-RSVP tunnel over an IGP route and ECMP between the two types is not considered.
The type and number of tunnels considered by LDP depends on the IGP metrics (the lowest metric between the tunnel endpoint and the target is selected) assuming that each LSP has a TLDP session established between the endpoints.
Enter the command ldporsvp include to make the associated LSP available to be used by the LDP-over-RSVP feature.
The no form of the command reverts to default operation.
Default 
ldporsvp exclude
include
Syntax 
[no] include group-name [group-name...(up to 5max)]
Context 
config>router>mpls>lsp
config>router>mpls>lsp>primary
config>router>mpls>lsp>secondary
config>router>mpls>lsp-template
Description 
This command specifies the admin groups to be included when an LSP is set up. Up to 5 groups per operation can be specified, up to 32 maximum.
The no form of the command deletes the specified groups in the specified context.
Default 
no include
Parameters 
group-name
Specifies admin groups to be included when an LSP is set up.
priority
Syntax 
priority setup-priority hold-priority
no priority
Context 
config>router>mpls>lsp>primary
config>router>mpls>lsp>secondary
Description 
This command enables the soft pre-emption procedures for this LSP path. The operator enables the soft pre-emption mechanism on a specific LSP name by explicitly configuring the setup and holding priorities for the primary path at the 7x50 head-end node. The operator can similarly configure priority values for a secondary path for this LSP name. Different values could be used for the primary and for any of the secondary paths. In the absence of explicit user configuration, the setup priority is internally set to the default value of 7 and the holding priority is set to the default value of 0. Note however that valid user-entered values for these two parameters require that the holding priority be numerically lower than or equal to the setup priority, otherwise pre-emption loops can occur.
Pre-emption is effected when a 7x50 pre-empting node processes a new RSVP session reservation and there is not enough available bandwidth on the RSVP interface, or the Class Type (CT) when Diff-Serv is enabled, to satisfy the bandwidth in the Flowspec object while there exist other session reservations for LSP paths with a strictly lower holding priority (numerically higher holding priority value) than the setup priority of the new LSP reservation. If enough available bandwidth is freed on the link or CT to accommodate the new reservation by pre-empting one or more lower priority LSP paths, the pre-empting node allows temporary overbooking of the RSVP interface and honors the new reservation.
The 7x50 pre-empting node will immediately set the ‘Preemption pending’ flag (0x10) in the IPv4 Sub-Object in the RRO object in the Resv refresh for each of the pre-empted LSP paths. The IPv4 Sub-Object corresponds to the outgoing interface being used by the pre-empting and pre-empted LSP paths. Note however that the bandwidth value in the Flowspec object is not changed. The Resv flag must also be set if the pre-empting node is a merge point for the primary LSP path and the backup bypass LSP or detour LSP and the backup LSP is activated.
When evaluating if enough available bandwidth will be freed, the 7x50 pre-empting node considers the reservations in order from the lowest holding priority (numerically higher holding priority value) to the holding priority just below the setup priority of the new reservation. A new reservation cannot pre-empt a reservation which has a value of the holding priority equal to the new reservation setup priority.
When Diff-Serv is enabled on the pre-empting node and the MAM bandwidth allocation model is used, a new reservation can only pre-empt a reservation in the same Class Type (CT).
LSP paths which were not flagged at the head-end for soft pre-emption will be hard pre-empted. LSP paths with the default holding priority of 0 cannot be pre-empted. LSP paths with zero bandwidth do not pre-empt other LSP paths regardless of the values of the path setup priority and the path holding priority. They can also not be pre-empted.
When evaluating if enough available bandwidth will be freed, the 7x50 pre-empting node considers the reservations in order from the lowest holding priority (numerically higher holding priority) to the holding priority just below the setup priority of the new reservation. There is no specific order in which the reservations in the same holding priority are considered. Furthermore, LSP paths which were not flagged at the head-end for soft pre-emption cannot be pre-empted because their holding priority is set internally to 0.
The 7x50 pre-empting node starts a preemption timer for each of the pre-empted LSP paths. While this timer is on, the node should continue to refresh the Path and Resv for the pre-empted LSP paths. When the preemption timer expires, the node tears down the reservation if the head-end node has not already done so.
A 7x50 head-end node upon receipt of the Resv refresh message with the ‘Preemption pending’ flag must immediately perform a make-before-break on the affected adaptive CSPF LSP. Both IGP metric and TE metric based CSPF LSPs are included. If an alternative path that excludes the flagged interface is not found, then the LSP is put on a retry in a similar way to the Global Revertive procedure at a 7x50 head-end node. However, the number of retries and the retry timer are governed by the values of the retry-limit and retry-timer parameters: config>router>mpls>lsp>retry-limit; config>router>mpls>lsp>retry-timer.
Note that MPLS will keep the address list of flagged interfaces for a maximum of 60 seconds (not user-configurable) from the time the first Resv message with the ‘Preemption pending’ flag is received. This actually means that MPLS will request CSPF to find a path that excludes the flagged interfaces in the first few retries until success or until 60 seconds have elapsed. Subsequent retries after the 60 seconds will not exclude the flagged interfaces as it is assumed IGP has converged by then and the Unreserved Bandwidth sub-TLV for that priority, or TE Class, in the TE database will show the updated value taking into account the pre-empting LSP path reservation or a value of zero if overbooked.
If the LSP has a configured secondary standby which is operationally UP, the 7x50 will switch the path of the LSP to it and then start the MBB. If no standby path is available and a secondary non-standby is configured, the 7x50 will start the MBB and signal the path of the secondary. The LSP path will be switched to either the secondary or the new primary, whichever comes up first.
The no form of the command reverts the LSP path priority to the default values and results in setting the setup priority to 7, in setting the holding priority to 0, and in clearing the ‘soft preemption desired’ flag in the RRO in the Resv refresh message.
Default 
no priority.
Parameters 
setup-priority
The priority of the reservation for this session at setup time.
Values
Default
holding-priority
The priority of the reservation for this session at pre-emption action.
Values
Default
main-ct-retry-limit
Syntax 
main-ct-retry-limit number
no main-ct-retry-limit
Context 
config>router>mpls>lsp
Description 
This command configures the maximum number of retries the LSP primary path should be retried with the LSP Diff-Serv main Class Type (CT).
When an unmapped LSP primary path goes into retry, it uses the main CT until the number of retries reaches the value of the new main-ct-retry-limit parameter. If the path did not come up, it must start using the backup CT at that point in time. By default, this parameter is set to infinite value. The new main-ct-retry-limit parameter has no effect on an LSP primary path which retries due to a failure event.
An unmapped LSP primary path is a path which has never received a Resv in response to the first Path message sent. This can occur when performing a “shut/no-shut” on the LSP or LSP primary path or when the node reboots. An unmapped LSP primary path goes into retry if the retry timer expired or the head-end node received a PathErr message before the retry timer expired.
If the user entered a value of the main-ct-retry-limit parameter that is greater than the value of the LSP retry-limit, the number of retries will still stop when the LSP primary path reaches the value of the LSP retry-limit. In other words, the meaning of the LSP retry-limit parameter is not changed and always represents the upper bound on the number of retries. The unmapped LSP primary path behavior applies to both CSPF and non-CSPF LSPs.
The no form of this command sets the parameter to the default value of zero (0) which means the LSP primary path will retry forever.
Default 
no main-ct-retry-limit
Parameters 
number
The number of times MPLS will attempt to re-establish the LSP primary path using the Diff-Serv main CT. Allowed values are integers in the range of zero (0) to 10,000, where zero indicates to retry infinitely.
Values
metric
Syntax 
[no] metric metric
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
This command allows the user to override the LSP operational metric with a constant administrative value that will not change regardless of the actual path the LSP is using over its lifetime.
The LSP operational metric will match the metric the active path of this LSP is using at any given time. For a CSPF LSP, this metric represents the cumulative IGP metric of all the links the active path is using. If CSPF for this LSP is configured to use the TE metric, the LSP operational metric is set to the maximum value. For a non-CSPF LSP, the operational metric is the shortest IGP cost to the destination of the LSP.
The LSP operational metric is used by some applications to select an LSP among a set of LSPs that are destined to the same egress router. The LSP with the lowest operational metric will be selected. If more than one LSP with the same lowest LSP metric exists, the LSP with the lowest tunnel index will be selected. The configuration of a constant metric by the user will make sure the LSP always maintains its preference in this selection regardless of the path it is using at any given time. Applications that use the LSP operational metric include LDP-over-RSVP, VPRN auto-bind, and IGP, BGP and static route shortcuts.
The no form of this command disables the administrative LSP metric and reverts to the default setting in which the metric value will represent the LSP metric returned by MPLS. The same behavior is obtained if the user entered a metric of value zero (0).
Default 
no metric. The LSP operational metric defaults to the metric retuned by MPLS.
Parameters 
metric
Specifies the integer value which specifies the value of the LSP administrative metric. A value of zero command reverts to the default setting and disables the administrative LSP metric.
Values
to
Syntax 
to [ip-address | node-id [a.b.c.d | 1...4,294,967,295]]
Context 
config>router>mpls>lsp
Description 
This command specifies the system IP address or MPLS-TP node-id of the egress router for the LSP. This command is mandatory to create an LSP.
An IP address for which a route does not exist is allowed in the configuration. If the LSP signaling fails because the destination is not reachable, an error is logged and the LSP operational status is set to down.
For a non MPLS-TP LSP, the to ip-address must be the system IP address of the egress router. If the to address does not match the SDP address, the LSP is not included in the SDP definition.
For an MPLS-TP LSP, the to node-id may be either in 4-octet IPv4 address format, or a 32bit unsigned integer. This command is mandatory to create an MPLS-TP LSP. Note tha a value of zero is invalid. This to address is used in the MPLS-TP LSP ID, and the MPLS-TP MEP ID for the LSP.
Default 
No default
Parameters 
ip-address
The system IP address of the egress router.
node-id a.b.c.d. | 1...4,294,967,295
4-octet IPv4 formatted or unsigned 32-bit integer MPLS-TP node-id of the egress router.
propagate-admin-group
Syntax 
[no] propagate-admin-group
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
This command enables propagation of session attribute object with resource affinity (C-type 1) in PATH message. If a session attribute with resource affinity is received at an LSR, then it will check the compatibility of admin-groups received in PATH message against configured admin-groups on the egress interface of LSP.
To support admin-group for inter-area LSP, the ingress node must configure propagating admin-groups within the session attribute object. If a PATH message is received by an LSR node that has the cspf-on-loose option enabled and the message includes admin-groups, then the ERO expansion by CSPF to calculate the path to the next loose hop will include the admin-group constraints received from ingress node.
If this option is disabled, then the session attribute object without resource affinity (C-Type 7) is propagated in PATH message and CSPF at the LSR node will not include admin-group constraints.
This admin group propagation is supported with a P2P LSP, a P2MP LSP instance, and an LSP template.
The user can change the value of the propagate-admin-group option on the fly. A RSVP P2P LSP will perform a Make-Before-Break (MBB) on changing the configuration. A S2L path of an RSVP P2MP LSP will perform a Break-Before-Make on changing the configuration.
Default 
no propagate-admin-group
vprn-auto-bind
Syntax 
vprn-auto-bind [include | exclude]
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
This command determines whether the associated names LSP can be used or no as part of the auto-bind feature for VPRN services. By default a names LSP is available for inclusion to used for the auto-bind feature.
By configuring the command vprn-auto-bind exclude, the associated LSP will not be used by the auto-bind feature within VPRN services.
The no form of the command resets the flag backto the default value.
Default 
include
Parameters 
include
Allows an associated LSPto be used by auto-bin for vprn services
exclude
Disables the use of the associated LSP to be used with the auto-bind feature for VPRN services.
retry-limit
Syntax 
retry-limit number
no retry-limit
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
This optional command specifies the number of attempts software should make to re-establish the LSP after it has failed LSP. After each successful attempt, the counter is reset to zero.
When the specified number is reached, no more attempts are made and the LSP path is put into the shutdown state.
Use the config router mpls lsp lsp-name no shutdown command to bring up the path after the retry-limit is exceeded.
For P2MP LSP created based on LSP template, all S2Ls must attempt to retry-limit before client application is informed of failure.
The no form of this command revert the parameter to the default value.
Default 
0 (no limit, retries forever)
Parameters 
number
The number of times software will attempt to re-establish the LSP after it has failed. Allowed values are integers in the range of 0 to 10000 where 0 indicates to retry forever.
Values
retry-timer
Syntax 
retry-timer seconds
no retry-timer
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
This command configures the time, in seconds, for LSP re-establishment attempts after it has failed.
For P2MP LSP created based on LSP template, all S2Ls must attempt to retry-limit before client application is informed of failure.
The no form of this command reverts to the default value.
Default 
30
Parameters 
seconds
The amount of time, in seconds, between attempts to re-establish the LSP after it has failed. Allowed values are integers in the range of 1 to 600.
Values
rsvp-resv-style
Syntax 
rsvp-resv-style [se | ff]
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
This command specifies the RSVP reservation style, shared explicit (se) or fixed filter (ff). A reservation style is a set of control options that specify a number of supported parameters. The style information is part of the LSP configuration.
Default 
se
Parameters 
ff
Fixed filter is single reservation with an explicit scope. This reservation style specifies an explicit list of senders and a distinct reservation for each of them. A specific reservation request is created for data packets from a particular sender. The reservation scope is determined by an explicit list of senders.
se
Shared explicit is shared reservation with a limited scope. This reservation style specifies a shared reservation environment with an explicit reservation scope. This reservation style creates a single reservation over a link that is shared by an explicit list of senders. Because each sender is explicitly listed in the RESV message, different labels can be assigned to different sender-receiver pairs, thereby creating separate LSPs.
shutdown
Syntax 
[no] shutdown
Context 
config>router>mpls>lsp
config>router>mpls>lsp-template
Description 
This command disables the existing LSP including the primary and any standby secondary paths.
To shutdown only the primary enter the config router mpls lsp lsp-name primary path-name shutdown command.
To shutdown a specific standby secondary enter the config router mpls lsp lsp-name secondary path-name shutdown command. The existing configuration of the LSP is preserved.
Use the no form of this command to restart the LSP. LSPs are created in a shutdown state. Use this command to administratively bring up the LSP.
Default 
shutdown
lsp-template
Syntax 
[no] lsp-template lsp-template-name p2mp-lsp
Context 
config>router>mpls
Description 
This command creates a template construct that can be referenced by client application where dynamic LSP creation is required. ‘p2mp-lsp’ keyword is mandatory.
The no form of command deletes LSP template. LSP template cannot be deleted if a client application is using it.
Default 
none
Parameters 
lsp-template-name — Name to identify LSP template. Any LSP template name and LSP name must not be same.
 
 
 
default-path
Syntax 
[no] default-path path-name
Context 
config>router>mpls>lsp-template
Description 
A default path binding must be provided before LSP template can be used for signaling LSP. LSP template must be shutdown to modify default-path binding.
The no form of command should delete path binding.
Default 
none
Parameters 
path-name
 
Primary and Secondary Path Commands
primary
Syntax 
primary path-name
no primary
Context 
config>router>mpls>lsp
Description 
This command specifies a preferred path for the LSP. This command is optional only if the secondary path-name is included in the LSP definition. Only one primary path can be defined for an LSP.
Some of the attributes of the LSP such as the bandwidth, and hop-limit can be optionally specified as the attributes of the primary path. The attributes specified in the primary path path-name command, override the LSP attributes.
The no form of this command deletes the association of this path-name from the LSP lsp-name. All configurations specific to this primary path, such as record, bandwidth, and hop limit, are deleted. The primary path must be shutdown first in order to delete it. The no primary command will not result in any action except a warning message on the console indicating that the primary path is administratively up.
Default 
none
Parameters 
path-name
The case-sensitive alphanumeric name label for the LSP path up to 32 characters in length.
secondary
Syntax 
[no] secondary path-name
Context 
config>router>mpls>lsp
Description 
This command specifies an alternative path that the LSP uses if the primary path is not available. This command is optional and is not required if the config router mpls lsp lsp-name primary path-name command is specified. After the switch over from the primary to the secondary, the software continuously tries to revert to the primary path. The switch back to the primary path is based on the retry-timer interval.
Up to eight secondary paths can be specified. All the secondary paths are considered equal and the first available path is used. The software will not switch back among secondary paths.
Software starts the signaling of all non-standby secondary paths at the same time. Retry counters are maintained for each unsuccessful attempt. Once the retry limit is reached on a path, software will not attempt to signal the path and administratively shuts down the path. The first successfully established path is made the active path for the LSP.
The no form of this command removes the association between this path-name and lsp-name. All specific configurations for this association are deleted. The secondary path must be shutdown first in order to delete it. The no secondary path-name command will not result in any action except a warning message on the console indicating that the secondary path is administratively up.
Default 
none
Parameters 
path-name
The case-sensitive alphanumeric name label for the LSP path up to 32 characters in length.
adaptive
Syntax 
[no] adaptive
Context 
config>router>mpls>lsp>primary
config>router>mpls>lsp>secondary
Description 
This command enables the make-before-break functionality for an LSP or a primary or secondary LSP path. When enabled for the LSP, make-before-break will be performed for primary path and all the secondary paths of the LSP.
Default 
adaptive
backup-class-type
Syntax 
backup-class-type ct-number
no backup-class-type
Context 
config>router>mpls>lsp>primary
Description 
This command enables the use of the Diff-Serv backup Class-Type (CT), instead of the Diff-Serv main CT, to signal the LSP primary path when it fails and goes into retry. The Diff-Serv main CT is configured at the LSP level or at the primary path level using the following commands:
config>router>mpls>lsp>class-type ct-number
config>router>mpls>lsp>primary>class-type ct-number
When a LSP primary path retries due a failure, for example, it fails after being in the UP state, or undergoes any type of Make-Before-Break (MBB), MPLS will retry a new path for the LSP using the main CT. If the first attempt failed, the head-end node performs subsequent retries using the backup CT. This procedure must be followed regardless if the currently used CT by this path is the main or backup CT. This applies to both CSPF and non-CSPF LSPs.
The triggers for using the backup CT after the first retry attempt are:
1.
2.
3.
4.
5.
6.
7.
When an unmapped LSP primary path goes into retry, it uses the main CT until the number of retries reaches the value of the new main-ct-retry-limit parameter. If the path did not come up, it must start using the backup CT at that point in time. By default, this parameter is set to infinite value. The new main-ct-retry-limit parameter has no effect on an LSP primary path which retries due to a failure event.
An unmapped LSP primary path is a path which has never received a Resv in response to the first Path message sent. This can occur when performing a ‘shut/no-shut’ on the LSP or LSP primary path or when the node reboots. An unmapped LSP primary path goes into retry if the retry timer expired or the head-end node received a PathErr message before the retry timer expired.
When the re-signal timer expires, CSPF will try to find a path with the main CT. The head-end node must re-signal the LSP even if the new path found by CSPF is identical to the existing one since the idea is to restore the main CT for the primary path. A path with main CT is not found, the LSP remains on its current primary path using the backup CT.
When the user performs a manual re-signal of the primary path, CSPF will try to find a path with the main CT. The head-end node must re-signal the LSP as in current implementation.
The no form of this command disables the use of the Diff-Serv backup CT.
Default 
no backup-class-type
Parameters 
ct-number
The Diff-Serv Class Type number. One or more system forwarding classes can be mapped to a CT.
Values
bandwidth
Syntax 
bandwidth rate-in-mbps
no bandwidth
Context 
config>router>mpls>lsp>primary
config>router>mpls>lsp>secondary
config>router>mpls>lsp-template>fast-reroute
Description 
This command specifies the amount of bandwidth to be reserved for the LSP path.
The no form of this command resets bandwidth parameters (no bandwidth is reserved).
Default 
no bandwidth (bandwidth setting in the global LSP configuration)
Parameters 
rate-in-mbps
The amount of bandwidth reserved for the LSP path in Mbps. Allowed values are integers in the range of 1 to 100000.
Values
exclude
Syntax 
[no] exclude group-name [group-name...(up to 5 max)]
Context 
config>router>mpls>lsp>primary
config>router>mpls>lsp>secondary
Description 
This command specifies the admin groups to be excluded when an LSP is set up. . Up to 5 groups per operation can be specified, up to 32 maximum. The admin groups are defined in the config>router>mpls>admin-group context.
Use the no form of the command to remove the exclude command.
Default 
no exclude
Parameters 
group-name
Specifies the existing group-name to be excluded when an LSP is set up.
hop-limit
Syntax 
hop-limit number
no hop-limit
Context 
config>router>mpls>lsp>primary
config>router>mpls>lsp>secondary
Description 
This optional command overrides the config router mpls lsp lsp-name hop-limit command. This command specifies the total number of hops that an LSP traverses, including the ingress and egress routers.
This value can be changed dynamically for an LSP that is already set up with the following implications:
If the new value is less than the current hops of the established LSP, the LSP is brought down. MPLS then tries to re-establish the LSP within the new hop-limit number. If the new value is equal or more than the current hops of the established LSP then the LSP will be unaffected.
The no form of this command reverts the values defined under the LSP definition using the config router mpls lsp lsp-name hop-limit command.
Default 
no hop-limit
Parameters 
number
The number of hops the LSP can traverse, expressed as an integer.
Values
record
Syntax 
[no] record
Context 
config>router>mpls>lsp>primary
config>router>mpls>lsp>secondary
config>router>mpls>lsp-template
Description 
This command enables recording of all the hops that an LSP path traverses. Enabling record increases the size of the PATH and RESV refresh messages for the LSP since this information is carried end-to-end along the path of the LSP. The increase in control traffic per LSP may impact scalability.
The no form of this command disables the recording of all the hops for the given LSP. There are no restrictions as to when the no command can be used. The no form of this command also disables the record-label command.
Default 
record
record-label
Syntax 
[no] record-label
Context 
config>router>mpls>lsp>primary
config>router>mpls>lsp>secondary
config>router>mpls>lsp-template
Description 
This command enables recording of all the labels at each node that an LSP path traverses. Enabling the record-label command will also enable the record command if it is not already enabled.
The no form of this command disables the recording of the hops that an LSP path traverses.
Default 
record-label
srlg
Syntax 
[no] srlg
Context 
config>router>mpls>lsp>secondary
Description
This command enables the use of the SRLG constraint in the computation of a secondary path for an LSP at the head-end LER.
When this feature is enabled, CSPF includes the SRLG constraint in the computation of the secondary LSP path. This requires that the primary LSP already be established and is up since the head-end LER needs the most current ERO computed by CSPF for the primary path. CSPF would return the list of SRLG groups along with the ERO during primary path CSPF computation. At a subsequent establishment of a secondary path with the SRLG constraint, the MPLS/RSVP task will query again CSPF providing the list of SLRG group numbers to be avoided. CSPF prunes all links with interfaces which belong to the same SRLGs as the interfaces included in the ERO of the primary path. If CSPF finds a path, the secondary is setup. If not, MPLS/RSVP will keep retrying the requests to CSPF.
If CSPF is not enabled on the LSP name, then a secondary path of that LSP which has the SRLG constraint included will be shut down and a specific failure code will indicate the exact reason for the failure in show>router>mpls>lsp>path>detail output.
At initial primary LSP path establishment, if primary does not come up or primary is not configured, SRLG secondary will not be signaled and will put to down state. A specific failure code will indicate the exact reason for the failure in show>router>mpls>lsp>path>detail output. However, if a non-SRLG secondary path was configured, such as a secondary path with the SRLG option disabled, MPLS/RSVP task will signal it and the LSP use it.
As soon as the primary path is configured and successfully established, MPLS/RSVP moves the LSP to the primary and signals all SRLG secondary paths.
Any time the primary path is re-optimized, has undergone MBB, or has come back up after being down, MPLS/RSVP task checks with CSPF if the SRLG secondary should be re-signaled. If MPLS/RSVP finds that current secondary path is no longer SRLG disjoint, for example, it became ineligible, it puts it on a delayed MBB immediately after the expiry of the retry timer. If MBB fails at the first try, the secondary path is torn down and the path is put on retry.
At the next opportunity the primary goes down, the LSP will use the path of an eligible SRLG secondary if it is UP. If all secondary eligible SLRG paths are Down, MPLS/RSVP will use a non SRLG secondary if configured and UP. If while the LSP is using a non SRLG secondary, an eligible SRLG secondary came back up, MPLS/RSVP will not switch the path of the LSP to it. As soon as primary is re-signaled and comes up with a new SLRG list, MPLS/RSVP will re-signal the secondary using the new SRLG list.
A secondary path which becomes ineligible as a result of an update to the SRLG membership list of the primary path will have the ineligibility status removed on any of the following events:
8.
9.
10.
Once primary path of the LSP is setup and is operationally up, any subsequent changes to the SRLG group membership of an interface the primary path is using would not be considered until the next opportunity the primary path is re-signaled. The primary path may be re-signaled due to a failure or to a make-before-break operation. Make-before-break occurs as a result of a global revertive operation, a timer based or manual re-optimization of the LSP path, or an operator change to any of the path constraints.
One an SRLG secondary path is setup and is operationally UP, any subsequent changes to the SRLG group membership of an interface the secondary path is using would not be considered until the next opportunity secondary path is re-signaled. The secondary path is re-signaled due to a failure, to a re-signaling of the primary path, or to a make before break operation. Make-before break occurs as a result of a timer based or manual re-optimization of the secondary path, or an operator change to any of the path constraints of the secondary path, including enabling or disabling the SRLG constraint itself.
Also, the user-configured include/exclude admin group statements for this secondary path are also checked together with the SRLG constraints by CSPF
 
The no form of the command reverts to the default value.
Default 
no srlg
standby
Syntax 
[no] standby
Context 
config>router>mpls>lsp>secondary
Description 
The secondary path LSP is normally signaled once the primary path LSP fails. The standby keyword ensures that the secondary path LSP is signaled and maintained indefinitely in a hot-standby state. When the primary path is re-established then the traffic is switched back to the primary path LSP.
The no form of this command specifies that the secondary LSP is signaled when the primary path LSP fails.
Default 
none
path-preference
Syntax 
[no] path-preference value
Context 
config>router>mpls>lsp>secondary
Description 
This command enables use of path preference among configured standby secondary paths per LSP. If all standby secondary paths have a default path-preference value then a non-standby secondary path will remain the active path while a standby secondary is available. A standby secondary path configured with highest priority (lowest path-preference value) must be made the active path when the primary is not in use. Path preference can be configured on standby secondary path.
The no form of this command resets the path-preference to the default value.
Default 
255
Parameters 
value
Specifies an alternate path for the LSP if the primary path is not available,
1–255
 
LSP Path Commands
hop
Syntax 
hop hop-index ip-address {strict | loose}
no hop hop-index
Context 
config>router>mpls>path
Description 
This command specifies the IP address of the hops that the LSP should traverse on its way to the egress router. The IP address can be the interface IP address or the system IP address. If the system IP address is specified then the LSP can choose the best available interface.
Optionally, the LSP ingress and egress IP address can be included as the first and the last hop. A hop list can include the ingress interface IP address, the system IP address, and the egress IP address of any of the hops being specified.
The no form of this command deletes hop list entries for the path. All the LSPs currently using this path are affected. Additionally, all services actively using these LSPs are affected. The path must be shutdown first in order to delete the hop from the hop list. The no hop hop-index command will not result in any action except a warning message on the console indicating that the path is administratively up.
Default 
none
Parameters 
hop-index
The hop index is used to order the hops specified. The LSP always traverses from the lowest hop index to the highest. The hop index does not need to be sequential.
Values
ip-address
The system or network interface IP address of the transit router. The IP address can be the interface IP address or the system IP address. If the system IP address is specified then the LSP can choose the best available interface. A hop list can also include the ingress interface IP address, the system IP address, and the egress IP address of any of the specified hops.
loose
This keyword specifies that the route taken by the LSP from the previous hop to this hop can traverse through other routers. Multiple hop entries with the same IP address are flagged as errors. Either the loose or strict keyword must be specified.
strict
This keyword specifies that the LSP must take a direct path from the previous hop router to this router. No transit routers between the previous router and this router are allowed. If the IP address specified is the interface address, then that is the interface the LSP must use. If there are direct parallel links between the previous router and this router and if system IP address is specified, then any one of the available interfaces can be used by the LSP. The user must ensure that the previous router and this router have a direct link. Multiple hop entries with the same IP address are flagged as errors. Either the loose or strict keyword must be specified.
path
Syntax 
[no] path path-name
Context 
config>router>mpls
Description 
This command creates the path to be used for an LSP. A path can be used by multiple LSPs. A path can specify some or all hops from ingress to egress and they can be either strict or loose. A path can also be empty (no path-name specified) in which case the LSP is set up based on IGP (best effort) calculated shortest path to the egress router. Paths are created in a shutdown state. A path must be shutdown before making any changes (adding or deleting hops) to the path. When a path is shutdown, any LSP using the path becomes operationally down.
To create a strict path from the ingress to the egress router, the ingress and the egress routers must be included in the path statement.
The no form of this command deletes the path and all its associated configuration information. All the LSPs that are currently using this path will be affected. Additionally all the services that are actively using these LSPs will be affected. A path must be shutdown and unbound from all LSPs using the path before it can be deleted. The no path path-name command will not result in any action except a warning message on the console indicating that the path may be in use.
Parameters 
path-name
Specify a unique case-sensitive alphanumeric name label for the LSP path up to 32 characters in length.
shutdown
Syntax 
[no] shutdown
Context 
config>router>mpls>path
Description 
This command disables the existing LSPs using this path. All services using these LSPs are affected. Binding information, however, is retained in those LSPs. Paths are created in the shutdown state.
The no form of this command administratively enables the path. All LSPs, where this path is defined as primary or defined as standby secondary, are (re)established.
Default 
shutdown
 
Static LSP Commands
static-lsp
Syntax 
[no] static-lsp lsp-name
Context 
config>router>mpls
Description 
This command is used to configure a static LSP on the ingress router. The static LSP is a manually set up LSP where the nexthop IP address and the outgoing label (push) must be specified.
The no form of this command deletes this static LSP and associated information.
The LSP must be shutdown first in order to delete it. If the LSP is not shut down, the no static-lsp lsp-name command does nothing except generate a warning message on the console indicating that the LSP is administratively up.
Parameters 
lsp-name
Name that identifies the LSP.
Values
static-lsp-fast-retry
Syntax 
static-lsp-fast-retry seconds
[no] static-lsp-fast-retry
Context 
config>router>mpls
Description 
This command specifies the value used as the fast retry timer for a static LSP.
When a static LSP is trying to come up, the MPLS request for the ARP entry of the LSP next-hop may fail when it is made while the next-hop is still down or unavailable. In that case, MPLS starts a retry timer before making the next request. This enhancement allows the user to configure the retry timer, so that the LSP comes up as soon as the next-hop is up.
The no form of the commnand reverts to the default.
Default 
no static-fast-retry-timer
Parameters 
seconds
specifies the value, in seconds, used as the fast retry timer for a static LSP.
Values
push
Syntax 
push {label | implicit-null-label} nexthop ip-address
no push {out-label | implicit-null-label}
Context 
config>router>mpls>static-lsp
Description 
This command specifies the label to be pushed on the label stack and the next hop IP address for the static LSP.
The no form of this command removes the association of the label to push for the static LSP.
Parameters 
implicit-null-label
Specifies the use of the implicit label value for the push operation.
label
The label to push on the label stack. Label values 16 through 1,048,575 are defined as follows:
Label values 16 through 31 are reserved.
Label values 32 through 1,023 are available for static assignment.
Label values 1,024 through 2,047 are reserved for future use.
Label values 2,048 through 18,431 are statically assigned for services.
Label values 28,672 through 131,071 are dynamically assigned for both MPLS and services.
Label values 131,072 through 1,048,575 are reserved for future use.
Values
nexthop ip-address
This command specifies the IP address of the next hop towards the LSP egress router. If an ARP entry for the next hop exists, then the static LSP is marked operational. If ARP entry does not exist, software sets the operational status of the static LSP to down and continues to ARP for the configured nexthop. Software continuously tries to ARP for the configured nexthop at a fixed interval.
shutdown
Syntax 
[no] shutdown
Context 
config>router>mpls>static-lsp
Description 
This command is used to administratively disable the static LSP.
The no form of this command administratively enables the static LSP.
Default 
shutdown
to
Syntax 
to ip-address
Context 
config>router>mpls>static-lsp
Description 
This command specifies the system IP address of the egress router for the static LSP. When creating an LSP this command is required. For LSPs that are used as transport tunnels for services, the to IP address must be the system IP address. If the to address does not match the SDP address, the LSP is not included in the SDP definition.
Parameters 
ip-address
The system IP address of the egress router.
Default 
none
Point-to-Multipoint MPLS (P2MP) Commands
p2mp-id
Syntax 
p2mp-id id
Context 
config>router>mpls>lsp
Description 
This command configures the identifier of an RSVP P2MP LSP. An RSVP P2MP LSP is fully identified by the combination of: <P2MP ID, tunnel ID, extended tunnel ID> part of the P2MP session object, and <tunnel sender address, LSP ID> fields in the p2mp sender_template object.
The p2mp-id is a 32-bit identifier used in the session object that remains constant over the life of the P2MP tunnel. It is unique within the scope of the ingress LER.
The no form restores the default value of this parameter.
Default 
0
Parameters 
id
Specifies a P2MP identifier.
Values
primary-p2mp-instance
Syntax 
[no] primary-p2mp-instance instance-name
Context 
config>router>mpls>lsp
Description 
This command creates the primary instance of a P2MP LSP. The primary instance of a P2MP LSP is modeled as a set of root-to-leaf (S2L) sub-LSP’s. The root, for example a head-end node triggers signaling using one path message per S2L path. The leaf sub-LSP paths are merged at branching points.
Default 
none
Parameters 
instance-name
Specifies a name that identifies the P2MP LSP instance. The instance name can be up to 32 characters long and must be unique.
s2l-path
Syntax 
[no] s2l-path path-name to ip-address
Context 
config>router>mpls>lsp>primary-inst
Description 
This command creates a root-to-leaf (S2L) sub-LSP path for the primary instance of a P2MP LSP. The primary instance of a P2MP LSP is modeled as a set of root-to-leaf (S2L) sub-LSPs. The root, for example, head-end node, triggers signaling using one path message per S2L path. The leaf sub-LSP paths are merged at branching points.
Each S2L sub-LSP is signaled in a separate path message. Each leaf node will respond with its own RESV message. A branch LSR node will forward the path message of each S2L sub-LSP to the downstream LSR without replicating it. It will also forward the RESV message of each S2L sub-LSP to the upstream LSR without merging it with the RESV messages of other S2L sub-LSPs of the same P2MP LSP. The same is done for subsequent refreshes of the path and RESV states.
The S2L paths can be empty paths or can specify a list of explicit hops. The path name must exist and must have been defined using the config>router>mpls>path command. The same path name can be re-used by more than one S2L of the primary P2MP instance. However, the to keyword must have a unique argument per S2L as it corresponds to the address of the egress LER node.
Default 
none
Parameters 
path-name
Specifies the name of the path which consists of up to 32 alphanumeric characters.
to ip-address
Specifies the system IP address of the egress router.
p2mp-resignal-timer
Syntax 
p2mp-resignal-timer minutes
no p2mp-resignal-timer
Context 
config>router>mpls
Description 
This command configures the re-signal timer for a P2MP LSP instance. MPLS will request CSPF to re-compute the whole set of S2L paths of a given active P2MP instance each time the P2MP re-signal timer expires. The P2MP re-signal timer is configured separately from the P2P LSP parameter. MPLS performs a global MBB and moves each S2L sub-LSP in the instance into its new path using a new P2MP LSP ID if the global MBB is successful, regardless of the cost of the new S2L path.
The no form of this command disables the timer-based re-signaling of P2MP LSPs on this system.
Parameters 
minutes
Specifies the time MPLS waits before attempting to re-signal the P2MP LSP instance.
Values
 
RSVP Configuration Commands
Generic Commands
shutdown
Syntax 
[no] shutdown
Context 
config>router>rsvp
config>router>rsvp>interface
Description 
This command disables the RSVP protocol instance or the RSVP-related functions for the interface. The RSVP configuration information associated with this interface is retained. When RSVP is administratively disabled, all the RSVP sessions are torn down. The existing configuration is retained.
The no form of this command administratively enables RSVP on the interface.
Default 
shutdown
 
RSVP Commands
rsvp
Syntax 
[no] rsvp
Context 
config>router
Description 
This command enables the context to configure RSVP protocol parameters. RSVP is not enabled by default and must be explicitely enabled (no shutdown).
RSVP is used to set up LSPs. RSVP should be enabled on all router interfaces that participate in signaled LSPs.
The no form of this command deletes this RSVP protocol instance and removes all configuration parameters for this RSVP instance. To suspend the execution and maintain the existing configuration, use the shutdown command. RSVP must be shutdown before the RSVP instance can be deleted. If RSVP is not shutdown, the no rsvp command does nothing except issue a warning message on the console indicating that RSVP is still administratively enabled.
Default 
no shutdown
diffserv-te
Syntax 
diffserv-te [mam | rdm]
no diffserv-te
Context 
config>router>rsvp
Description 
This command enabled Diff-Serv Traffic Engineering on the node.
When this command is enabled, IS-IS and OSPF will start advertising available bandwidth for each TE class configured under the diffserv-te node. This command will only have effect if the operator has already enabled traffic engineering at the IS-IS and/or OSPF routing protocol levels:
config>router>isis>traffic-engineering
and/or:
config>router>ospf>traffic-engineering
IGP will advertize for each RSVP interface in the system the available bandwidth in each TE class in the unreserved bandwidth TE parameter for that class. In addition, IGP will continue to advertize the existing Maximum Reservable Link Bandwidth TE parameter to mean the maximum bandwidth that can be booked on a given interface by all classes. The value advertized is adjusted with the link subscription percentage factor configured in the config>router>rsvp>interface context.
The user configures the following parameters for the operation of Diff-Serv:
When Diff-Serv TE is enabled, the system will automatically enable the Max Allocation Model (MAM) Admission Control Policy. MAM represents the bandwidth constraint model for the admission control of an LSP reservation to a link. This is the only Admission Control Policy supported in this release.
Each CT shares a percentage of the Maximum Reservable Link Bandwidth via the user configured Bandwidth Constraint (BC) for this CT. The Maximum Reservable Link Bandwidth is the link bandwidth multiplied by the RSVP interface subscription factor.
The sum of all BC values across all CTs will not exceed the Maximum Reservable Link Bandwidth. In other words, the following rule is enforced:
SUM (BCc) =< Max-Reservable-Bandwidth, 0 <= c <= 7
An LSP of class-type CTc, setup priority p, holding priority h (h=<p), and bandwidth B is admitted into a link if the following condition is satisfied:
B <= Unreserved Bandwidth for TE-Class[i]
where TE-Class [i] maps to < CTc , p > in the definition of the TE classes on the node. The bandwidth reservation is effected at the holding priority, i.e., in TE-class [j] = <CTc, h>. Thus, the reserved bandwidth for CTc and the unreserved bandwidth for the TE classes using CTc are updated as follows:
Reserved(CTc) = Reserved(CTc) + B
Unreserved TE-Class [j] = BCc - SUM (Reserved(CTc,q)) for 0<= q <= h
Unreserved TE-Class [i] = BCc - SUM (Reserved(CTc,q)) for 0<= q <= p
The same is done to update the unreserved bandwidth for any other TE class making use of the same CTc. These new values are advertised to the rest of the network at the next IGP-TE flooding.
The Russian Doll Model (RDM) LSP admission control policy allows bandwidth sharing across Class Types. It provides a hierarchical model by which the reserved bandwidth of a CT is the sum of the reserved bandwidths of the numerically equal and higher CTs.
The RDM model is defined using the following equations:
SUM (Reserved (CTc)) <= BCb,
where the SUM is across all values of c in the range b <= c <= (MaxCT - 1), and BCb is the bandwidth constraint of CTb.
BC0= Max-Reservable-Bandwidth, so that
SUM (Reserved(CTc)) <= Max-Reservable-Bandwidth,
where the SUM is across all values of c in the range 0 <= c <= (MaxCT - 1).
When Diff-Serv is disabled on the node, this model degenerates into a single default CT internally with eight pre-emption priorities and a non-configurable BC equal to the Maximum Reservable Link Bandwidth. This would behave exactly like CT0 with eight pre-emption priorities and BC= Maximum Reservable Link Bandwidth if Diff-Serv was enabled.
The enabling or disabling of Diff-Serv TE on the system requires the RSVP and MPLS protocol be shutdown.
The no form of this command reverts to the default value.
Default 
no diffserv-te
Parameters 
mam
Defines the default admission control policy for Diff-Serv LSPs.
rdm
Defines Russian doll model for the admission control policy of Diff-Serv LSPs.
class-type-bw
Syntax 
class-type-bw ct0 %-link-bandwidth ct1%-link-bandwidth ct2%-link-bandwidth ct3%-link-bandwidth ct4%-link-bandwidth ct5%-link-bandwidth ct6%-link-bandwidth ct7%-link-bandwidth
no class-type-bw
Context 
config>router>rsvp>diffserv-te
config>router>rsvp>interface
Description 
This command configures the percentage of RSVP interface bandwidth each CT shares, for example, the Bandwidth Constraint (BC).
The absolute value of the CT share of the interface bandwidth is derived as the percentage of the bandwidth advertised by IGP in the Maximum Reservable Link Bandwidth TE parameter, for example, the link bandwidth multiplied by the RSVP interface subscription percentage parameter.
Note this configuration also exists at RSVP interface level and the interface specific configured value overrides the global configured value. The BC value can be changed at any time.
The RSVP interface subscription percentage parameter is configured in the config>router>rsvp>interface context.
The operator can specify the Bandwidth Constraint (BC) for a CT which is not used in any of the TE class definition but that does not get used by any LSP originating or transiting this node.
When Diff-Serv is disabled on the node, this model degenerates into a single default CT internally with eight pre-emption priorities and a non configurable BC equal to the Maximum Reservable Link Bandwidth. This would behave exactly like CT0 with eight pre-emption priorities and BC= Maximum Reservable Link Bandwidth if Diff-Serv was enabled.
The no form of this command reverts to the default value.
Parameters 
ct0 (ct1/ct2/ ct7) % link-bandwidth
The Diff-Serv Class Type number. One or more system forwading classes can be mapped to a CT.
Values
Default
fc
Syntax 
fc fc-name class-type ct-number
no fc fc-name
Context 
config>router>rsvp>diffserv-te
Description 
This command maps one or more system forwarding classes to a Diff-Serv Class Type (CT).
The default mapping is shown in the following table.
The no form of this command reverts to the default mapping for the forwarding class name.
Parameters 
class-type ct-number
The Diff-Serv Class Type number. One or more system forwading classes can be mapped to a CT.
Values
te-class
Syntax 
te-class te-class-number class-type ct-number priority priority
no te-class te-class-number
Context 
config>router>rsvp>diffserv-te
Description 
This command configures a traffic engineering class. A TE class is defined as:
TE Class = {Class Type (CT), LSP priority}
Eight TE classes are supported. There is no default TE class once Diff-Serv is enabled. The user has to explicitly define each TE class.
When when Diff-Serv is disabled there will be an internal use of the default CT (CT0) and eight pre-emption priorities as shown in the following table.
 
The no form of this command deletes the TE class.
Parameters 
te-class te-class-number
The traffic engineering class number.
Values
class-type ct-number
The Diff-Serv Class Type number. One or more system forwading classes can be mapped to a CT.
Values
priority priority
The LSP priority.
Values
gr-helper
Syntax 
gr-helper [enable | disable]
Context 
config>router>rsvp>if
Description 
This command enables the RSVP Graceful Restart Helper feature.
The RSVP-TE Graceful Restart helper mode allows the SR OS based system (the helper node) to provide another router that has requested it (the restarting node) a grace period, during which the system will continue to use RSVP sessions to neighbors requesting the grace period. This is typically used when another router is rebooting its control plane but its forwarding plane is expected to continue to forward traffic based on the previously available Path and Resv states.
The user can enable Graceful Restart helper on each RSVP interface separately. When the GR helper feature is enabled on an RSVP interface, the node starts inserting a new Restart_Cap Object in the Hello packets to its neighbor. The restarting node does the same and indicates to the helper node the desired Restart Time and Recovery Time.
The GR Restart helper consists of a couple of phases. Once it loses Hello communication with its neighbor, the helper node enters the Restart phase. During this phase, it preserves the state of all RSVP sessions to its neighbor and waits for a new Hello message.
Once the Hello message is received indicating the restarting node preserved state, the helper node enters the recovery phase in which it starts refreshing all the sessions that were preserved. The restarting node will activate all the stale sessions that are refreshed by the helper node. Any Path state which did not get a Resv message from the restarting node once the Recovery Phase time is over is considered to have expired and is deleted by the helper node causing the proper Path Tear generation downstream.
The duration of the restart phase (recovery phase) is equal to the minimum of the neighbor’s advertised Restart Time (Recovery Time) in its last Hello message and the locally configured value of the max-restart (max-recovery) parameter.
When GR helper is enabled on an RSVP interface, its procedures apply to the state of both P2P and P2MP RSVP LSP to a neighbor over this interface.
Default 
disable
graceful-shutdown
Syntax 
[no] graceful-shutdown
Context 
config>router>rsvp
config>router>rsvp>interface
Description 
This command initiates a graceful shutdown of the specified RSVP interface or all RSVP interfaces on the node if applied at the RSVP level. These are referred to as maintenance interface and maintenance node, respectively.
To initiate a graceful shutdown the maintenance node generates a PathErr message with a specific error sub-code of Local Maintenance on TE Link required for each LSP that is exiting the maintenance interface.
The node performs a single make-before-break attempt for all adaptive CSPF LSPs it originates and LSP paths using the maintenance interfaces. If an alternative path for an affected LSP is not found, then the LSP is maintained on its current path. The maintenance node also tears down and re-signals any detour LSP path using listed maintenance interfaces as soon as they are not active.
The maintenance node floods an IGP TE LSA/LSP containing Link TLV for the links under graceful shutdown with Traffic Engineering metric set to 0xffffffff and Unreserved Bandwidth parameter set to zero (0).
A head-end LER node, upon receipt of the PathErr message performs a single make-before-break attempt on the affected adaptive CSPF LSP. If an alternative path is not found, then the LSP is maintained on its current path.
A node does not take any action on the paths of the following originating LSPs after receiving the PathErr message:
a. An adaptive CSPF LSP for which the PathErr indicates a node address in the address list and the node corresponds to the destination of the LSP. In this case, there are no alternative paths which can be found.
b. An adaptive CSPF LSP whose path has explicit hops defined using the listed maintenance interface(s)/node(s).
c. A CSPF LSP with the adaptive option disabled and which current path is over the listed maintenance interfaces in the PathErr message. These are not subject to make-before-break.
d. A non CSPF LSP which current path is over the listed maintenance interfaces in the PathErr message.
The head-end LER node upon receipt of the updates IPG TE LSA/LSP for the maintenance interfaces updates the TE database. This information will be used at the next scheduled CSPF computation for any LSP which path may traverse any of the maintenance interfaces.
The no form of the command disables the graceful shutdown operation at the RSVP interface level or at the RSVP level. The configured TE parameters of the maintenance links are restored and the maintenance node floods the links.
Default 
none
gr-helper-time
Syntax 
gr-helper-time max-recovery recovery-interval [1..1800] seconds max-restart restart-interval [1..300] seconds
no gr-helper-time
Context 
config>router>rsvp
Description 
This command configures the local values for the max-recovery and the max-restart intervals used in the RSVP Graceful Restart Helper feature.
The values are configured globally in RSVP but separate instances of the timers are applied to each RSVP interface that has the RSVP Graceful Restart Helper enabled.
The no version of this command re-instates the default value for the delay timer.
Parameters 
recovery-interval
Specifies the max recovery interval value in seconds.
Values
Default
restart-interval
Specifies the max restart interval value in seconds.
Values
Default
implicit-null-label
Syntax 
[no] implicit-null-label
implicit-null-label
Context 
config>router>rsvp
Description 
This command enables the use of the implicit null label.
Signalling the IMPLICIT NULL label value for all RSVP LSPs can be enabled for which this node is the egress LER. RSVP must be shutdown before being able to change this configuration option.
The egress LER does not signal the implicit null label value on P2MP RSVP LSPs. However, the Penultimate Hop Popping (PHP) node can honor a resv message with the label value set to the implicit null.
The no form of this command disables the signaling of the implicit null label.
Default 
no implicit-null-label
keep-multiplier
Syntax 
[no] keep-multiplier number
no keep-multiplier
Context 
config>router>rsvp
Description 
The keep-multiplier number is an integer used by RSVP to declare that a reservation is down or the neighbor is down.
The no form of this command reverts to the default value.
Default 
3
Parameters 
number
The keep-multiplier value.
Values
refresh-reduction-over-bypass
Syntax 
refresh-reduction-over-bypass [enable | disable]
Context 
config>router>rsvp
Description 
This command enables the refresh reduction capabilities over all bypass tunnels originating on this PLR node or terminating on this Merge Point (MP) node.
By default, this is disabled. Since a bypass tunnel may merge with the primary LSP path in a node downstream of the next-hop, there is no direct interface between the PLR and the MP node and it is possible the latter will not accept summary refresh messages received over the bypass.
When disabled, the node as a PLR or MP will not set the “Refresh-Reduction-Capable” bit on RSVP messages pertaining to LSP paths tunneled over the bypass. It will also not send Message-ID in RSVP messages. This effectively disables summary refresh.
Default 
disable
rapid-retransmit-time
Syntax 
rapid-retransmit-time hundred-milliseconds
no rapid-retransmit-time
Context 
config>router>rsvp
Description 
This command defines the value of the Rapid Retransmission Interval. It is used in the re-transmission mechanism to handle unacknowledged message_id objects and is based on an exponential back-off timer.
Re-transmission interval of a RSVP message with the same message_id = 2 * rapid-retransmit-time interval of time.
The node stops re-transmission of unacknowledged RSVP messages:
If the number of re-transmissions reaches the value of the rapid-retry-limit parameter, whichever comes first.
The Rapid Retransmission Interval must be smaller than the regular refresh interval configured in config>router>rsvp>refresh-time.
The no form of this command reverts to the default value.
Default 
5
Parameters 
hundred-milliseconds
Specifies the rapid retransmission interval.
Values
rapid-retry-limit
Syntax 
rapid-retry-limit number
no rapid-retry-limit
Context 
config>router>rsvp
Description
This command is used to define the value of the Rapid Retry Limit. This is used in the retransmission mechanism based on an exponential backoff timer in order to handle unacknowledged message_id objects. The RSVP message with the same message_id is retransmitted every 2 * rapid-retransmit-time interval of time. The node will stop retransmission of unacknowledged RSVP messages whenever the updated backoff interval exceeds the value of the regular refresh interval or the number of retransmissions reaches the value of the rapid-retry-limit parameter, whichever comes first.
The no form of this command reverts to the default value.
Default 
3
Parameters 
number
Specifies the value of the Rapid Retry Limit.
Values
refresh-time
Syntax 
refresh-time seconds
no refresh-time
Context 
config>router>rsvp
Description 
The refresh-time controls the interval, in seconds, between the successive Path and Resv refresh messages. RSVP declares the session down after it misses keep-multiplier number consecutive refresh messages.
The no form of this command reverts to the default value.
Default 
30 seconds
Parameters 
seconds
The refresh time in seconds.
Values
te-threshold-update
Syntax 
[no] te-threshold-update
Context 
config>router>rsvp
Description 
This command is used to control threshold-based IGP TE updates. The te-threshold-update command must enable IGP TE update based only on bandwidth reservation thresholds per interface and must block IGP TE update on bandwidth changes for each reservation. Threshold levels can be defined using the te-up-threshold and te-down-threshold commands at the global RSVP or per-interface level.
The no form of this command should reset te-threshold-update to the default value and disable threshold based update.
Default 
no te-threshold-update
on-cac-failure
Syntax 
[no] on-cac-failure
Context 
config>router>rsvp>te-threshold-update
Description 
This command is used to enable a CAC failure-triggered IGP update.
The no form of this command should reset on-cac-failure to the default value and disable the CAC failure-triggered IGP update.
Default 
no on-cac-failure
update-timer
Syntax 
update-timer seconds
no update-timer
Context 
config>router>rsvp>te-threshold-update
Description 
This command is to control timer-based IGP TE updates. Timer-based IGP updates can be enabled by specifying a non-zero time value. Default value of update-timer is 0.
The no form of this command should reset update-timer to the default value and disable timer-based IGP update.
Default 
no update-timer (time - 0 seconds)
Parameters 
seconds
The time in seconds.
Values
te-up-threshold
Syntax 
te-up-threshold threshold-level [threshold-level...(up to 16 max)]
no te-up-threshold
Context 
config>router>rsvp
config>router>rsvp>interface
Description 
This command configures the specific threshold levels per node and per interface. Threshold levels are for reserved bandwidth per interface. The te-threshold-update command is used to enable or disable threshold-based IGP TE updates. Any reserved bandwidth change per interface is compared with all the threshold levels and trigger an IGP TE update if a defined threshold level is crossed in either direction (LSP setup or teardown). Threshold-based updates must be supported with both ISIS and OSPF. A minimum of one and a maximum of 16 threshold levels must be supported.
Threshold levels configured per node is inherited by all configured RSVP interfaces. Threshold levels defined under the RSVP interface is used to trigger IGP updates if non-default threshold levels are configured.
The no form of this command resets te-up-threshold to its default value.
Default 
0 15 30 45 60 75 80 85 90 95 96 97 98 99 100
Parameters 
threshold-level
Integer value
Values
te-down-threshold
Syntax 
te-down-threshold threshold-level [threshold-level...(up to 16 max)]
no te-down-threshold
Context 
config>router>rsvp
config>router>rsvp>interface
Description 
This command configures the specific threshold levels per node and per interface. Threshold levels are for reserved bandwidth per interface. The te-threshold-update command is used to enable or disable threshold-based IGP TE updates. Any reserved bandwidth change per interface is compared with all the threshold levels and trigger an IGP TE update if a defined threshold level is crossed in either direction (LSP setup or teardown). Threshold-based updates must be supported with both ISIS and OSPF. A minimum of one and a maximum of 16 threshold levels is supported.
Threshold levels configured per node is inherited by all configured RSVP interfaces. Threshold levels defined under the RSVP interface is used to trigger IGP updates if non-default threshold levels are configured.
The no form of this command resets te-down-threshold to its default value.
Default 
100 99 98 97 96 95 90 85 80 75 60 45 30 15 0
Parameters 
threshold-level
Integer value
Values
 
Interface Commands
interface
Syntax 
[no] interface ip-int-name
Context 
config>router>rsvp
Description 
This command enables RSVP protocol support on an IP interface. No RSVP commands are executed on an IP interface where RSVP is not enabled.
The no form of this command deletes all RSVP commands such as hello-interval and subscription, which are defined for the interface. The RSVP interface must be shutdown it can be deleted. If the interface is not shut down, the no interface ip-int-name command does nothing except issue a warning message on the console indicating that the interface is administratively up.
Default 
shutdown
Parameters 
ip-int-name
The name of the network IP interface. An interface name cannot be in the form of an IP address. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.
Values
authentication-key
Syntax 
authentication-key [authentication-key | hash-key] [hash | hash2]
no authentication-key
Context 
config>router>rsvp>interface
Description 
his command specifies the authentication key to be used between RSVP neighbors to authenticate RSVP messages. Authentication uses the MD-5 message-based digest.
When enabled on an RSVP interface, authentication of RSVP messages operates in both directions of the interface.
A node maintains a security association using one authentication key for each interface to a neighbor. The following items are stored in the context of this security association:
A router RSVP sender transmits an authenticating digest of the RSVP message, computed using the shared authentication key and a keyed-hash algorithm. The message digest is included in an integrity object which also contains a flags field, a key identifier field, and a sequence number field. The RSVP sender complies to the procedures for RSVP message generation in RFC 2747, RSVP Cryptographic Authentication.
A RSVP receiver uses the key together with the authentication algorithm to process received RSVP messages.
When a PLR node switches the path of the LSP to a bypass LSP, it does not send the Integrity object in the RSVP messages sent over the bypass tunnel. If the PLR receives an RSVP message with an Integrity object, it will perform the digest verification for the key of the interface over which the packet was received. If this fails, the packet is dropped. If the received RSVP message is a RESV message and does not have an Integrity object, then the PLR node will accept it only if it originated from the MP node.
An MP node will accept RSVP messages received over the bypass tunnel with and without the Integrity object. If an Integrity object is present, the proper digest verification for the key of the interface over which the packet was received is performed. If this fails, the packet is dropped.
The MD5 implementation does not support the authentication challenge procedures in RFC 2747.
The no form of this command disables authentication.
Default 
no authentication-key - The authentication key value is the null string.
Parameters 
authentication-key
The authentication key. The key can be any combination of ASCII characters up to 16 characters in length (unencrypted). If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.
hash-key
The hash key. The key can be any combination of up 33 alphanumeric characters. If spaces are used in the string, enclose the entire string in quotation marks (“ ”).
This is useful when a user must configure the parameter, but for security purposes, the actual unencrypted key value is not provided.
hash
Specifies the key is entered in an encrypted form. If the hash parameter is not used, the key is assumed to be in a non-encrypted, clear text form. For security, all keys are stored in encrypted form in the configuration file with the hash parameter specified.
hash2
Specifies the key is entered in a more complex encrypted form. If the hash2 parameter is not used, the less encrypted hash form is assumed.
bfd-enable
Syntax 
[no] bfd-enable
Context 
config>router>rsvp>interface
Description 
This command enables the use of bi-directional forwarding (BFD) to control the state of the associated RSVP interface. This causes RSVP to register the interface with the BFD session on that interface.
The user configures the BFD session parameters, such as, transmit-interval, receive-interval, and multiplier, under the IP interface in the config>router> interface>bfd context.
Note that it is possible that the BFD session on the interface was started because of a prior registration with another protocol, for example, OSPF or IS-IS.
The registration of an RSVP interface with BFD is performed at the time of neighbor gets its first session. This means when this node sends or receives a new Path message over the interface. If however the session did not come up, due to not receiving a Resv for a new path message sent after the maximum number of re-tries, the LSP is shutdown and the node de-registers with BFD. In general, the registration of RSVP with BFD is removed as soon as the last RSVP session is cleared.
The registration of an RSVP interface with BFD is performed independent of whether RSVP hello is enabled on the interface or not. However, hello timeout will clear all sessions towards the neighbor and RSVP de-registers with BFD at clearing of the last session.
Note that an RSVP session is associated with a neighbor based on the interface address the path message is sent to. If multiple interfaces exist to the same node, then each interface is treated as a separate RSVP neighbor. The user will have to enable BFD on each interface and RSVP will register with the BFD session running with each of those neighbors independently
Similarly the disabling of BFD on the interface results in removing registration of the interface with BFD.
When a BFD session transitions to DOWN state, the following actions are triggered. For RSVP signaled LSPs, this triggers activation of FRR bypass/detour backup (PLR role), global revertive (head-end role), and switchover to secondary if any (head-end role) for affected LSPs with FRR enabled. It triggers switchover to secondary if any and scheduling of re-tries for signaling the primary path of the non-FRR affected LSPs (head-end role).
The no form of this command removes BFD from the associated RSVP protocol adjacency.
Default 
no bfd-enable
hello-interval
Syntax 
hello-interval milli-seconds
no hello-interval
Context 
config>router>rsvp>interface
Description 
This command configures the time interval between RSVP hello messages.
RSVP hello packets are used to detect loss of RSVP connectivity with the neighboring node. Hello packets detect the loss of neighbor far quicker than it would take for the RSVP session to time out based on the refresh interval. After the loss of the of number keep-multiplier consecutive hello packets, the neighbor is declared to be in a down state.
The no form of this command reverts to the default value of the hello-interval. To disable sending hello messages, set the value to zero.
Default 
3000 milliseconds
Parameters 
milli-seconds
Specifies the RSVP hello interval in milliseconds, in multiples of 1000. A 0 (zero) value disables the sending of RSVP hello messages.
Values
implicit-null-label
Syntax 
implicit-null-label [enable | disable]
no implicit-null-label
Context 
config>router>rsvp>interface
Description 
This command enables the use of the implicit null label over a specific RSVP interface.
All LSPs for which this node is the egress LER and for which the path message is received from the previous hop node over this RSVP interface will signal the implicit null label. This means that if the egress LER is also the merge-point (MP) node, then the incoming interface for the path refresh message over the bypass dictates if the packet will use the implicit null label or not. The same for a 1-to-1 detour LSP.
The user must shutdown the RSVP interface before being able to change the implicit null configuration option.
The no form of this command returns the RSVP interface to use the RSVP level configuration value.
Default 
disable
Parameters 
enable
This parameter enables the implicit null label.
disable
This parameter disables the implicit null label.
refresh-reduction
Syntax 
[no] refresh-reduction
Context 
config>router>rsvp>interface
Description 
This command enables the use of the RSVP overhead refresh reduction capabilities on this RSVP interface.
When this option is enabled, a node will enable support for three capabilities. It will accept bundles RSVP messages from its peer over this interface, it will attempt to perform reliable RSVP message delivery to its peer, and will use summary refresh messages to refresh path and resv states. The reliable message delivery must be explicitly enabled by the user after refresh reduction is enabled. The other two capabilities are enabled immediately.
A bundle message is intended to reduce overall message handling load. A bundle message consists of a bundle header followed by one or more bundle sub-messages. A sub-message can be any regular RSVP message except another bundle message. A node will only process received bundled RSVP messages but will not generate them.
When reliable message delivery is supported by both the node and its peer over the RSVP interface, an RSVP message is sent with a message_id object. A message_id object can be added to any RSVP message when sent individually or as a sub-message of a bundled message.
if the sender sets the ack_desired flag in the message_id object, the receiver acknowledges the receipt of the RSVP message by piggy-backing a message_ack object to the next RSVP message it sends to its peer. Alternatively, an ACK message can also be used to send the message_ack object. In both cases, one or many message_ack objects could be included in the same message.
The router supportsthe sending of separate ACK messages only but is capable of processing received message_ack objects piggy-backed to hop-by-hop RSVP messages, such as path and resv.
The router sets the ack_desired flag only in non refresh RSVP messages and in refresh messages which contain new state information.
A retransmission mechanism based on an exponential backoff timer is supported in order to handle unacknowledged message_id objects. The RSVP message with the same message_id is retransmitted every 2 * rapid-retransmit-time interval of time. The rapid-retransmit-time is referred to as the rapid retransmission interval as it must be smaller than the regular refresh interval configured in the config>router>rsvp>refresh-time context. There is also a maximum number of retransmissions of an unacknowledged RSVP message rapid-retry-limit. The node will stop retransmission of unacknowledged RSVP messages whenever the updated backoff interval exceeds the value of the regular refresh interval or the number of retransmissions reaches the value of the rapid-retry-limit parameter, whichever comes first. These two parameters are configurable globally on a system in the config>router>rsvp context.
Refresh summary consists of sending a summary refresh message containing a message_id list object. The fields of this object are populated each with the value of the message_identifier field in the message_id object of a previously sent individual path or resv message. The summary refresh message is sent every refresh regular interval as configured by the user using the refresh-time command in the config>router>rsvp context. The receiver checks each message_id object against the saved path and resv states. If a match is found, the state is updated as if a regular path or resv refresh message was received from the peer. If a specific message_identifier field does not match, then the node sends a message_id_nack object to the originator of the message.
The above capabilities are referred to collectively as “refresh overhead reduction extensions”. When the refresh-reduction is enabled on an RSVP interface, the node indicates this to its peer by setting a “refresh-reduction-capable” bit in the flags field of the common RSVP header. If both peers of an RSVP interface set this bit, all the above three capabilities can be used. Furthermore, the node monitors the settings of this bit in received RSVP messages from the peer on the interface. As soon as this bit is cleared, the router stops sending summary refresh messages. If a peer did not set the “refresh-reduction-capable” bit, a node does not attempt to send summary refresh messages.
However, if the peer did not set the “refresh-reduction-capable” bit, a node, with refresh reduction enabled and reliable message delivery enabled, will still attempt to perform reliable message delivery with this peer. If the peer does not support the message_id object, it returns an error message “unknown object class”. In this case, the node retransmits the RSVP message without the message_id object and reverts to using this method for future messages destined to this peer.
The no form of the command reverts to the default value.
Default 
no refresh-reduction
reliable-delivery
Syntax 
[no] reliable-delivery
Context 
config>router>rsvp>interface>refresh-reduction
Description
This command enables reliable delivery of RSVP messages over the RSVP interface. When refresh-reduction is enabled on an interface and reliable-delivery is disabled, then the router will send a message_id and not set ACK desired in the RSVP messages over the interface. Thus 7750 does not expect an ACK and but will accept it if received. The node will also accept message ID and reply with an ACK when requested. In this case, if the neighbor set the “refresh-reduction-capable” bit in the flags field of the common RSVP header, the node will enter summary refresh for a specific message_id it sent regardless if it received an ACK or not to this message from the neighbor.
Finally, when ‘reliable-delivery’ option is enabled on any interface, RSVP message pacing is disabled on all RSVP interfaces of the system, for example, the user cannot enable the msg-pacing option in the config>router>rsvp context, and error message is returned in CLI. Conversely, when the msg-pacing option is enabled, the user cannot enable the reliable delivery option on any interface on this system. An error message will also generated in CLI after such an attempt.
The no form of the command reverts to the default value.
Default 
no reliable-delivery
subscription
Syntax 
subscription percentage
no subscription
Context 
config>router>rsvp>interface
Description 
This command configures the percentage of the link bandwidth that RSVP can use for reservation and sets a limit for the amount of over-subscription or under-subscription allowed on the interface.
When the subscription is set to zero, no new sessions are permitted on this interface. If the percentage is exceeded, the reservation is rejected and a log message is generated.
The no form of this command reverts the percentage to the default value.
Default 
100
Parameters 
percentage
The percentage of the interface's bandwidth that RSVP allows to be used for reservations.
Values
te-up-threshold
Syntax 
te-up-threshold threshold-level [threshold-level...(up to 16 max)]
no te-up-threshold
Context 
config>router>rsvp
config>router>rsvp>interface
Description 
This command configures the specific threshold levels per node and per interface. Threshold levels are for reserved bandwidth per interface. The te-threshold-update command is used to enable or disable threshold-based IGP TE updates. Any reserved bandwidth change per interface is compared with all the threshold levels and trigger an IGP TE update if a defined threshold level is crossed in either direction (LSP setup or teardown). Threshold-based updates must be supported with both ISIS and OSPF. A minimum of one and a maximum of 16 threshold levels must be supported.
Threshold levels configured per node is inherited by all configured RSVP interfaces. Threshold levels defined under the RSVP interface is used to trigger IGP updates if non-default threshold levels are configured.
The no form of this command resets the default value.
Default 
0 15 30 45 60 75 80 85 90 95 96 97 98 99 100
Parameters 
threshold-level
Integer value
Values
te-down-threshold
Syntax 
te-down-threshold threshold-level [threshold-level...(up to 16 max)]
no te-down-threshold
Context 
config>router>rsvp
config>router>rsvp>interface
Description 
This command configures the specific threshold levels per node and per interface. Threshold levels are for reserved bandwidth per interface. The te-threshold-update command is used to enable or disable threshold-based IGP TE updates. Any reserved bandwidth change per interface is compared with all the threshold levels and trigger an IGP TE update if a defined threshold level is crossed in either direction (LSP setup or teardown). Threshold-based updates is supported with both ISIS and OSPF. A minimum of one and a maximum of 16 threshold levels is supported.
Threshold levels configured per node is inherited by all configured RSVP interfaces. Threshold levels defined under the RSVP interface must be used to trigger IGP updates if non-default threshold levels are configured.
The no form of this command resets the default value.
Default 
100 99 98 97 96 95 90 85 80 75 60 45 30 15 0
Parameters 
threshold-level
Integer value
Values
 
Message Pacing Commands
msg-pacing
Syntax 
[no] msg-pacing
Context 
config>router>rsvp
Description 
This command enables RSVP message pacing in which the specified number of RSVP messages, specified in the max-burst command, are sent in a configured interval, specified in the period command. A count is kept of the messages that were dropped because the output queue for the interface used for message pacing was full.
Default 
no msg-pacing
max-burst
Syntax 
max-burst number
no max-burst
Context 
config>router>rsvp>msg-pacing
Description 
This command specifies the maximum number of RSVP messages that are sent in the specified period under normal operating conditions.
Default 
650
Parameters 
number
 
Values
period
Syntax 
period milli-seconds
no period
Context 
config>router>rsvp>msg-pacing
Description 
This command specifies the time interval, in milliseconds, when the router can send the specified number of RSVP messages which is specified in the max-burst command.
Default 
100
Parameters 
milli-seconds
 
Values