Multilink Commands on Cisco IOS XR Software


This module contains commands for configuring multilink interfaces on Cisco IOS XR software.

bundle

To create a multilink interface bundle, use the bundle command in the interface configuration mode. To remove a multilink interface bundle, use the no form of this command.

bundle bundleID

Syntax Description

bundleID

ID number of the multilink interface bundle. Range is from 1 through 1023.


Defaults

No default behavior or values

Command Modes

Interface configuration

Command History

Release
Modification

Release 3.4.1

This command was introduced on the Cisco XR 12000 Series Router.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

The bundle command is used in mgmtmultilink controller mode to dynamically create a multilink interface. This command is similar to the channel-group command on the T1 controller, which dynamically creates a serial interface.

Task ID
Task ID
Operations

sonet-sdh

read, write


Examples

The following example shows how to create a multilink interface with a bundle ID of 1:

RP/0/0/CPU0:router# configure
RP/0/0/CPU0:router(config)# controller mgmtmultilink 0/1/0/0
RP/0/0/CPU0:router(config-mgmtmultilink)# bundle 1
RP/0/0/CPU0:router(config-mgmtmultilink)# commit

Related Commands

Command
Description

multilink

Enters the config-if-multilink submode.

multilink fragment-size

Sets the fragment size to be used on the multilink interface.

multilink group

Adds the serial interface to the multilink interface.

ppp multilink minimum-active links

Sets the minimum number of active links required before the multilink interface line can be brought to the up state.


controller MgmtMultilink

To configure a controller for a generic multilink bundle and enter MgmtMultilink configuration mode, use the controller MgmtMultilink command in global configuration mode. To return to the default state, use the no form of this command.

controller MgmtMultilink interface-path-id

no controller MgmtMultilink interface-path-id

Syntax Description

interface-path-id

Physical interface or virtual interface.

Note Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.


Defaults

No default behavior or values

Command Modes

Global configuration

Command History

Release
Modification

Release 3.6.0

This command was introduced on the Cisco CRS-1 router and Cisco XR 12000 Series Router.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

For the interface-path-id argument, use the following guidelines:

If specifying a physical interface, the naming notation is rack/slot/module/port. The slash between values is required as part of the notation. An explanation of each component of the naming notation is as follows:

rack: Chassis number of the rack.

slot: Physical slot number of the line card.

module: Module number. A physical layer interface module (PLIM) is always 0.

port: Physical port number of the interface.

If specifying a virtual interface, the number range varies, depending on interface type.

Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to enter the MgmtMultilink configuration mode :

RP/0/RP0/CPU0:router# config
RP/0/RP0/CPU0:router(config)# controller MgmtMultilink 0/1/0/0 
RP/0/RP0/CPU0:router(config-mgmtmultilink)# 

Related Commands

Command
Description

show controller mgmtmultilink

Displays information about a management multilink controller.


interface Multilink

To configure a multilink interface and enter multilink interface configuration mode, use the interface multilink command in global configuration mode. To delete the interface configuration, use the no form of this command. To return to the default state, use the no form of this command.

interface multilink interface-path-id/bundleId.subinterface type [point-to-point | l2transport ]

no interface multilink interface-path-id/bundleId.subinterface type [point-to-point | l2transport ]

Syntax Description

interface-path-id

Physical interface or virtual interface.

Note Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.

bundleId

Bundle ID number of the multilink interface bundle.

.subinterface

Subinterface instance. Naming notation is .subinterface. The period in front of the subinterface value is required as part of the notation. Replace subinterface with the virtual interface number to be associated with the physical interface.

For more information about the syntax for the router, use the question mark (?) online help function.

type

Interface type. For more information, use the question mark (?) online help function.

point-to-point

Interface functions as one endpoint of a point-to-point link.

l2transport

Interface functions as one endpoint on an Layer 2 link.


Defaults

No interfaces are configured.

Command Modes

Global configuration

Command History

Release
Modification

Release 3.6.0

This command was introduced on the Cisco CRS-1 router and the Cisco XR 12000 Series Router.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

For the interface-path-id argument, use the following guidelines:

If specifying a physical interface, the naming notation is rack/slot/module/port. The slash between values is required as part of the notation. An explanation of each component of the naming notation is as follows:

rack: Chassis number of the rack.

slot: Physical slot number of the line card.

module: Module number. A physical layer interface module (PLIM) is always 0.

port: Physical port number of the interface.

If specifying a virtual interface, the number range varies, depending on interface type.

Task ID
Task ID
Operations

interface

read, write


Examples

The following example shows how to enter interface configuration mode for multilink bundle interface:

RP/0/RP0/CPU0:router(config)# interface Multilink 0/1/0/0/100 

RP/0/RP0/CPU0:router(config-if)#

The following example shows how to enter subinterface configuration mode for multilink bundle subinterface:

RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# interface Multilink 0/1/0/0/100.16 point-to-point 
RP/0/RP0/CPU0:router(config-subif)#

Related Commands

