11.3.3 Changing the host name

You cannot change the host name or logical host name (for a cluster system) while JP1/Service Support is running. When you change the host name, you must also change the JP1/Service Support settings.

To change the host name:

1. Stop services in the following order:

   • JP1/Service Support - Task Service service

   • JP1/Service Support - Web Service service

   • JP1/Service Support service

2. Execute the jssdbbackup.bat command to back up the data in the Item management database.

   When you execute this command, specify the -maint option as an argument. For details about the command, see jssdbbackup.bat (backs up databases) in Chapter 12. Commands.

3. Check the startup type of the following services, and then, if it is Automatic, change it to Manual:

   • JP1/Service Support service

   • JP1/Service Support - DB Server service

   • JP1/Service Support - Web Service service

   • JP1/Service Support - Task Service service

   Note:

   After changing the host name, you will need to restore the startup types of the services to the state they were in before changing the host name. Therefore, record the original startup types.

4. Change the host name.

5. Restart the OS.

6. Execute the jssdbinit.bat command to initialize the Item management database.

   For details about the command, see jssdbinit.bat (initializes databases) in Chapter 12. Commands.

   Note:

   For the -s option (size of the Item management database), make sure that you specify the size of the Item management database that you obtained in step 2.

7. Execute the jssdbrecovery.bat command to recover the Item management database.

   When you execute this command, specify the -maint option as an argument. For details about the command, see jssdbrecovery.bat (recovers a database) in Chapter 12. Commands.

   Note:

   For the -f option (backup file name), make sure that you specify the name of the backup file that you obtained in step 2.

8. If email notification is being used, change the server name in the URL definition file (jsslogin.url).

9. Restart services in the following order:

   • JP1/Service Support service

   • JP1/Service Support - Web Service service

   • JP1/Service Support - Task Service service

10. Return the startup type of the services you changed to Manual in step 3 to Automatic.

To change the logical host name (for a cluster system):

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

   Switch the nodes by using the cluster software. This step is not necessary if the primary node is already running as the active server.

2. On the primary node, use the cluster software to stop services in the following order:

   • JP1/Service Support - Task Service service

   • JP1/Service Support - Web Service service

   • JP1/Service Support service

3. On the primary node, execute the jssdbbackup.bat command to back up the data in the Item management database.

   Specify the -maint option as an argument. For details about the command, see jssdbbackup.bat (backs up databases) in Chapter 12. Commands.

4. Delete the logical host from a cluster environment.

   For details about the procedure, see 10.6 Deleting a logical host from a cluster environment.

5. On the active and standby servers, edit the logical host name in jsshasetupinfo.bat.

   Change the value of IMSSLOGICALHOST to the new logical host name. At this time, do not change other values.

   For details about how to edit jsshasetupinfo.bat, see 10.2.4 Editing jsshasetupinfo.bat.

6. Change the resource (logical host name) of the cluster software.

   Change the logical host name to the new one. For details about resources of the cluster software, see 10.2.5 Registering resources in the cluster software.

7. Set up a logical host on the primary node.

   For details about the procedure, see 10.2.6 Setting up a logical host (primary node).

8. Set up a logical host on the secondary node.

   For details about the procedure, see 10.2.7 Setting up a logical host (secondary node).

9. Register the services in the cluster software.

   For details about the procedure, see 10.2.8 Registering services in the cluster software.

10. On the primary node, use the cluster software to start services in the following order:

    • JP1/Service Support - DB Cluster Service service

    • JP1/Service Support - DB Server service

11. On the primary node, execute the jssdbrecovery.bat command to recover the Item management database.

    Use the Item management database backup file to recover the Item management database.

    Specify the -maint option as an argument. For the -f option, specify the backup file that was created for the Item management database in step 3.

    For details about the jssdbrecovery.bat command, see jssdbrecovery.bat (recovers a database) in Chapter 12. Commands.

12. If email notification is set up, change the server name in the URL definition file (jsslogin.url).

    For details about the URL definition file (jsslogin.url), see URL definition file (jsslogin.url) in Chapter 13. Definition Files.

The following describes influences on linked products.

Organization of this subsection

• (1) If linkage with JP1/IM - Manager is used

• (2) If linkage with JP1/AIM is used

• (3) If linkage with JP1/NP is used

• (4) If linkage with JP1/AO is used

• (5) If linkage with JP1/ITDM2 - Asset Console

• (6) If linkage with JP1/Base (authentication functionality) is used