ethchan_config Command

Purpose

Adds adapters to an EtherChannel or removes adapters from an EtherChannel.

Syntax

ethchan_config { -a [ -b ] | -d } [ -p ParentName ] EtherChannel Adapter

ethchan_config -c [ -p ParentName ] EtherChannel Attribute NewValue

ethchan_config -f [ -p ParentName ] EtherChannel

Description

This command adds adapters to an EtherChannel or removes adapters from an EtherChannel. This command can also be used to modify EtherChannel attributes. These additions, deletions, or modifications can take place even if the EtherChannel's interface is configured; that is, it is not necessary to detach the interface of EtherChannel to add or remove adapters or modify most EtherChannel attributes.

Flags

Item	Description
-a	Adds the specified Adapter to the specified EtherChannel. If the adapter must be added as a backup adapter, the -b flag must be specified.
-b	Specifies that the Adapter is being added as a backup adapter. This flag is only valid when used with the -a flag.
-c	Changes the specified Attribute of the specified EtherChannel attribute to the specified NewValue.
-d	Deletes the specified Adapter from the specified EtherChannel. The -b flag must not be used with the -d flag.
-f	Forces a failover of the specified EtherChannel. The failover occurs only if the adapter in the idle channel is up. If the adapter in the idle channel is down, the EtherChannel keeps operating on the active one and no failover takes place.
-p	Specifies the parent adapter of an EtherChannel. If a Shared Ethernet Adapter (SEA) is configured over an EtherChannel, this flag must be used along with the other flags to change any attribute of the EtherChannel (for example, adding or deleting adapters).

Parameters

Item	Description
Adapter	Specifies the adapter to add or delete.
Attribute	Specifies an attribute of the specified EtherChannel.
EtherChannel	Specifies the EtherChannel.
NewValue	Specifies the new value for the specified attribute of the specified EtherChannel.
ParentName	Specifies the parent adapter of an EtherChannel.

Exit Status

Item	Description
0	The command completed successfully.
>0	An error occurred.

Examples

To add the adapter ent0 as the backup adapter in the EtherChannel called ent7, enter the following command:
```
/usr/lib/methods/ethchan_config -a -b ent7 ent0
```
To change the address to ping attribute of an EtherChannel called ent7 to 10.10.10.10, enter the following command:
```
/usr/lib/methods/ethchan_config -c ent7 netaddr 10.10.10.10
```
To force a failover of an EtherChannel called ent7 from the currently active channel to the idle channel, enter the following command:
```
/usr/lib/methods/ethchan_config -f ent7
```
To delete the adapter ent13 from an EtherChannel called ent18, which belongs to an SEA called ent32, enter the following command:
```
/usr/lib/methods/ethchan_config -d -p ent32 ent18 ent13
```

Restrictions

The use of the use_jumbo_frame attribute cannot be modified by this command. If you attempt to modify this attribute, this command prints an error message.

Location

/usr/lib/methods