Sun Java Enterprise System 5 Update 1 Upgrade Guide for Microsoft Windows

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:

Table 6–3 Patches to Upgrade Java DB on Windows


Patch ID [Patch revision numbers are the minimum required for upgrade to Release 5U1. If newer revisions become available, use the newer ones instead of those shown in the table.]

Java DB  


Upgrade Procedure

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

ProcedureTo 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\ -f PortalServer-base\lib\derby.xml start-instance

  9. Start any Java DB clients.