Host information configuration file (jpchosts)
- Organization of this page
Function
The host information configuration file defines Performance Management-specific host information for services other than PFM - Web Console.
It defines host names and IP addresses, in the same way as the OS's hosts file. In this file, you can define IP addresses to be used to optimize the communication path when there are multiple IP routes.
Name of file
jpchosts (Host information configuration file)
Location
- Windows
-
-
On physical hosts:
installation-folder\
-
On logical hosts:
installation-folder-for-the-executing-node-and-standby-node\
-
- UNIX
-
-
On physical hosts:
/opt/jp1pc/
-
On logical hosts:
the-executing-node-and-standby-node/opt/jp1pc/
-
Timing of applying definition information
Definition information in the host information configuration file is applied at the timings shown below. Even if definition information in the host information configuration file is updated, there is no need to restart the service.
However, when you add, change, or delete an IP address for the local host name in the host information configuration file, you need to restart the service.
-
When a health check agent checks the operating status of a monitoring agent or the host on which a monitoring agent is operating
-
When an agent sends performance data to JP1/SLM by linking to JP1/SLM
-
When the service attempts to communicate with another service but cannot obtain information about the communication destination from the Name Server service
If definition information in the host information configuration file is applied, the KAVE00537-I message is output to common logs.
If access to the jpchosts file fails when an attempt is made to apply definition information in the host information configuration file, the KAVE00180-E message is output to common logs. In this case, the service continues processing by using the definition information in the jpchosts file that was loaded last time.
Notes
-
If you have set the jpchosts file, the definitions in the hosts file or DNS are not referenced for a host name defined in the jpchosts file. Therefore, the IP address obtained from a host name must be defined in the jpchosts file.
-
The same host name cannot be specified more than once. If there are multiple lines that specify the same host name, only the definition in the first line specified will be used.
-
If names are resolved between the PFM - Manager host and the PFM - Agent or PFM - RM host, there is no problem in the network settings. However, to avoid any confusion during operation, we recommend that you use the same definition in the jpchosts file on all target hosts.
-
The IP addresses specified in the jpchosts file are not used to resolve IP addresses for hosts monitored by PFM - RM. For details about IP address resolution for hosts monitored by PFM - RM, see the manuals for PFM - RM that you use.
-
In a multiple-NIC environment (a network environment in which hosts are connected to multiple LANs), configure the settings as follows:
• If the PFM - Manager host has two or more NICs:
- In the jpchosts file on PFM - Manager: specify the IP addresses you want to use in PFM - Manager.
- In the jpchosts file on a PFM - Agent or PFM - RM connected to PFM - Manager: specify the IP addresses you want to use in PFM - Manager.
• If a PFM - Agent or PFM - RM host has two or more NICs:
- In the jpchosts file on PFM - Manager: specify the IP addresses you want to use in the PFM - Agent or PFM-RM.
- In the jpchosts file on the target PFM - Agent or PFM - RM: specify the IP addresses you want to use in the PFM - Agent or PFM-RM.
- In the jpchosts file on any other PFM - Agent or PFM - RM: no configuration is necessary. However, if you want to use commands such as jpctool db backup, jpctool db clear, jpctool db dump, or jpctool service list to communicate between the target PFM - Agent or PFM - RM and another PFM - Agent or PFM - RM host, you will need to add the settings of the target PFM - Agent or PFM - RM.
How to modify
See Procedure for modifying the host information configuration file (jpchosts).
Setting items
host-name IP-address-1, IP-address-2, IP-address-3, ..., IP-address-16
-
Specify one line for each host name. If there are multiple lines that specify the same host name, only the definition on the first line specified will be used.
-
You can specify up to 1,023 bytes of ASCII characters on a single line.
-
At least one single-byte space or tab character must separate the host name from the IP addresses.
-
You can specify up to 16 IP addresses for one host. Any IP addresses that you specify beyond this number will be ignored. When multiple IP addresses are set, the leftmost address takes precedence.
-
You cannot specify a zone ID at the end of an IPv6 address, for example using the format %1 in Windows. If you specify a zone ID, the address will be treated as an invalid IPv6 address and ignored.
-
IP address settings becomes invalid if any of the following conditions is met:
- The host name length is 33 bytes or longer.
- The host name is localhost.
- The IP address (such as 172.16.233.12 or ACE6:45:75:91::1) is used as a host name.
- The host name starts with a hyphen (-).
- The host name includes any of the following characters or the space character:
\ / : , ; * ? " > < | . =
Note that if a hash mark (#) is specified, everything from the # until the end of the line is treated as a comment.
Definition example
This example gives definitions of hostA and hostB. In this case, only the first definition, hostA 192.168.92.1, is used as the host information for hostA.
# jpchosts sample hostA 192.168.92.1 hostB 192.168.92.3 , 192.168.92.4 hostA 192.168.92.2