Cisco IOS Software Releases 12.0 S

Table Of Contents

Multilink Frame Relay (FRF.16)

Contents

Information about the Multilink Frame Relay (FRF.16) Feature

Multilink Frame Relay Bundles and Bundle Links

Link Integrity Protocol Control Messages

Benefits

Restrictions

Related Documents

Supported Platforms

Supported Standards, MIBs, and RFCs

Prerequisites

Configuration Tasks

Configuring a Multilink Frame Relay Bundle

Configuring a Multilink Frame Relay Bundle Link

Verifying Multilink Frame Relay

Monitoring and Maintaining Multilink Frame Relay

Configuration Examples

Multilink Frame Relay Configuration Example

Command Reference

encapsulation frame-relay mfr

frame-relay multilink ack

frame-relay multilink bid

frame-relay multilink hello

frame-relay multilink lid

frame-relay multilink retry

interface mfr

show frame-relay multilink

Debug Commands

debug frame-relay multilink

Glossary

Multilink Frame Relay (FRF.16)

---

The Multilink Frame Relay feature introduces functionality based on the Frame Relay Forum Multilink Frame Relay UNI/NNI Implementation Agreement (FRF.16). This feature provides a cost-effective way to increase bandwidth for particular applications by enabling multiple serial links to be aggregated into a single bundle of bandwidth. Multilink Frame Relay is supported on User-to-Network Interfaces (UNI) and Network-to-Network Interfaces (NNI) in Frame Relay networks.

History for the MultiLink Frame Relay (FRF.16) Feature

Release	Modification
12.0(17)S	This feature was introduced and implemented on the Cisco 12000 series router.

Finding Support Information for Platforms and Cisco IOS Software Images

Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at the login dialog box and follow the instructions that appear.

Contents

•Information about the Multilink Frame Relay (FRF.16) Feature

•Supported Platforms

•Supported Standards, MIBs, and RFCs

•Prerequisites

•Configuration Tasks

•Monitoring and Maintaining Multilink Frame Relay

•Configuration Examples

•Command Reference

•Debug Commands

•Glossary

Information about the Multilink Frame Relay (FRF.16) Feature

The following sections provide additional information about the multilink (FRF.16) feature:

•Multilink Frame Relay Bundles and Bundle Links

•Link Integrity Protocol Control Messages

•Benefits

•Restrictions

•Related Documents

Multilink Frame Relay Bundles and Bundle Links

The Multilink Frame Relay feature enables you to create a virtual interface called a bundle or bundle interface. The bundle interface serves as the Frame Relay data link and performs the same functions as a physical interface.

The bundle is made up of physical serial links, called bundle links. The bundle links within a bundle function as one physical link. Bundle links are invisible to the Frame Relay data-link layer, so Frame Relay functionality cannot be configured on these interfaces. Functionality that you want to apply to these links must be configured on the bundle interface. Bundle links are visible to peer devices. The local router and peer devices exchange link integrity protocol control messages to determine which bundle links are operational and to synchronize which bundle links should be associated with which bundles.

Link Integrity Protocol Control Messages

Both ends of a bundle link send out hello messages at regular intervals. When a peer device receives a hello message, it responds by sending an acknowledgment message. This exchange of hello messages and acknowledgments serve as a keepalive mechanism for the link. If a router is sending hello messages but not receiving acknowledgments, it will resend the hello message up to a configured maximum number of times. If the router exhausts the maximum number of retries, the bundle link line protocol is considered down (unoperational).

The bundle link line protocol is considered up (operational) when the peer device acknowledges that it will use the same link for the bundle. The line protocol remains up when the peer device acknowledges the hello messages from the local router.

The bundle line protocol is considered up when the Frame Relay data-link layer at the local router and peer device synchronize using the Local Management Interface (LMI). The bundle line protocol remains up as long as the LMI keepalives are successful. FRF2.1 Annex 1 is supported as an alternative to LMI on NNI-type bundle interfaces. The bundle interface is considered up when the line protocol of at least one of its associated bundle links is up.

Benefits

Flexible Pool of Bandwidth

By combining multiple physical interfaces into a bundle, you can design a Frame Relay interface with more bandwidth than is available from any single physical interface. For example, many new network applications require more bandwidth than is available on a T1 line. One option is to invest in a T3 line; however, T3 lines can be expensive and are not available in some locations. Multilink Frame Relay provides a cost-effective solution to this problem by allowing multiple T1 lines to be aggregated into a single bundle of bandwidth.

Greater Service Resilience When Links Fail

Greater service resilience is provided when multiple physical interfaces are provisioned as a single bundle. When a link fails, the bundle continues to support the Frame Relay service by transmitting across the remaining bundle links.

Restrictions

The Multilink Frame Relay feature has the following restrictions:

•Frame Relay extended addressing is not supported. Frame Relay extended addressing uses a 23-bit DLCI field that enables support for thousands of DLCIs in NNI networks.

•Frame Relay fragmentation is not supported.

•This feature is supported on 6-port channelized T3 line card interfaces and 2-port channelized OC-3 linecard interfaces.

