3.7.3 Upgrade procedure

(1) Procedure for backing up the data from the upgrade target

Perform the procedure below in the pre-upgrade environment.

Important note

If there is Operational Content associated with I/O Plugins that were created using a version of uCosminexus Navigation Developer earlier than 09-50 (old I/O Plugins), delete the relevant User Plugins before upgrading. If the old I/O Plugins are left in place, the attempt to restore the data from the upgrade target might fail.

Reference note

For details about the properties and directories mentioned in this procedure, see the documentation for the product being upgraded.

1. Create a backup folder in a location of your choice.

2. Create a folder named contents directly under the backup folder.

3. Execute the following command to export all the Operational Contents to the contents folder:

   Navigation-Platform-installation-directory\bin\npexport backup-folder-path\contents\backupcontents.zip

4. Create a folder named htdocs directly under the backup folder.

5. Copy the folder indicated below to the htdocs folder directly under the backup folder.

   • In uCosminexus Navigation Platform:

     Cosminexus-installation-directory\httpsd\htdocs\ucnpuserstaticfiles

     Note that if the value of the property ucnp.base.server.cosminexus.httpsd.documentroot.path in the user property file (ucnp_user.properties) has been revised from its default, substitute the revised value for the Cosminexus-installation-directory\httpsd\htdocs portion of the path.

   • In JP1/Integrated Management - Navigation Platform:

     Navigation-Platform-installation-directory\PP\uCPSB\httpsd\htdocs\ucnpuserstaticfiles

6. If there are a folders other than ucnpuserstaticfiles in the htdocs source folder indicated in step 5, copy them into the htdocs folder directly under the backup folder.

   However, the ucnp folder does not need to be copied.

7. Copy the following folder to just below the backup folder:

   Navigation-Platform-installation-directory\conf

   In the case of JP1/Integrated Management - Navigation Platform, the backup is now complete. In the case of uCosminexus Navigation Platform, the steps below must also be performed as needed.

8. If the upgrade target is uCosminexus Navigation Developer, copy all of the following folders to just below the backup folder:

   • Navigation-Platform-installation-directory\pluginSDK

   • Navigation-Platform-installation-directory\usrlib

   • The portal project directory (the value specified for the property ucnp.setup.server.ucnp.portalproject.path in the user setup property file (ucnp_setup_user.properties))

9. Create the following folders directly under the backup folder:

   • A folder named j2ee_usrconf

   • A folder named j2ee_connector

10. Copy all of the following files to the j2ee_usrconf folder directly under the backup folder:

    • Cosminexus-installation-directory\CC\server\usrconf\ejb\value-of-property-ucnp.setup.server.cosminexus.ejbserver.name\usrconf.cfg

    • Cosminexus-installation-directory\CC\server\usrconf\ejb\value-of-property-ucnp.setup.server.cosminexus.ejbserver.name\usrconf.properties

11. Copy the library files in the path specified in the add.class.path key in the usrconf.cfg file you copied in step 10 to the folder backup-folder\usrlib\sys.

12. Execute the following command to display the list of resource adapters on the J2EE server:

    Cosminexus-installation-directory\CC\admin\bin\cjlistrar value-of-property-ucnp.setup.server.cosminexus.ejbserver.name -nameserver corbaname::localhost:value-of-property-ucnp.setup.server.cosminexus.ejbserver.naming.port

    Make note of the display name of each resource adapter in the list.

13. Execute the following command to back up the resource adapter connector attribute file to the j2ee_connector file:

    Cosminexus-installation-directory\CC\admin\bin\cjgetrarprop value-of-property-ucnp.setup.server.cosminexus.ejbserver.name -nameserver corbaname::localhost:value-of-property-ucnp.setup.server.cosminexus.ejbserver.naming.port -resname display-name-of-resource-adapter -c backup-folder-path\j2ee_connector\display-name-of-resource-adapter.xml

14. If there are multiple resource adapters, repeat step 13 for each resource adapter.

To Page Top

(2) Procedure to perform unsetup to restore the previous version's environment

Perform the unsetup procedure by consulting the documentation for the product that is to be upgraded. If the upgrade target is uCosminexus Navigation Developer, unsetup of WTP must also be perform.

To Page Top

(3) Uninstall the previous version's environment

Perform the following procedure in the environment where the unsetup procedure was completed:

1. Uninstall the product to be upgraded by following its documentation.

2. Restart the OS.

3. If there are any remaining logs or other files you want to keep in the Navigation Platform installation directory, back them up before deleting them.

4. Delete the following folder:

   Navigation-Platform-installation-directory

To Page Top

(4) Upgrade JP1/Base

In the case of an environment in which JP1/Base has been set up, perform the procedure below.

Reference note

For details about using JP1/Base in this procedure, see the JP1/Base User's Guide. For details about the properties in this procedure, see the documentation for the product being upgraded.

1. Upgrade JP1/Base.

   After upgrading JP1/Base, start or restart the JP1/Base-related services as needed.

2. Make changes to ensure that the value of the property ucnp.base.server.jp1auth.system.resource.group is the same as the name of the JP1 resource group set in JP1/Base.

   The default value of the property ucnp.base.server.jp1auth.system.resource.group will be different in the product being upgraded and the post-upgrade Navigation Platform. You must therefore change either the JP1/Base setting or the value specified for the Navigation Platform property.

3. Change the JP1 permission levels specified in JP1/Base as follows:

   Before change	After change
   UCNP_Admin JP1_IMNP_Admin	HNP_Admin
   UCNP_Editor JP1_IMNP_Editor	HNP_Editor
   UCNP_User JP1_IMNP_User	HNP_User

To Page Top

(5) Upgrade JP1/Automatic Operation

In the case of an environment linked to JP1/Automatic Operation, perform the following procedure:

1. Upgrade JP1/Automatic Operation.

   For details about how to upgrade JP1/Automatic Operation, see the JP1/Automatic Operation documentation. After upgrading JP1/Automatic Operation, start or restart the JP1/Automatic Operation-related services as needed.

2. If you are using the Automatic Operation Service Execution Plugin, delete the directory specified in the property ucnp.base.client.jp1ao.submittask.passwordfile.path.

To Page Top

(6) Install Navigation Platform

For details about how to install Navigation Platform, see 3.5.2 Procedure for a new installation.

To Page Top

(7) Revise the user setup property file

Copy the sample file for the post-upgrade user setup property file (ucnp_setup_user.properties), and modify the settings as needed. For the location of the sample file and where to copy it to, see 8.3.2 Storage location of the user setup property file.

Because different properties will be available before and after the upgrade, and there will be properties whose default value has changed, you must not use the user setup property file that was backed up. For details about the differences between properties before and after an upgrade, see Appendix D. Properties That Need to Be Checked When a Version Upgrade is Performed.

Tip

When upgrading uCosminexus Navigation Developer, the following properties must be set:

• ucnp.setup.server.cosminexus.debug.enable

• ucnp.setup.server.cosminexus.debug.jdwp.port

To Page Top

(8) Set up Navigation Platform

For details about how to set up Navigation Platform, see Chapter 4. Setting Up Navigation Platform.

To Page Top

(9) Restore the data from the upgrade target

Restore the pre-upgrade environment by copying to the post-upgrade Navigation Platform the data backed up in (1) Procedure for backing up the data from the upgrade target.

1. Edit the backed-up user property file (ucnp_user.properties).

   Some properties that were available in the previous version might not be available after the upgrade. For details about the differences between properties before and after an upgrade, see Appendix D. Properties That Need to Be Checked When a Version Upgrade is Performed.

2. If you have customized the contents of messages, reset the messages in the user message properties file.

   Configure the messages that were customized in the backed-up user message properties file (ucnp_message_user.properties) in the post-migration user message properties file (Navigation-Platform-installation-directory\conf\ucnp_message_user.properties). In the case of a Japanese locale, configure the Japanese version of the user message properties file (ucnp_message_user_ja.properties).

3. If Operational Contents are associated with JP1 events in the earlier product, copy the backed-up JP1 event mapping file to the folder indicated below.

   File to be copied

   Backup-directory\conf\ucnp_jp1event_mapping.txt

   Destination directory

   Navigation-Platform-installation-directory\conf

4. Restart Navigation Platform.

5. Copy the files related to the application server settings.

   For the detailed procedure, see the description about changing the J2EE server settings in the Hitachi Navigation Platform Development Guide.

6. Copy the data created by developers.

   For the detailed procedure, see the description about migrating plug-ins developed with earlier versions in the Hitachi Navigation Platform Development Guide.

7. Copy the backed-up static files to the following folder:

   Navigation-Platform-installation-directory\PP\uCPSB\httpsd\htdocs

   Do not overwrite the ucnp folder directly below the destination htdocs folder.

8. Execute the following command to import the Operational Contents:

   Navigation-Platform-installation-directory\bin\npimport -d backup-folder\contents\backupcontents.zip

   If the npimport command (import Operational Content) terminates with an error, message KDCZ10382-E is output, and the name of the access permission group in the message is Standard access permissions, perform the procedure described in (10) If the npimport command (import Operational Content) terminates with an error.

To Page Top

(10) If the npimport command (import Operational Content) terminates with an error

Perform the following procedure when the npimport command (import Operational Content) terminates with an error, message KDCZ10382-E is output, and the name of the access permission group in the message is Standard access permissions:

1. Specify true for the property ucnp.base.server.acl.defaultacl.name.japaneseonly in the user property file (ucnp_user.properties).

2. Restart Navigation Platform.

3. Execute the following command to re-import the Operational Contents:

   Navigation-Platform-installation-directory\bin\npimport -d backup-folder\contents\backupcontents.zip

4. Change the name of the access permission group.

   Log in to Navigation Platform with system administrator permissions and change the name of the access permission group Standard access permissions to a name other than or Standard access permissions.

   For information about how to change the name of the access permission group, see 6.2 Setting access permissions for Operational Contents (when using a directory server for user authentication).

5. Specify false for the property ucnp.base.server.acl.defaultacl.name.japaneseonly in the user property file (ucnp_user.properties).

6. Restart Navigation Platform.

To Page Top