Command
Description

show interfaces

Displays statistics for all interfaces configured on the router or for a specific node.


multilink

To enter the config-if-multilink submode, use the multilink command in the interface configuration mode.

multilink

Syntax Description

This command has no arguments or keywords.

Defaults

No default behavior or values

Command Modes

Interface configuration

Command History

Release
Modification

Release 3.4.1

This command was introduced on the Cisco XR 12000 Series Router.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

For multilink interfaces, the multilink command provides access to the config-if-multilink submode to use the multilink fragment-size command. For serial interfaces, this command provides access to the config-if-multilink submode to use the group command.


Note This command behaves similarly to the timeslots command. It is not be possible to enter this command or remove the multilink interface after the channel-group configuration is committed.


Task ID
Task ID
Operations

hdlc

read, write


Examples

The following example shows how to enter the config-if-multilink submode:

RP/0/0/CPU0:router# configure
RP/0/0/CPU0:router(config)# interface serial 0/1/0/0/1:0
RP/0/0/CPU0:router(config-if)# multilink
RP/0/0/CPU0:router(config-if-multilink)# group 1
RP/0/0/CPU0:router(config-if-multilink)# commit

Related Commands

Command
Description

multilink fragment-size

Sets the fragment size to be used on the multilink interface.

multilink group

Adds the serial interface to the multilink interface.

ppp multilink minimum-active links

Sets the minimum number of active links required before the multilink interface line can be brought to the up state.


multilink fragment-size

To set the Layer 2 fragmentation size for a multilink interface as opposed to the Layer 3 fragment size, which is controlled by the mtu command, use the multilink fragment-size command in interface configuration mode. To set the fragment size back to the default, no fragment size, use the no form of this command.

multilink fragment-size value

no multilink fragment-size value

Syntax Description

value

Value of the fragment size. The allowed values are determined by the hardware. In the current release, the allowed values are 128, 256 and 512. The value 64 also appears in the CLI help for this parameter. However, 64 is not allowed in this release and will cause configuration problems in the system if used.


Defaults

The default is no multilink fragment-size, which means no fragmentation at Layer 2.

Command Modes

Interface configuration

Command History

Release
Modification

Release 3.4.1

This command was introduced on the Cisco XR 12000 Series Router.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Task ID
Task ID
Operations

hdlc

read, write


Examples

The following example shows how to set the fragment size to 128:

RP/0/0/CPU0:router# configure
RP/0/0/CPU0:router(config)# interface multilink 0/1/0/0/1
RP/0/0/CPU0:router(config-if)# multilink fragmentation-size 128
RP/0/0/CPU0:router(config-if)# commit

Related Commands

Command
Description

multilink group

Adds the serial interface to the multilink interface.

multilink

Enters the config-if-multilink submode.

ppp multilink minimum-active links

Sets the minimum number of active links required before the multilink interface line can be brought to the up state.


multilink group

To attach a serial interface to a multilink interface bundle, use the multilink group command in interface configuration mode. To remove a serial interface from a multilink interface bundle, use the no form of this command.

multilink group bundleID

no multilink group bundleID

Syntax Description

bundleID

Bundle ID number of the multilink interface, in the format rack/slot/bay/controllerID/bundleID)


Defaults

No default behavior or values

Command Modes

Interface configuration

Command History

Release
Modification

Release 3.4.1

This command was introduced on the Cisco XR 12000 Series Router.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Task ID
Task ID
Operations

hdlc

read, write


Examples

The following examples show how to attach a serial interface to a multilink interface bundle:

RP/0/0/CPU0:router# configure
RP/0/0/CPU0:router(config)# interface serial 0/1/0/0/1:0
RP/0/0/CPU0:router(config-if)# multilink group 1
RP/0/0/CPU0:router(config-if)# commit
 
   

or

RP/0/0/CPU0:router# configure
RP/0/0/CPU0:router(config)# interface serial 0/1/0/0/1:0
RP/0/0/CPU0:router(config-if)# multilink
RP/0/0/CPU0:router(config-if-multilink)# group 1
RP/0/0/CPU0:router(config-if-multilink)# commit

Related Commands

Command
Description

multilink fragment-size

Sets the fragment size to be used on the multilink interface.

multilink

Enters the config-if-multilink submode.

ppp multilink minimum-active links

Sets the minimum number of active links required before the multilink interface line can be brought to the up state.


multilink interleave

To enable interleave on a multilink interface, use the multilink interleave command in interface configuration mode.

multilink interleave

Syntax Description

This command has no arguments or keywords.

Defaults

The default is no interleave.

Command Modes

Interface configuration

Command History

Release
Modification

Release 3.5.0

This command was introduced on the Cisco XR 12000 Series Router.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

Link Fragmentation and Interleaving (LFI) is designed for MLPPP interfaces and is required when integrating voice and data on low-speed interfaces that run at less than 768 Kbps.