•FRF2.1 Annex 1 is supported on NNI-type bundle interfaces.

•A maximum of 32 bundle links per bundle is supported.

•A maximum of 200 DLCIs per bundle is supported.

Related Documents

•Cisco IOS Wide-Area Networking Configuration Guide, Release 12.0

•Cisco IOS Wide-Area Networking Command Reference, Release 12.0

Supported Platforms

•Cisco 10000 series

•Cisco 12000 series

Supported Standards, MIBs, and RFCs

Standards

•Event Driven Procedures (FRF 2.1Annex 1), July 1995

•Multilink Frame Relay UNI/NNI Implementation Agreement (FRF.16), August 1999

MIBs

No new or modified MIBs are supported by this feature.

To obtain lists of supported MIBs by platform and Cisco IOS release, and to download MIB modules, go to the Cisco MIB website on Cisco.com at http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml.

RFCs

No new or modified RFCs are supported by this feature.

Prerequisites

Multilink Frame Relay must be configured on the peer device.

Configuration Tasks

See the following sections for configuration tasks for the Multilink Frame Relay feature. Each task in the list is identified as either optional or required.

•Configuring a Multilink Frame Relay Bundle (required)

•Configuring a Multilink Frame Relay Bundle Link (required)

•Verifying Multilink Frame Relay (optional)

Configuring a Multilink Frame Relay Bundle

To configure the bundle interface for multilink Frame Relay, use the following commands beginning in global configuration mode:

	Command	Purpose
Step 1	Router(config)# interface mfr interface-number	Configures a multilink Frame Relay bundle interface.
Step 2	Router(config-if)# frame-relay intf-type dce	Configures a device to function as a DCE. Only one end of a link should be configured as a DCE. The other end will function as a DTE, which is the default setting. Note This command can be used only if Frame Relay switching has been enabled by entering the frame-relay switching command in global configuration mode.
Step 3	Router(config-if)# frame-relay multilink bid name	(Optional) Assigns a bundle identification name to a multilink Frame Relay bundle. Note The bundle identification (BID) will not go into effect until the interface has gone from the down state to the up state. One way to bring the interface down and back up again is by using the shut and no shut commands in interface configuration mode.
Step 4	Router(config-if)# frame-relay multilink output-threshold bytes	(Optional) Configures the number of bytes that a bundle link will transmit before the load-balancing mechanism causes transmission to roll over to the next available link. Note When configured on the bundle interface, this command applies to all bundle links in the bundle.
Step 5	Router(config-if)# interface mfr interface-number.subinterface-number point-to-point	Configures a point-to-point multilink Frame Relay subinterface.
Step 6	Router(config-subif)# ip address ip-address mask	Configures the IP address for the subinterface.
Step 7	Router(config-subif)# frame-relay interface-dlci dlci	Assigns a DLCI to a Frame Relay subinterface.

Configuring a Multilink Frame Relay Bundle Link

To configure a bundle link interface for multilink Frame Relay, use the following commands beginning in global configuration mode:

	Command	Purpose
Step 1	Router(config)# interface serial number	Configures an interface and enters interface configuration mode.
Step 2	Router(config-if)# encapsulation frame-relay mfr number [name]	Creates a multilink Frame Relay bundle link and associates the link with a bundle. Tips To minimize latency that results from the arrival order of packets, we recommend bundling physical links of the same line speed in one bundle.
Step 3	Router(config-if)# frame-relay multilink lid name	(Optional) Assigns a bundle link identification name with a multilink Frame Relay bundle link. Note The bundle link identification (LID) will not go into effect until the interface has gone from the down state to the up state. One way to bring the interface down and back up again is by using the shut and no shut commands in interface configuration mode.
Step 4	Router(config-if)# frame-relay multilink hello seconds	(Optional) Configures the interval at which a bundle link will send out hello messages. The default value is 10 seconds.
Step 5	Router(config-if)# frame-relay multilink ack seconds	(Optional) Configures the number of seconds that a bundle link will wait for a hello message acknowledgment before resending the hello message. The default value is 4 seconds.
Step 6	Router(config-if)# frame-relay multilink retry number	(Optional) Configures the maximum number of times a bundle link will resend a hello message while waiting for an acknowledgment. The default value is 2 tries.

Verifying Multilink Frame Relay

To verify multilink Frame Relay configuration, use the show frame-relay multilink command.

The following example shows output for the show frame-relay multilink command.

Router# show frame-relay multilink

Bundle:MFR1, State = up, class = A, fragmentation disabled

 BID = MFR1

 Bundle links :

 Serial5/2/9:0, HW state = up, Protocol state = Up, LID = Serial5/2/9:0

 Serial5/2/8:0, HW state = up, Protocol state = Up, LID = Serial5/2/8:0

 Serial5/2/7:0, HW state = up, Protocol state = Up, LID = Serial5/2/7:0

 Serial5/2/6:0, HW state = up, Protocol state = Up, LID = Serial5/2/6:0

 Serial5/2/5:0, HW state = up, Protocol state = Up, LID = Serial5/2/5:0

 Serial5/2/4:0, HW state = up, Protocol state = Up, LID = Serial5/2/4:0

 Serial5/2/3:0, HW state = up, Protocol state = Up, LID = Serial5/2/3:0

 Serial5/2/2:0, HW state = up, Protocol state = Up, LID = Serial5/2/2:0

 Serial5/2/1:0, HW state = up, Protocol state = Up, LID = Serial5/2/1:0

 Serial5/0/2:0, HW state = up, Protocol state = Up, LID = Serial5/0/2:0

