Hitachi

JP1 Version 12 JP1/Base User's Guide


5.4.5 Settings to configure both physical and logical host environments on the same host

To configure both physical and logical host environments on the same host, you need to set up the network control. If you skip this process in Windows, the system operates as if the IP address of the logical host were assigned to the physical host, causing the physical host to receive requests intended for the logical host. Also, an IP address that is resolved from the physical host name might be converted to an unexpected IP address, causing malfunction of the JP1 communication. To avoid this scenario, use the following procedure to set up network control when you set up JP1/Base on the logical host.

  1. Create a definition file that contains the following information using a text editor (such as Notepad):

    physical-host-name physical-IP-address #node1

    physical-host-name physical-IP-address #node2

    You can use any name for the definition file. Define the physical host names and the physical IP addresses to match the host environment. As a physical host name, specify a host name displayed by the hostname command. Physical host names and physical IP addresses must be separated by one or more spaces or tab characters. The characters following the hash and up to the next linefeed constitute a comment. End the final line of the file with a linefeed character.

    Example: When you build a 2-node cluster with jp1-node1 (IP address is 100.100.100.1) and jp1-node2 (IP address is 100.100.100.2) on the logical host jp1-cluster, create a definition file as stated below:

    jp1-node1 100.100.100.1

    jp1-node2 100.100.100.2

  2. Apply the jp1hosts information or jp1hosts2 information to the common definition information.

    For jp1hosts information:

    Execute the jbshostsimport command to apply the contents of the definition file to the common definition information for the physical and logical hosts. For details on the jbshostsimport command, see jbshostsimport in 15. Commands.

    Also, change the communication settings for the event service.

    Example: Execute the jbshostsimport command in the following formats:

    - Stop JP1/Base services on physical and logical hosts.

    - c:\>installation-folder\bin\jbshostsimport -o definition-file-name

    - c:\>installation-folder\bin\jbshostsimport -o definition-file-name -h jp1-cluster

    - Set the ports parameter in the event server settings file (conf) on the physical host.

    Example:

    jp1-node1:

    ports 100.100.100.1 jp1imevt jp1evtapi

    jp1-node2:

    ports 100.100.100.2 jp1imevt jp1evtapi

    - Add the server parameter in the API settings file (api).

    Example:

    server jp1-node1 keep-alive 100.100.100.1

    server jp1-node2 keep-alive 100.100.100.2

    - Start JP1/Base services on physical and logical hosts.

    For jp1hosts2 information:

    Execute the jbshosts2import command to register the contents of the definition file with the physical host. For details on the jbshosts2import command, see jbshosts2import in 15. Commands.

    Note that you do not have to change the communication settings for the event service.

    Example: Execute the jbshosts2import command as follows:

    - Stop JP1/Base services on physical and logical hosts.

    - Execute jbshosts2import -o definition-file-name

    - Start JP1/Base services on physical and logical hosts.

    If you set 0 for the +PhysicalMerge parameter in the jp1hosts2 information for the logical host, you also need to register the definition file contents with the jp1hosts2 information for the logical host.

  3. Check the settings applied to the jp1hosts and jp1hosts2 information.

    Execute the following command to check the applied settings:

    Example:

    To check the setting of the physical host jp1-node1, execute:

    c:\>installation-folder\bin\jp1ping jp1-node1

    LogicalHostnameKey : no define. use JP1_DEFAULT

    jp1hosts : Use jp1hosts entry in JP1_DEFAULT

    Search jp1hosts : jp1-node1 is found.

    Resolved Host List : jp1-node1 -> jp1-node1(100.100.100.1)

    ...

    To check the setting of the physical host jp1-node2, execute:

    c:\>installation-folder\bin\jp1ping jp1-node2

    LogicalHostnameKey : no define. use JP1_DEFAULT

    jp1hosts : Use jp1hosts entry in JP1_DEFAULT

    Search jp1hosts : jp1-node2 is found.

    Resolved Host List : jp1-node2 -> jp1-node2(100.100.100.2)

    ...

    To check the setting of the logical host jp1-cluster, execute:

    c:\>installation-folder\bin\jp1ping -h jp1-cluster jp1-node1

    LogicalHostnameKey : jp1-cluster

    jp1hosts : Use jp1hosts entry in jp1-cluster

    Search jp1hosts : jp1-node1 is found.

    Resolved Host List : jp1-node1 -> 100.100.100.1(100.100.100.1)

    ...

    c:\>installation-folder\bin\jp1ping -h jp1-cluster jp1-node2

    LogicalHostnameKey : jp1-cluster

    jp1hosts : Use jp1hosts entry in jp1-cluster

    Search jp1hosts : jp1-node2 is found.

    Resolved Host List : jp1-node2 -> 100.100.100.2(100.100.100.2)

    ...

    The settings are correctly applied if the Resolved Host List line indicates the physical IP address you specified, as shown in the above example. When the indicated physical IP address is different from what you have specified, review the definition file and retry the application.