Top
PRIMECLUSTER GLS for Windows User's Guide 4.3

6.2.4 hanetpoll

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.

Table 6.9 Subcommands of the hanetpoll Command

Subcommand

Description

Required Rights

create

Makes ping settings.

Administrators

delete

Deletes ping settings.

Administrators

print

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

6.2.4.1 create

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.

Table 6.10 Adapter Names in Windows and 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

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

6.2.4.2 delete

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.

Table 6.11 Adapter Names in Windows and 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

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

6.2.4.3 print

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.

Table 6.12 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
If a network device is using STP, it may not be possible to establish communication between the device and the server before the STP timer times out. By setting an idle time, you can prevent STP from mistakenly assuming that an error has occurred during this period.

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

6.2.4.4 param

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

Example

To set the ping interval to two seconds:

> hanetpoll param -s 2

6.2.4.5 on

You can use the on subcommand to start ping monitoring.

Format

hanetpoll on

Description

Starts ping monitoring.

Notes

Example

To start ping monitoring:

> hanetpoll on

6.2.4.6 off

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