PRIMECLUSTER Global Link Services Configuration and Administration Guide: Redundant Line Control Function 4.1 (for Solaris(TM) Operating System)

7.7 hanetpoll Command

[Name]

hanetpoll - Setting, modifying, deleting, and displaying the monitoring destination information for the Router/HUB monitoring function

[Synopsis]

/opt/FJSVhanet/usr/sbin/hanetpoll command [args]

[Feature description]

The hanetpoll command sets the monitoring destination information required for the Router/HUB monitoring function. This command also modifies, deletes, displays, enables, or disables the settings.

command	Process outline	Authority
create	Creates monitoring destination information	Super user
copy	Copies monitoring destination information (synchronous switch)	Super user
print	Displays monitoring destination information	General user
modify	Modifies monitoring destination information	Super user
delete	Deletes monitoring destination information	Super user
on	Enabling the Router/HUB monitoring function	Super user
off	Disabling the Router/HUB monitoring function	Super user

(1) create command

The operation of the router/HUB monitoring function requires the definition of monitoring destination information. Use the create command to define monitoring destination information.

/opt/FJSVhanet/usr/sbin/hanetpoll create -n devicename -p polladdress1[,polladdress2] [-b {on | off}]

-n devicename:

Specify the name of a virtual interface to be monitored. Specify a virtual interface created using the hanetconfig create command or the hanetconfig copy command. No logical virtual interface name can be specified.

-p polladdress1[,polladdress2]:

Specify a monitor-to host name or IP address. Specify a monitor-to host name or IP address to "polladdress1" when activating a Primary interface. Specify a monitor-to host name or IP address to "polladdress2" when activating a Secondary interface. When Primary and Secondary interfaces monitor the same thing, or when a Secondary interface is not defined (a single case), omit "polladdress2". In RIP mode, specify a host name or an IP address of an adjacent router. In NIC switching mode, specify a host name or an IP address of the connected HUB. It is also possible to set IPv4 or IPv6 addresses as an address form. When setting an IPv6 address, do not specify a prefix value. When specifying a host name, do not use the same name that exists in IPv4 and IPv6. If the same name exists, it is dealt with as an IPv6 host.

-b on | off:

If two HUBs are specified as monitoring destinations in NIC switching mode, communication between the primary and secondary HUBs can be monitored.

on: Monitors communication between two HUBs.
off: Does not monitor communication between two HUBs.

(2) copy command

Use this command when copying monitoring target's information to a virtual interface on NIC Switching mode or when synchronizing the switching operation of virtual interface.
This command thus allows monitoring destination information to be automatically created by using the copy source information and without requiring you to specify monitoring destination information and HUB-to-HUB monitoring mode. This command realizes simpler operation than directly executing the hanetpoll create command. The following is the command format for the copy command:

/opt/FJSVhanet/usr/sbin/hanetpoll copy -n devicename1,devicename2

If you have used tagged VLAN interface on NIC Switching mode and created more than one virtual interface, which have disparate network address, you must keep in account that multiple IP address cannot be configured as monitoring target on Switch/HUB running VLAN. In such a case, it is possible to implement synchronous switching in between virtual interfaces using the same physical interface. This allows a virtual interface, which does not have the IP address for monitoring target to perform fail back operation by synchronizing with a virtual interface, which already has the existing monitoring target. In order to synchronize the switching operation of virtual interface, use the "copy" command (it is possible to specify disparate network addresses).

-n devicename1,devicename2:

Specify the names of virtual interfaces from and to which monitoring destination information should be copied.

devicename1:

Specify the name of a virtual interface that is set in monitoring information in the copy source.

devicename2:

Specify the name of a new virtual interface to be monitored. Specify a virtual interface created using the hanetconfig create command or the hanetconfig copy command. No logical virtual interface name can be specified.

(3) print command

Use the print command to display the current monitoring destination information. Use this command to view the current monitoring destination information. The following is the format of the print command.

/opt/FJSVhanet/usr/sbin/hanetpoll print [-n devicename1[,devicename2,...]]

-n devicename1[,devicename2,...]:

Specify the names of virtual interfaces whose monitoring destination information should be displayed. If this option is not specified, the print command displays all the monitoring destination information currently specified.

The following shows an example of displaying information without any option specified.

Item		Explanation
Standard Polling Parameter		Common monitoring information
Polling Parameter of each interface		Each monitoring information
Name		Displays the name of a virtual interface to be monitored.
Hostname		Displays the host name or IP address to be monitored, in the order of the primary and secondary monitoring destinations.
hub-hub poll		Displays the inter-HUB monitoring status.
hub-hub poll	ON	The monitoring function is enabled.
	OFF	The monitoring function is disabled.
	---	The monitoring function is not used.
interval(idle)	interval	Displays the monitoring interval in the stationary status.
	idle	Displays in seconds the wait time that elapses after monitoring starts and before the HUB links up.
times		Displays the monitoring count.
max_retry		Displays the consecutive failure occurrence count before failure notification.
repair_time		Displays the recovery monitoring interval in seconds.
failover mode		With or without cluster switching when an error occurred in all transfer routes.
failover mode	YES	Node switching is performed when the virtual interface is registered in the cluster resource.
	NO	No node switching is performed.

