Index for Section 8

Alphabetical listing for L

Bottom of page

lagconfig(8)
NAME
  lagconfig - 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
  -c  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:

      lag=interface-id
	  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.

      key=value
	  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.

      dist={dstip|dstmac|port|roundrobin}
	  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.

      macaddr=address
	  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.

  -p port
      Enables the specified port (or physical interface) for link
      aggregation.  You must also specify one of the following attributes:

      lag=interface-id
	  Specifies the link aggregation group virtual interface name in the
	  form lagn, where n is the unit number (for example, lag1).

      key=value
	  Specifies the link aggregation group virtual interface to which to
	  add the port by the key assigned to it.

  -d port
      Deletes the specified port or interface from a link aggregation group.

  -s lag=interface-id
      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 single
  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 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.

EXAMPLES
   1.  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

   2.  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.

   3.  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

   4.  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
  lagconfig: subsystem error: Invalid argument
      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

Index for Section 8

Alphabetical listing for L

Top of page