The following example shows output for the show frame-relay multilink command with the serial number option. It displays information about the specified bundle link.

Router# show frame-relay multilink Serial5/2/1:0

 Bundle links :

 Serial5/2/1:0, HW state = up, Protocol state = Up, LID = Serial5/2/1:0

 Bundle interface = MFR1,  BID = MFR1

The following example shows output for the show frame-relay multilink command with the serial number and detail options. It displays detailed information about the specified bundle link.

Router# show frame-relay multilink Serial5/2/9:0 detailed

Bundle links :

Serial5/2/9:0, HW state = up, Protocol state = Up, LID = Serial5/2/9:0

                Cause code = none, Ack timer = 4, Hello timer = 10,

                Max retry count = 2, Current count = 0,

                Peer  lid = Serial5/2/9:0

                Statistics -

                Add_link sent = 2, Add_link rcv'd = 2,

                Add_link ack sent = 2, Add_link ack rcv'd = 1,

                Add_link rej sent = 0, Add_link rej rcv'd = 0,

                Remove_link sent = 0, Remove_link rcv'd = 0,

                Remove_link_ack sent = 0, Remove_link_ack rcv'd = 0,

                Hello sent = 9, Hello rcv'd = 8,

                Hello_ack sent = 8, Hello_ack rcv'd = 9,

                outgoing pak dropped = 0,incoming pak dropped = 0,

Monitoring and Maintaining Multilink Frame Relay

To monitor and maintain multilink Frame Relay, use one or more of the following commands in EXEC mode:

Command	Purpose
Router# debug frame-relay multilink [control [mfr number | serial number]]	Displays debug messages for multilink Frame Relay bundles and bundle links.
Router# show frame-relay multilink [mfr number | serial number] [detailed]	Displays configuration information and statistics about multilink Frame Relay bundles and bundle links.
Router# show interfaces [type number]	Displays statistics for interfaces configured on the router or access server.

Configuration Examples

This section provides the following configuration example:

•Multilink Frame Relay Configuration Example

Multilink Frame Relay Configuration Example

The following example shows the configuration of bundle "MFR1". Serial interfaces 5/0/2:0 and 6/0/0:0 are configured as bundle links.

interface MFR1

 no ip address

 mls qos trust dscp

 frame-relay intf-type dce

 frame-relay multilink bid router1

!

interface MFR1.1 point-to-point

 ip address 10.0.1.1 255.255.255.0

 ip pim sparse-mode

 mls qos trust dscp

 frame-relay interface-dlci 100

interface Serial5/0

 encapsulation frame-relay MFR1

 frame-relay multilink lid first-link

 frame-relay multilink hello 9

 frame-relay multilink retry 3

interface Serial6/0

 encapsulation frame-relay MFR1

 frame-relay multilink ack 4

Command Reference

This section documents new or modified commands. All other commands used with this feature are documented in the Cisco IOS Release 12.2SB command reference publications.

•encapsulation frame-relay mfr

•frame-relay multilink ack

•frame-relay multilink bid

•frame-relay multilink hello

•frame-relay multilink lid

•frame-relay multilink retry

•interface mfr

•show frame-relay multilink

encapsulation frame-relay mfr

To create a multilink Frame Relay bundle link and associate the link with a bundle, use the encapsulation frame-relay mfr command in interface configuration mode. To remove the bundle link from the bundle, use the no form of this command.

encapsulation frame-relay mfr number [name]

no encapsulation frame-relay mfr

Syntax Description

number	The interface number of the multilink Frame Relay bundle with which this bundle link will be associated.
name	(Optional) Bundle link identification (LID) name. The name can be up to 49 characters long.

Defaults

The default LID is the name of the physical interface.

Command Modes

Interface configuration

Command History

Release	Modification
12.0(17)S	This command was introduced on the Cisco 12000 series routers.

Usage Guidelines

Use the name argument to assign a LID name to the bundle link. This name will be used to identify the bundle link to peer devices and to enable the devices to determine which bundle links are associated with which bundles. The LID name can also be assigned or changed by using the frame-relay multilink lid command on the bundle link interface. If the LID name is not assigned, the default name is the name of the physical interface.

---

Tips To minimize latency that results from the arrival order of packets, we recommend bundling physical links of the same line speed in one bundle.

---

Examples

The following example shows serial interface 0 being associated as a bundle link to bundle interface "mfr0". The bundle link identification name is "BL1".

interface mfr0

!

interface serial 0

 encapsulation frame-relay mfr0 BL1

Related Commands

