10.8.1 Procedure for version upgrade of JP1/Service Support in a cluster environment

The following figure shows an overview of the environment setup process when performing a version upgrade of JP1/Service Support in a cluster environment.

Figure 10‒6: Version upgrade installation in cluster environment

To perform a version upgrade of JP1/Service Support running in a cluster environment to the latest version of JP1/Service Support:

In the pre-upgrade environment on the active node, execute the jssdbbackup.bat command to back up the Item management database for recovery purposes.

From the Start menu, select Programs, JP1_Service Support, and then JP1_SS Command Prompt. From the command prompt, execute the jssdbbackup.bat command with the -maint option specified to back up the Item management database. For details on the jssdbbackup.bat command, see jssdbbackup.bat (backs up databases) in Chapter 12. Commands.
In the pre-upgrade environment on the active or standby node, back up the definition information for recovery purposes.

Back up every file listed in Table 11-1 in 11.1.1 Backing up definition information, except the environment setup commands, cluster environment setup command, and environment settings files. The active and standby nodes have the same definition information. We, however, recommend that you back up the definition information on the active node.
Stop the services registered in the cluster software in the following order.

Do not stop the IP address resource or physical disk resource.
- JP1/Service Support - Web Service service
- JP1/Service Support service
- JP1/Service Support - DB Server service
- JP1/Service Support - DB Cluster Service service
Switch the active server from the secondary node to the primary node.

If the secondary node is the active server, switch to the primary node.
On the primary node, perform an overwrite installation of the latest version of JP1/Service Support.
Switch the active server from the primary node to the secondary node.
On the secondary node, perform an overwrite installation of the latest version of JP1/Service Support.
Switch the active server from the secondary node to the primary node.
In Service Control Manager on the primary node, start the JP1/Service Support - DB Server service of the Item management database server.

On the primary node, set up a logical host and perform a version upgrade of the environment.

From the Start menu, select Programs, JP1_Service Support, and then JP1_SS Command Prompt. From the command prompt, execute the jsshasetup.bat command with the -vup option specified. Executing the jsshasetup.bat command requires the drive storing the Item management database to have some free space. The amount of the free space required depends on the version of JP1/Service Support and the size of the Item management database.

Table 10‒9: When upgrading the version from JP1/Service Support 09-00 or 09-50
Size of Item management database	Required free space
S	0.2 GB
M	0.9 GB
L	1.4 GB
LL	2.9 GB
XL	Not applicable because the XL size is not available in JP1/Service Support 09-00 or 09-50

Table 10‒10: When upgrading the version from JP1/Service Support 10-00 or 10-10
Size of Item management database	Required free space
S	0.2 GB
M	0.8 GB
L	1.3 GB
LL	2.3 GB
XL	Not applicable because the XL size is not available in JP1/Service Support 10-00 or 10-10

Note that, when upgrading from JP1/Service Support 10-50 or later, the drive storing the Item management database does not need to have free space.

For details on the memory requirements of the version upgrade process itself, see the Release Notes.

Specify other arguments as described below according to your operation requirements. For details about the jsshasetup.bat command, see jsshasetup.bat (sets up JP1/Service Support in a cluster environment) in Chapter 12. Commands.

Allowing Items to be registered by email: If you want to register Items by email, specify the -t option to create the master system and temporary receipt process work board. Note that you can create a master system and a temporary receipt process work board at any time (not only during setup) by using the jsscreatesysandpwb command. For details on the jsscreatesysandpwb command, see jsscreatesysandpwb (creates the master system and the temporary receipt process work board) in Chapter 12. Commands.

Configure the authentication server.

If you use an LDAP server as the authentication server, or you use the authentication function of JP1/Base, execute the jsschauthorityserver command to switch the authentication server. You can skip this step if you do not use an LDAP server or the authentication function of JP1/Base.

For details on the jsschauthorityserver command, see jsschauthorityserver (switches the authentication method) in Chapter 12. Commands.
Switch the active server from the primary node to the secondary node.

Switch the active server to the secondary node.
In Service Control Manager on the secondary node, start the JP1/Service Support - DB Server service of the Item management database server.
On the standby node, set up a logical host and perform a version upgrade of the environment.

From the Start menu, select Programs, JP1_Service Support, and then JP1_SS Command Prompt. From the command prompt, execute the jsshasetup.bat command with the -vup option specified.

For details on the jsshasetup.bat command, see jsshasetup.bat (sets up JP1/Service Support in a cluster environment) in Chapter 12. Commands.
Configure the authentication server.

If you use an LDAP server as the authentication server, or you use the authentication function of JP1/Base, execute the jsschauthorityserver command to switch the authentication server. You can skip this step if you do not use an LDAP server or the authentication function of JP1/Base.

For details on the jsschauthorityserver command, see jsschauthorityserver (switches the authentication method) in Chapter 12. Commands.
In Service Control Manager on the primary and secondary nodes, stop the JP1/Service Support - DB Server service of the Item management database server.
Start the services in the cluster software.

First, make sure that the services are running on the secondary node. Then, switch from the secondary node to the primary node and make sure that the services are running on the primary node.
On the primary node, execute the jssdbbackup.bat command to back up the Item management database for recovery purposes.

From the Start menu, select Programs, JP1_Service Support, and then JP1_SS Command Prompt. From the command prompt, execute the jssdbbackup.bat command with the -maint option specified to back up the Item management database. For details on the jssdbbackup.bat command, see jssdbbackup.bat (backs up databases) in Chapter 12. Commands.

Notes:: If the version of JP1/Service Support is 10-50 or earlier and registration of Items by email is used, the jsssetup.bat command with the -vup option specified automatically executes the jssauthusersetup (authentication user setting) command. Then, the jssauthusersetup command re-sets the password (hptl_jp1_imss_mail_pop3_password) specified in the email definition file for the mail server that is the destination of Item registration emails.

If the upgrade process fails

If the version upgrade installation fails, use the following procedure to restore the pre-upgrade environment:

Uninstall JP1/Service Support.

For details on how to uninstall JP1/Service Support, see 6.7 Unsetup and uninstallation of JP1/Service Support.
Delete the installation folder and all files and folders under the shared folder on the shared disk.
Perform a new installation of the same version of JP1/Service Support as the pre-upgrade environment.

For details on how to install JP1/Service Support, see 6.3.1 New installation procedure.
Recover the definition information you backed up.

For details on how to recover definition information, see 11.1.2 Recovering definition information.
Set up a new cluster environment.
Restore the pre-upgrade environment by recovering it from the backup data.

Use the backup data you created in step 1 to restore the pre-upgrade environment. For details on recovery, see jssdbrecovery.bat (recovers a database) in Chapter 12. Commands.

If the system is configured to display an HTML manual when Help is clicked

You need to overwrite the existing manual with the new version. For details on how to do so, see 10.2.11 Procedure for incorporating a manual in a cluster environment.

To Page Top