6.2.3 Installing and setting up the logical host (upgrade installation and setup)

This subsection describes the upgrade installation and setup of the logical host for JP1/IM - Manager. It also describes the setup of JP1/Base because JP1/Base must be set up on the same logical host.

Before you start the procedure, check the following information about the cluster system.

Table 6‒8: Items to be checked before you install and set up the logical host (Windows)
Item to be checked	Description
Logical host name	Name of the logical host that executes JP1
Logical IP address	IP address that corresponds to the logical host name
Shared folder	Folder on the shared disk that stores a set of files for the JP1 execution environment on the logical host

Additionally, make sure that these items satisfy the prerequisites described in 6.1.2 Prerequisites for cluster operation.

Once you have finished checking the above items, you are ready to start the installation and setup.

Note that logical host names are case sensitive. Specify the logical host names set in JP1/Base in the correct form, including case. If you set up and install a logical host after specifying an incorrect logical host name, delete the IM databases and the logical host, and then install and set up the logical host again. For details about how to delete IM databases and logical hosts, see 6.2.6 Deleting the IM databases and logical host.

Organization of this subsection

(1) Installing
(2) Setting up the physical host environment
(3) Setting up the logical host environment (primary node)
(4) Copying the common definition information

(1) Installing

Install JP1/IM - Manager and JP1/Base on the local disk of both the primary server and the secondary server.

To install:

Back up the settings and database.

For the backup method, see the manual for the old version.
Install JP1/Base.
Install JP1/IM - Manager.

To Page Top

(2) Setting up the physical host environment

If you use JP1/IM - Manager at the physical host, set up the physical host environment according to the procedure described in 1.19.3 Settings during upgrading.

To Page Top

(3) Setting up the logical host environment (primary node)

If you use the functions of Central Scope, steps 6 through 8 are required. If you do not use the functions of Central Scope, skip steps 6 through 8.

Terminate JP1/IM - Manager.

Terminate the JP1/IM - Managers in both the physical and logical host environments.
Set up a logical host environment for JP1/Base.

If you have upgraded JP1/Base, see the notes about installation and uninstallation in the Job Management Partner 1/Base User's Guide, and then perform the setup. If you have not upgraded JP1/Base, there is no need to perform this setup.
Make sure that the shared disk is available.
Execute the jp1cohaverup command.

jp1cohaverup -h logical-host-name
If you want to change the location of the event acquisition filter to Event Base Service, execute the jcochafmode command.

jcochafmode -h logical-host-name
Check the available disk capacity.

To upgrade JP1/IM - Manager, you need as much free space on the hard disk as the disk capacity under shared-folder\JP1Scope\database\.
Execute the jp1cshaverup.bat command.

jp1cshaverup.bat -h logical-host-name -w work-folder

Execute the jbssetcnf command.

Whether the following functions are enabled or disabled depends on the settings in the old version of JP1/IM - Manager or Central Scope:

Completed-action linkage function
Monitoring of the maximum number of status change events

If these functions are currently disabled but you want to enable them, execute the jbssetcnf command, using the files shown in the table below as arguments.

Table 6‒9: Settings files for enabling the functions
File name	Description
`action_complete_on.conf`	File for enabling the completed-action linkage function
`evhist_warn_event_on.conf`	File for enabling the function for issuing JP1 events when the number of status change events for the monitoring object exceeds the maximum value (100).

Back up the common definition information.

jbsgetcnf -h logical-host-name > common-definition-information-backup-file-name

To Page Top

(4) Copying the common definition information

Terminate JP1/IM - Manager.

Terminate the JP1/IM - Managers in both the physical and logical host environments.
Copy the common definition information backup file (backed up on the primary server) to the secondary server.

Use a method such as FTP to copy the file.
Set the common definition information.

jbssetcnf common-definition-information-backup-file-name

To Page Top