[Name]
hanetpathmon - Enabling and disabling the network monitoring function, modifying and displaying the monitoring destination information, modifying monitoring parameters, and starting and stopping monitoring
[Synopsis]
/opt/FJSVhanet/usr/sbin/hanetpathmon command [args]
[Feature description]
The hanetpathmon command serves to enable and disable the network monitoring function, to modify and display monitoring destination information, to modify monitoring parameters, and to start and stop network monitoring.
Command | Process outline | Authority |
---|---|---|
target | Changes and displays monitoring destination information. | Change: Super user |
param | Changes and displays monitoring parameters. | Change: Super user |
on | Starts network monitoring. | Super user |
off | Stops network monitoring. | Super user |
(1) target command
Use the target command to modify or display the setting of monitoring destination. The following is the format of the target command.
Setting: /opt/FJSVhanet/usr/sbin/hanetpathmon target -n devicename [-v vlanid] [-p ipaddress1[,ipaddress2]] Displaying: /opt/FJSVhanet/usr/sbin/hanetpathmon target [-n devicename] Deleting: /opt/FJSVhanet/usr/sbin/hanetpathmon target -n devicename -d |
Setting
Specify the names of virtual interfaces whose monitoring destination information should be set.
Specify the VLAN ID of a VLAN interface when the monitoring destination is the network of a tagged VLAN. When this parameter is not specified, the network without tag is monitored.
Specify a monitor-to host name or IP address. Specify a monitor-to host name or IP address to "ipaddress1" when activating a Primary interface. Specify a monitor-to host name or IP address to "ipaddress2" 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 "ipaddress2".
In Virtual NIC mode, specify an IP address of the connected HUB. It is also possible to set IPv4 or IPv6 addresses as an address form. When specifying an IPv6 address, do not specify a prefix value.
Without specifying these parameters, HUB monitoring will not work. Only the standby patrol function will be enabled.
Note
To specify an IPv4 address for the target IP of HUB monitoring, specify the same network address as IPv4 set in the setting file for a virtual interface or the setting file of a tagged VLAN for a virtual interface.
Deleting
Specify the names of virtual interfaces whose monitoring destination information should be deleted.
Specify this option to delete the monitoring destination IP and VLAN ID, and to initialize the monitoring destination information.
Displaying
Specify each name of a virtual interface whose monitoring destination information should be displayed. When this parameter is omitted, all monitoring destination information currently set is displayed.
# /opt/FJSVhanet/usr/sbin/hanetpathmon target [Target List] Name VID Target +-------+----+----------------------------------------------------------+ sha0 - 192.13.90.251,192.13.90.252 sha1 - 192.13.100.251 sha2 6 - |
Display | Contents |
---|---|
Name | Virtual interface name When monitoring a tagged VLAN interface, the name of the virtual interface from which the tagged VLAN interface is originally generated is displayed. |
VID | When monitoring a virtual interface, a hyphen ("-") is displayed. When monitoring a tagged VLAN interface, the tag ID is displayed. |
Target | Target IP addresses in HUB monitoring are displayed in the order of primary and secondary monitoring targets. If no monitoring target is specified, a hyphen ("-") is displayed. |
Note
When network monitoring is started, you cannot change the settings of monitoring destination information. Stop network monitoring before executing this command.
(2) param command
Use the param command to modify the settings of monitoring parameters.
Setting: /opt/FJSVhanet/usr/sbin/hanetpathmon param -n devicename [-a {yes | no}] [-s sec] [-c times] [-r times] [-p sec] [-q {yes | no}] [-f {yes | no}] Displaying: /opt/FJSVhanet/usr/sbin/hanetpathmon param [-n devicename] |
Setting
Specify the name of the virtual interface for which the monitoring parameters are to be modified.
Set whether or not to start the network monitoring function in conjunction with startup of the virtual interface. If you do not specify this option, the previous value will be used. The default value is "yes".
yes: Network monitoring starts in conjunction with startup of the virtual interface.
no : Network monitoring does not start in conjunction with startup of the virtual interface.
Specify the monitoring interval in seconds. The values which can be specified are from 1 to 300. If you do not specify this option, the previous value will be used. The default value is 3 (seconds).
Specify the monitoring count. The values which can be specified are from 1 to 300. If you do not specify this option, the previous value will be used. The default value is 5 (times).
Specify the number of succeed counts to go back to the normal monitoring after recovery of a monitoring target is detected in the recovery monitoring by the standby patrol of the network monitoring function. The values which can be specified are from 1 to 300. If you do not specify this option, the previous value will be used. The default value is 2 (times). (The monitoring target is considered as recovered if the standby patrol succeeds twice.)
Specify in seconds the wait time that should elapse after monitoring starts and before the HUB links up in network monitoring. The values which can be specified are from 1 to 300. If you do not specify this option, the previous value will be used. The default value is 45 (seconds). If the value is less than the product of monitoring period and monitoring times (monitoring period X monitoring times), then the value is ignored and ends up using the value of the product of monitoring period and monitoring times.
Specify whether to perform the automatic fail-back when recovery of transfer paths between active NICs and standby NICs is detected by using the standby patrol function. The default value is "no".
yes: Performs the automatic fail-back.
no : Does not perform the automatic fail-back.
Specify the operation used when node switching occurs due to a line failure during cluster operation. If you do not specify this option, the previous value will be used. The default value is "yes". This parameter is valid only in 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.
Displaying
Specify each name of a virtual interface whose monitoring parameter information should be displayed. When this parameter is omitted, all monitoring parameter information currently set is displayed.
# /opt/FJSVhanet/usr/sbin/hanetpathmon param [Parameter List] Name Monitoring Parameter +-------+----------------------------------------------------------+ sha0 auto_startup = YES interval = 3 sec times = 5 times repair_times = 2 times idle = 45 sec Auto fail-back = NO FAILOVER Status = YES Name Monitoring Parameter +-------+----------------------------------------------------------+ sha1 auto_startup = NO interval = 5 sec times = 5 times repair_times = 5 times idle = 30 sec Auto fail-back = YES FAILOVER Status = NO |
Display | Contents | |
---|---|---|
Name | Virtual interface name When monitoring a tagged VLAN interface, the name of the virtual interface from which the tagged VLAN interface is originally generated is displayed. | |
VID | When monitoring a virtual interface, a hyphen ("-") is displayed. When monitoring a tagged VLAN interface, the tag ID is displayed. | |
Monitoring Parameter | The monitoring parameter currently set is displayed. | |
auto_startup | YES | Network monitoring starts in conjunction with startup of the virtual interface. |
NO | Network monitoring does not start in conjunction with startup of the virtual interface. | |
interval | The monitoring interval is displayed in seconds. | |
times | The number of error monitoring | |
repair_times | The number of recovery monitoring | |
idle | In seconds the wait time that elapses after monitoring starts and before the HUB links up. | |
Auto fail-back | YES | Automatic fail-back is enabled. |
NO | Automatic fail-back is disabled. | |
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. |
Note
When network monitoring is started, you cannot change the settings of monitoring parameters. Stop network monitoring before executing this command.
(3) on command
Use the on command to start network monitoring. Execute this command for every virtual interface.
Normally, network monitoring is started along with the activation of a virtual interface, but this command is used to resume network monitoring after suspending the network monitoring by the off command.
/opt/FJSVhanet/usr/sbin/hanetpathmon on [-n devicename] |
Specify the names of virtual interfaces (such as sha0 and sha1) for which to start network monitoring. When this parameter is omitted, monitoring all virtual interfaces for which monitoring is enabled is started.
(4) off command
Use the off command to stop network monitoring. Execute this command for every virtual interface.
Normally, network monitoring is stopped along with the inactivation of a virtual interface, but this command is used to suspend the network when changing monitoring destination information by the target command or changing monitoring parameters by the param command.
/opt/FJSVhanet/usr/sbin/hanetpathmon off [-n devicename] |
Specify the names of virtual interfaces (such as sha0 and sha1) for which network monitoring is to be stopped. When this parameter is omitted, monitoring all virtual interfaces for which monitoring is enabled is stopped.
[Examples]
The following shows an example of setting IP addresses "192.13.90.251" and "192.13.90.252", which are monitoring destinations for the virtual interface sha0, as monitoring targets.
/opt/FJSVhanet/usr/sbin/hanetpathmon target -n sha0 -p 192.13.90.251,192.13.90.252 |
The following shows an example of setting IP address "192.13.90.251", which is the monitoring destination for the virtual interface sha0, as monitoring target.
/opt/FJSVhanet/usr/sbin/hanetpathmon target -n sha0 -p 192.13.90.251 |
The following shows an example of setting IP addresses "192.13.80.251" and "192.13.80.252", which are monitoring destinations for the virtual interface of the tagged VLAN interface sha0.2, as monitoring targets.
/opt/FJSVhanet/usr/sbin/hanetpathmon target -n sha0 -p 192.13.80.251,192.13.80.252 -v 2 |
The following shows an example of initializing the monitoring destination information of the virtual interface sha0.
/opt/FJSVhanet/usr/sbin/hanetpathmon target -n sha0 -d |
The following shows an example when the monitoring interval is set to 10 seconds and when switching between nodes is not performed in the event of transfer path failure in cluster operation.
/opt/FJSVhanet/usr/sbin/hanetpathmon param -n sha0 -s 10 -f no |
The following shows an example of starting monitoring for all virtual interfaces.
/opt/FJSVhanet/usr/sbin/hanetpathmon on |
The following shows an example of stopping monitoring for all virtual interfaces.
/opt/FJSVhanet/usr/sbin/hanetpathmon off |