lagconfig(8)lagconfig(8)NAMElagconfig - Configures or displays link aggregation groups (or trunk
groups)
SYNOPSIS
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
OPTIONS
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 num‐
ber (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 distribu‐
tion algorithm to be used by the virtual interface for outbound traf‐
fic. 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 aggrega‐
tion 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).
DESCRIPTION
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 sin‐
gle virtual link. (Upper-layer 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 traf‐
fic 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 config‐
ure 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 traf‐
fic.
If a port fails in some way, the port detaches from the link aggrega‐
tion 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 inter‐
faces.
EXAMPLES
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 lag‐
config -p ee1 key=1
Note
Both ee0 and ee1 must be DOWN and not have an IP address config‐
ured 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
DIAGNOSTICS
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.
SEE ALSO
Commands: netstat(1), ifconfig(8), pfconfig(8), sysconfig(8)
Interfaces: lag(7)
System Attributes: sys_attrs_lag(5)
Network Administration: Connections
lagconfig(8)