(4) modify command

Use the modify command to modify the monitoring destination information.

/opt/FJSVhanet/usr/sbin/hanetpoll modify -n devicename {[-p polladdress1[,polladdress2]] [-b {on | off}]}

-n devicename:

Specify the name of a virtual interface whose monitoring destination information should be modified. Specify a virtual interface whose monitoring destination information is currently defined.

-p polladdress1[,polladdress2]:

Specify the host names or IP addresses of the monitoring destinations to be modified. In RIP mode, specify the host names or IP addresses of neighboring routers as the monitoring destinations. In NIC switching mode, specify the host names or IP addresses of the primary and secondary HUBs.

-b on | off:

If two HUBs are specified as monitoring destinations in NIC switching mode, communication between the primary and secondary HUBs can be monitored. This parameter cannot be specified for the monitoring destination information in RIP mode.

on: Monitors communication between two HUBs.
off: Does not monitor communication between two HUBs.

Changing the number of monitoring target from two targets to one target, verify that HUB-to-HUB monitoring exists, and if the value is set "on", then change it back to "off".

(5) delete command

Use the delete command to delete the monitoring destination information. The following is the format of the delete command:

/opt/FJSVhanet/usr/sbin/hanetpoll delete -n {devicename1[,devicename2,...] | all}

-n devicename1[,devicename2,...]:

Specify the names of virtual interfaces (such as sha0 and sha1) whose monitoring destination information should be deleted.

all:

Specify this parameter to delete all the defined monitoring destination information.

(6) on command

To make the created Router/HUB monitoring function valid, and to change an interval to monitor a Router/HUB monitoring function, and a monitoring function of the other end of communication in GS/SURE linkage mode, use the on command:

RIP mode, Fast switching/RIP mode, NIC switching mode or GS/SURE linkage mode:
/opt/FJSVhanet/usr/sbin/hanetpoll on [-s sec] [-c times] [-r retry] [-b sec] [-f {yes | no}] [-p sec]

NIC switching mode (When a specific virtual interface is specified):
/opt/FJSVhanet/usr/sbin/hanetpoll on -n devicename [-d] | [[-s sec] [-c times] [-b sec] [-f {yes | no}] [-p sec]]

-n devicename:

Specify the virtual interface name (such as sha0, sha1) used in NIC switching mode for enabling HUB monitoring feature. If this option is not specified, the entire virtual interfaces, which have the monitoring target configured, will be selected. In addition, the virtual interface which is sharing NIC synchronizes and enables a HUB monitoring function.

-d:

Changes the value of individually modified monitoring information such as monitoring period and monitoring frequency, into the configuration values that are defined in the common monitoring information. However, this option is only available when '-n' option was individually specified for the virtual interface on NIC Switching mode. (For details on common monitoring information, see the display format of (3) print command)

-s sec:

Specify the monitoring time in seconds. A value from 1 to 300 can be specified (note that the product of sec and times must be 300 or less). If this option is not specified, the previous setting is enabled. Initially, 5 (seconds) is specified.

-c times:

Specify the monitoring count. A value from 1 to 300 can be specified (note that the product of sec and times must be 300 or less). If this option is not specified, the previous setting is enabled. Initially, 5 (times) is specified.

-r retry:

Specify the retry count at which the router monitoring should be stopped when a failure is detected. A value from 0 to 99999 can be specified. If this option is not specified, the previous setting is enabled. Initially, 5 (times) is specified. Specify 0 if the router monitoring should not be stopped.

Only in the case of RIP mode or Fast switching/RIP mode, this option is effective. In the case of other modes, it is ignored.

-b sec:

When detected an error in HUB-to-HUB monitoring of NIC switching mode, and in monitoring the other end of communication in GS/SURE linkage mode, specify an interval to monitor recovery. The range possible to set is zero to 300. If not specified this option, the values set the last time become valid. 5 (seconds) is set as the initial set value.

-f yes | no:

Specify the operation used when node switching occurs due to a line failure during cluster operation. If this option is not specified, the previous setting is enabled. Initially, "yes" is specified. (This parameter is enabled only during cluster operation.)

yes: Node switching is performed if a line monitoring failure occurs.
no: No node switching is performed if a line monitoring failure occurs.

-p sec:

Specify in seconds the wait time that should elapse after monitoring starts and before the HUB links up in RIP mode, NIC switching mode, and GS/SURE linkage mode. A value from 1 to 300 can be specified. If this option is not specified, the previous setting is enabled. Initially, 60 (seconds) is specified. If the specified value is less than the monitoring interval multiplied by the monitoring count, the system ignores the specified link-up time and adopts the time obtained by multiplying the monitoring interval by the monitoring count.

(7) off command

Use the off command to disable the router/HUB monitoring function. The following is the format of the off command:

/opt/FJSVhanet/usr/sbin/hanetpoll off [-n devicename]

-n devicename:

