Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java Enterprise System Upgrade Guide for HP-UX  

Chapter 4
Directory Proxy Server

This chapter describes how to upgrade Directory Proxy Server to Java ES 2005Q4 (Release 4) Sun Java System Directory Proxy Server 5 2005Q4.

The chapter provides a general overview of upgrade issues and procedures for the different upgrade paths supported by Java ES Release 4.


Note

File locations in this chapter are specified with respect to a directory path referred to as serverRoot. At least part of this path might have been specified as an installation directory when Directory Proxy Server was initially installed. If not, the Java ES installer assigned a default value.

The default value of serverRoot is /opt/sun/mps/serverroot.



Overview of Directory Proxy Server Upgrades

This section describes the following general aspects of Directory Proxy Server that impact upgrading to Java ES 2005Q4 (Release 4):

About Java ES Release 4

Java ES Release 4 Directory Proxy Server represents only minor bug fixes and improvements. There are no new functional capabilities.

Java ES Release 4 Upgrade Roadmap

Table 4-1 shows the supported Directory Proxy Server upgrade paths to Java ES Release 4.

Table 4-1  Upgrade Paths to Java ES Release 4:
Sun Java System Directory Proxy Server 5 2005Q4

Java ES Release

Directory Proxy Server Version

General Approach

Re-configuration Required

Release 3

Sun Java System Directory Proxy Server 5 2005Q1

Direct upgrade:

Apply patches and re-configure configuration directory.

Automatic re-configuration of data in configuration directory

Directory Proxy Server Data

Directory Proxy Server makes use of Directory Server for storing configuration data. The data is stored in a specific tree structure within the directory. The Directory Server instance hosting the configuration is referred to as the configuration directory.

In most deployment architectures, the configuration directory is remote from the other components that use it to store configuration information.

The following table shows the type of data that could be impacted by an upgrade of Directory Proxy Server software.

Table 4-2  Directory Proxy Server Data Usage

Type of Data

Location

Usage

Directory Proxy Server configuration data

Configuration directory

Configuration of Directory Proxy Server

Compatibility Issues

Java ES Release 4 Directory Proxy Server does not introduce any interface changes and is backwardly compatible with earlier versions.

Dependencies

Dependencies on other Java ES components can impact the procedure for upgrading and re-configuring Directory Proxy Server software. Directory Proxy Server has dependencies on specific Java ES shared components (see Table 1-6). Directory Proxy Server provides front-end access to Directory Server and uses Administration Server for configuration purposes. Directory Proxy Server therefore has dependencies on both Directory Server and Administration Server.


Upgrading Directory Proxy Server from Java ES Release 3

This section includes information about upgrading Directory Proxy Server from Java ES 2005 Q1 (Release 3) to Java ES 2005Q4 (Release 4). The section covers the following topics:

Introduction

When upgrading Java ES Release 3 Directory Proxy Server to Release 4, consider the following aspects of the upgrade process:

Directory Proxy Server Upgrade

This section describes how to perform an upgrade of Directory Proxy Server from Java ES Release 3 to Java ES Release 4 on HP-UX platform. The section covers the following topics:

Pre-Upgrade Tasks

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

Verify Current Version Information

You can verify the current version of Directory Proxy Server using the following commands:

cd serverRoot/bin/dps/server/bin

./ldapfwd -v

The output is shown in the following table:

Table 4-3  Directory Proxy Server Version Verification Outputs

Java ES Release

Directory Proxy Server Version Number

Release 3

Sun ONE Directory Proxy Server Version 5.2_Patch_3

Release 4

Sun ONE Directory Proxy Server Version 5.2_Patch_4

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 Java ES Release 4.

Directory Proxy Server has hard upgrade dependencies on Directory Server and Administration Server, even when they run on remote computers, so these components should be upgraded before upgrading Directory Proxy Server.

Upgrading of Java ES Release 3 shared components upon which Directory Proxy Server depends is optional, but recommended.

You can upgrade Directory Proxy Server dependencies in the following order, all before you upgrade Directory Proxy Server. You can skip any that might already have been upgraded.

  1. Shared Components. Instructions for upgrading Java ES shared components to Release 4 are provided in Chapter 2, "Upgrading Java ES Shared Components".
  2. Directory Server. Instructions for upgrading Directory Server to Release 4 are provided in Chapter 3, "Directory Server and Administration Server".
Back Up Directory Server Data

The Directory Proxy Server upgrade process modifies configuration directory data. Therefore, before you upgrade, it is recommended that you back up your configuration directory data using the Directory Server Console or a command-line utility such as db2bak.

