hp_apaconf File

The /etc/rc.config.d/hp_apaconf file contains the following general HP APA configuration parameters for link aggregates. You must set each of the supported parameters on a specific link aggregate prior to aggregating any physical ports. All of the link aggregate configuration parameters begin with the prefix HP_APA_.

HP_APA_DEFAULT_PORT_MODE

The default way to configure link aggregates is through MANUAL port configuration mode. Ensure that switch ports and server ports are set to the same trunking mode (MANUAL or AUTO), duplex mode, and speed. Disable PAgP or LACP on any switch ports not intended to be used with APA. There are two variables governing the mode of ports:

HP_APA_DEFAULT_PORT_MODE in the /etc/rc.config.d/hp_apaconf file. Sets the default APA configuration mode for all ports. The recommended mode is MANUAL. The APA product is shipped with the entry in the hp_apaconf file set to: HP_APA_DEFAULT_PORT_MODE=MANUAL.
HP_APAPORT_CONFIG_MODE in the /etc/rc.config.d/hp_apaportconf file. Sets the APA configuration mode for a single port. This variable takes precedence.

A port's mode is set to the value of HP_APA_DEFAULT_PORT_MODE, unless you specify its mode using the HP_APAPORT_CONFIG_MODE variable.

Example 1:

If the configuration mode of a port is not set with HP_APAPORT_CONFIG_MODE and HP_APA_DEFAULT_PORT_MODE is not set, the port's configuration mode is MANUAL for HP-UX 11.0 and 11i v1, and FEC_AUTO for HP-UX 11i v2.

Example 2:

If the configuration mode of a port is not set with HP_APAPORT_CONFIG_MODE and HP_APA_DEFAULT_PORT_MODE is set to MANUAL, the port's configuration mode is MANUAL.

Example 3:

If the configuration mode of a port is set to FEC_AUTO with HP_APAPORT_CONFIG_MODE and HP_APA_DEFAULT_PORT_MODE is set to MANUAL, the port's configuration mode is FEC_AUTO.

HP_APA_GROUP_CAPABILITY

For FEC_AUTO (11i v1 and 11i v2) and MANUAL (11i v1) only. An integer value used to determine which network physical ports can be aggregated into a common PAgP link aggregate. Set the group capability to be the same for all network physical ports in the same link aggregate. Ports going to different link aggregates should have different group capabilities. This value must match the value of HP_APAPORT_GROUP_CAPABILITY in the /etc/rc.config.d/hp_apaportconf file.

HP_APA_HOT_STANDBY

Configure a link aggregate for Hot Standby mode. This parameter is mutually exclusive with the HP_APA_LOAD_BALANCE_MODE parameter. In addition, HP_APA_HOT_STANDBY takes precedence over the HP_APA_LOAD_BALANCE_MODE parameter. The permissible values are on and off. The default is off.




	CAUTION: For most versions of HP-UX, use lowercase text when specifying on or off for `HP_APA_HOT_STANDBY` in `/etc/rc.config.d/hp_apaconf`. Using uppercase text might cause errors. This does not apply to HP APA running on HP-UX 11i v2.

HP_APA_INTERFACE_NAME

Name of the link aggregate. For example, lan900 and lan901.

HP_APA_KEY

For LACP_AUTO only. An integer value that determines which network physical ports can be aggregated into a common LACP link aggregate. Set the key to be the same for all network physical ports in the same link aggregate. Ports going to different link aggregates should have different keys. Must match the value of HP_APAPORT_KEY in the /etc/rc.config.d/hp_apaportconf file.

HP_APA_LACP_SYSTEM_ID_MODE

For LACP_AUTO only, and for the May 2005 and later releases of HP APA for HP-UX 11i v1 (B.11.11.20), PHNE_33116 (B.11.11.17) patch release, and December 2005 and later releases of HP APA for HP-UX 11i v2 (B.11.23.10) only. Directs APA how to set up the LACP System ID. The supported values are as follows:

FIRST_APA_PORT: Sets the LACP System ID to the first supported HP APA port. This is the default.
FIRST_LACP_PORT: Sets the LACP System ID to the first active (UP) port that starts LACP.

HP_APA_LACP_TIMEOUT

For LACP_AUTO mode only. Specifies the length of the LACP timeout. This is also a global parameter. For a description of this parameter, see “Modifying HP APA Global Parameters”.

HP_APA_LOAD_BALANCE_MODE

Defines the load-balancing mode for the specified link aggregate (HP_APA_INTERFACE_NAME). The supported values are as follows:

LB_MAC
LB_IP
LB_PORT

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




	NOTE: Some IP applications might not have TCP/UDP port numbers, or the TCP/UDP port numbers are encrypted. For such cases, even if you choose LB_PORT, it will fall back to the default LB_MAC.

HP_APA_MANUAL_LA

Manually set ports for the specified link aggregate. Specify the ports with PPA numbers. Separate each port by a comma (,).

HP_APA_MAX_LINKAGGS

Sets the maximum number of link aggregates for the server. The valid range is from 5 to 50. The default value is 50. This value takes effect only after a reboot.

HP_APA_USE_SYSLOG

Enables (1) or disables (0) the logging of status messages to the syslog.log file (for example, when a link aggregate or port fails or comes up). The default value is 0. See Section for sample syslog.log messages and their meaning. For the May 2005 and later releases of HP APA for HP-UX 11i v1 (B.11.11.20), PHNE_33116 (B.11.11.17) patch release, and December 2005 and later releases of HP APA for HP-UX 11i v2 (B.11.23.10) only.

Examples

To set the load-balancing mode to port based (LB_PORT) on lan900:

HP_APA_INTERFACE_NAME[0]="lan900"
HP_APA_LOAD_BALANCE_MODE[0]="LB_PORT"
HP_APA_HOT_STANDBY[0]="off"

To create a manually formed link aggregate having ports with PPAs 2, 3, and 4:
HP_APA_INTERFACE_NAME[1]="lan900" HP_APA_LOAD_BALANCE_MODE[1]="LB_PORT" HP_APA_HOT_STANDBY[1]="off" HP_APA_MANUAL_LA[1]="2,3,4"
NOTE: Ensure that the server and switch are set to the same mode—MANUAL.

hp_apaconf File

Technical documentation

» Table of Contents

» Glossary

» Index

Examples