Hitachi

JP1 Version 12 JP1/Service Support Configuration and Administration Guide

10.9.1 Procedure for product upgrade of JP1/Service Support in a cluster environment

This subsection describes how to upgrade a JP1/Service Support Starter Edition or JP1/Service Support (earlier than version 11-00 other than JP1/Service Support Advanced Edition) operating in a cluster environment to JP1/Service Support (Standard).

  1. 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.

  2. In the pre-upgrade environment on the primary or secondary 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.

  3. 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

  4. Switch the active server to the primary node.

    If the active server is the secondary node, switch it to the primary node.

  5. On the primary node, Insert the distribution media into the drive, and install JP1/Service Support (Standard).

    Install the product by following the prompts of the installer, which starts automatically.

    The same installation folder as the existing JP1/Service Support Starter Edition installation will be used.

    The user information and the program name displayed in the Start menu are also inherited from the previous installation.

  6. If requested, restart the operating system.

  7. Switch the active server from the primary node to the secondary node.

  8. On the secondary node, Insert the distribution media into the drive, and install JP1/Service Support (Standard).

    The procedure is the same as on the primary node (step 5).

  9. Switch the active server from the secondary node to the primary node.

  10. In Service Control Manager on the primary node, start the JP1/Service Support - DB Server service of the Item management database server.

  11. On the primary node, set up the logical host.

    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. If the versions are different (that is, the process involves a version upgrade), 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 size of the Item management database as shown below.

    Table 10‒11: When upgrading 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‒12: When upgrading 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 other than JP1/Service Support Advanced Edition, the drive storing the Item management database does not need to have free space.

    For the memory size required for upgrading, 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.

  12. 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.

  13. Switch the active server from the primary node to the secondary node.

    Switch the active server to the secondary node.

  14. In Service Control Manager on the secondary node, start the JP1/Service Support - DB Server service of the Item management database server.

  15. On the secondary node, set up a logical host and upgrade 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.

  16. 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.

  17. In Service Control Manager on the primary and secondary nodes, stop the JP1/Service Support - DB Server service of the Item management database server.

  18. Start the services in the cluster software.

    First, make sure that the services are running on the secondary node. Then, switch the active node from the secondary node to the primary node and make sure that the services are running on the primary node.

  19. 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.

  20. Expand the size of the Item management database to XL.

    If you do not want to expand the Item management database, you can skip this step.

    For details on how to change the size of the Item management database, see 10.4 Extending the size of the Item management database in a cluster system.

    Note that some of the command options you need to specify in this step are different from those in 10.4 Extending the size of the Item management database in a cluster system. Specify the command arguments as follows:

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 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 product upgrade fails, use the following procedure to restore the pre-upgrade environment:

  1. Uninstall JP1/Service Support.

    For details on how to uninstall JP1/Service Support, see 6.7 Unsetup and uninstallation of JP1/Service Support.

  2. Delete the installation folder and all files and folders under the shared folder on the shared disk.

  3. 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.

  4. Recover the definition information you backed up.

    For details on how to recover definition information, see 11.1.2 Recovering definition information.

  5. Set up a new cluster environment.

  6. Restore the pre-upgrade environment from the backup data.

    Use the backup data you created in step 1 to recover 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

Copyright (C) 2019, Hitachi, Ltd.

Copyright (C) 2019, Hitachi Solutions, Ltd.