For more information about backing up Directory Server, see the Sun Java System Directory Server Administration Guide (http://docs.sun.com/doc/817-7613).

Obtain Required Configuration Information and Passwords

Directory Proxy Server must run as the same user and group as Directory Server and Administration Server. That is, they must all run with the same UID and GID.

Upgrading 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

The upgrade of Directory Proxy Server software to Java ES Release 4 takes into account the following considerations:

Table 4-4  Patches1 to Upgrade Directory Proxy Server

Component

Patch-ID

Directory Proxy Server

121521-01

Directory Proxy Server locale

121932-01

1Patch revision numbers are the minimum required for upgrade to Java ES Release 4. If newer revisions become available, use the newer ones instead of those shown in the table.

Upgrade Procedure

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

  1. Obtain the required patches, based on Table 4-4.
  2. Patches can be downloaded from:

    http://sunsolve.sun.com.

  3. Log in as superuser.
  4. su root

  5. Stop the Administration Console if it is running locally.
  6. Shut down all Java ES components dependent on the Directory Proxy Server instances that are to be upgraded. This step might depend on how Directory Proxy Server is replicated within your deployment architecture.
  7. For information about how to shut down a Java ES component, see its respective administration guide.

  8. Make sure you have upgraded any Java ES components upon which Directory Proxy Server has hard upgrade dependencies (see “Upgrading Directory Proxy Server).
  9. Upgrade Directory Proxy Server.
    1. Ensure that the configuration directory is running.
    2. If it is local you might have to start it up. If it is remote, check to make sure it is running.

    3. Apply the Directory Proxy Server patches in Table 4-4.
    4. swinstall -s $<path_to_DirectoryProxyServer_patch>/<patch_ID> <patch_ID>

  10. Restart Directory Proxy Server and all Java ES components dependent on Directory Proxy Server.
  11. To restart Directory Proxy Server:

    serverRoot/dps-hostName/restart-dps

Verifying the Upgrade

You can verify successful upgrade of Directory Proxy Server using the following commands:

See Table 4-3 for output values.

Post-Upgrade Tasks

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

Rolling Back the Upgrade

This section describes considerations that impact the upgrade rollback procedure for Directory Proxy Server, followed by the procedure itself.

Rollback Considerations

The procedure for rolling back the upgrade to Release 4 of Directory Proxy Server is pretty much the reverse of the procedure for upgrading to Release 4. The patches are removed and the configuration directory is re-synchronized.

One special consideration is that when you apply patches, you upgrade the SSL certificate database to a cert8 format. The patch backs up the cert7 data, and then converts it to cert8 format. If you subsequently decide to roll back the upgrade and have added new certificates to the certificate database, you should manually extract these certificates, back out the patches, and then add the certificates back to the previous cert7 format certificate database.

When you roll back an upgrade after having changed the SSL certificate database, you cannot start in SSL mode. To work around this problem, turn off SSL mode, restart Administration Server and Directory Proxy Server, reinstall the certificate, and then enable SSL mode.

Rollback Procedure
  1. Log in as superuser.
  2. su root

  3. Stop the Administration Console if it is running locally.
  4. Shut down all Java ES components dependent on the Directory Proxy Server instances that are to be upgraded. This step might depend on how Directory Proxy Server is replicated within your deployment architecture.
  5. For information about how to shut down a Java ES component, see its respective administration guide.

  6. Roll back the Directory Proxy Server upgrade.
    1. Ensure that the configuration directory is running.
    2. If it is local you might have to start it up. If it is remote, check to make sure it is running.

    3. Remove the Directory Proxy Server patches in Table 4-4.
    4. swremove <patch_ID>

  7. Roll back upgrades to any Java ES components upon which Directory Proxy Server has hard upgrade dependencies, in particular Directory Server and Administration Server.
  8. Restart Directory Proxy Server and all Java ES components dependent on Directory Proxy Server.

Multiple Instance Upgrades

In some deployment architectures Directory Proxy Server is deployed on multiple computer systems to provide for scalability and to improve availability. For example, you might have Directory Proxy Server components running on multiple computers with a load balancer to distribute the load.

In the case of load-balanced instances of Directory Proxy Server, you can perform a rolling upgrade in which you upgrade the Directory Proxy Server instances sequentially without interrupting service. You upgrade each instance of Directory Proxy Server while the others remain running. You perform the upgrade of each instance as described in Directory Proxy Server Upgrade.



Previous      Contents      Index      Next     


Part No: 819-4460-10.   Copyright 2006 Sun Microsystems, Inc. All rights reserved.