jp1hosts2 definition file
- Organization of this page
Format
# Comment +DefaultResolve {0 | 1} +PhysicalMerge {0 | 1} host-name IP-address IP-address IP-address |
Storage destination directory
- In Windows:
-
installation-folder\conf\
shared-folder\jp1base\conf\ (in a cluster system)
- In UNIX:
-
/etc/opt/jp1base/conf/
shared-directory/jp1base/conf/ (in a cluster system)
Description
This file contains hosts information specific to JP1. A jp1hosts2 definition file is provided by default, and you can also create and edit your own.
Application of settings
Execute the jbshosts2import command to apply the information in a jp1hosts2 file. For details on the jbshosts2import command, see jbshosts2import in 15. Commands.
Definition details
The following conventions apply to entries in the jp1hosts2 definition file:
-
A jp1hosts2 definition file consists of one line per entry. There is no limit to the number of characters per line.
-
You can define a maximum of 10,000 hosts in a jp1hosts2 definition file.
-
A hash mark (#) (code 0x23) at the start of a line indicates a comment.
- +DefaultResolve {0 | 1}
-
Specify how the system uses the OS hosts file or other methods to resolve host names that are not defined in the jp1hosts2 information. If you omit this parameter, 0 is assumed.
- 0
-
Resolve IPv4 addresses only.
- 1
-
Resolve IPv4 and IPv6 addresses.
- +PhysicalMerge {0 | 1}
-
Specify whether to enable the physical merge mechanism. The physical merge mechanism merges jp1hosts2 information for a physical host with that of a logical host. This parameter only applies to the jp1hosts2 information on logical hosts. If there is no jp1hosts2 information for the logical host or you omit this parameter from the jp1hosts2 information on a logical host, 1 applies.
- 0
-
Disables the physical merge mechanism.
- 1
-
Enables the physical merge mechanism.
- Conventions when merging jp1hosts2 information
-
If the same host name is defined in the jp1hosts2 information of the physical and logical hosts, the definition in the jp1hosts2 information on the logical host applies. An example of merging jp1hosts2 information is shown below.
jp1hosts2 information on physical host
jp1hosts2 information on logical host
Merged jp1hosts2 information on logical host
hostA addr1
hostB addr2
hostC addr3
hostB addr4
hostD addr5
hostB addr4
hostD addr5
hostA addr1
hostC addr3
The +DefaultResolve parameter is also subject to merging, according to the criteria below. The +PhysicalMerge parameter is not merged.
-
If there is no +DefaultResolve parameter in the jp1hosts2 information on the logical host, the definition for the physical host applies.
-
If a +DefaultResolve parameter is specified in the jp1hosts2 information on the logical host, the definition for the logical host applies.
-
- host-name IP-address IP-address IP-address
-
Specify the correspondence between host names and IP addresses. host-name and IP-address must be separated by one or more spaces or tab characters.
- host-name
-
-
You can use ASCII characters only.
-
You cannot use the following characters:
" / \ [ ] ; : | = , + ? < >
-
Do not specify a string that is recognized as an IP address.
-
- IP-address
-
-
You can specify IPv4 and IPv6 addresses.
-
Delimit multiple IP addresses with one or more space or tab characters, or a comma (,).
-
You can specify a maximum of four IPv4 addresses and four IPv6 addresses for a given host, for a total of eight IP addresses.
-
If you specify multiple IP addresses for a remote host, JP1/Base uses the first IP address of those specified to communicate with the host.
-
If you use the IP binding method as the communication protocol for sending, the source IP address depends on the destination IP address type. If the destination host uses an IPv4 address, JP1/Base uses the first IPv4 address associated with the local host name. If the destination host uses an IPv6 address, JP1/Base uses the first IPv6 address of the local host name.
-
- Format of IPv4 addresses
-
-
An IPv4 address must be specified in the format W.X.Y.Z. Each of W, X, Y, and Z is a decimal number in the range from 0 to 255.
-
- Format of IPv6 addresses
-
-
An IPv6 address must be specified in the format A:B:C:D:E:F:G:H. Each of A, B, C, D, E, F, G, and H is a hexadecimal value in the range from 0 to ffff.
-
You can omit the initial zero from numerical values that begin with a zero.
-
For 0000, specify 0.
-
Consecutive fields of four zeros can be replaced by two colons, but only once per address.
Example:
Before: 0123:0000:0000:0000:4567:0000:0000:89ab
After: 123::4567:0:0:89ab
-
- Notes on specifying IPv6 addresses
-
The following addresses will be ignored:
-
IPv4-compatible address (addresses other than ::1 and ::0 whose upper 96 bits are zeroes)
-
IPv4-mapped address (addresses in which the upper 80 bits are zeroes and the 16 bits from the 81st to 96th bit are ones)
-
IPv6 link-local addresses (addresses whose upper 10 bits are 1111 1110 10)
Example: fe80::
-
Multicast addresses (addresses whose upper 8 bits are ones)
-
Brackets ([]), addresses with no values (::), network interface (%), or subnet mask (/)
-