Command	Description
debug frame-relay multilink	Displays debug messages for multilink Frame Relay bundles and bundle links.
frame-relay multilink lid	Assigns a LID name to a multilink Frame Relay bundle link.
show frame-relay multilink	Displays configuration information and statistics about multilink Frame Relay bundles and bundle links.

frame-relay multilink ack

To configure the number of seconds that a bundle link will wait for a hello message acknowledgment before resending the hello message, use the frame-relay multilink ack command in interface configuration mode. To reset this parameter to the default setting, use the no form of this command.

frame-relay multilink ack seconds

no frame-relay multilink ack

Syntax Description

seconds

Number of seconds that a bundle link will wait for a hello message acknowledgment before resending the hello message. The range is from 1 to 10 seconds.

Defaults

4 seconds

Command Modes

Interface configuration

Command History

Release	Modification
12.2(31)SB2	This command was introduced on the Cisco 10000 series routers.
12.0(17)S	This command was introduced.

Usage Guidelines

The frame-relay multilink ack command can be configured only on bundle link interfaces that have been associated with a bundle using the encapsulation frame-relay mfr command.

Both ends of a bundle link send out hello messages at regular intervals. When a peer device receives a hello message, it responds by sending an acknowledgment. This exchange of hello messages and acknowledgments serve as a keepalive mechanism for the link. If the bundle link sends a hello message but does not receive an acknowledgment, it will resend the hello message up to a configured maximum number of times. If the bundle link exhausts the maximum number of retries, the bundle link line protocol is considered down (unoperational).

The frame-relay multilink ack command setting on the local router is independent of the setting on the peer device.

Examples

The following example shows how to configure the bundle link to wait 6 seconds before resending hello messages:

interface serial0

 encapsulation frame-relay mfr0

 frame-relay multilink ack 6

Related Commands

Command	Description
encapsulation frame-relay mfr	Creates a multilink Frame Relay bundle link and associates the link with a bundle.
frame-relay multilink hello	Configures the interval at which a bundle link will send out hello messages.
frame-relay multilink retry	Configures the maximum number of times a bundle link will resend a hello message while waiting for an acknowledgment.

frame-relay multilink bid

To assign a bundle identification (BID) name to a multilink Frame Relay bundle, use the frame-relay multilink bid command in interface configuration mode. To reset the name to the default, use the no form of this command.

frame-relay multilink bid name

no frame-relay multilink bid

Syntax Description

name	Bundle identification name. The name can be up to 49 characters long.

Defaults

The default BID is "mfr" plus the number assigned to the bundle using the interface mfr command; for example, "mfr0".

Command Modes

Interface configuration

Command History

Release	Modification
12.0(17)S	This command was introduced.

Usage Guidelines

This command can be entered only at the multilink Frame Relay bundle interface.

---

Note You can enter the frame-relay multilink bid command at any time without affecting the current state of the interface; however, the BID will not go into effect until the interface has gone from the down state to the up state. One way to bring the interface down and back up again is by using the shut and no shut commands in interface configuration mode.

---

Only one BID is allowed per bundle. A later entry of the frame-relay multilink bid command supersedes prior entries.

The local and peer BIDs do not have to be unique.

Examples

The following example shows how to assign a BID of "bundle1" to the multilink Frame Relay bundle. The previous BID for the bundle was "mfr0".

interface mfr0

 frame-relay multilink bid bundle1

Related Commands

Command	Description
frame-relay multilink lid	Assigns a LID name to a multilink Frame Relay bundle link.
interface mfr	Configures a multilink Frame Relay bundle interface.
show frame-relay multilink	Displays configuration information and statistics about multilink Frame Relay bundles and bundle links.

frame-relay multilink hello

To configure the interval at which a bundle link will send out hello messages, use the frame-relay multilink hello command in interface configuration mode. To reset this parameter to the default setting, use the no form of this command.

frame-relay multilink hello seconds

no frame-relay multilink hello

Syntax Description

seconds

Interval, in seconds, at which a bundle link will send out hello messages. The range is 1 through 180 seconds.

Defaults

10 seconds

Command Modes

Interface configuration

Command History

Release	Modification
12.0(17)S	This command was introduced.

Usage Guidelines

The frame-relay multilink hello command can be configured only on bundle link interfaces that have been associated with a bundle using the encapsulation frame-relay mfr command.

Both ends of a bundle link send out hello messages at regular intervals. When a peer device receives a hello message, it responds by sending an acknowledgment. This exchange of hello messages and acknowledgments serve as a keepalive mechanism for the link. If the bundle link sends a hello message but does not receive an acknowledgment, it will resend the hello message up to a configured maximum number of times. If the bundle link exhausts the maximum number of retries, the bundle link line protocol is considered down (unoperational).

The setting of the hello message interval on the local router is independent of the setting on the peer device.

Examples

The following example shows how to configure a bundle link to send hello messages every 15 seconds:

interface serial0

 encapsulation frame-relay mfr0

 frame-relay multilink hello 15

Related Commands

