cfglnagg command
Purpose
Add or remove adapters from a Link Aggregation or change Link Aggregation attributes.
Syntax
cfglnagg {-add [-backup] | -rm} [-parent ParentName] LinkAggregation Adapter
cfglnagg [-f ] [-parent ParentName] -attr Attribute=NewValue ... LinkAggregation
Description
This command adds adapters to a Link Aggregation or removes adapters from a Link Aggregation. This command can also be used to modify Link Aggregation attributes. It is not necessary to detach the Link Aggregation's interface to add or remove adapters or modify most Link Aggregation attributes.
Changing the use_jumbo_frame attribute requires the Link Aggregation to be detached. If this attribute is specified, the cfglnagg command detaches the Link Aggregation before modifying the use_jumbo_frame attributes, then brings the Link Aggregation back up. The user is prompted to continue unless the -f flags is specified.
Use the lsdev command with the -attr flag to view all attributes associated with a Link Aggregation device, including adapters.
The failover occurs only if the adapter in the idle channel is up. If the adapter in the idle channel is down, the Link Aggregation operates on the active one and no failover occurs.
Flags
| Flag name | Description |
|---|---|
| -add | Adds the specified Adapter to the specified Link Aggregation. If the adapter must be added as a backup adapter, the -backup flag must be specified. |
| -attr | Changes the value of the LinkAggregation attribute to the NewValue attribute. |
| -backup | Specifies that the Adapter is being added as a backup adapter. |
| -f | Instructs the command not to prompt you. |
| -failover | Forces a failover of the specified Link Aggregation. |
| -parent | Specifies the name of the parent adapter (for example, SEA). |
| -rm | Deletes the specified Adapter from the specified Link Aggregation. The specified adapter can be either a primary or backup adapter. |
Parameters
| Parameter | Description |
|---|---|
| Adapter | Specifies the adapter to add or delete. |
| LinkAggregation | Specifies the Link Aggregation. |
| ParentName | Specifies the parent name of the Link Aggregation adapter. |
Exit Status
Examples
- To add adapter ent8 to Link Aggregation ent3, type
the following command:
cfglnagg -add ent3 ent8 - To force a failover of the Link Aggregation adapter ent7 from
the currently active channel to the idle channel, type the following
command:
cfglnagg -failover ent7
