06-Interface collaboration commands
Chapters Download (69.36 KB)
Use collaboration-group to create a collaboration group and enter its view, or enter the view of an existing collaboration group.
Use undo collaboration-group to delete a collaboration group.
Syntax
collaboration-group group-id
undo collaboration-group group-id
Default
No collaboration groups exist.
Views
System view
Predefined user roles
network-admin
context-admin
Parameters
group-id: Specifies a collaboration group ID. The value range for this argument is 1 to 16.
Usage guidelines
Interface collaboration assigns different interfaces on a device to a collaboration group and associates the states of these interfaces. All member interfaces in a collaboration group can or cannot transmit packets.
Collaboration groups take effect only when Monitor Link is enabled globally.
You must remove all member interfaces from a collaboration group before deleting the collaboration group.
Examples
# Create collaboration group 1 and enter its view.
<Sysname> system-view
[Sysname] collaboration-group 1
[Sysname-collaboration-group1]
Use collaboration-group clean to remove ineffective member interfaces from all collaboration groups.
Syntax
collaboration-group clean
Views
System view
Predefined user roles
network-admin
context-admin
Usage guidelines
A member interface in a collaboration group becomes ineffective when the card that hosts the interface is removed or changed to another slot. This command prevents an ineffective interface from causing all other member interfaces in the same collaboration group to go down.
An ineffective interface becomes effective and is automatically assigned to the original collaboration group when its hosting card is reinstalled or changed back to the original slot.
Examples
# Remove ineffective member interfaces from all collaboration groups.
<Sysname> system-view
[Sysname] collaboration-group clean
Use display collaboration-group to display information about collaboration groups.
Syntax
display collaboration-group { group-id | all } [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
context-admin
context-operator
Parameters
group-id: Specifies a collaboration group by its ID. The value range for this argument is 1 to 16.
all: Specifies all collaboration groups.
verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information.
Examples
# Display brief information about all collaboration groups.
<Sysname> display collaboration-group all
Group ID Group status
1 DOWN
2 DOWN
# Display detailed information about all collaboration groups.
<Sysname> display collaboration-group all verbose
Collaboration group protocol status: Enabled
Collaboration group 1 information:
Group status : DOWN
Member up delay : 0 seconds
Last up time : 16:55:34 2017/04/05
Last down time : 16:57:22 2017/04/05
Member Status
GE1/2/5/1 DOWN
GE1/2/5/2 Collaboration-down
Table 1 Command output
|
Field |
Description |
|
Group status |
Collaboration group status: · DOWN. · UP. · N/A—Monitor Link is disabled globally. The collaboration group does not take effect. · UP-Pending—The collaboration group is transitioning from DOWN to UP. It takes 10 seconds for the system to determine the collaboration group state (DOWN or UP). |
|
Collaboration group protocol status |
Whether interface collaboration is enabled globally: · Enabled. · Disabled. |
|
Member up delay |
Delay time for the member interfaces in the collaboration group to come up after a device restart, in seconds. |
|
Last up time |
Last time when the collaboration group came up. |
|
Last down time |
Last time when the collaboration group went down. |
|
Member |
Member interfaces of the collaboration group. |
|
Status |
Member interface status: · UP—The interface is up. · DOWN—The interface is down. To identify cause, use the display interface command. · Collaboration-down—The interface is shut down by interface collaboration. · Not available—The interface is ineffective because the hosting card is not in position. |
Use port to assign an interface to a collaboration group.
Use undo port to remove an interface from a collaboration group.
port interface-type interface-number
undo port interface-type interface-number
Default
No member interfaces exist in a collaboration group.
Views
Collaboration group view
Predefined user roles
network-admin
context-admin
Parameters
interface-type interface-number: Specifies an interface by its type and number.
Usage guidelines
You can assign an interface to only one collaboration group.
For a collaboration group to work correctly, do not assign its member interfaces to a redundancy group.
Do not add both Selected ports and Unselected ports in a dynamic aggregation group to the same collaboration group.
If you have configured a member interface as the uplink/downlink interface of a monitor link group, do not configure any other member interface in the same collaboration group as the downlink/uplink interface of any monitor link group.
You can also assign an interface to a collaboration group by using the port collaboration-group command in interface view.
Examples
# Assign GigabitEthernet 1/2/5/1 to collaboration group 1.
[Sysname] collaboration-group 1
[Sysname-collaboration-group1] port gigabitethernet 1/2/5/1
port collaboration-group
Use port collaboration-group to assign the current interface to a collaboration group.
Use undo port collaboration-group to remove the current interface from a collaboration group.
Syntax
port collaboration-group group-id
undo collaboration-group group-id
Default
The interface is not a collaboration group member.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Layer 2 aggregate interface view
Layer 3 aggregate interface view
Predefined user roles
network-admin
context-admin
Parameters
group-id: Specifies a collaboration group by its ID. The value range for this argument is 1 to 16.
Usage guidelines
You can assign an interface to only one collaboration group.
To assign an interface to a collaboration group by using this command, make sure the collaboration group have been created.
For a collaboration group to work correctly, do not assign its member interfaces to a redundancy group.
Do not add both Selected ports and Unselected ports in a dynamic aggregation group to the same collaboration group.
If you have configured a member interface as the uplink/downlink interface of a monitor link group, do not configure any other member interface in the same collaboration group as the downlink/uplink interface of any monitor link group.
You can also assign an interface to a collaboration group by using the port command in collaboration group view.
Examples
# Assign GigabitEthernet 1/2/5/1 to collaboration group 1.
[Sysname] collaboration-group 1
[Sysname-collaboration-group1] quit
[Sysname] interface gigabitethernet 1/2/5/1
[Sysname-GigabitEthernet1/2/5/1] port collaboration-group 1
Related commands
port
Use up-delay to set the delay time for the member interfaces in a collaboration group to come up after a device restart.
Use undo up-delay to restore the default.
Syntax
up-delay delay
undo up-delay
Default
The delay time is 0 seconds. The member interfaces come up as soon as the device restarts.
Views
Collaboration group view
Predefined user roles
network-admin
context-admin
Parameters
delay: Specifies the delay time in the range of 1 to 3600 seconds.
Usage guidelines
This command enables the member interfaces to come up after a configurable delay time upon a device restart.
Examples
# Set the delay time to 10 seconds for the member interfaces in collaboration group 1.
<Sysname> system-view
[Sysname] collaboration-group 1
[Sysname-collaboration-group1] up-delay 10