Command	Description
encapsulation frame-relay mfr	Creates a multilink Frame Relay bundle link and associates the link with a bundle.
frame-relay multilink ack	Configures the number of seconds that a bundle link will wait for a hello message acknowledgment before resending the hello message.
frame-relay multilink retry	Configures the maximum number of times a bundle link will resend a hello message while waiting for an acknowledgment.

frame-relay multilink lid

To assign a bundle link identification (LID) name to a multilink Frame Relay bundle link, use the frame-relay multilink lid command in interface configuration mode. To reset the name to the default, use the no form of this command.

frame-relay multilink lid name

no frame-relay multilink lid

Syntax Description

name	Bundle link identification name. The name can be up to 49 characters long.

Defaults

The default LID is the name of the physical interface.

Command Modes

Interface configuration

Command History

Release	Modification
12.0(17)S	This command was introduced.

Usage Guidelines

The frame-relay multilink lid command can be configured only on bundle link interfaces that have been associated with a bundle using the encapsulation frame-relay command with the mfr keyword.

---

Note You can enter the frame-relay multilink lid command at any time without affecting the current state of the interface; however, the LID will not go into effect until the interface has gone from the down state to the up state. One way to bring the interface down and back up again is by using the shut and no shut commands in interface configuration mode.

---

The LID will be used to identify the bundle link to peer devices and to enable the devices to identify which bundle links are associated with which bundles. The LID can also be assigned when the bundle link is created by using the encapsulation frame-relay command with the name argument. If the LID is not assigned, the default LID is the name of the physical interface.

The local and peer LIDs do not need to be unique.

Examples

The following example shows the LID "BL1" assigned to serial interface 0:

interface serial 0

 encapsulation frame-relay mfr0

 frame-relay multilink lid BL1

Related Commands

Command	Description
encapsulation frame-relay mfr	Creates a multilink Frame Relay bundle link and associates the link with a bundle.
frame-relay multilink bid	Assigns a BID name to a multilink Frame Relay bundle.
show frame-relay multilink	Displays configuration information and statistics about multilink Frame Relay bundles and bundle links.

frame-relay multilink retry

To configure the maximum number of times a bundle link will resend a hello message while waiting for an acknowledgment, use the frame-relay multilink retry command in interface configuration mode. To reset this parameter to the default setting, use the no form of this command.

frame-relay multilink retry number

no frame-relay multilink retry

Syntax Description

number

Maximum number of times a bundle link will resend a hello message while waiting for an acknowledgment. The range is 1 through 5.

Defaults

2 tries

Command Modes

interface configuration

Command History

Release	Modification
12.0(17)S	This command was introduced.

Usage Guidelines

The frame-relay multilink retry command can be configured only on bundle link interfaces that have been associated with a bundle using the encapsulation frame-relay command with the mfr keyword.

If the bundle link sends the maximum number of hello messages without receiving an acknowledgment, the bundle link line protocol is considered down (unoperational).

The maximum number of retries configured on the local router is independent of the maximum number configured on the peer device.

Examples

The following example shows how to configure a bundle link to send a hello message a maximum of 3 times while waiting for an acknowledgment:

interface serial0

 encapsulation frame-relay mfr0

 frame-relay multilink retry 3

Related Commands

Command	Description
encapsulation frame-relay mfr	Creates a multilink Frame Relay bundle link and associates the link with a bundle.
frame-relay multilink ack	Configures the number of seconds that a bundle link will wait for a hello message acknowledgment before resending the hello message.
frame-relay multilink hello	Configures the interval at which a bundle link will send out hello messages.

interface mfr

To configure a multilink Frame Relay bundle interface, use the interface mfr command in global configuration mode. To remove the bundle interface, use the no form of this command.

interface mfr number

no interface mfr number

Syntax Description

number

Number that will uniquely identify this bundle interface. The range is from 0 to 2,147,483,647.

Defaults

A bundle interface is not configured.

Frame Relay encapsulation is the default encapsulation type for multilink Frame Relay bundle interfaces.

Command Modes

Global configuration

Command History

Release	Modification
12.0(17)S	This command was introduced.

Usage Guidelines

A bundle interface is a virtual interface that serves as the Frame Relay data link and performs the same functions as a physical interface. The bundle is made up of physical serial links, called bundle links. The bundle links within a bundle function as one physical link and one pool of bandwidth. Functionality that you want to apply to the bundle links must be configured on the bundle interface.

A bundle will support up to 200 data-link connection identifiers (DLCIs).

The no interface mfr command will work only if all bundle links have been removed from the bundle by using the no encapsulation frame-relay mfr command.

Examples

The following example shows the configuration of a bundle interface called "mfr0". The bundle identification (BID) name "BUNDLE-A" is assigned to the bundle. Serial interfaces 0 and 1 are assigned to the bundle as bundle links.

interface mfr0

 frame-relay multilink bid BUNDLE-A

!

interface serial0

 encapsulation frame-relay mfr0

!

interface serial1

 encapsulation frame-relay mfr0

Related Commands

