[Name]
hanetpoll - Setting, modifying, deleting, and displaying the monitoring destination information for the HUB monitoring function
[Synopsis]
/opt/FJSVhanet/usr/sbin/hanetpoll command [args]
[Feature description]
The hanetpoll command sets the monitoring destination information required for the 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 | Super user |
Displays monitoring destination information | General user | |
modify | Modifies monitoring destination information | Super user |
delete | Deletes monitoring destination information | Super user |
on | Enabling the HUB monitoring function | Super user |
off | Disabling the HUB monitoring function | Super user |
devparam | Displays monitoring destination information for each virtual interface | General user |
Creates/deletes monitoring destination information for each virtual interface | Super user |
(1) create command
The operation of the 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}] |
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.
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 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.
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 the copy command to create copy monitoring destination information on a virtual interface in NIC switching mode. 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 |
Point
When the tagged VLAN interface is used, the "copy" command is used to set a synchronous switching in the virtual interface.
Specify the names of virtual interfaces from and to which monitoring destination information should be copied.
Specify the name of a virtual interface that is set in monitoring information in the copy source.
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,...]] |
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.
Display | Contents | ||
|---|---|---|---|
Polling Status | The current status of the monitoring function. | ||
Polling Status | ON | The monitoring function is enabled. | |
OFF | The monitoring function is disabled. | ||
interval(idle) | interval | The monitoring interval in the stationary status. | |
idle | In seconds the wait time that elapses after monitoring starts and before the HUB links up. | ||
times | The monitoring count. | ||
repair_time | The recovery monitoring interval in seconds. | ||
link detection | YES | NIC switching is performed when the NIC link down is detected. | |
NO | NIC switching is not performed even if the NIC link down is detected until ping monitoring fails. | ||
FAILOVER Status | With or without cluster switching when an error occurred in all transfer routes. | ||
FAILOVER Status | YES | Node switching is performed when the virtual interface is registered in the cluster resource. | |
NO | No node switching is performed. | ||
Name | The name of a virtual interface to be monitored. | ||
HUB Poll | The HUB-to-HUB monitoring status. | ||
HUB Poll | ON | The monitoring function is enabled. | |
OFF | The monitoring function is disabled. | ||
--- | The monitoring function is not used. | ||
Hostname | The host name or IP address to be monitored, in the order of the primary and secondary monitoring destinations. In the example, "hostA" is the primary monitoring destination and "192.168.10.10" is the secondary monitoring destination. | ||
(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}]} |
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.
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.
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.
Note
Changing the number of monitoring targets 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} |
Specify the names of virtual interfaces (such as sha0 and sha1) whose monitoring destination information should be deleted.
Specify this parameter to delete all the defined monitoring destination information.
(6) on command
To make the created HUB monitoring function valid, and to change an interval to monitor a HUB monitoring function, use the on command:
/opt/FJSVhanet/usr/sbin/hanetpoll on [-s sec] [-c times] [-b sec] [-f {yes | no}] [-p sec] [-l {yes | no}] |
Specify the monitoring time in seconds. A value from 1 to 300 can be specified (note that the product of sec and time must be 300 or less). If this option is not specified, the previous setting is enabled. Initially, 5 (seconds) is specified.
Specify the monitoring count. A value from 1 to 300 can be specified (note that the product of sec and time must be 300 or less). If this option is not specified, the previous setting is enabled. Initially, 5 (times) is specified.
When detected an error in HUB-to-HUB monitoring of NIC switching 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.
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 when a takeover virtual interface is set for 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.
Note
Setting "no" restricts switching caused by an error occurred in transfer routes. This does not restrict node switching caused by other errors such as an activation failure for virtual interfaces.
Specify in seconds the wait time that should elapse after monitoring starts and before the HUB links up in NIC switching 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.
Specify the task to be performed when the link of a running NIC in NIC switching mode is down. If you do not specify this option, the previous value will be used. The default value is "no".
yes: NIC switching is immediately performed if HUB monitoring fails even once when the link of a running NIC is down.
no : NIC switching is not performed until HUB monitoring fails when the link of a running NIC is down.
Note
In an environment where GLS is used on the host OS of the virtual machine function, the NIC link down cannot be detected by the link status monitoring function. This is because the link down is not notified to a physical interface bundled by GLS and connected via a virtual switch, even if the NIC link down of the host OS is detected by the link status monitoring function. Therefore, the line will be switched after an error is detected by the HUB monitoring function instead of by the link status monitoring function.
Link down is detected just after a failure by ping with the HUB monitoring function is detected. As with the HUB monitoring function, monitoring is started after the waiting time for linkup specified by the -p option elapses.
(7) off command
Use the off command to disable the HUB monitoring function. The following is the format of the off command:
/opt/FJSVhanet/usr/sbin/hanetpoll off |
(8) devparam command
Display
Use the "devparam" command to display the HUB monitoring parameters set for each virtual interface.
Display | Contents | |
|---|---|---|
[ Standard Polling Parameter ] | The current status of the monitoring function. | |
[ Polling Parameter of each interface ] | Common monitoring information. For information on each displayed item, see "(3) print command". | |
[ Polling Parameter of each interface ] | Monitoring information that has been set for each individual virtual interface. If no setting has been made, '---' is displayed. Common monitoring information is used. | |
Name | The name of a virtual interface to be monitored. | |
intvl | The monitoring interval in the stationary status. | |
idle | In seconds the wait time that elapses after monitoring starts and before the HUB links up. | |
time | The monitoring count. | |
repar | The recovery monitoring interval in seconds. | |
link | YES | NIC switching is performed when the NIC link down is detected. |
NO | NIC switching is not performed even if the NIC link down is detected until ping monitoring fails. | |
Fover | YES | Node switching is performed when the virtual interface is registered in the cluster resource. |
NO | No node switching is performed. | |
Settings
To set the HUB monitoring parameters for each individual virtual interface, specify the virtual interface name by using the "-n" option, and then the desired monitoring parameters by using options such as "-s". The parameters you do not specify will be set to common monitoring defaults. If NICs are shared, the settings of virtual interface parameter that you made first will be used. To enable the settings, restart monitoring (execute the "hanetpoll off" command and then the "hanetpoll on" command).
/opt/FJSVhanet/usr/sbin/hanetpoll devparam -n devicename [-s sec] [-c times] [-b sec] [-f {yes | no}] [-p sec] [-l {yes | no}] |
Specify the virtual interface name for which individual monitoring parameters are to be set.
Specify the monitoring time in seconds. For details about this option, see '(6) on command'.
Specify the monitoring count. For details about this option, see '(6) on command'.
When detected an error in HUB-to-HUB monitoring of NIC switching mode, specify an interval to monitor recovery. For details about this option, see '(6) on command'.
Specify the operation used when node switching occurs due to a line failure during cluster operation. For details about this option, see '(6) on command'.
Specify in seconds the wait time that should elapse after monitoring starts and before the HUB links up in NIC switching mode. For details about this option, see '(6) on command'.
Specify the task to be performed when the link of a running NIC in NIC switching mode is down. For details about this option, see '(6) on command'.
Deleting
To delete the HUB monitoring parameters that have been set for each virtual interface, specify the virtual interface name with the "-n" option and specify the "-d" option.
/opt/FJSVhanet/usr/sbin/hanetpoll devparam -n devicename -d |
Specify the virtual interface name for which individual monitoring parameters are to be set.
Delete the individual parameter settings of the specified virtual interface.
[Notes]
Be sure to specify address information for neighboring hubs (hubs in the subnet to which physical interfaces bundled by the specified virtual interface belong) as the hub monitoring destination. If any other address information is specified, the HUB monitoring function 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 NIC switching mode (operation mode "d" or "e").
After modifying monitoring destination information, disable the HUB monitoring function (hanetpoll off) and then enable it again (hanetpoll on). If the HUB monitoring function is enabled while it has already been enabled (duplicated activation of hanetpoll on), no monitoring destination information is reflected after modification.
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.
If a virtual interface to be monitored is set to Fast switching mode, an error message is output to indicate this fact and the line 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 hub monitoring.
If any valid monitoring destination information exists, monitoring automatically starts when the system is started up.
Be sure to define in the /etc/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, not a create command, for setting the second and after. If used a create command, occasionally the state is not displayed properly by a dsppoll command.
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/hosts file. 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 possible to change a corresponding host name on the database such as /etc/hosts 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 reconfigure.
Do not specify a multicast address as a monitor-to address.
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/hosts so that it does not contain any other characters. Also, the first and last character for the host name must be alphanumeric character.
[Examples]
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/hosts file.
# /opt/FJSVhanet/usr/sbin/hanetpoll create -n sha2 -p routerA,routerB |
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 |
The following shows an example of displaying the configuration information list of a virtual interface.
# /opt/FJSVhanet/usr/sbin/hanetpoll print |
The following shows an example of changing configuration information for monitoring two hubs hubA and hubB to hubA and hubC on virtual interface sha2. The host name is assumed to be associated with the virtual IP address in the /etc/hosts file.
# /opt/FJSVhanet/usr/sbin/hanetpoll modify -n sha2 -p hubA,hubC |
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 |
The following shows an example of starting the HUB monitoring function.
# /opt/FJSVhanet/usr/sbin/hanetpoll on |
The following shows an example of stopping the HUB monitoring function.
# /opt/FJSVhanet/usr/sbin/hanetpoll off |
The following shows an example of setting monitoring parameters for each virtual interface.
# /opt/FJSVhanet/usr/sbin/hanetpoll devparam -n sha0 -s 2 |
