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

Upgrading Directory Proxy Server from Java ES 5

This section includes information about upgrading Directory Proxy Server from Release 5 to Release 5U1. The section covers the following topics:

Introduction

When upgrading Release 5 Directory Proxy Server to Release 5U1, consider the following aspects of the upgrade process:

Release 5 Directory Proxy Server Upgrade

This section describes how to perform an upgrade of Directory Proxy Server from Release 5 to Release 5U1. The section covers the following topics:

Pre-Upgrade Tasks

Before you upgrade Directory Proxy Server, perform the tasks described below.

Verify Current Version Information

Verify the current version of Directory Proxy Server before you upgrade.

ProcedureTo Verify Current Version Information

  1. Log in as administrator.

  2. Check the current version of Directory Proxy Server instance.

    DSEE-base\dps6\bin\dpadm.exe -V

  3. Start the new Directory Server Proxy Server instance.

    DSEE-base\dps6\bin\dpadm.exe start instance-path


    [dpadm]
    dpadm               : 6.0                 [Build information]

Upgrade Directory Proxy Server Dependencies

It is generally recommended that all Java ES components on a computer system (and in a computing environment) be upgraded to Release 5U1. Before upgrading Directory Proxy Server, you need to upgrade CAC, MFWK, SJWC, and Security components (NSS,JSS,NSPR). Also, Directory Proxy Server requires that Windows Installer patch (126910–02) is already applied.

Upgrading Release 5 Directory Proxy Server

This section discusses considerations that impact the upgrade procedure for Directory Proxy Server, followed by a description of the procedure itself.

Upgrade Considerations

This upgrade of Directory Proxy Server software to Release 5U1 takes into account the following considerations:

Table 4–3 Patches to Upgrade Directory Proxy Server on Windows

Description 

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

Directory Server Enterprise Edition core (includes Directory Proxy Server) 

125311–05 

Directory Proxy Server localization 

The localized patch files are delivered within the core patch. 

Upgrade Procedure

The procedure documented below applies to Directory Proxy Server instances residing locally on the computer where the upgrade is taking place.


Note –

Directory Server and Directory Proxy Server share the same patch. You require to follow the upgrade procedure listed here only if the Directory Proxy Server is on a separate host. You are not required to execute the Directory Server related stop-commands if the Directory Server is not installed on the same host. However, you can execute the Directory Server stop-command to be sure that the Directory Server process is stopped.


ProcedureTo Upgrade Directory Proxy Server to Release 5U1

  1. Log in as administrator.

  2. Stop any Java ES components which use the Directory Server.

    Stop the service using persistent connections like Access Manager. You can stop Access Manager by stopping its web container.

  3. Shut down the Directory Server.

    Also shut down Directory Server and Directory Registry if they are on the same system.

    DSEE-base\ds6\bin\dsadm.exe stop instancePath

    DSEE-base\dps6\bin\dpadm.exe stop instancePath

    DSEE-base\dscc6\bin\dsccsetup.exe stop instancePath

  4. Make sure you have upgraded any Java ES components upon which Directory Proxy Server has hard upgrade dependencies (see Upgrade Directory Proxy Server Dependencies.

  5. Obtain the required Directory Proxy Server Release 5U1 upgrade patches, based on Table 4–3.

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

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


  7. Verify the patch log file.

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

  8. 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 6. For more information, see Identifying Installed Java ES Patches.

  9. Start the Directory Proxy Server.

    Also start Directory Server and Directory Registry if they are on the same system.

    DSEE-base\ds6\bin\dsadm.exe start instancePath

    DSEE-base\dps6\bin\dpadm.exe start instancePath

    DSEE-base\dscc6\bin\dsccsetup.exe start instancePath

  10. Restart CAC.

  11. Start any Java ES components that use Directory Server.

Verifying the Upgrade

You can verify successful upgrade of Directory Proxy Server as follows:

  1. Log in as administrator.

  2. Check the new version of Directory Proxy Server instance:DSEE-base\dps6\bin\dsadm.exe -V


    [dsadm]
    dsadm               : 6.2                 [Build information]

Post-Upgrade Tasks

There are no post-upgrade tasks beyond the steps described in Upgrade Procedure.

Rolling Back the Upgrade

  1. Log in as administrator.

  2. Shut down the Directory Proxy Server instances.

    DSEE-base\ds6\bin\dpadm.exe stop instancePath

  3. Double-click Uninstall_patch-id.bat to uninstall the patch.

  4. Restart the Directory Proxy Server instances that were shut down in step 2.DSEE-base\ds6\bin\dpadm.exe start instancePath

  5. Start the Directory Server Proxy Server instance.

    DSEE-base\dps6\bin\dpadm.exe start instancePath


    [dpadm]
    dpadm               : 6.0                 [Build information]