unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



lagconfig(8)							 lagconfig(8)
Patchkit 5							   Patchkit 5



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 syn-
  tax:

  /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 inter-
	  face.

      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 aggrega-
      tion.  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	exam-
      ple, 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 distri-
  buted	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 (netcon-
  fig) 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 parame-
  ters 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 previ-
       ous 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 vir-
       tual 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