5.8.1 Notes on cluster use (common to all OSs)
-
When setting up JP1/Base in a cluster system, make sure that you stop the JP1/Base services active on the physical host and existing logical hosts. If you do not stop the JP1/Base services before setting up JP1/Base, the services on the logical hosts will not operate properly. If this happens, recover by restarting the server.
-
To issue events from a user application in a cluster system, use the jevsend command with the -s option specified. For the -s option, specify the event server name. This option allows issued events to be inherited from the primary node to the secondary node when a failover occurs.
-
When node switching is enabled, JP1/Base does not support duplication of the event database and command execution log (ISAM) file. Use a mirror disk or RAID disk to ensure the reliability of the disk system.
-
When using JP1/Base in a cluster system, specify sync for the options parameter in the event server settings file (conf). The OS normally stores data written from a program in buffer memory, and then writes it to the disk in order to improve performance. Therefore, if the system suddenly terminates because of a power failure or an error in the OS, any data not yet written to the disk will be lost. The event service suppresses this buffering to prevent data from disappearing. If you specify no-sync for the option parameter or specify neither sync nor no-sync, data might be lost.
-
The more logical hosts you concurrently activate in a cluster system, the greater the system resources required.
-
To run JP1/Base on both the logical and physical hosts in a cluster system, you must change the event service setting on the physical hosts to IP addressing. Edit the event server settings file (conf) on both the primary and secondary nodes to change the address specified in the ports parameter to the local host name, to the IP address of the local host, or to <jp1hosts2>. The event service on the physical host is set to jp1host2 (for new installations) or 0.0.0.0 (for overwrite installations from version 09-00 or earlier) by default. However, an event service (on the physical host) that is set to 0.0.0.0 cannot be activated concurrently with the event service on the logical host. For details on the event server settings file, see Event server settings file in 16. Definition Files.
-
Suppose that the authentication server is used in a cluster system and JP1/IM and JP1/AJS are installed on the host on which the authentication server is set up. If the authentication server is switched during a failover, the related programs behave as follows:
- JP1/IM
-
A communication error occurs. Operations are restored after the failover.
- JP1/AJS
-
A communication error occurs. The user must log in again after the failover.
You can avoid potential problems due to this behavior of JP1/IM and JP1/AJS2 by placing the authentication server on a host outside the cluster system.
-
If you want to monitor files on a shared disk using the JP1/Base log file trapping function, ensure that the shared disk remains accessible while the files are being monitored. If you change the shared disk allocation during file monitoring, problems such as errors in the monitoring process and control failure in disk space allocation and deallocation could occur.
-
To prevent data from being lost from the command execution log file (ISAM), specify ON for the -flush option of the jcocmddef command, enabling the command execution log to be written line-by-line to the disk. For details on the jcocmddef command, see the manual Job Management Partner 1/Integrated Management - Manager Command and Definition File Reference.