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 11i v3 > Appendix B HP APA Configuration Files

lanconfig.ascii File

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

Example B-1 shows a sample /etc/lanmon/lanconfig.ascii ASCII configuration file. This file contains configuration information that LAN Monitor uses for failover groups.

Example B-1 Sample lanconfig.ascii Configuration File

#***********************************************
#******* LAN MONITOR CONFIGURATION FILE
#*** For complete details about the parameters and how
#*** to set them, consult the lanqueryconf(1m) manpage
#*** or your manual.
#*** All timeout values are microseconds; they are rounded up
#*** or down appropriately.
#***********************************************************

#***********************************************
# The valid range for POLLING_INTERVAL: 500,000-10,000,000 usec
# Default value for POLLING_INTERVAL: 10,000,000 usec  
# Minimum value for DEAD_COUNT: 2  
# Default value for DEAD_COUNT: 3  
#**********************************************
POLLING_INTERVAL                10000000
DEAD_COUNT                      3
#***********************************************  
# By default, LM_RAPID_ARP is on.  
# If LM_RAPID_ARP is on, the valid ranges are:  
# LM_RAPID_ARP_INTERVAL: 1000000-4000000 (default:1000000 usec  
# LM_RAPID_ARP_COUNT:    5 - 60          (default is 10) 
# (LM_RAPID_ARP_INTERVAL * LM_RAPID_ARP_COUNT) <= 60s  
#**********************************************
LM_RAPID_ARP                    off
LM_RAPID_ARP_INTERVAL           1000000
LM_RAPID_ARP_COUNT              10
# ****************************************************************
#                            Note:                              **
#                                                               **
# In Proactive Failover, the active port of a fail-over group   **
# is the port with the minimum normalized port cost. This means **
# a fail-over group will change its active port to a ready port **
# having a lower normalized port cost, even when the current    **
# active port remains up. You must use cost-based fail-over     **
# groups in order to get the Proactive Failover behavior.       **
#                                                               **
# To define a cost-based fail-over group, all the ports in the  **
# fail-over group must have a cost defined. Cost has a valid    **
# range of between 1 and 100, inclusive. The value must be      **
# preceded by a colon (:) character.                            **
#                                                               **
# If one of the ports in a fail-over group does not have a cost **
# defined, the fail-over group is invalid.                      **
#                                                               **
# If all ports in a fail-over group have no cost defined, the   **
# default failover behavior is used. The available port with    **
# the highest priority becomes the active port.                 **
#                                                               **
# By default, the lanqueryconf -s command creates only          **
# priority-based fail-over groups.                              **
#                                                               **
# Example with cost defined:                                    **
#   FAILOVER_GROUP  lan903                                      **
#   STATIONARY_IP   195.55.55.55                                **
#   # Pri/Stdby       I/f    Pri    Cost                        **
#   PRIMARY         lan900    7      : 1                        **
#   STANDBY         lan901    6      : 2                        **
#                                                               **
# For more information on how to use proactive fail-over, see   **
# the HP Auto Port Aggregation Administrator's Guide at         **
# http://docs.hp.com.                                           **
# ****************************************************************
FAILOVER_GROUP                  lan900
        STATIONARY_IP   193.33.33.33
        STANDBY         lan9    3
        PRIMARY         lan6    5

FAILOVER_GROUP                  lan901
        STATIONARY_IP   195.55.55.55
        PRIMARY         lan4    5
        STANDBY         lan1    3
        STANDBY         lan2    3
        STANDBY         lan3    3

FAILOVER_GROUP                  lan902
        STATIONARY_IP   fe80::2
        PRIMARY         lan11   5
        STANDBY         lan10   3

The lanconfig.ascii configuration file contains the following fields:

FAILOVER_GROUP

The name for a single LAN Monitor failover group. You must specify a name for each LAN Monitor failover group on the system. If the group consists of multiple ports (multiple PPAs), the name format is lan9XX, where XX is a decimal number starting with 00 (for example, lan900).

Each FAILOVER_GROUP can have the following keywords:

STATIONARY_IP

The IPv4 or IPv6 address dedicated to the failover group. This is a required field; you must set it for each failover group before running lanapplyconf.

PRIMARY

Specifies the active port for the FAILOVER_GROUP.

Each failover group must have one port. This port is typically assigned the highest priority or lowest cost value so it will be the port that initially carries traffic. The port can also have IP addresses configured. After lanapplyconf creates the failover group, the IP addresses on the port (if present) are moved to the failover group.

In previous versions of HP APA, the port must have IP address configured and must be the highest priority or lowest cost. In the HP-UX 11i v3 version of HP APA, you can assign the port any priority or cost values. You also need not configure an IP address on it.

HP recommends that you always assign the port the highest priority or the lowest cost in a failover group.

STANDBY

Specifies a standby port for the FAILOVER_GROUP. A standby port is a port that replaces the active port when the active is incapable of carrying traffic. Specify this keyword only if the failover group has more than one port. A failover group must have one or more standby ports.

Both the PRIMARY and STANDBY keywords have the following fields:

  • The LAN interface name (for example, lan0 and lan1).

  • The port priority that will be assigned to the port. The port with the highest priority is the port.

  • A cost value for the LAN interface preceded by a colon (:). This is an optional field. See “Proactive Failover” for more information.

POLLING_INTERVAL

The number of microseconds between polling messages. You can specify this keyword multiple times in the configuration file. A link aggregate's polling interval is set to the last specified interval. For a description of this parameter, see “Failover Group Advanced Parameters”.

DEAD_COUNT

The number of polling packets that are missed before LAN Monitor sends a nettl log message to the user that indicates the link might have problems and the network should be checked. For a description of this parameter, see “Failover Group Advanced Parameters”.

LM_RAPID_ARP

Enables (on) or disables (off) the ability to transmit gratuitous ARP messages at intervals shorter than 5 seconds. By default, LM_RAPID_ARP is off. For a description of this parameter, see “Failover Group Advanced Parameters”.

LM_RAPID_ARP_INTERVAL

The number of microseconds between rapid gratuitous ARP messages. If the value is out of the valid range and LM_RAPID_ARP is on, the interval value last processed with the lanapplyconf command is used. If LM_RAPID_ARP is off, this value is ignored for the corresponding failover group. For a description of this parameter, see “Failover Group Advanced Parameters”.

LM_RAPID_ARP_COUNT

The number of gratuitous ARP packets sent rapidly. If the value is not in the valid range and LM_RAPID_ARP is on, the count value last processed with the lanapplyconf is used. If LM_RAPID_ARP is off, this value is ignored for the corresponding failover group. For a description of this parameter, see “Failover Group Advanced Parameters”.

If you specify the POLLING_INTERVAL, DEAD_COUNT, LM_RAPID_ARP_INTERVAL, and LM_RAPID_ARP_COUNT fields once in the lanconfig.ascii file before all failover, the values apply to all failover groups. If you specify them multiple times in the file, the values apply only to those failover groups that follow these fields; you can set different values for failover groups.

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