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 "Local Area Connection" in specifying the name of a physical adapter.
Normal specification (not abbreviated):
> hanetpoll create -t "Local Area Connection 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 |
---|---|
"Local Area Connection" | 0 |
"Local Area Connection 0" | Cannot be abbreviated |
"Local Area Connection 1" | 1 |
"Local Area Connection 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.
-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
Stop ping monitoring using the off subcommand before executing the create subcommand. For more details, refer to "6.2.4.6 off."
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 Local Area Connection 1:
> hanetpoll create -t "Local Area Connection 1" -p 192.168.10.10 |
2
To set the IP addresses 192.168.10.10 and 192.168.10.20 as the ping targets for the operational physical adapter Local Area Connection 2:
> hanetpoll create -t "Local Area Connection 2" -p 192.168.10.10,192.168.10.20 |
3
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 Local Area Connection 1 so that the network adapter is not switched if an error is detected:
> hanetpoll create -t "Local Area Connection 1" -p 192.168.10.10,192.168.2.2 -f no |
4
To set the IP address 192.168.10.10 as the ping target for the operational physical adapter Local Area Connection 1, abbreviating the text string "Local Area Connection":
> hanetpoll create -t 1 -p 192.168.10.10 |
5
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 |
6
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 "Local Area Connection" in specifying the name of a physical adapter.
Normal specification (not abbreviated):
> hanetpoll delete -t "Local Area Connection 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 |
---|---|
"Local Area Connection" | 0 |
"Local Area Connection 0" | Cannot be abbreviated |
"Local Area Connection 1" | 1 |
"Local Area Connection 2" | 2 |
-t all
Specifies deletion of all settings for ping monitoring.
Note
Stop ping monitoring using the off subcommand before executing this subcommand. For more details, refer to "6.2.4.6 off."
Examples
1
To delete the ping settings for the physical adapter Local Area Connection 1:
> hanetpoll delete -t "Local Area Connection 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
> hanetpoll print Polling Status = ON interval(idle) = 3( 60) sec times = 5 times Adapter Fo Target ip +-------------------------------+---+-----------------------------------------+ Local Area Connection 1 YES 192.168.10.10 Local Area Connection 1 NO 192.168.10.100 Local Area Connection 2 YES 192.168.10.20 Local Area Connection 2 NO 192.168.10.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
Stop ping monitoring using the off subcommand before executing this command. For more details, refer to "6.2.4.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
Description
Starts ping monitoring.
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.
Example
To start ping monitoring:
> hanetpoll on |
You can use the off subcommand to stop ping monitoring.
Format
hanetpoll off
Description
Stops ping monitoring.
Example
To stop ping monitoring:
> hanetpoll off |
Note
This command is not available in safe mode.