Hitachi

JP1 Version 12 JP1/Base User's Guide


jp1hosts2 definition file

Organization of this page

Format

# Comment

+DefaultResolve {0 | 1}

+PhysicalMerge {0 | 1}

host-name IP-address IP-address IP-address

Parameters by type

Required parameters:

None

Custom parameters:

None

File name

jp1hosts2.conf or any other file name

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:

+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 (/)