Top
PRIMECLUSTER GLS for Windows User's Guide 4.4
FUJITSU Software

6.2.5 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.10 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.5.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 "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.

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

-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 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

6.2.5.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 "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.

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

6.2.5.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

The table below explains the output format.

The table below explains the output items.

Table 6.13 Output Items

Item

Details

Polling Status

Status of ping monitoring

ON

Denotes that ping monitoring has started.
The status becomes ON when one or more physical adapters where the ping monitoring is running exist.

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 GLS 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.5.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.5.5 on

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

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

6.2.5.6 off

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