To assign and configure a physical interface to an EtherChannel, use
the
channel-group command. To remove the channel
group configuration from the interface, use the
no form of this command.
channel-group number [force] [ mode { active | on | passive } ]
no channel-group [number]
Syntax Description
|
number
|
Number of channel group. The
number range is from 1 to 4096. Cisco NX-OS creates
the EtherChannel associated with this channel group if the EtherChannel does
not already exist.
|
|
force
|
(Optional) Specifies that the LAN port be forcefully added
to the channel group.
|
|
mode
|
(Optional) Specifies the EtherChannel mode of the
interface.
|
|
active
|
Specifies that when you enable the Link Aggregation Control
Protocol (LACP), this command enables LACP on the specified interface. The
interface is in an active negotiating state, in which the port initiates
negotiations with other ports by sending LACP packets.
|
|
on
|
This is the default channel mode. Specifies that all
EtherChannels that are not running LACP remain in this mode. If you attempt to
change the channel mode to active or passive before enabling LACP, the switch
returns an error message.
After you enable LACP globally, by using the
feature
lacp command, you enable LACP on each
channel by configuring the channel mode as either active or passive. An
interface in this mode does not initiate or respond to LACP packets. When an
LACP attempts to negotiate with an interface in the on state, it does not
receive any LACP packets and becomes an individual link with that interface; it
does not join the channel group.
The default mode is
on .
|
|
passive
|
Specifies that when you enable LACP, this command enables
LACP only if an LACP device is detected. The interface is in a passive
negotiation state, in which the port responds to LACP packets that it receives
but does not initiate LACP negotiation.
|
Command Modes
Interface configuration mode
Command History
|
Release
|
Modification
|
|
7.0(1)N1(1)
|
This command was introduced.
|
Usage Guidelines
Use this command to create a channel group that includes the
interface that you are working on and to add or remove specific interfaces from
the channel group. Use this command to move a port from one channel group to
another. You enter the channel group that you want the port to move to; the
switch automatically removes the specified port from its present channel group
and adds it to the specified channel group.
Use the
force keyword to force the addition of the
interface into the specified channel group.
After you enable LACP globally, by using the
feature
lacp command, you enable LACP on each channel by
configuring the channel mode as either
active or
passive . An EtherChannel in the
on channel mode is a pure EtherChannel and
can aggregate a maximum of eight ports. The EtherChannel does not run LACP.
You cannot change the mode for an existing EtherChannel or any of its
interfaces if that EtherChannel is not running LACP; the channel mode remains
as
on . The system returns an error message if
you attempt to change the mode.
Use the
no form of this command to remove the
physical interface from the EtherChannel. When you delete the last physical
interface from an EtherChannel, the EtherChannel remains. To delete the
EtherChannel completely, use the
no form of the
interface
port-channel command.
The compatibility check includes the following operational
attributes:
Use the
show
port-channel
compatibility-parameters command to see the full
list of compatibility checks that Cisco NX-OS uses.
You can only add interfaces configured with the channel mode set to
on for static EtherChannels, that is, without
a configured aggregation protocol. You can only add interfaces configured with
the channel mode as
active or
passive to EtherChannels that are running
LACP.
You can configure these attributes on an individual member port. If
you configure a member port with an incompatible attribute, Cisco NX-OS
suspends that port in the EtherChannel.
When the interface joins an EtherChannel, some of its individual
parameters are overridden with the values on the EtherChannel, as follows:
Interface parameters, such as the following, remain unaffected when
the interface joins or leaves a EtherChannel:
If interfaces are configured for the EtherChannel interface and a
member port is removed from the EtherChannel, the configuration of the
EtherChannel interface is not propagated to the member ports.
Any configuration changes that you make in any of the compatibility
parameters to the EtherChannel interface are propagated to all interfaces
within the same channel group as the EtherChannel (for example, configuration
changes are also propagated to the physical interfaces that are not part of the
EtherChannel but are part of the channel group).
Examples
This example shows how to add an interface to LACP channel group 5 in
active mode:
switch(config)#interface ethernet 1/1
switch(config-if)#channel-group 5 mode active
switch(config-if)#
This example shows how to forcefully add an interface to the channel
group 5:
switch(config)#interface ethernet 1/1
switch(config-if)#channel-group 5 force
switch(config-if)#
Feedback