[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 (synchronous switch) | 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 |
(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".
Specify a host name or an IP address of the connected HUB. It is 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.
When setting an IPv6 address in the environment where the automatic address configuration by an IPv6 router is not performed, set the link-local address.
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 |
Point
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).
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.
# /opt/FJSVhanet/usr/sbin/hanetpoll print
[ Standard Polling Parameter ]
interval(idle) = 5( 60) sec
times = 5 times
max_retry = 5 retry
repair_time = 5 sec
link detection = NO
failover mode = YES
[ Polling Parameter of each interface ]
Name Hostname/Polling Parameter
+-------+------------------------------------------------------+
sha0 swhub1,swhub2
hub-hub poll = OFF
interval(idle) = 5( 60) sec
times = 5 times
max_retry = 5 retry
repair_time = 5 sec
link detection = NO
failover mode = YES
Name Hostname/Polling Parameter
+-------+------------------------------------------------------+
sha1 swhub3,swhub4
hub-hub poll = OFF
interval(idle) = 5( 60) sec
times = 5 times
max_retry = 5 retry
repair_time = 5 sec
link detection = NO
failover mode = YES |
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. | |
link detection | YES | Detects link-based failures. |
NO | Does not detect link-based failures. | |
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}]} |
Specify the name of a virtual interface whose monitoring destination information should be modified.
Specify the host names or IP addresses of the monitoring destinations to be modified. See the -p option of (1) create command.
Set whether or not to use HUB-to-HUB monitoring (Monitoring on/off for). For details, see the -b option of (1) create command.
Note
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} |
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, and a monitoring function of the other end of communication in GS/SURE linkage mode, use the on command:
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] [-l {yes | no}]
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] [-l {yes | no}]] |
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.
When specifying the virtual interface with this option, the setting values of the virtual interface will become the setting values of the specific monitoring information regardless of whether the common monitoring information is changed or not.When operating the virtual interface using the same setting value as the common monitoring information, use this option and the -d option to change the information to the common monitoring information.
In addition, the virtual interface which is sharing NIC synchronizes and enables a HUB monitoring function.
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)
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). When HUB-to-HUB monitoring is enabled, set the monitoring time to 2 seconds or longer. 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 times must be 300 or less). If this option is not specified, the previous setting is enabled. Initially, 5 (times) is specified.
Specify the monitoring period when a failure is detected by monitoring the remote host by GS/SURE linkage mode. The values which can be specified are from 0 to 300. If this option is not specified, the previous setting is enabled. Initially, 5 (seconds) is specified.
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.
Specify in seconds the wait time that should elapse after monitoring starts and before the HUB links up in 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 "monitoring interval" multiplied by "monitoring count," the system ignores the specified link-up time and adopts the time calculated by multiplying "monitoring interval" by "monitoring count."
Specify whether to detect link-based failures of a physical NIC in NIC switching mode. If this option is not specified, the previous setting is enabled. Initially, "no" is specified.
yes: Enables detection of link-based failures.
no : Disables detection of link-based failures.
When setting this option to "yes", control the monitoring or switching as follows based on the link status of a physical NIC:
When activating NIC by using the "strhanet" command, if the status is One-system failure due to the link down of the primary NIC, stop using the primary NIC and activate the secondary NIC.
If the monitoring fails due to the link down of a physical NIC, it is immediately considered as transfer route failure instead of retrying the monitoring.
When switching NICs due to the failure of the monitoring, check the status of the NIC to be switched beforehand. If the status is link down and the link down status has continued for 5 seconds or longer (when the standby patrol is set: 2.5 seconds or longer), restrict switching NICs.
Note
NIC link down by the link status monitoring function cannot be detected in the following environments:
Oracle VM environments where virtual switches (vswX) or virtual network devices (vnetX) are bundled and physical link status is not reflected.
Environments where the virtual NIC (VNIC) of Solaris 11 is used.
This is because the operating system does not notify NIC link down to the interfaces bundled by GLS even if NIC link down is detected on physical NICs. The route is switched after a failure is detected by the HUB monitoring function, not by the link status monitoring function.
Use the ldm(1M) command to reflect the physical link status. For details on the ldm(1M) command, see Solaris documentation.
(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 [-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]
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"). (In GS/SURE linkage mode, only the functions of enabling and disabling the monitoring function are available.)
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 HUBs is not performed when the 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 HUB 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 the 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/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 possible 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]
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 |
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 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 |
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 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 |
The following shows an example of stopping the 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 |