Command	Description
debug frame-relay multilink	Displays debug messages for multilink Frame Relay bundles and bundle links.
encapsulation frame-relay mfr	Creates a multilink Frame Relay bundle link and associates the link with a bundle.
frame-relay multilink bid	Assigns a BID name to a multilink Frame Relay bundle.
show frame-relay multilink	Displays configuration information and statistics about multilink Frame Relay bundles and bundle links.

show frame-relay multilink

To display configuration information and statistics about multilink Frame Relay bundles and bundle links, use the show frame-relay multilink command in EXEC mode.

show frame-relay multilink [mfr number | serial number] [detailed]

Syntax Description

mfr number	(Optional) Specific bundle interface for which information will be displayed.
serial number	(Optional) Specific bundle link interface for which information will be displayed.
detailed	(Optional) More detailed information will be displayed, including counters for the control messages sent to and from the peer device and the status of the bundle links.

Command Modes

EXEC

Command History

Release	Modification
12.0(17)S	This command was introduced.

Usage Guidelines

If you do not specify a bundle or bundle link, information for all bundles and bundle links will be displayed.

Examples

All Bundles and Bundle Links Example

The following example shows output for the show frame-relay multilink command. Because a particular bundle or bundle link is not specified, information for all bundles and bundle links is displayed.

Router# show frame-relay multilink

Bundle:MFR1, State = up, class = A, fragmentation disabled

 BID = MFR1

 Bundle links :

 Serial5/2/9:0, HW state = up, Protocol state = Up, LID = Serial5/2/9:0

 Serial5/2/8:0, HW state = up, Protocol state = Up, LID = Serial5/2/8:0

 Serial5/2/7:0, HW state = up, Protocol state = Up, LID = Serial5/2/7:0

 Serial5/2/6:0, HW state = up, Protocol state = Up, LID = Serial5/2/6:0

 Serial5/2/5:0, HW state = up, Protocol state = Up, LID = Serial5/2/5:0

 Serial5/2/4:0, HW state = up, Protocol state = Up, LID = Serial5/2/4:0

 Serial5/2/3:0, HW state = up, Protocol state = Up, LID = Serial5/2/3:0

 Serial5/2/2:0, HW state = up, Protocol state = Up, LID = Serial5/2/2:0

 Serial5/2/1:0, HW state = up, Protocol state = Up, LID = Serial5/2/1:0

 Serial5/0/2:0, HW state = up, Protocol state = Up, LID = Serial5/0/2:0

Bundle Link Example

The following example shows output for the show frame-relay multilink command with the serial number option. It displays information about the specified bundle link.

Router# show frame-relay multilink Serial5/2/1:0

 Bundle links :

 Serial5/2/1:0, HW state = up, Protocol state = Up, LID = Serial5/2/1:0

 Bundle interface = MFR1,  BID = MFR1

Detailed Bundle Link Example

The following example shows output for the show frame-relay multilink command with the serial number and detail options. It displays detailed information about the specified bundle link.

Router# show frame-relay multilink Serial5/2/9:0 detailed

Bundle links :

Serial5/2/9:0, HW state = up, Protocol state = up, LID = Serial5/2/9:0

                Cause code = none, Ack timer = 4, Hello timer = 10,

                Max retry count = 2, Current count = 0,

                Peer  lid = Serial5/2/9:0

                Statistics -

                Add_link sent = 2, Add_link rcv'd = 2,

                Add_link ack sent = 2, Add_link ack rcv'd = 1,

                Add_link rej sent = 0, Add_link rej rcv'd = 0,

                Remove_link sent = 0, Remove_link rcv'd = 0,

                Remove_link_ack sent = 0, Remove_link_ack rcv'd = 0,

                Hello sent = 9, Hello rcv'd = 8,

                Hello_ack sent = 8, Hello_ack rcv'd = 9,

                outgoing pak dropped = 0,incoming pak dropped = 0,

Table 1 describes the significant fields in shown in the display.

Table 1 show frame-relay multilink Field Descriptions 

