You can use the hanetpoll command to make, delete, and display the ping settings. Subcommands of the hanetpoll command are listed in the table below.
Subcommand | Description | Required Rights |
---|---|---|
create | Makes ping settings. | Administrators |
delete | Deletes ping settings. | Administrators |
Displays ping settings. | Administrators or Users | |
param | Changes the ping interval and number of pings. | Administrators |
on | Starts ping monitoring. | Administrators |
off | Stops ping monitoring. | Administrators |
To create ping settings, use the create subcommand.
Format
hanetpoll create -t adapter -p ping_target1[,ping_target2] [-f yes|no]
Description
Creates ping settings.
Options
-t adapter
Specifies the name of the physical adapter (specified with the hanetconfig command, create subcommand, -t option) bundled in the virtual adapter. When this physical adapter is operational, the ping targets specified with the -p option are monitored.
It is also possible to abbreviate the text string "Ethernet" or "Local Area Connection" in specifying the name of a physical adapter.
Normal specification (not abbreviated):
> hanetpoll create -t "Ethernet 1" -p 192.168.2.10 |
Abbreviated specification:
> hanetpoll create -t 1 -p 192.168.2.10 |
The table below shows the adapter names as displayed by Windows and the corresponding abbreviations in GLS commands.
Adapter Name in Windows | Abbreviation in GLS Commands |
---|---|
"Ethernet" or "Ethernet 0" | 0 |
"Ethernet 1" | 1 |
"Ethernet 2" | 2 |
-p ping_target1[,ping_target2]
Specifies the IP address of the ping target. When specifying multiple IP addresses, they must be delimited by commas ( , ). Such sequences of IP addresses are called "IP address lists", and each may contain up to 3 addresses. Also, a maximum of 3 IP address lists can be specified per physical adapter.
If none of the IP addresses in the list responds to the ping signal, the IP address list is faulty. If any single list in the IP address lists specified for a physical adapter malfunctions, the NIC switches to another one.
When you specify the IP address for a physical adapter bundled in a virtual adapter as a ping target, you must also specify an IP address for the other physical adapter in that virtual adapter as a ping target.
The IPv4 or IPv6 addresses can be set as the address format. When you specify the IPv6 address, you cannot specify a prefix length. Also, the format of the IPv6 address which can be specified conforms to the specifications of operating systems.
If you use the IPv6 address for the ping target, the following types of IPv6 addresses can be set:
Global Unicast Address
Unique Local Unicast Address
-f {yes|no}
Allocates attributions for IP address lists.
If you specify "yes" and an IP address list is faulty, this will be detected as a communication error, and adapters will be swapped.
If you specify "no", communication errors will be detected, but adapters will not be swapped.
If you omit this option, the default value, "yes", is assumed.
You can specify the "yes" and "no" options each for a maximum of 3 times in an IP address list.
Notes
This command is not available in safe mode.
Examples
1
To set the IP address 192.168.10.10 as the ping target for the operational physical adapter Ethernet 1:
> hanetpoll create -t "Ethernet 1" -p 192.168.10.10 |
2
To set the IP address 2001:db8:10:1::10 as the ping target for the operational physical adapter Ethernet 1:
> hanetpoll create -t "Ethernet 1" -p 2001:db8:10:1::10 |
3
To set the IP addresses 192.168.10.10 and 192.168.10.20 as the ping targets for the operational physical adapter Ethernet 2:
> hanetpoll create -t "Ethernet 2" -p 192.168.10.10,192.168.10.20 |
4
To set the IP addresses 192.168.10.10 and 192.168.2.2 (destination system) as the ping targets for the operational physical adapter Ethernet 1 so that the network adapter is not switched if an error is detected:
> hanetpoll create -t "Ethernet 1" -p 192.168.10.10,192.168.2.2 -f no |
5
To set the IP address 192.168.10.10 as the ping target for the operational physical adapter Ethernet 1, abbreviating the text string "Ethernet":
> hanetpoll create -t 1 -p 192.168.10.10 |
6
Swapping of adapters when either 192.168.10.10 or 192.168.10.20 is malfunctioning:
> hanetpoll create -t 1 -p 192.168.10.10 > hanetpoll create -t 1 -p 192.168.10.20 |
7
Swapping of adapters when both IP addresses in a pair, either 192.168.10.10 and 192.168.10.20, or 192.168.10.30 and 192.168.10.40 are malfunctioning:
> hanetpoll create -t 1 -p 192.168.10.10,192.168.10.20 > hanetpoll create -t 1 -p 192.168.10.30,192.168.10.40 |
You can use the delete subcommand to delete ping target settings.
Format
hanetpoll delete -t {adapter|all}
Description
Deletes ping target settings.
Options
-t adapter
Specifies the name of the physical adapter for which ping monitoring is set. It is also possible to abbreviate the text string "Ethernet" or "Local Area Connection" in specifying the name of a physical adapter.
Normal specification (not abbreviated):
> hanetpoll delete -t "Ethernet 1" |
Abbreviated specification:
> hanetpoll delete -t 1 |
The table below shows the adapter names as displayed by Windows and the corresponding abbreviations in GLS commands.
Adapter Name in Windows | Abbreviation in GLS Commands |
---|---|
"Ethernet" or "Ethernet 0" | 0 |
"Ethernet 1" | 1 |
"Ethernet 2" | 2 |
-t all
Specifies deletion of all settings for ping monitoring.
Examples
1
To delete the ping settings for the physical adapter Ethernet 1:
> hanetpoll delete -t "Ethernet 1" |
2
To delete the ping settings for all physical adapters:
> hanetpoll delete -t all |
You can use the print subcommand to display details of ping target settings.
Format
hanetpoll print
Description
Displays details of ping target settings.
Output Format
The table below explains the output format.
When the ping monitoring target is the IPv4 address
> hanetpoll print Polling Status = ON interval(idle) = 3( 60) sec times = 5 times Adapter Fo Target ip +-------------------------------+---+-----------------------------------------+ Ethernet 1 YES 192.168.10.10 NO 192.168.10.100 Ethernet 2 YES 192.168.10.20 NO 192.168.10.100 |
When the ping monitoring target is the IPv6 address
> hanetpoll print Polling Status = ON interval(idle) = 3( 60) sec times = 5 times Adapter Fo Target ip +-------------------------------+---+-----------------------------------------+ Ethernet 1 YES 2001:db8:10:1::10 NO 2001:db8:10:1::100 Ethernet 2 YES 2001:db8:10:1::20 NO 2001:db8:10:1::100 |
The table below explains the output items.
Item | Details | |
---|---|---|
Polling Status | Status of ping monitoring | |
ON | Denotes that ping monitoring has started. | |
OFF | Denotes that ping monitoring has stopped. | |
interval(idle) | Ping interval (standby time until pinging starts) | |
interval | Interval between pings | |
idle | Time from immediately after ping monitoring starts to when it actually starts monitoring | |
times | Maximum number of unanswered pings before an error is assumed to have occurred | |
Adapter | Physical adapter name | |
Fo | Setting for switching network adapter if ping monitoring detects an error | |
YES | Denotes that the network adapter is switched if ping monitoring detects an error. | |
NO | Denotes that the network adapter is not switched if ping monitoring detects an error. An error message informs the user that an error has been detected. | |
Target ip | IP address of ping monitoring target |
You can use the param subcommand to set the ping monitoring time.
Format
hanetpoll param [-s sec|-c times|-p sec]
Description
Sets the ping monitoring time.
Options
-s sec
Specifies the interval at which pings are sent. The valid range is 1 - 300, but the product of this value and the value set for the -c option must be no more than 300.
The initial value is 3. If this option is omitted, the value when it was previously set is assumed.
-c times
Specifies the number of times pings are sent before the system assumes that a network error has occurred. The valid range is 1 - 300, but the product of this value and the value set for the -s option must be no more than 300.
The initial value is 5. If this option is omitted, the value when it was previously set is assumed.
-p sec
Specifies the number of seconds that may elapse from immediately after ping monitoring starts to when it actually starts monitoring. The valid range is 1 - 300 seconds.
If the value set for this option is less than the product of the values set for the -s and -c options, the value set for this option is ignored and the product of the values set for the -s and -c options is assumed. The initial value is 60.
Notes
If one or more physical adapters where ping monitoring has started, stop ping monitoring using the off subcommand before executing this command. For more details, refer to "6.2.5.6 off."
Make sure to set the values for the -s and -c options so that the product of these values multiplied with each other does not exceed "300".
Do not set low values for the -s and -c options. If you do, and packet loss occurs, the ping monitor may assume an error has occurred even if the network is functioning normally.
Use the following guidelines for the settings:
If the pinged network device is located beyond the L3 switch (router)
5 pings (-c option) at 3-second intervals (-s option)
If the pinged network device is located on the same network
5 pings (-c option) at 2-second intervals (-s option)
This command is not available in safe mode.
Example
To set the ping interval to two seconds:
> hanetpoll param -s 2 |
You can use the on subcommand to start ping monitoring.
Format
hanetpoll on [-n vadapter]
Description
Starts ping monitoring.
Options
-n vadapter
Specifies virtual adapters where ping monitoring will be started. Ping monitoring will be started on all physical adapters bundled in the specified virtual adapter.
If this option is omitted, ping monitoring is started on all virtual adapters.
Notes
Make sure that IP addresses have been set for all virtual adapters before you start ping monitoring.
This command is not available in safe mode.
Examples
1
To start ping monitoring on all virtual adapters:
> hanetpoll on |
2
To start ping monitoring on the specified virtual adapter:
> hanetpoll on -n sha0 |
You can use the off subcommand to stop ping monitoring.
Format
hanetpoll off [-n vadapter]
Description
Stops ping monitoring.
Options
-n vadapter
Specifies virtual adapters where ping monitoring will be stopped. Ping monitoring will be stopped on all physical adapters bundled in the specified virtual adapter.
If this option is omitted, ping monitoring is stopped on all virtual adapters.
Examples
1
To stop ping monitoring on all virtual adapters:
> hanetpoll off |
2
To stop ping monitoring on the specified virtual adapter:
> hanetpoll off -n sha0 |
Note
This command is not available in safe mode.