lagconfig man page on Tru64

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
Tru64 logo
[printable version]

lagconfig(8)							  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
       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)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Tru64

List of man pages available for Tru64

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net