lagconfig - Configures or displays link aggregation groups
(or trunk groups)
For creating a link aggregation group, use the following
syntax: /usr/sbin/lagconfig -c [attribute,attribute,...]
For enabling a port for link aggregation, use the following
syntax: /usr/sbin/lagconfig -p port {lag=interface-id|
key=value}
For deleting a port from a link aggregation group, use the
following syntax: /usr/sbin/lagconfig -d port
For displaying a link aggregation group, use the following
syntax: /usr/sbin/lagconfig -s lag=interface-id
Creates a link aggregation group virtual interface. You
can specify the following attributes to this option. If
you specify more than one attribute, separate them with
commas: Specifies the link aggregation group virtual
interface name in the form lagn, where n is the unit number
(for example, lag1). By default, the next available
unit number is assigned to the interface. Specifies a
value with which to identify the link aggregation group
interface. By default, the key value is the next available
number. For example, if you previously created a link
aggregation group with a key of 4, the next time you create
a link aggregation group it is assigned a key of 5.
Specifies the distribution algorithm to be used by the
virtual interface for outbound traffic. The software can
distribute traffic based on destination IP address
(dstip), destination MAC address (dstmac) or transport
port number (port), or in a round robin fashion
(roundrobin). The default distribution algorithm is
dstip. See lag(7) for more information. Specifies the
Media Access Control (MAC) address to be assigned to the
link aggregation group interface. By default, the MAC
address of the first link aggregation port (interface) to
attach to the link aggregation group is used. Enables the
specified port (or physical interface) for link aggregation.
You must also specify one of the following
attributes: Specifies the link aggregation group virtual
interface name in the form lagn, where n is the unit number
(for example, lag1). Specifies the link aggregation
group virtual interface to which to add the port by the
key assigned to it. Deletes the specified port or interface
from a link aggregation group. Displays the
attributes for the specified link aggregation group. The
interface-id is in the form lagn, where n is the unit number
(for example, lag3).
The lagconfig command allows you to perform the following
tasks: Create link aggregation group virtual interfaces.
Enable a port (physical interface) for link aggregation.
Display attributes for a specified link aggregation group
virtual interface. Delete a port from a link aggregation
group.
Link aggregation, or trunking, enables administrators to
combine one or more physical Ethernet Network Interface
Cards (NICs) and create a single virtual link. (Upperlayer
software sees this link aggregation group as a single
virtual interface.) The single virtual link can carry
traffic at higher data rates than a single interface
because the traffic is distributed across all of the physical
ports that make up the link aggregation group.
If you want to enable a port for link aggregation, you
must not configure an IP address on the port, either
through the Network Setup Wizard (netconfig) or SysMan.
After you enable ports for link aggregation, you issue the
ifconfig up command to enable the link aggregation group
interface. The enabled ports then attach to the link
aggregation group that has the same key assigned to it and
are available to carry traffic.
If a port fails in some way, the port detaches from the
link aggregation group and traffic rerouted to the remaining
port or ports. A port also detaches when the system is
shut down.
The server or switch at the other end of a link aggregation
group must also be configured for link aggregation.
Modifications made with the lagconfig command do not persist
across reboots of the operating system. To configure
the interface or modify the parameters automatically each
time the system is booted, edit the inet.local file and
add the lagconfig command and ifconfig command entries to
it.
Any user can query the status of a link aggregation group;
only the superuser can create and modify the configuration
of network interfaces.
To create the link aggregation group virtual interface
lag0 with key value 1 and transport port-based distribution,
enter: lagconfig -c lag=lag0,key=1,dist=port To add
ee0 and ee1 to the link aggregation group created in the
previous step, enter: lagconfig -p ee0 key=1 lagconfig -p
ee1 key=1
Note
Both ee0 and ee1 must be DOWN and not have an IP
address configured prior to issuing the lagconfig
-p commands. To display information about the link
aggregation group, enter: lagconfig -s lag=lag0
lag0: Attached Interfaces: ( ee3 ee2 ee1 ee0 )
key = 1
Max ports = 8
dist = port To configure an IP address
10.1.2.3 on the link aggregation group virtual
interface lag0 and bring the interface up, enter:
ifconfig lag0 10.1.2.3 up
You attempted to add a port (interface) to a link aggregation
group and the port is UP. Mark the interface DOWN
with the ifconfig command and try to add the port again.
Commands: netstat(1), ifconfig(8), pfconfig(8), sysconfig(8)
Interfaces: lag(7)
System Attributes: sys_attrs_lag(5)
Network Administration: Connections
lagconfig(8)
[ Back ] |
