9.13 monlistip (detects IP addresses) : For Linux(R) (x86) Systems HA Monitor Cluster Software

Format

monlistip output-file-name

Users who can execute the command

Superuser

Description

The monlistip command detects the devices in the reset path's network and outputs a list of their IP addresses for HA Monitor on the host where the command was executed. The command outputs the IP addresses that responded to the ICMP echo packet sent by the command.

Before you execute this command, check that the kernel parameter has been set to a value that is at least the number of host sections in the network of the reset path. For details, see Notes for this command.

Options

output-file-name

Specifies a name for the CSV file to which the list of IP addresses is to be output. If a file with the specified name already exists, the command cancels file output processing, so first check that the file name you intend to specify is unique.

An example of the CSV file is shown below. This example specifies IP_list.csv as the output file name.
```
Search IP address in a range from 1.1.2.1 to 1.1.2.254
IP address,machine,HAmon,address,resetpath,SVP(or HRL),resetpath(2nd),HRL(2nd)
1.1.2.131
1.1.2.141
1.1.2.111
1.1.2.151
1.1.2.161
1.1.2.121
1.1.2.171
1.1.2.172
```

Return codes

Value	Meaning
`0`	Normal termination (detection of IP addresses has been completed)
Other than `0`	Abnormal termination

Messages

The following table lists and describes the messages that might be output to the standard error output during command execution.

Table 9‒4: Messages that might be output to the standard error output by the monlistip command
Message	Description	Action
`Usage` `:aa....aa` `outfile`	The option specified in the `monlistip` command is invalid. `aa....aa`: Path used during `monlistip` command execution	Correct the option specification and re-execute the command.
`The` `specified` `file` `(aa....aa)` `already` `exists.`	A file with the output file name specified in the `monlistip` command already exists. `aa....aa`: Output file name	Either specify a different output file name in the option or delete the existing file with the specified file name.
`Settings` `of` `the` `reset` `path` `have` `not` `been` `configured.`	The reset path has not been configured.	Complete reset path configuration on the host on which the `monlistip` command is being executed. This message is also output if you have executed the `monlistip` command on a system other than BladeSymphony or HA8000. In such a case, execute the `monlistip` command on a BladeSymphony or HA8000 system.
`An` `error` `occurred` `in` `the` `aa....aa` `system` `call.` `Errno` `:` `bb....bb.` `Information` `:` `cc....cc.`	A system call error occurred during `monlistip` command execution. `aa....aa`: System call name `bb....bb`: System call's `errno` `cc....cc`: Detail information	If the displayed system call name (`aa....aa`) is `sendto` and the system call's `errno` (`bb....bb`) is `105`, the kernel parameter setting is invalid. See Notes for the command. If any other error has occurred, contact maintenance personnel.
`The` `netmask` `cannot` `be` `acquired.`	The netmask setting of the reset path could not be obtained.	Eliminate the cause of the error according to the error message that was issued immediately before this message. If no error message has been issued before this message, check the IP address of the reset path specified in the `monsetup` `-resetpath` command and correct it if there is an error.
`Processing` `will` `now` `stop.`	Processing is being cancelled due to an error.	Eliminate the cause of the error according to the error message that was issued immediately before this message, and then re-execute the `monlistip` command.

Notes

The monlistip command can be executed only when the system being used is BladeSymphony or HA8000.
Execute the monlistip command on a host on which an HA Monitor environment has been configured.
Execution of the monlistip command results in approximately 20 kilobytes of load per second. Execute the command when the processing load is light.
Before you execute the monlistip command, make sure that the kernel parameter shown below is set to a value that is at least the number of host sections in the network of the reset path. You can use the sysctl OS command to display and change the kernel parameter.

Kernel parameter to be changed:

net.ipv4.neigh.default.gc_thresh3

Value:

Specify a value that is at least the number of host sections in the network of the reset path. You can also check the number of host sections in the network of the reset path in the number of IP addresses to be checked that is displayed when you execute the monlistip command.

Example of sysctl command (when the address class is B):

/sbin/sysctl -w net.ipv4.neigh.default.gc_thresh3= 65536
Detection of IP addresses requires the following number of seconds at the most:

Number of host sections in the network of the reset path ÷ 100 × 3 (the value is rounded up)

Examples

This example specifies IP_list.csv as the output file name:

> monlistip IP_list.csv
Now processing.
100/254 39% complete.
200/254 78% complete.
254/254 100% complete.
Processing ended.

The following table lists and describes the messages that are displayed during command execution.

Table 9‒5: Messages that are displayed during monlistip command execution
Item that is displayed	Description
`Now` `processing.`	Command processing has started.
`aa....aa` `/` `bb....bb` `cc....cc%` `complete.`	Shows the progress of the command's processing: `aa....aa`: Number of IP addresses that have been checked `bb....bb`: Number of IP addresses to be checked `cc....cc`: Percentage of IP addresses that have been checked
`Processing` `ended.`	Command processing has terminated.