Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP Auto Port Aggregation Administrator's Guide: HP-UX 11.0, 11i v1, 11i v2 > Chapter 4 Using the lanadmin Command

Set Options

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

To manage link aggregates and add ports to a link aggregate, use the following syntax and options with the -X (uppercase) option:

lanadmin [-X -a portPPA [portPPA]]

[-X -c linkAggregatePPA]

[-X -d portPPA [portPPA]... linkAggregatePPA]

[-X -g portPPA group_capability anyLinkAggregatePPA]

[-X [–h | –H] anyLinkAggregatePPA]

[-X -k portPPA admin_key anyLinkAggregatePPA]

[-X -l load_balance_algorithm linkAggregatePPA ]

[-X -o linkAggregatePPA]

[-X -p portPPA config_mode anyLinkAggregatePPA]

[-X -s portPPA system_priority anyLinkAggregatePPA]

[-X -t portPPA port_priority anyLinkAggregatePPA]

[-X -y on|off linkAggregatePPA]

Where:

-a

-X -a portPPA [portPPA]... linkAggregatePPA

Adds a port or ports with the specified portPPA to the link aggregate with the specified linkAggregatePPA number.

CAUTION: Be careful when using the -a suboption. This might lead to an invalid link aggregate. This command gives you full control over forming any link aggregate that you want.

-c

-X -c linkAggregatePPA

Clears (removes all) ports from a link aggregate with the specified linkAggregatePPA number. This option fully deconfigures the link aggregate. After removal from a link aggregate, the port's mode is set to MANUAL. The Administrative Key (LACP) or group_capability (FEC_AUTO and MANUAL) is not changed.

-d

-X -d portPPA [portPPA]... linkAggregatePPA

Deletes ports with the specified PPAs from the link aggregate with the specified linkAggregatePPA number.

CAUTION: Failure to fully deconfigure a link aggregate (using the the -c suboption) can result in some properties being retained in the link aggregate. Subsequently, when new ports are added onto the link aggregate, they might not aggregate properly.

-g

-X -g portPPA group_capability anyLinkAggregatePPA

Sets the group capability for a port with the specified portPPA. Ports going to different link aggregates should have different group capabilities. The valid values for group_capability are integer numbers starting at 0. This is applicable to MANUAL and FEC_AUTO ports.

-h

-X -h anyLinkAggregatePPA

Displays the -X and -x options help screen.

-H

-X -H anyLinkAggregatePPA

Displays the extended -X and -x options help screen, which includes a detailed description and syntax of the -X and -x options.

-k

-X -k portPPA admin_key anyLinkAggregatePPA

Sets the Administrative Key for an LACP_AUTO port or LACP_AUTO link aggregate. Applies to LACP_AUTO only. An Administrative Key and Operational Key are associated with each port. The Operational Key is used for forming aggregations in autonegotiation. The Administrative Key can be set at anytime. At the port level, the Operational Key only copies the Administrative Key value when the LACP protocol is not running. At the link aggregate level, the Operational Key only copies the Administrative Key when the link aggregate is not configured (no ports have joined the link aggregate).

For example: An LACP_AUTO port is in an aggregation. The admin_key and oper_key are 1234. Use lanadmin -X -k admin_key anyLinkAggregatePPA to modify the admin_key to 5432. The oper_key is not changed immediately. You must stop LACP_AUTO for the port and then restart it for both keys to have the new value of 5432.

-l

-X -l load_balance_algorithm linkAggregatePPA

Sets the load-balancing algorithm for a link aggregate with the specified linkAggregatePPA number.

The following choices are valid for load_balance_algorithm:

  • LB_MAC

  • LB_IP

  • LB_PORT

For a description of these parameters, see the load distribution algorithms in “Link Aggregate Advanced Parameters”.

-o

-X -o linkAggregatePPA

Clears data flows for a link aggregate specified by linkAggregatePPA. This rebalances the link aggregate outbound traffic across the ports in the link aggregate.

-p

-X -p portPPA config_mode anyLinkAggregatePPA

Sets mode for a port with the specified portPPA number. The following values are valid:

  • LACP_AUTO

  • FEC_AUTO

  • MANUAL

  • LAN_MONITOR

For a description of these parameters, see the mode descriptions in “Preparing for Configuration”.

-s

-X -s portPPA system_priority anyLinkAggregatePPA

Sets the system priority for an LACP_AUTO port. The default value is 0. This has no affect on a MANUAL or FEC_AUTO port.

-t

-X -t portPPA port_priority anyLinkAggregatePPA

Sets the port_priority for the port with the specified PPA Number. For LACP_AUTO, this sets the priority value for the port. The lanapplyconf command assigns port priority according to settings in lanconfig.ascii. You can change the priority of primary and standby ports, but the primary port should have a higher priority. By default a primary port is 5; standby is 3. This option is not applicable to PAgP. If the port is not in a standalone state, attempting to set the port priority will fail. Check the port status using the lanadmin -x -p command.

The valid values for port_priority are integral numbers starting at 0.

For HOT_STANDBY: The bigger the number, the higher the priority.

For LACP ports: The smaller the number, the higher the priority.

-y

-X -y on | off linkAggregatePPA

Turns Hot Standby on or off for the link aggregate with the specified linkAggregatePPA number. For a description of Hot Standby, see the load distribution algorithms in “Link Aggregate Advanced Parameters” and the the description of HP_APA_HOT_STANDBY in “hp_apaconf File”.

Turn on sets link aggregate load-balancing mode to LB_HOT_STANDBY. Turn off sets link aggregate load-balancing mode to LB_MAC.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2007 Hewlett-Packard Development Company, L.P.