Link Fragmentation and Interleaving (LFI) provides stability for delay-sensitive traffic, such as voice or video, traveling on the same circuit as data. Voice is susceptible to increased latency and jitter when the network processes large packets on low-speed interfaces that run at less than 768 Kbps. LFI reduces delay and jitter by fragmenting large datagrams and interleaving them with low-delay traffic packets.

Task ID
Task ID
Operations

hdlc

read, write


Examples

The following examples show how to enable interleave on a multilink interface.

RP/0/0/CPU0:router# configuration 
RP/0/0/CPU0:router#(config)# interface multilink 0/1/0/0/1
RP/0/0/CPU0:router#(config-if)# multilink interleave
RP/0/0/CPU0:router#(config-if)# commit
 
   

or

RP/0/0/CPU0:router# configuration 
RP/0/0/CPU0:router#(config)# interface multilink 0/1/0/0/1
RP/0/0/CPU0:router#(config-if)# multilink
RP/0/0/CPU0:router#(config-if-multilink)# interleave
RP/0/0/CPU0:router#(config-if-multilink)# commit

Related Commands

Command
Description

multilink

Enters the multilink configuration submode.

multilink fragment-size

Sets the fragment size to be used on the multilink interface.


ppp multilink minimum-active links

To set the minimum number of active links required before the multilink interface line can be brought to the up state, use the ppp multilink minimum-active links command in global configuration mode.

ppp multilink minimum-active links value

Syntax Description

value

Number of active links. The range is 1 through 12.


Defaults

The default value is 1 active link.

Command Modes

Global configuration

Command History

Release
Modification

Release 3.4.1

This command was introduced on the Cisco XR 12000 Series Router.

Release 3.5.0

No modification.

Release 3.6.0

No modification.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

When multiple links are active and one link goes down, the whole bundle goes down.

Task ID
Task ID
Operations

ppp

read, write


Examples

The following example shows how to set the minimum number of active links to 6:

RP/0/0/CPU0:router# configure
RP/0/0/CPU0:router(config)# interface Multilink 0/1/0/0/1 
RP/0/0/CPU0:router(config-if)# ppp multilink minimum-active links 6

Related Commands

Command
Description

multilink fragment-size

Sets the fragment size to be used on the multilink interface.

multilink group

Adds the serial interface to the multilink interface.

multilink

Enters the config-if-multilink submode.


show controller mgmtmultilink

To display information about the state and the number of bundles of a multilink controller, use the show controller mgmtmultilink command in EXEC mode.

show controllers mgmtmultilink interface-path-id

Syntax Description

interface-path-id

Physical interface or virtual interface.

Note Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.6.0

This command was introduced on the Cisco CRS-1 router and the Cisco XR 12000 Series Routers.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

For the interface-path-id argument, use the following guidelines:

If specifying a physical interface, the naming notation is rack/slot/module/port. The slash between values is required as part of the notation. An explanation of each component of the naming notation is as follows:

rack: Chassis number of the rack.

slot: Physical slot number of the line card.

module: Module number. A physical layer interface module (PLIM) is always 0.

port: Physical port number of the interface.

If specifying a virtual interface, the number range varies, depending on interface type.

Task ID
Task ID
Operations

interface

read


Examples

The following example shows how to display information for a management multilink controller:

RP/0/RP0/CPU0:Router# show controllers mgmtmultilink 0/1/0/0
 
   
Controller MgmtMultilink 0/1/0/0
  State is up
  Number of bundles: 0

Related Commands

Command
Description

show interfaces multilink

Displays information about a multilink interface.


show interfaces multilink

To display information about a multilink interface, use the show interfaces multilink command in EXEC mode.

show interfaces multilink interface-path-id

Syntax Description

interface-path-id

Physical interface or virtual interface.

Note Use the show interfaces command to see a list of all interfaces currently configured on the router.

For more information about the syntax for the router, use the question mark (?) online help function.


Defaults

No default behavior or values

Command Modes

EXEC

Command History

Release
Modification

Release 3.6.0

This command was introduced on the Cisco CRS-1 router and the Cisco XR 12000 Series Routers.

Release 3.7.0

No modification.

Release 3.8.0

No modification.


Usage Guidelines

To use this command, your Cisco IOS XR software system administrator must assign you to a user group associated with a task group that includes the corresponding command task IDs. If you need assistance with your task group assignment, contact your system administrator. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of Cisco IOS XR System Security Configuration Guide.

For the interface-path-id argument, use the following guidelines:

If specifying a physical interface, the naming notation is rack/slot/module/port. The slash between values is required as part of the notation. An explanation of each component of the naming notation is as follows:

rack: Chassis number of the rack.

slot: Physical slot number of the line card.

module: Module number. A physical layer interface module (PLIM) is always 0.

port: Physical port number of the interface.

If specifying a virtual interface, the number range varies, depending on interface type.

Task ID
Task ID
Operations

interface

read


Examples

The following example shows how to display information about a multilink interface:

RP/0/RP0/CPU0:router# show interfaces multilink interface 0/1/0/0