Field	Description
Bundle	Bundle interface.
State	Operational state of the bundle interface.
class	Class A indicates that if one bundle link is up, then the bundle is marked up, and all bundle links must be down before the bundle is marked down.
BID	Bundle identification.
Bundle links	Bundle links for which information will be displayed.
HW state	Operational state of the physical link.
Protocol state	Operational state of the bundle link line protocol.
LID	Bundle link identification.
Cause code	May be one of the following values: •ack timer expiry—add link synchronization process has been exhausted. •bundle link idle—peer's bundle link is idle. This usually occurs when the peer's bundle interface is shut. •inconsistent bundle—peer already has this bundle associated with a different bundle. •loopback detected—local bundle link's physical line is looped back. •other—indicates a LID mismatch, or that the ID length from the peer is too long, or that there has been a failure to allocate ID memory. •unexpected Add_link—Add_link message is received when the bundle link is already in the up state. This code may appear when the line protocol is being set up, but will disappear once the connection has stabilized.
Bundle interface	Bundle interface with which the bundle link is associated.
Ack timer	Number of seconds the bundle link will wait for a hello acknowledgment before resending a hello message or resending an Add_link message used for initial synchronization.
Hello timer	Interval at which a bundle link sends out hello messages.
Max retry count	Maximum number of times a bundle link will resend a hello message before receiving an acknowledgment or resending an Add_link message.
Current count	Number of retries that have already been attempted.
Peer lid	Bundle link identification name of the peer end of the link.
Statistics	Statistics for each bundle link will be displayed.
Add_link sent	Number of Add_link messages sent. Add_link messages notify the peer endpoint that the local endpoint is ready to process frames.
Add_link rcv'd	Number of Add_link messages received.
Add_link ack sent	Number of Add_link acknowledgments sent. Add_link acknowledgments notify the peer endpoint that an Add_link message was received.
Add_link ack rcv'd	Number of Add_link acknowledgments received.
Remove_link sent	Number of Remove_link messages sent. Remove_link messages notify the peer that on the local end a bundle link is being removed from the bundle.
Remove_link rcv'd	Number of Remove_link messages received.
Remove_link_ack sent	Number of Remove_link acknowledgments sent. Remove_link acknowledgments notify the peer that a Remove_link message has been received.
Remove_link_ack rcv'd	Number of Remove_link acknowledgments received.
Hello sent	Number of Hello messages sent. Hello messages notify the peer endpoint that the local endpoint remains in the up state.
Hello rcv'd	Number of Hello messages received.
Hello_ack sent	Number of Hello acknowledgments sent. Hello acknowledgments notify the peer that hello messages have been received.
Hello_ack rcv'd	Number of Hello acknowledgments received.
outgoing pak dropped	Number of outgoing packets dropped.
incoming pak dropped	Number of incoming packets dropped.

Related Commands

Command	Description
debug frame-relay multilink	Displays debug messages for multilink Frame Relay bundles and bundle links.

Debug Commands

This section documents the new debug command related to the Multilink Frame Relay feature.

•debug frame-relay multilink

debug frame-relay multilink

To display debug messages for multilink Frame Relay bundles and bundle links, use the debug frame-relay multilink command in EXEC mode. To disable the display of debug messages for multilink Frame Relay bundles and bundle links, use the no form of this command.

debug frame-relay multilink [control [mfr number | serial number]]

no debug frame-relay multilink

Syntax Description

control	(Optional) Displays incoming and outgoing bundle link control messages and bundle link status changes.
mfr number	(Optional) Specific bundle interface for which information will be displayed.
serial number	(Optional) Specific bundle link interface for which information will be displayed.

Defaults

No default behavior or values.

Command History

Release	Modification
12.0(17)S	This command was introduced.

Usage Guidelines

---

Caution Using the debug frame-relay multilink command without the control keyword could severely impact router performance and is not recommended.

---

Examples

The following example shows output from the debug frame-relay multilink command for bundle "MFR0", which has 3 bundle links:

Router# debug frame-relay multilink control MFR0

00:42:54:Serial5/0/3:0(o):msg=Add_link, Link=Serial5/0/3:0, Bundle=MFR0, Link id=Serial5/0/3:0, BL state=Idle

E1 00 01 01 07 4D 46 52 30 00

00:42:54:Serial5/0/2:0(o):msg=Add_link, Link=Serial5/0/2:0, Bundle=MFR0, Link id=Serial5/0/2:0, BL state=Idle

E1 00 01 01 07 4D 46 52 30 00

00:42:54:Serial5/0/1:0(o):msg=Add_link, Link=Serial5/0/1:0, Bundle=MFR0, Link id=Serial5/0/1:0, BL state=Idle

E1 00 01 01 07 4D 46 52 30 00

00:42:54:%LINK-3-UPDOWN:Interface MFR0, changed state to down

00:42:54:Serial5/0/3:0(i):msg=Add_link_ack, Link=Serial5/0/3:0, Bundle=MFR0, Link id=Serial5/0/3:0, 
BL state=Add_sent

E1 00 02 01 07 4D 46 52 30 00

00:42:54:Serial5/0/2:0(i):msg=Add_link_ack, Link=Serial5/0/2:0, Bundle=MFR0, Link id=Serial5/0/2:0, 
BL state=Add_sent

E1 00 02 01 07 4D 46 52 30 00

00:42:54:Serial5/0/1:0(i):msg=Add_link_ack, Link=Serial5/0/1:0, Bundle=MFR0, Link id=Serial5/0/1:0, 
BL state=Add_sent

E1 00 02 01 07 4D 46 52 30 00

00:42:54:%SYS-5-CONFIG_I:Configured from console by console

00:43:00:Serial5/0/1:0(i):msg=Add_link, Link=Serial5/0/1:0, Bundle=MFR0, Link id=Serial5/0/1:0, 
BL state=Ack_rx

E1 00 01 01 07 4D 46 52 30 00

00:43:00:Serial5/0/1:0(o):msg=Add_link_ack, Link=Serial5/0/1:0, Bundle=MFR0, Link id=Serial5/0/1:0, 
BL state=Ack_rx

E1 00 02 01 07 4D 46 52 30 00

