Config Guide (Bundle XR)
Config Guide (Bundle XR)
Software
This module describes the configuration of link bundle interfaces on the Cisco CRS-1 Router.
A link bundle is a group of one or more ports that are aggregated together and treated as a single link.
The Link Bundling feature allows you to group multiple point-to-point links together into one logical
link and provide higher bidirectional bandwidth, redundancy, and load balancing between two routers.
A virtual interface is assigned to the bundled link. The component links can be dynamically added and
deleted from the virtual interface. The virtual interface is treated as a single interface on which you can
configure an IP address and other software features used by the link bundle. Packets sent to the link
bundle are forwarded to one of the links in the bundle.
Each bundle has a single MAC and shares a single Layer 3 configuration set, such as IP address, ACL,
Quality of Service (QoS), and so on.
Note Link bundles do not have a one-to-one modular services card association. Member links can terminate
on different cards.
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-197
Configuring Link Bundling on Cisco IOS XR Software
Release Modification
Release 3.2 This feature was introduced on the Cisco CRS-1 Router.
Release 3.3.0 This feature was updated as follows:
• To support the 1:N redundancy feature, users can configure the
minimum number of active links using the bundle minimum-active
links command.
• To support the 1:N redundancy feature, users can configure the
minimum bandwidth in kbps using the bundle minimum-active links
command.
• Support was added for VLAN subinterfaces on Ethernet link bundles.
• Output for show bundle bundle-Ether command and show bundle
bundle-POS command was modified.
• The reasons keyword was added to the show bundle bundle-Ether
command and the show bundle bundle-POS command.
• The bundle id command was changed from bundle-id.
• BFD over bundled VLANs using static routes.
Release 3.4.0 The configuration procedures in this module were modified with
enhancements.
Release 3.7.0 Note was added, specifying that link bundling is supported on the
multishelf Cisco CRS-1 Router.
Release 3.8.0 This feature was updated as follows:
• The reasons keyword was removed from the show bundle
bundle-Ether command and the show bundle bundle-POS command.
Now, if a port is in a state other than the distributing state, the output
of both commands displays the reason.
• The hot-standby keyword was added to the bundle maximum-active
links command.
• The lacp fast-switchover command was added.
Release 3.8.4 Bundle member links are put into new err-disable link interface status and
admin-down protocol state when a bundle interface is shut down.
Release 3.9.0 Support for super short LACP was added.
Support for load balancing was added.
Support for a maximum of 64 member links per bundle was added.
Release 4.0.0 Support for the following physical layer interface modules (PLIMs) was
added:
• 14-Port 10-Gigabit Ethernet LAN/WAN-PHY PLIM
(14X10GBE-WL-XFP) (with the Cisco CRS-3 Modular Services Card
or Cisco CRS-3 Forwarding Processor Card)
• 20-Port 10-Gigabit Ethernet LAN/WAN-PHY PLIM
(20X10GBE-WL-XFP) (with the Cisco CRS-3 Modular Services Card
or Cisco CRS-3 Forwarding Processor Card)
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-198 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
Contents
Contents
This module includes the following sections:
• Prerequisites for Configuring Link Bundling, page 199
• Information About Configuring Link Bundling, page 200
• How to Configure Link Bundling, page 207
• Configuration Examples for Link Bundling, page 235
• Additional References, page 239
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-199
Configuring Link Bundling on Cisco IOS XR Software
Information About Configuring Link Bundling
Note For more information about physical interfaces, PLIMs, and modular services cards, refer to the
Cisco CRS-1 Carrier Routing System 8-Slot Line Card Chassis System Description.
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-200 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
Information About Configuring Link Bundling
• Bundled interfaces increase bandwidth availability, because traffic is forwarded over all available
members of the bundle. Therefore, traffic can move onto another link if one of the links within a
bundle fails. You can add or remove bandwidth without interrupting packet flow. For example, you
can upgrade from an OC-48c PLIM modular services card to an OC-192 PLIM modular services card
without interrupting traffic.
All links within a bundle must be of the same type. For example, a bundle can contain all Ethernet
interfaces, or it can contain all POS interfaces, but it cannot contain Ethernet and POS interfaces at the
same time.
Cisco IOS XR software supports the following methods of forming bundles of Ethernet and POS
interfaces:
• IEEE 802.3ad—Standard technology that employs a Link Aggregation Control Protocol (LACP) to
ensure that all the member links in a bundle are compatible. Links that are incompatible or have
failed are automatically removed from a bundle.
• EtherChannel or POS Channel—Cisco proprietary technology that allows the user to configure links
to join a bundle, but has no mechanisms to check whether the links in a bundle are compatible.
(EtherChannel applies to Ethernet interfaces, and POS Channel applies to POS interfaces.)
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-201
Configuring Link Bundling on Cisco IOS XR Software
Information About Configuring Link Bundling
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-202 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
Information About Configuring Link Bundling
• HDLC is the only supported encapsulation type for POS link bundles in Cisco IOS XR software.
POS links that are configured with any other encapsulation type cannot join a bundle. Keep in mind
that all POS link bundle members must be running HDLC for HDLC to work on a bundle.
• QoS is supported and is applied proportionally on each bundle member.
• Link layer protocols, such as CDP and HDLC keepalives, work independently on each link within
a bundle.
• All links within a single bundle must be configured to run either POS Channel or 802.3ad. Mixed
bundles are not supported.
• Cisco CRS Router allows mixed bandwidth of up to ten times in the same interface. This means that
GigE and 10GigE interfaces or 10GigE and 100GigE interfaces can be aggregated in a bundle
ethernet interface.
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-203
Configuring Link Bundling on Cisco IOS XR Software
Information About Configuring Link Bundling
The information from the peer system is combined with the information from the local system to
determine the compatibility of the links configured to be members of a bundle.
The MAC address of the first link attached to a bundle becomes the MAC address of the bundle itself.
The bundle uses this MAC address until that link (the first link attached to the bundle) is detached from
the bundle, or until the user configures a different MAC address. The bundle MAC address is used by all
member links when passing bundle traffic. Any unicast or multicast addresses set on the bundle are also
set on all the member links.
Note We recommend that you avoid modifying the MAC address, because changes in the MAC address can
affect packet forwarding.
Note You must always configure the transmit interval at both ends of the connection before you configure the
receive interval at either end of the connection. Failure to configure the transmit interval at both ends
first results in route flapping (a route going up and down continuously). When you remove a custom
LACP short period, you must do it in reverse order. You must remove the receive intervals first and then
the transmit intervals.
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-204 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
Information About Configuring Link Bundling
Load Balancing
Load balancing is a forwarding mechanism which distributes traffic over multiple links, based on
Layer 3 routing information in the router. Per-flow load balancing is supported on all links in the bundle.
This scheme achieves load sharing by allowing the router to distribute packets over one of the links in
the bundle, that is determined through a hash calculation. The hash calculation is an algorithm for link
selection based on certain parameters.
The standard hash calculation is a 3-tuple hashing, using the following parameters:
• IP source address
• IP destination address
• Router ID
7-tuple hashing can also be configured. based on Layer 3 and Layer 4 parameters:
• IP source address
• IP destination address
• Router ID
• Input interface
• IP protocol
• Layer 4 source port
• Layer 4 destination port
When per-flow load balancing and 3-tuple hashing is enabled, all packets for a certain source-destination
pair will go through the same link, though there are multiple links available. Per-flow load balancing
ensures that packets for a certain source-destination pair arrive in order.
Note For multicast traffic, ingress forwarding is based on the Fabric Multicast Group Identifier (FGID).
Egress forwarding over the bundle is based on the bundle load balancing.
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-205
Configuring Link Bundling on Cisco IOS XR Software
Information About Configuring Link Bundling
Note The memory requirement for bundle VLANs is slightly higher than standard physical interfaces.
To create a VLAN subinterface on a bundle, include the VLAN subinterface instance with the interface
Bundle-Ether command, as follows:
interface Bundle-Ether interface-bundle-id.subinterface
After you create a VLAN on an Ethernet link bundle, all VLAN subinterface configuration is supported
on that link bundle.
VLAN subinterfaces can support multiple Layer 2 frame types and services, such as Ethernet Flow
Points - EFPs) and Layer 3 services.
Note A link is configured as a member of a bundle from the interface configuration submode for that link.
Note You do not need to configure anything to guarantee that the standby interface configurations are
maintained.
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-206 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Link Switchover
By default, a maximum of 64 links in a bundle can actively carry traffic on a Cisco CRS-1 Router, If
one member link in a bundle fails, traffic is redirected to the remaining operational member links.
On a Cisco CRS-1 Router, you can optionally implement 1:1 link protection for a bundle by setting the
bundle maximum-active links command to 1. By doing so, you designate one active link and one or
more dedicated standby links. If the active link fails, a switchover occurs and a standby link immediately
becomes active, thereby ensuring uninterrupted traffic.
If the active and standby links are running LACP, you can choose between an IEEE standard-based
switchover (the default) or a faster proprietary optimized switchover. If the active and standby links are
not running LACP, the proprietary optimized switchover option is used.
Regardless of the type of switchover you are using, you can disable the wait-while timer, which
expedites the state negotiations of the standby link and causes a faster switchover from a failed active
link to the standby link. To do so, you can use the lacp fast-switchover command.
Note In order for an Ethernet bundle to be active, you must perform the same configuration on both connection
endpoints of the bundle.
SUMMARY STEPS
The creation of an Ethernet link bundle involves creating a bundle and adding member interfaces to that
bundle, as shown in the steps that follow.
1. configure
2. interface Bundle-Ether bundle-id
3. ipv4 address ipv4-address mask
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-207
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
DETAILED STEPS
Example:
RP/0/RP0/CPU0:router# configure
Step 2 interface Bundle-Ether bundle-id Creates a new Ethernet link bundle with the specified
bundle-id. The range is 1 to 65535.
Example: This interface Bundle-Ether command enters you
RP/0/RP0/CPU0:router#(config)# interface into the interface configuration submode, where you
Bundle-Ether 3 can enter interface specific configuration commands
are entered. Use the exit command to exit from the
interface configuration submode back to the normal
global configuration mode.
Step 3 ipv4 address ipv4-address mask Assigns an IP address and subnet mask to the virtual
interface using the ipv4 address configuration
subcommand.
Example:
RP/0/RP0/CPU0:router(config-if)# ipv4 address Note
10.1.2.3 255.0.0.0
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-208 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-209
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Example:
RP/0/RP0/CPU0:router(config)# interface
GigabitEthernet 1/0/2/1
RP/0/RP0/CPU0:router(config-if)# bundle id 3
RP/0/RP0/CPU0:router(config-if)# bundle
port-priority 2
RP/0/RP0/CPU0:router(config-if)# no shutdown
RP/0/RP0/CPU0:router(config-if)# exit
RP/0/RP0/CPU0:router(config)# interface
GigabitEthernet 1/0/2/3
RP/0/RP0/CPU0:router(config-if)# bundle id 3
RP/0/RP0/CPU0:router(config-if)# no shutdown
RP/0/RP0/CPU0:router(config-if)# exit
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-210 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Example:
RP/0/RP0/CPU0:router(config-if)# exit
Step 17 exit Exits global configuration mode.
Example:
RP/0/RP0/CPU0:router(config)# exit
Step 18 Perform Step 1 through Step 15 on the remote end of the Brings up the other end of the link bundle.
connection.
Step 19 show bundle Bundle-Ether bundle-id (Optional) Shows information about the specified
Ethernet link bundle.
Example:
RP/0/RP0/CPU0:router# show bundle Bundle-Ether 3
Step 20 show lacp bundle Bundle-Ether bundle-id (Optional) Shows detailed information about LACP
ports and their peers.
Example:
RP/0/RP0/CPU0:router# show lacp bundle
Bundle-Ether 3
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-211
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Note If the active members of the bundle change, the traffic for the bundle may get mapped to a different
physical link that has a hash value that matches the configured value.
SUMMARY STEPS
Perform the following steps to configure EFP Load Balancing on an Ethernet link bundle:
1. configure
2. interface Bundle-Ether bundle-id l2transport
3. bundle load-balance hash hash-value [auto]
4. end
or
commit
DETAILED STEPS
Example:
RP/0/RP0/CPU0:router# configure
Step 2 interface Bundle-Ether bundle-id l2transport Creates a new Ethernet link bundle with the specified
bundle-id and with Layer 2 transport enabled.
Example: The range is 1 to 65535.
RP/0/RP0/CPU0:router#(config)# interface
Bundle-Ether 3 l2transport
Step 3 bundle load-balance hash hash-value [auto] Configures all egressing traffic on the fixed members
of a bundle to flow through the same physical member
Example: link.
RP/0/RP0/CPU0:router(config-subif)# bundle
load-balancing hash 1 • hash-value—Numeric value that specifies the
or physical member link through which all egressing
traffic in this bundle will flow. The values are 1
RP/0/RP0/CPU0:router(config-subif)# bundle
load-balancing hash auto
through 8.
• auto—The physical member link through which
all egressing traffic on this bundle will flow is
automatically chosen.
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-212 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Note In order for a VLAN bundle to be active, you must perform the same configuration on both ends of the
bundle connection.
SUMMARY STEPS
The creation of a VLAN link bundle is described in the steps that follow.
1. configure
2. interface Bundle-Ether bundle-id
3. ipv4 address ipv4-address mask
4. bundle minimum-active bandwidth kbps
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-213
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-214 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
DETAILED STEPS
Example:
RP/0/RP0/CPU0:router# configure
Step 2 interface Bundle-Ether bundle-id Creates and names a new Ethernet link bundle.
This interface Bundle-Ether command enters
Example: you into the interface configuration submode,
RP/0/RP0/CPU0:router#(config)# interface where you can enter interface-specific
Bundle-Ether 3 configuration commands. Use the exit command
to exit from the interface configuration submode
back to the normal global configuration mode.
Step 3 ipv4 address ipv4-address mask Assigns an IP address and subnet mask to the
virtual interface using the ipv4 address
configuration subcommand.
Example:
RP/0/RP0/CPU0:router(config-if)# ipv4 address
10.1.2.3 255.0.0.0
Step 4 bundle minimum-active bandwidth kbps (Optional) Sets the minimum amount of
bandwidth required before a user can bring up a
bundle.
Example:
RP/0/RP0/CPU0:router(config-if)# bundle
minimum-active bandwidth 580000
Step 5 bundle minimum-active links links (Optional) Sets the number of active links
required before you can bring up a specific
bundle.
Example:
RP/0/RP0/CPU0:router(config-if)# bundle
minimum-active links 2
Step 6 bundle maximum-active links links [hot-standby] (Optional) Implements 1:1 link protection for the
bundle, which causes the highest-priority link in
the bundle to become active and the
Example:
RP/0/RP0/CPU0:router(config-if)# bundle
second-highest-priority link to become the
maximum-active links 1 hot-standby standby. Also, specifies that a switchover between
active and standby LACP-enabled links is
implemented per a proprietary optimization.
Note The priority of the active and standby
links is based on the value of the bundle
port-priority command.
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-215
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Example:
RP/0/RP0/CPU0:router(config-if)# exit
Step 9 interface Bundle-Ether bundle-id.vlan-id Creates a new VLAN, and assigns the VLAN to
the Ethernet bundle you created in Step 2.
Example: Replace the bundle-id argument with the
RP/0/RP0/CPU0:router#(config)# interface bundle-id you created in Step 2.
Bundle-Ether 3.1
Replace the vlan-id with a subinterface identifier.
Range is from 1 to 4094 inclusive (0 and 4095 are
reserved).
Note When you include the .vlan-id argument
with the interface Bundle-Ether
bundle-id command, you enter
subinterface configuration mode.
Step 10 dot1q vlan vlan-id Assigns a VLAN to the subinterface.
Replace the vlan-id argument with a subinterface
Example: identifier. Range is from 1 to 4094 inclusive (0
RP/0/RP0/CPU0:router#(config-subif)# dot1q vlan 10 and 4095 are reserved).
Step 11 ipv4 address ipv4-address mask Assigns an IP address and subnet mask to the
subinterface.
Example:
RP/0/RP0/CPU0:router#(config-subif)# ipv4 address
10.1.2.3/24
Step 12 no shutdown (Optional) If a link is in the down state, bring it
up. The no shutdown command returns the link to
an up or down state depending on the
Example:
RP/0/RP0/CPU0:router#(config-subif)# no shutdown
configuration and state of the link.
Step 13 exit Exits subinterface configuration mode for the
VLAN subinterface.
Example:
RP/0/RP0/CPU0:router(config-subif)# exit
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-216 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Example:
RP/0/RP0/CPU0:router(config-subif)# interface
Bundle-Ether 3.1
RP/0/RP0/CPU0:router(config-subif)# dot1q vlan 20
RP/0/RP0/CPU0:router(config-subif)# ipv4 address
20.2.3.4/24
RP/0/RP0/CPU0:router(config-subif)# no shutdown
exit
Step 15 end Saves configuration changes.
or
• When you issue the end command, the
commit system prompts you to commit changes:
Uncommitted changes found, commit them
Example: before exiting(yes/no/cancel)?
RP/0/RP0/CPU0:router(config-subif)# end [cancel]:
or
– Entering yes saves configuration changes
RP/0/RP0/CPU0:router(config-subif)# commit to the running configuration file, exits the
configuration session, and returns the
router to EXEC mode.
– Entering no exits the configuration
session and returns the router to EXEC
mode without committing the
configuration changes.
– Entering cancel leaves the router in the
current configuration session without
exiting or committing the configuration
changes.
• Use the commit command to save the
configuration changes to the running
configuration file and remain within the
configuration session.
Step 16 exit Exits interface configuration mode.
Example:
RP/0/RP0/CPU0:router(config-subif)# end
Step 17 exit Exits global configuration mode.
Example:
RP/0/RP0/CPU0:router(config)# exit
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-217
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Example:
RP/0/RP0/CPU0:router # configure
Step 19 interface {GigabitEthernet | TenGigE} Enters interface configuration mode for the
interface-path-id Ethernet interface you want to add to the Bundle.
Enter the GigabitEthernet or TenGigE keyword
Example: to specify the interface type. Replace the
RP/0/RP0/CPU0:router(config)# interface interface-path-id argument with the node-id in
GigabitEthernet 1/0/0/0
the rack/slot/module format.
Note A VLAN bundle is not active until you
add an Ethernet interface on both ends of
the link bundle.
Step 20 bundle id bundle-id [mode {active | on | passive}] Adds an Ethernet interface to the bundle you
configured in Step 2 through Step 13.
Example: To enable active or passive LACP on the bundle,
RP/0/RP0/CPU0:router(config-if)# bundle-id 3 include the optional mode active or mode passive
keywords in the command string.
To add the interface to the bundle without LACP
support, include the optional mode on keywords
with the command string.
Note If you do not specify the mode keyword,
the default mode is on (LACP is not run
over the port).
Step 21 bundle port-priority priority (Optional) If you set the bundle
maximum-active links command to 1, you must
also set the priority of the active link to the highest
Example:
RP/0/RP0/CPU0:router(config-if)# bundle
priority (lowest value) and the standby link to the
port-priority 1 second-highest priority (next lowest value). For
example, you can set the priority of the active link
to 1 and the standby link to 2.
Step 22 no shutdown (Optional) If a link is in the down state, bring it
up. The no shutdown command returns the link to
an up or down state depending on the
Example:
RP/0/RP0/CPU0:router(config-if)# no shutdown
configuration and state of the link.
Step 23 — Repeat Step 19 through Step 21 to add more
Ethernet interfaces to the VLAN bundle.
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-218 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-219
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Note In order for a POS bundle to be active, you must perform the same configuration on both connection
endpoints of the POS bundle.
SUMMARY STEPS
The creation of a bundled POS interface involves configuring both the bundle and the member interfaces,
as shown in these steps:
1. configure
2. interface Bundle-POS bundle-id
3. ipv4 address ipv4-address mask
4. bundle minimum-active bandwidth kbps
5. bundle minimum-active links links
6. bundle maximum-active links links [hot-standby]
7. lacp fast-switchover
8. exit
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-220 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
DETAILED STEPS
Example:
RP/0/RP0/CPU0:router# configure
Step 2 interface Bundle-POS bundle-id Configures and names the new bundled POS interface.
Enters the interface configuration submode, from
Example: where interface specific configuration commands are
RP/0/RP0/CPU0:router#(config)#interface Bundle-POS executed. Use the exit command to exit from the
2 interface configuration submode, and get back to the
normal global configuration mode.
Step 3 ipv4 address ipv4-address mask Assigns an IP address and subnet mask to the virtual
interface using the ip address configuration
subcommand.
Example:
RP/0/RP0/CPU0:router(config-if)# ipv4 address
10.1.2.3 255.0.0.0
Step 4 bundle minimum-active bandwidth kbps (Optional) Sets the minimum amount of bandwidth
required before a user can bring up a bundle.
Example:
RP/0/RP0/CPU0:router(config-if)# bundle
minimum-active bandwidth 620000
Step 5 bundle minimum-active links links (Optional) Sets the number of active links required
before you can bring up a specific bundle.
Example:
RP/0/RP0/CPU0:router(config-if)# bundle
minimum-active links 2
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-221
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Step 10 bundle id bundle-id [mode {active | on | passive}] Adds the link to the specified bundle.
To enable active or passive LACP on the bundle,
Example: include the optional mode active or mode passive
RP/0/RP0/CPU0:router(config-if)# bundle-id 3 keywords in the command string.
To add the link to the bundle without LACP support,
include the optional mode on keywords with the
command string.
Note If you do not specify the mode keyword, the
default mode is on (LACP is not run over the
port).
Step 11 bundle port-priority priority (Optional) If you set the bundle maximum-active
links command to 1, you must also set the priority of
the active link to the highest priority (lowest value) and
Example:
RP/0/RP0/CPU0:router(config-if)# bundle
the standby link to the second-highest priority (next
port-priority 1 lowest value). For example, you can set the priority of
the active link to 1 and the standby link to 2.
Step 12 no shutdown Removes the shutdown configuration which forces the
interface administratively down. The no shutdown
command then returns the link to an up or down state,
Example:
RP/0/RP0/CPU0:router(config-if)# no shutdown
depending on the configuration and state of the link.
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-222 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Example:
RP/0/RP0/CPU0:router(config-if)# exit
Step 17 exit Exits global configuration mode.
Example:
RP/0/RP0/CPU0:router(config)# exit
Step 18 Perform Step 1 through Step 15 on the remote end of the Brings up the other end of the link bundle.
connection.
Step 19 show bundle Bundle-POS number (Optional) Shows information about the specified POS
link bundle.
Example:
RP/0/RP0/CPU0:router# show bundle Bundle-POS 1
Step 20 show lacp bundle Bundle-POS bundle-id (Optional) Shows detailed information about LACP
ports and their peers.
Example:
RP/0/RP0/CPU0:router# show lacp bundle
Bundle-POS 3
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-223
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
SUMMARY STEPS
To enable an LACP short period time interval, using the default time of 1 second, perform the following
steps.
1. configure
2. interface GigabitEthernet interface-path
3. bundle id number mode active
4. lacp period short
5. commit
DETAILED STEPS
Example:
RP/0/RP0/CPU0:router# configure
Step 2 interface GigabitEthernet interface-path Creates a Gigabit Ethernet interface and enters
interface configuration mode.
Example:
RP/0/RP0/CPU0:router(config)# interface
GigabitEthernet 0/0/0/1
Step 3 bundle id number mode active Specifies the bundle interface and puts the member
interface in active mode.
Example:
RP/0/RP0/CPU0:router(config-if)# bundle id 1 mode
active
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-224 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-225
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Note You must always configure the transmit interval at both ends of the connection before you configure the
receive interval at either end of the connection. Failure to configure the transmit interval at both ends
first results in route flapping (a route going up and down continuously). When you remove a custom
LACP short period, you must do it in reverse order. You must remove the receive intervals first and then
the transmit intervals.
SUMMARY STEPS
To configure custom receive and transmit intervals for LACP packets, perform the following steps.
Router A
1. configure
2. interface GigabitEthernet interface-path
3. bundle id number mode active
4. lacp period short
5. commit
Router B
6. configure
7. interface GigabitEthernet interface-path
8. bundle id number mode active
9. lacp period short
10. commit
Router A
11. configure
12. interface GigabitEthernet interface-path
13. lacp period short transmit interval
14. commit
Router B
15. configure
16. interface GigabitEthernet interface-path
17. lacp period short transmit interval
18. commit
Router A
19. configure
20. interface GigabitEthernet interface-path
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-226 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Router B
23. configure
24. interface GigabitEthernet interface-path
25. lacp period short receive interval
26. commit or end
DETAILED STEPS
Example:
RP/0/RP0/CPU0:router# configure
Step 2 interface Bundle-Ether bundle-id Creates and names a new Ethernet link bundle.
This interface Bundle-Ether command enters
Example: you into the interface configuration submode,
RP/0/RP0/CPU0:router#(config)# interface where you can enter interface-specific
Bundle-Ether 3 configuration commands. Use the exit command
to exit from the interface configuration submode
back to the normal global configuration mode.
Step 3 ipv4 address ipv4-address mask Assigns an IP address and subnet mask to the
virtual interface using the ipv4 address
configuration subcommand.
Example:
RP/0/RP0/CPU0:router(config-if)# ipv4 address
10.1.2.3 255.0.0.0
Step 4 bundle minimum-active bandwidth kbps (Optional) Sets the minimum amount of
bandwidth required before a user can bring up a
bundle.
Example:
RP/0/RP0/CPU0:router(config-if)# bundle
minimum-active bandwidth 580000
Step 5 bundle minimum-active links links (Optional) Sets the number of active links
required before you can bring up a specific
bundle.
Example:
RP/0/RP0/CPU0:router(config-if)# bundle
minimum-active links 2
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-227
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Example:
RP/0/RP0/CPU0:router(config-if)# exit
Step 8 interface Bundle-Ether bundle-id.vlan-id Creates a new VLAN, and assigns the VLAN to
the Ethernet bundle you created in Step 2.
Example: Replace the bundle-id argument with the
RP/0/RP0/CPU0:router#(config)# interface bundle-id you created in Step 2.
Bundle-Ether 3.1
Replace the vlan-id with a subinterface identifier.
Range is from 1 to 4094 inclusive (0 and 4095 are
reserved).
Note When you include the .vlan-id argument
with the interface Bundle-Ether
bundle-id command, you enter
subinterface configuration mode.
Step 9 dot1q vlan vlan-id Assigns a VLAN to the subinterface.
Replace the vlan-id argument with a subinterface
Example: identifier. Range is from 1 to 4094 inclusive (0
RP/0/RP0/CPU0:router#(config-subif)# dot1q vlan 10 and 4095 are reserved).
Step 10 ipv4 address ipv4-address mask Assigns an IP address and subnet mask to the
subinterface.
Example:
RP/0/RP0/CPU0:router#(config-subif)# ipv4 address
10.1.2.3/24
Step 11 no shutdown (Optional) If a link is in the down state, bring it
up. The no shutdown command returns the link to
an up or down state depending on the
Example:
RP/0/RP0/CPU0:router#(config-subif)# no shutdown
configuration and state of the link.
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-228 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Example:
RP/0/RP0/CPU0:router(config-subif)# exit
Step 16 exit Exits global configuration mode.
Example:
RP/0/RSP0/CPU0:router(config)# exit
Step 17 show ethernet trunk bundle-ether instance (Optional) Displays the interface configuration.
The Ethernet bundle instance range is from 1
Example: through 65535.
RP/0/RP0/CPU0:router# show ethernet trunk
bundle-ether 5
Step 18 configure Enters global configuration mode.
Example:
RP/0/RP0/CPU0:router # configure
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-229
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-230 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-231
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Example:
RP/0/RP0/CPU0:router# configure
Step 2 interface GigabitEthernet interface-path Creates a Gigabit Ethernet interface and enters
interface configuration mode.
Example:
RP/0/RP0/CPU0:router(config)# interface
GigabitEthernet 0/0/0/1
Step 3 bundle id number mode active Specifies the bundle interface and puts the member
interface in active mode.
Example:
RP/0/RP0/CPU0:router(config-if)# bundle id 1 mode
active
Step 4 lacp period short Enables the short period time interval.
Example:
RP/0/RP0/CPU0:router(config-if)# lacp period short
Step 5 commit Saves configuration changes and exits to EXEC mode.
Example:
RP/0/RP0/CPU0:router(config-if)# commit
Router B
Step 6 configure Enters global configuration mode.
Example:
RP/0/RP0/CPU0:router# configure
Step 7 interface GigabitEthernet interface-path Creates a Gigabit Ethernet interface and enters
interface configuration mode.
Example:
RP/0/RP0/CPU0:router(config)# interface
GigabitEthernet 0/0/0/1
Step 8 bundle id number mode active Specifies the bundle interface and puts the member
interface in active mode.
Example:
RP/0/RP0/CPU0:router(config-if)# bundle id 1 mode
active
Step 9 lacp period short Enables the short period time interval.
Example:
RP/0/RP0/CPU0:router(config-if)# lacp period short
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-232 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Example:
RP/0/RP0/CPU0:router(config-if)# commit
Router A
Step 11 configure Enters global configuration mode.
Example:
RP/0/RP0/CPU0:router# configure
Step 12 interface GigabitEthernet interface-path Creates a Gigabit Ethernet interface and enters
interface configuration mode at one end of the
connection.
Example:
RP/0/RP0/CPU0:router(config)# interface
GigabitEthernet 0/0/0/1
Step 13 lacp period short transmit interval Configures the short period transmit time interval for
LACP packets at one end of the connection.
Example: Valid values are 100 to 1000 milliseconds in multiples
RP/0/RP0/CPU0:router(config-if)# lacp period short of 100, such as 100, 200, 300, and so on.
transmit 500
Step 14 commit Saves configuration changes and exits to EXEC mode.
Example:
RP/0/RP0/CPU0:router(config-if)# commit
Router B
Step 15 configure Enters global configuration mode.
Example:
RP/0/RP0/CPU0:router# configure
Step 16 interface GigabitEthernet interface-path Creates a Gigabit Ethernet interface and enters
interface configuration mode at one end of the
connection.
Example:
RP/0/RP0/CPU0:router(config)# interface
GigabitEthernet 0/0/0/1
Step 17 lacp period short transmit interval Configures the short period transmit time interval for
LACP packets at one end of the connection.
Example: Valid values are 100 to 1000 milliseconds in multiples
RP/0/RP0/CPU0:router(config-if)# lacp period short of 100, such as 100, 200, 300, and so on.
transmit 500
Step 18 commit Saves configuration changes and exits to EXEC mode.
Example:
RP/0/RP0/CPU0:router(config-if)# commit
Router A
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-233
Configuring Link Bundling on Cisco IOS XR Software
How to Configure Link Bundling
Example:
RP/0/RP0/CPU0:router# configure
Step 20 interface GigabitEthernet interface-path Creates a Gigabit Ethernet interface and enters
interface configuration mode at one end of the
connection.
Example:
RP/0/RP0/CPU0:router(config)# interface
GigabitEthernet 0/0/0/1
Step 21 lacp period short receive interval Configures the short period receive time interval for
LACP packets at one end of the connection.
Example: Valid values are 100 to 1000 milliseconds in multiples
RP/0/RP0/CPU0:router(config-if)# lacp period short of 100, such as 100, 200, 300, and so on.
receive 500
Step 22 commit Saves configuration changes and exits to EXEC mode.
Example:
RP/0/RP0/CPU0:router(config-if)# commit
Router B
Step 23 configure Enters global configuration mode.
Example:
RP/0/RP0/CPU0:router# configure
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-234 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
Configuration Examples for Link Bundling
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-235
Configuring Link Bundling on Cisco IOS XR Software
Configuration Examples for Link Bundling
The following example shows how to join two ports to form an EtherChannel bundle running LACP:
RP/0/RP0/CPU0:Router# config
RP/0/RP0/CPU0:Router(config)# interface Bundle-Ether 3
RP/0/RP0/CPU0:Router(config-if)# ipv4 address 1.2.3.4/24
RP/0/RP0/CPU0:Router(config-if)# bundle minimum-active bandwidth 620000
RP/0/RP0/CPU0:Router(config-if)# bundle minimum-active links 1
RP/0/RP0/CPU0:Router(config-if)# bundle maximum-active links 1 hot-standby
RP/0/RP0/CPU0:Router(config-if)# lacp fast-switchover
RP/0/RP0/CPU0:Router(config-if)# exit
RP/0/RP0/CPU0:Router(config)# interface TenGigE 0/3/0/0
RP/0/RP0/CPU0:Router(config-if)# bundle id 3 mode active
RP/0/RP0/CPU0:Router(config-if)# bundle port-priority 1
RP/0/RP0/CPU0:Router(config-if)# no shutdown
RP/0/RP0/CPU0:Router(config)# exit
RP/0/RP0/CPU0:Router(config)# interface TenGigE 0/3/0/1
RP/0/RP0/CPU0:Router(config-if)# bundle id 3 mode active
RP/0/RP0/CPU0:Router(config-if)# bundle port-priority 2
RP/0/RP0/CPU0:Router(config-if)# no shutdown
RP/0/RP0/CPU0:Router(config-if)# exit
The following example shows how to create and bring up two VLANS on an Ethernet bundle:
RP/0/RP0/CPU0:Router# config
RP/0/RP0/CPU0:Router(config)# interface Bundle-Ether 1
RP/0/RP0/CPU0:Router(config-if)# ipv4 address 1.2.3.4/24
RP/0/RP0/CPU0:Router(config-if)# bundle minimum-active bandwidth 620000
RP/0/RP0/CPU0:Router(config-if)# bundle minimum-active links 1
RP/0/RP0/CPU0:Router(config-if)# exit
RP/0/RP0/CPU0:Router(config)# interface Bundle-Ether 1.1
RP/0/RP0/CPU0:Router(config-subif)# dot1q vlan 10
RP/0/RP0/CPU0:Router(config-subif)# ip addr 10.2.3.4/24
RP/0/RP0/CPU0:Router(config-subif)# no shutdown
RP/0/RP0/CPU0:Router(config-subif)# exit
RP/0/RP0/CPU0:Router(config)# interface Bundle-Ether 1.2
RP/0/RP0/CPU0:Router(config-subif)# dot1q vlan 20
RP/0/RP0/CPU0:Router(config-subif)# ip addr 20.2.3.4/24
RP/0/RP0/CPU0:Router(config-subif)# no shutdown
RP/0/RP0/CPU0:Router(config-subif)# exit
RP/0/RP0/CPU0:Router(config)#interface gig 0/1/5/7
RP/0/RP0/CPU0:Router(config-if)# bundle-id 1 mode act
RP/0/RP0/CPU0:Router(config-if)# commit
RP/0/RP0/CPU0:Router(config-if)# exit
RP/0/RP0/CPU0:Router(config)# exit
RP/0/RP0/CPU0:Router # show vlan trunks
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-236 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
Configuration Examples for Link Bundling
The following example shows how to configure all egressing traffic on the fixed members of a bundle to
flow through a specified physical member link.
RP/0/RP0/CPU0:router# configuration terminal
RP/0/RP0/CPU0:router(config)# interface bundle-ether 1.1 l2transport
RP/0/RP0/CPU0:router(config-subif)# bundle load-balancing hash 1
RP/0/RP0/CPU0:router(config-subif)#
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-237
Configuring Link Bundling on Cisco IOS XR Software
Configuration Examples for Link Bundling
The following example shows how to configure custom LACP short period transmit and receive intervals
to less than the default of 1000 milliseconds (1 second):
Router A
config
interface gigabitethernet 0/0/0/1
bundle id 1 mode active
lacp period short
commit
Router B
config
interface gigabitethernet 0/0/0/1
bundle id 1 mode active
lacp period short
commit
Router A
config
interface gigabitethernet 0/0/0/1
lacp period short transmit 100
commit
Router B
config
interface gigabitethernet 0/0/0/1
lacp period short transmit 100
commit
Router A
config
interface gigabitethernet 0/0/0/1
lacp period short receive 100
commit
Router B
config
interface gigabitethernet 0/0/0/1
lacp period short receive 100
commit
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-238 OL-26055-03
Configuring Link Bundling on Cisco IOS XR Software
Additional References
Additional References
The following sections provide references related to link bundle configuration.
Related Documents
Related Topic Document Title
Cisco IOS XR master command reference Cisco IOS XR Master Commands List
Cisco IOS XR interface configuration commands Cisco IOS XR Interface and Hardware Component Command
Reference
Initial system bootup and configuration information for Cisco IOS XR Getting Started Guide
a router using the Cisco IOS XR software.
Information about user groups and task IDs Cisco IOS XR Interface and Hardware Component Command
Reference
Standards
Standards Title
IEEE 802.3ad (incorporated as Annex 43 into —
802.3-2002)
MIBs
MIBs MIBs Link
The IEEE-defined MIB for Link Aggregation (defined To locate and download MIBs for selected platforms using
in 802.3 Annex 30C) Cisco IOS XR Software, use the Cisco MIB Locator found at the
following URL:
http://cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml
RFCs
RFCs Title
No new or modified RFCs are supported by this —
feature, and support for existing RFCs has not been
modified by this feature.
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
OL-26055-03 HC-239
Configuring Link Bundling on Cisco IOS XR Software
Additional References
Technical Assistance
Description Link
The Cisco Technical Support website contains http://www.cisco.com/techsupport
thousands of pages of searchable technical content,
including links to products, technologies, solutions,
technical tips, and tools. Registered Cisco.com users
can log in from this page to access even more content.
Cisco IOS XR Interface and Hardware Component Configuration Guide for the Cisco CRS Router
HC-240 OL-26055-03