9.13 monlistip (detects IP addresses)
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.
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.
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. |