00:43:00:%LINK-3-UPDOWN:Interface MFR0, changed state to up

00:43:00:Serial5/0/1:0(i):msg=Hello, Link=Serial5/0/1:0, Bundle=MFR0, Linkid=Serial5/0/1:0, BL state=Up

E1 00 04 03 06 30 A7 E0 54 00

00:43:00:Serial5/0/1:0(o):msg=Hello_ack, Link=Serial5/0/1:0, Bundle=MFR0, Link id=Serial5/0/1:0, BL state=Up

E1 00 05 03 06 90 E7 0F C2 06

00:43:01:Serial5/0/2:0(i):msg=Add_link, Link=Serial5/0/2:0, Bundle=MFR0, Link id=Serial5/0/2:0, 
BL state=Ack_rx

E1 00 01 01 07 4D 46 52 30 00

00:43:01:Serial5/0/2:0(o):msg=Add_link_ack, Link=Serial5/0/2:0, Bundle=MFR0, Link id=Serial5/0/2:0, 
BL state=Ack_rx

E1 00 02 01 07 4D 46 52 30 00

00:43:01:Serial5/0/2:0(i):msg=Hello, Link=Serial5/0/2:0, Bundle=MFR0, Linkid=Serial5/0/2:0, BL state=Up

E1 00 04 03 06 30 A7 E0 54 00

00:43:01:Serial5/0/2:0(o):msg=Hello_ack, Link=Serial5/0/2:0, Bundle=MFR0, Link id=Serial5/0/2:0, BL state=Up

E1 00 05 03 06 90 E7 0F C2 06

00:43:01:%LINEPROTO-5-UPDOWN:Line protocol on Interface Serial5/0/1:0, changed state to up

00:43:01:Serial5/0/3:0(i):msg=Add_link, Link=Serial5/0/3:0, Bundle=MFR0, Link id=Serial5/0/3:0, 
BL state=Ack_rx

E1 00 01 01 07 4D 46 52 30 00

00:43:01:Serial5/0/3:0(o):msg=Add_link_ack, Link=Serial5/0/3:0, Bundle=MFR0, Link id=Serial5/0/3:0, 
BL state=Ack_rx

E1 00 02 01 07 4D 46 52 30 00

00:43:01:Serial5/0/3:0(i):msg=Hello, Link=Serial5/0/3:0, Bundle=MFR0, Linkid=Serial5/0/3:0, BL state=Up

E1 00 04 03 06 30 A7 E0 54 00

00:43:01:Serial5/0/3:0(o):msg=Hello_ack, Link=Serial5/0/3:0, Bundle=MFR0, Link id=Serial5/0/3:0, BL state=Up

E1 00 05 03 06 90 E7 0F C2 06

00:43:02:%LINEPROTO-5-UPDOWN:Line protocol on Interface Serial5/0/2:0 , changed state to up

00:43:02:%LINEPROTO-5-UPDOWN:Line protocol on Interface Serial5/0/3:0 , changed state to up

Table 2 describes the significant fields shown in the display.

Table 2 debug frame-relay multilink Field Descriptions

Field	Description
msg	Type of bundle link control message that was sent or received.
Link	Interface number of the bundle link.
Bundle	Bundle with which the link is associated.
Link id	Bundle link identification name.
BL state	Operational state of the bundle link.

Related Commands

Command	Description
show frame-relay multilink	Displays configuration information and statistics about multilink Frame Relay bundles and bundle links.

Glossary

BID—bundle identification. BID is the name used to identify the bundle. The BID can be assigned or the default can be used.

bundle—A logical grouping of one or more physical interfaces using the formats and procedures of multilink Frame Relay. A bundle emulates a physical interface to the Frame Relay data-link layer. The bundle is also referred to as a virtual interface and mfr interface.

bundle link—An individual physical interface that is a member of a bundle.

DLCI—data-link connection identifier. Value that identifies a permanent virtual circuit (PVC) in Frame Relay network.

FRF2.1 Annex 1—Frame Relay Forum standard that provides a signaling protocol for permanent virtual circuit (PVC) monitoring at the NNI for a Frame Relay switching network. FRF2.1 Annex 1 generates notification when an event occurs that changes status; when an event occurs, it generates immediate notification.

hello message—Message that notifies a peer endpoint that the local endpoint is in the operational state (up).

hello acknowledgment—Message that notifies a peer endpoint that a hello message has been received.

LID—link identification. LID is the name used to identify a bundle link. The LID can be assigned or the default can be used.

LMI—Local Management Interface. Set of enhancements to the basic Frame Relay specification. LMI includes support for a keepalive mechanism, which verifies that data is flowing; a multicast mechanism, which provides the network server with its local DLCI and the multicast DLCI; global addressing, which gives DLCIs global rather than local significance in Frame Relay networks; and a status mechanism, which provides an ongoing status report on the DLCIs known to the switch.

NNI—Network-to-Network Interface. The interface between two Frame Relay devices that are both located in a private network or both located in a public network.

UNI—User-to-Network Interface. The interface between a Frame Relay device in a public network and a Frame Relay device in a private network.