Generally, label switching routers (LSRs) use a label distribution protocol to dynamically learn the labels that they should use to label-switch packets. Examples of such protocols include:
Label Distribution Protocol (LDP), the Internet Engineering Task Force (IETF) standard that is used to bind labels to network addresses
Resource Reservation Protocol (RSVP), which is used to distribute labels for traffic engineering (TE)
Border Gateway Protocol (BGP), which is used to distribute labels for MPLS virtual private networks
(VPNs)
To use a learned label to label-switch packets, an LSR installs the label into its Label Forwarding Information Base (LFIB). The static MPLS feature enables you to statically configure the following:
The binding between a label and an IPv4 or IPv6 prefix
The action corresponding to the binding between a label and an IPv4 or IPv6 prefix (label swap or pop)
The contents of an LFIB cross-connect entry
For more information, see the Cisco Nexus 9000 Series NX-Label Switching Configuration Guide:
The CLI commands and options listed below are the equivalent to the payload example displayed in the pane on the right.
feature mpls static
Note: The property information for this example was added in Release 9.3(3).
Verifying a DME Configuration The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO
DN
fmEntity
sys/fm
fmMplsStatic
sys/fm/mplsstatic
fmMplsStatic Properties
The following table contains information about the fmMplsStatic properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
adminSt
fm:AdminState (scalar:Enum8)
Admin status
SELECTION:
1 - enabled
2 - disabled
DEFAULT: disabled
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
The CLI commands and options listed below are the equivalent to the payload example displayed in the pane on the right.
no feature mpls static
Note: The property information for this example was added in Release 9.3(3).
Verifying a DME Configuration The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO
DN
fmEntity
sys/fm
fmMplsStatic
sys/fm/mplsstatic
fmMplsStatic Properties
The following table contains information about the fmMplsStatic properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
adminSt
fm:AdminState (scalar:Enum8)
Admin status
SELECTION:
1 - enabled
2 - disabled
DEFAULT: disabled
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
Enables MPLS forwarding on Ethernet interface 1/5.
Creating an instance of this MO enables MPLS on the specified interface.
Deleting an instance of this MO disables MPLS on the specified interface.
CLI Commands
The CLI commands and options listed below are the equivalent to the payload example displayed in the pane on the right.
int eth1/5 no switchport mpls ip forwarding
Note: The property information for this example was added in Release 9.3(3).
Verifying a DME Configuration The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO
DN
topSystem
sys
mplsEntity
sys/mpls
mplsIf
sys/mpls/If-{[id]}
interfaceEntity
sys/intf
l1PhysIf
sys/intf/phys-{[id]}
mplsIf Properties
The following table contains information about the mplsIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
id
nw:IfId (base:IfIndex)
An identifier .
Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100
l1PhysIf Properties
The following table contains information about the l1PhysIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
id
nw:IfId (base:IfIndex)
An identifier .
Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100
layer
l1:Layer (scalar:Enum8)
Administrative port layer
SELECTION:
1 - Layer2
2 - Layer3
DEFAULT: Layer2
userCfgdFlags
l1:userCfgdFlags (scalar:Bitmask8)
Port User Config Flags
SELECTION:
0 - none
1 - admin_state
2 - admin_layer
4 - admin_router_mac
8 - admin_dce_mode
16 - admin_mtu
DEFAULT: none
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
Disables MPLS forwarding on Ethernet interface 1/5.
CLI Commands
The CLI commands and options listed below are the equivalent to the payload example displayed in the pane on the right.
int eth1/5 no switchport no mpls ip forwarding
Note: The property information for this example was added in Release 9.3(3).
Verifying a DME Configuration The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO
DN
topSystem
sys
mplsEntity
sys/mpls
mplsIf
sys/mpls/If-{[id]}
interfaceEntity
sys/intf
l1PhysIf
sys/intf/phys-{[id]}
mplsIf Properties
The following table contains information about the mplsIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
id
nw:IfId (base:IfIndex)
An identifier .
Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100
l1PhysIf Properties
The following table contains information about the l1PhysIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
id
nw:IfId (base:IfIndex)
An identifier .
Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100
layer
l1:Layer (scalar:Enum8)
Administrative port layer
SELECTION:
1 - Layer2
2 - Layer3
DEFAULT: Layer2
userCfgdFlags
l1:userCfgdFlags (scalar:Bitmask8)
Port User Config Flags
SELECTION:
0 - none
1 - admin_state
2 - admin_layer
4 - admin_router_mac
8 - admin_dce_mode
16 - admin_mtu
DEFAULT: none
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
The CLI command below is the equivalent to the payload example displayed in the pane on the right.
feature mpls segment-routing
Note: The property information for this example was added in Release 9.3(3).
Verifying a DME Configuration The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO
DN
fmEntity
sys/fm
fmMplsSgmntRtg
sys/fm/mplssgmntrtg
fmMplsSgmntRtg Properties
The following table contains information about the fmMplsSgmntRtg properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
adminSt
fm:AdminState (scalar:Enum8)
Admin status
SELECTION:
1 - enabled
2 - disabled
DEFAULT: disabled
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
The CLI command below is the equivalent to the payload example displayed in the pane on the right.
no feature mpls segment-routing
Note: The property information for this example was added in Release 9.3(3).
Verifying a DME Configuration The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO
DN
fmEntity
sys/fm
fmMplsSgmntRtg
sys/fm/mplssgmntrtg
fmMplsSgmntRtg Properties
The following table contains information about the fmMplsSgmntRtg properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
adminSt
fm:AdminState (scalar:Enum8)
Admin status
SELECTION:
1 - enabled
2 - disabled
DEFAULT: disabled
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
There are three partitions (ranges) in ULIB: the dynamic label range, the static label range, and the segment routing global block (SRGB) range. The dynamic and static label ranges must be non-overlapping, while the SRGB range must be a contiguous subset of the dynamic range.
This example configures labels for static assignment.
CLI Commands
The CLI commands and options listed below are used to create the payload example displayed in the pane on the right.
mpls label range 17 99 static 100 1000
Note: The property information for this example was added in Release 9.3(3).
Verifying a DME Configuration The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO
DN
ulibLabelTable
sys/labeltable
ulibLblRange
sys/labeltable/lblrange
ulibLblRange Properties
The following table contains information about the ulibLblRange properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
dynLblMax
ulib:DynLblMax (scalar:Uint32)
Maximum dynamic label, configured value
Must be between 16 and 471804, and must be greater than or equal to dynLblMin, and the range [staticLblMin, staticLblMax] must be disjoint from the range [dynLblMin, dynLblMax]
RANGE: [16 , 471804]
DEFAULT: 471804
dynLblMin
ulib:DynLblMin (scalar:Uint32)
Minimum dynamic label, configured value
Must be between 16 and 471804, must be less than or equal to dynLblMax, and the range [staticLblMin, staticLblMax] must be disjoint from the range [dynLblMin, dynLblMax]
RANGE: [16 , 471804]
DEFAULT: 16
staticLblMax
ulib:LabelVal (scalar:Uint32)
Maximum Static Label, configured value
Must be EITHER: (1) set to 0 as long as staticLblMin is also set to 0 OR (2) between 16 and 471804, be greater than or equal to staticLblMin, and the range [staticLblMin, staticLblMax] must be disjoint from the range [dynLblMin, dynLblMax]
RANGE: [0 , 471804]
staticLblMin
ulib:LabelVal (scalar:Uint32)
Minimum Static Label, configured value
Must be EITHER: (1) set to 0 as long as staticLblMax is also set to 0 OR (2) between 16 and 471804, be less than to staticLblMax, and the range [staticLblMin, staticLblMax] must be disjoint from the range [dynLblMin, dynLblMax]
RANGE: [0 , 471804]
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
Note: The property information for this example was added in Release 9.3(3).
Verifying a DME Configuration The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO
DN
topSystem
sys
mplsEntity
sys/mpls
mplsIf
sys/mpls/If-{[id]}
mplsstaticEntity
sys/mplsstatic
mplsstaticAf
sys/mplsstatic/af-{type}
mplsstaticPfxLclLbl
sys/mplsstatic/af-{type}/pfxlabel-{label}
mplsIf Properties
The following table contains information about the mplsIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
id
nw:IfId (base:IfIndex)
An identifier .
Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100
mplsstaticEntity Properties
The following table contains information about the mplsstaticEntity properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
adminSt
nw:AdminSt (scalar:Enum8)
The administrative state of the object or policy.
SELECTION:
1 - enabled
2 - disabled
DEFAULT: enabled
mplsstaticAf Properties
The following table contains information about the mplsstaticAf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
type
mplsstatic:AfT (scalar:Enum8)
Type of Address Family (IPv4, IPv6, etc.)
SELECTION:
1 - ipv4-ucast
2 - ipv6-ucast
DEFAULT: ipv4-ucast
mplsstaticPfxLclLbl Properties
The following table contains information about the mplsstaticPfxLclLbl properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
label
mplsstatic:InLabelVal (scalar:Uint32)
Local In Label Value
RANGE: [16 , 471804]
DEFAULT: 16
pfx
address:Ip
Local Label Prefix/Subnet
Must be a valid IP prefix, and may not be a reserved, loopback, or multicast address, or the zero address
Value must match ipv4 or ipv6 known format
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
Note: The property information for this example was added in Release 9.3(3).
Verifying a DME Configuration The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
MO
DN
topSystem
sys
mplsEntity
sys/mpls
mplsIf
sys/mpls/If-{[id]}
mplsstaticEntity
sys/mplsstatic
mplsstaticAf
sys/mplsstatic/af-{type}
mplsstaticPfxLclLbl
sys/mplsstatic/af-{type}/pfxlabel-{label}
mplsstaticNh
sys/mplsstatic/af-{type}/pfxlabel-{label}/nh
mplsIf Properties
The following table contains information about the mplsIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
id
nw:IfId (base:IfIndex)
An identifier .
Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100
mplsstaticEntity Properties
The following table contains information about the mplsstaticEntity properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
adminSt
nw:AdminSt (scalar:Enum8)
The administrative state of the object or policy.
SELECTION:
1 - enabled
2 - disabled
DEFAULT: enabled
mplsstaticAf Properties
The following table contains information about the mplsstaticAf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
type
mplsstatic:AfT (scalar:Enum8)
Type of Address Family (IPv4, IPv6, etc.)
SELECTION:
1 - ipv4-ucast
2 - ipv6-ucast
DEFAULT: ipv4-ucast
mplsstaticPfxLclLbl Properties
The following table contains information about the mplsstaticPfxLclLbl properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
label
mplsstatic:InLabelVal (scalar:Uint32)
Local In Label Value
RANGE: [16 , 471804]
DEFAULT: 16
pfx
address:Ip
Local Label Prefix/Subnet
Must be a valid IP prefix, and may not be a reserved, loopback, or multicast address, or the zero address
Value must match ipv4 or ipv6 known format
mplsstaticNh Properties
The following table contains information about the mplsstaticNh properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
nhAddr
address:Ip
Next Hop - IP Address
Must be a valid IP address and may not be a multicast address or the zero address
Value must match ipv4 or ipv6 known format
outLbl
mplsstatic:OutLabelVal (scalar:Uint32)
Outgoing Label Value
RANGE: [0 , 1048575]
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
Note: The property information for this example was added in Release 9.3(3).
Verifying a DME Configuration The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
The following table contains information about the mplsIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
id
nw:IfId (base:IfIndex)
An identifier .
Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100
mplsstaticEntity Properties
The following table contains information about the mplsstaticEntity properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
adminSt
nw:AdminSt (scalar:Enum8)
The administrative state of the object or policy.
SELECTION:
1 - enabled
2 - disabled
DEFAULT: enabled
mplsstaticAf Properties
The following table contains information about the mplsstaticAf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
type
mplsstatic:AfT (scalar:Enum8)
Type of Address Family (IPv4, IPv6, etc.)
SELECTION:
1 - ipv4-ucast
2 - ipv6-ucast
DEFAULT: ipv4-ucast
mplsstaticPfxLclLbl Properties
The following table contains information about the mplsstaticPfxLclLbl properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
label
mplsstatic:InLabelVal (scalar:Uint32)
Local In Label Value
RANGE: [16 , 471804]
DEFAULT: 16
pfx
address:Ip
Local Label Prefix/Subnet
Must be a valid IP prefix, and may not be a reserved, loopback, or multicast address, or the zero address
Value must match ipv4 or ipv6 known format
mplsstaticBackupNh Properties
The following table contains information about the mplsstaticBackupNh properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
if
nw:IfId (base:IfIndex)
Backup Next Hop Interface
Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100
nhAddr
address:Ip
Backup Next Hop IP Address
Value must match ipv4 or ipv6 known format
outLbl
mplsstatic:OutLabelVal (scalar:Uint32)
Outgoing Label Value
RANGE: [0 , 1048575]
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
Note: The property information for this example was added in Release 9.3(3).
Verifying a DME Configuration The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.
The following table contains information about the mplsIf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
id
nw:IfId (base:IfIndex)
An identifier .
Must match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100
mplsstaticEntity Properties
The following table contains information about the mplsstaticEntity properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
adminSt
nw:AdminSt (scalar:Enum8)
The administrative state of the object or policy.
SELECTION:
1 - enabled
2 - disabled
DEFAULT: enabled
mplsstaticAf Properties
The following table contains information about the mplsstaticAf properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
type
mplsstatic:AfT (scalar:Enum8)
Type of Address Family (IPv4, IPv6, etc.)
SELECTION:
1 - ipv4-ucast
2 - ipv6-ucast
DEFAULT: ipv4-ucast
mplsstaticPfxLclLbl Properties
The following table contains information about the mplsstaticPfxLclLbl properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
label
mplsstatic:InLabelVal (scalar:Uint32)
Local In Label Value
RANGE: [16 , 471804]
DEFAULT: 16
pfx
address:Ip
Local Label Prefix/Subnet
Must be a valid IP prefix, and may not be a reserved, loopback, or multicast address, or the zero address
Value must match ipv4 or ipv6 known format
mplsstaticAutoResolveNh Properties
The following table contains information about the mplsstaticAutoResolveNh properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name
Data Type
Description
Values
outLbl
mplsstatic:OutLabelVal (scalar:Uint32)
Outgoing Label Value
RANGE: [0 , 1048575]
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference: