Upgrading Release 5 Java DB

This section discusses considerations that impact the upgrade procedure for Java DB, followed by a description of the procedure itself.

Upgrade Considerations

The upgrade of Java DB software to Java ES Release 5U1 takes into account the following considerations:

• In a deployment architecture in which there are multiple instances of Java DB running on a single computer (all corresponding to the same installed Java DB image), you only have to upgrade the Java DB image once.

• In a maintenance upgrade, you do not have to migrate schema, configuration, security or user data.

• The Release 5U1 Java DB upgrade patches for Windows are shown in the following table:

Upgrade Procedure

The procedure documented below applies to Java DB instances residing locally on the computer where the upgrade is taking place.

To Upgrade Java DB to Java ES 5 Update 1

1. Log in as administrator.

2. Stop any Java DB instances.

   If you have a network server running, use the following command:

   java -cp JavaDB-base\lib\derby.jar:JavaDB-base\lib\derbynet.jar/ org.apache.derby.drda.NetworkServerControl shutdown

   Otherwise, simply stop all applications using Java DB.

3. Make sure you have upgraded any Java ES components upon which Java DB has hard upgrade dependencies (see Upgrade Java DB Dependencies).

4. Obtain the required Java DB Release 5U1 upgrade patches, based on Table 6–3.

   To obtain the patch, see Accessing Java ES Patches. Patches can be downloaded to \workingDirectory.

5. Install the patch.

   Installation is generally performed by running patch-id.exe, however, be sure to consult the README.patch-id file in the patch directory for installation instructions.

   ---

   Note –

   If you are prompted to restart the system, select No. Wait till the patch installation process is completed and then restart and re-login as the same user to complete the patch installation.

   ---

6. Verify the patch log file.

   The log file is found at: %TEMP%\SUNJAVAES_<patch-id>.log

7. Verify the patch installation with the utility ListJavaESPatches.exe.

   Run ListJavaESPatches.exe and check that the output includes the patch id of the patch that you have installed in Step 5. For more information, see Identifying Installed Java ES Patches.

8. Start the Release 5 Java DB instances.

   For example, start Java DB instance for Portal Server with ANT from the command line.

   JavaES5-Install-Dir\share\ant\bin\ant.bat -DPS_CONFIG=PortalServer-base\config\PSConfig.properties -f PortalServer-base\lib\derby.xml start-instance

9. Start any Java DB clients.