Specify the virtual interface name (such as sha0, sha1) used in NIC switching mode for disabling HUB monitoring feature. If this option is not specified, the entire virtual interfaces, which have the monitoring target configured, will be chosen. In addition, the virtual interface which is sharing NIC synchronizes and disables a HUB monitoring function.

[Notes]

• Be sure to specify address information for neighboring routers (routers in the subnet to which physical interfaces bundled by the specified virtual interface belong) as the router monitoring destination. If any other address information is specified, the router monitoring function (RIP mode) may not operate properly.
• Before monitoring destination information can be specified using this command, configuration information must be set using the hanetconfig command.
• This command can be specified for a virtual interface in RIP mode (operation mode "r"), Fast switching/RIP mode (operation mode "b"), and NIC switching mode (operation mode "d" or "e"). (In GS/SURE linkage mode, only the functions of enabling and disabling the monitoring function are available.)
• When modifying the monitoring target data on RIP mode, you must first disable the Router Monitoring feature (hanetpoll off), and then enable the Router Monitoring feature using "hanetpoll on" command.
• A virtual interface to be used in the cluster system is monitored only while a userApplication to which the virtual interface belongs is in operation.
• The monitoring of a Routers/HUBs is not performed when a Router/HUB monitoring function is specified to virtual interface in Fast switching mode. In this case, an error message is output to indicate this fact and the Routers/HUBs is not monitored.
• The monitoring time and count to be specified using the hanetpoll on command must be specified so that their product does not exceed 300.
• The retry count to be specified using the hanetpoll on command can be set to 0 from 99999. Monitoring continues indefinitely if 0 is specified.
• Use the hanetpoll print command to display the latest user-defined information (result of create, delete, modify, on, and off) but not to display the current status of router monitoring.
• If any valid monitoring destination information exists, monitoring automatically starts when the system is started up.
• Be sure to define in the /etc/inet/hosts file IP addresses and host names to be specified when the monitoring destination information is set or modified.
• When specified a numeric string for a host name, it is dealt with as decimal and converted into an IP address corresponding to its value to work. (For instance, when specified "123456", it is regarded an IP address "0.1.226.64" is specified.)
• When setting the same monitor-to device for the monitor-to information of more than one virtual interface, use a copy command, for setting the second and after.
• When specified a host name to where to set a host name or an IP address with this command, it is not possible to change/delete the corresponding host name on the host database of such as /etc/inet/hosts and /etc/inet/ipnodes files. To change/delete the information of the host name, it is necessary to temporarily delete a definition of a Redundant Line Control function to use the corresponding host name and to set the definition again.
• When specified a host name with this command to where a host name or an IP address should be set, it is not possble to change a corresponding host name on the database such as /etc/inet/hosts and /etc/inet/ipnodes files. To change host name information, it is necessary to delete the definition of a Redundant Line Control function that uses a corresponding host name, and to reset.
• Do not use characters other than alphanumeric characters, period, and hyphen for the host name. If characters other than the above are used, re-write the host names in /etc/inet/hosts and /etc/inet/ipnodes so that it does not contain any other characters. Also, the first and last character for the host name must be alphanumeric character.

[Examples]

(1) create command

The following shows an example of creating configuration information for monitoring two routers routerA and routerB on virtual interface sha2. The host name is assumed to be associated with the IP address in the /etc/inet/hosts file.

# /opt/FJSVhanet/usr/sbin/hanetpoll create -n sha2 -p routerA,routerB

(2) copy command

The following is an example of copying monitoring target data defined in virtual interface sha0 for NIC Switching mode into sha1. (By copying the configuration data of sha0 onto sha1, when sha0 performs failover operation, sha1 also fails back along with sha0).

# /opt/FJSVhanet/usr/sbin/hanetpoll copy -n sha0,sha1

(3) print command

The following shows an example of displaying the configuration information list of a virtual interface.

# /opt/FJSVhanet/usr/sbin/hanetpoll print

(4) modify command

The following shows an example of changing configuration information for monitoring two routers routerA and routerB to routerA and routerC on virtual interface sha2. The host name is assumed to be associated with the virtual IP address in the /etc/inet/hosts file.

# /opt/FJSVhanet/usr/sbin/hanetpoll modify -n sha2 -p routerA,routerC

(5) delete command

The following shows an example of deleting the monitoring destination information on virtual interface sha2 from the definition.

# /opt/FJSVhanet/usr/sbin/hanetpoll delete -n sha2

(6) on command

The following shows an example of starting the router/HUB monitoring function.

# /opt/FJSVhanet/usr/sbin/hanetpoll on

The following is an example of starting HUB monitoring function specifying the virtual interface sha0 for NIC Switching mode.

# /opt/FJSVhanet/usr/sbin/hanetpoll on -n sha0

(7) off command

The following shows an example of stopping the router/HUB monitoring function.

# /opt/FJSVhanet/usr/sbin/hanetpoll off

The following is an example of stopping HUB monitoring function specifying the virtual interface sha0 for NIC Switching mode.

# /opt/FJSVhanet/usr/sbin/hanetpoll off -n sha0