Sun Java Enterprise System 5 Upgrade Guide for Microsoft Windows

Chapter 3 Directory Proxy Server

This chapter describes how to upgrade Release 4: Directory Proxy Server 5.2 to Release 5: Directory Proxy Server 6.0.

The chapter provides a general overview of upgrade issues and procedures for the different upgrade paths supported by Release 5. This chapter covers the following topics:

Note –

File locations in this chapter are specified with respect to directory paths referred to asServer-Root (Directory Proxy Server 5.x) and DirectoryProxyServer-base (Directory Proxy Server 6.0). At least part of these paths might have been specified as installation directories when Directory Proxy Server was installed. If not, the Java ES installer assigned a default value.

The default value of Server-Root is Install-dir\Server_Root and DirectoryProxyServer-base is C:\Program Files\Sun\JavaES5\DSEE.

Overview of Directory Proxy Server Upgrades

The following sections describe general aspects of Directory Proxy Server that affect upgrading to Release 5:

About Java ES 5 Directory Proxy Server

Java ES Release 5 Directory Proxy Server represents a major release. Release 5 Directory Proxy Server is still an LDAP proxy, but with new, extensible routing capabilities. Release 5 also enables the Virtual Directory feature, the ability to aggregate multiple data views in a single view. These data views can represent LDAP or SQL accessible data stores.

For more information, see the Sun Java System Directory Server Enterprise Edition 6.0 Release Notes.

Java ES 5 Directory Proxy Server Upgrade Roadmap

Table 3–1 shows the supported Directory Proxy Server upgrade paths to Release 5:

Table 3–1 Upgrade Paths to Java ES 5: Sun Java System Directory Proxy Server 6


Java ES Release	Directory Proxy Server Release	General Approach	Reconfiguration Required
Release 4	Sun Java System Directory Proxy Server 5.2 2005Q4	Direct upgrade: Replace Release 4 with a fresh install and configuration of Release 5.	If backward compatibility desired, manually map previous configuration to new configuration

Directory Proxy Server Data

Directory Proxy Server no longer uses Directory Server for storing configuration data. Configuration is performed using the new Directory Service Control Center or Directory Server EE command-line utilities.

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

Table 3–2 Directory Proxy Server Data Usage


Type of Data	Location	Usage
Directory Proxy Server configuration data	Directory Proxy Server 5.x: configuration directory Directory Proxy Server 6.0: Accessed through Directory Service Control Center and Directory Server EE command-line utilities	Configuration of Directory Proxy Server
Security data	Directory Proxy Server 5.x: SSL configured through Directory Proxy Server Console Directory Proxy Server 6.0: SSL configured through Directory Service Control Center and Directory Server EE command-line utilities	Server certificates

Directory Proxy Server Compatibility Issues

Release 5 Directory Proxy Server introduces interface changes that make it incompatible with earlier Directory Proxy Server releases. Release 5 Directory Proxy Server is based on a completely new Java-based implementation and its configuration differs fundamentally from Release 4 Directory Proxy Server, as well as earlier releases.

However, you can to configure Release 5 Directory Proxy Server to be backwardly compatible, that is, to behave like Release 4 Directory Proxy Server and earlier releases. This configuration requires you to manually map previous configuration attributes to Release 5 configuration properties. For more information, see the Sun Java System Directory Server Enterprise Edition 6.0 Migration Guide.

Directory Proxy Server Dependencies

Dependencies on other Java ES components can impact the procedure for upgrading and reconfiguring Directory Proxy Server software. Directory Proxy Server has dependencies on specific Java ES shared components, as listed in Table 1–7. Directory Proxy Server provides front-end access to Directory Server but has no dependency on Directory Server beyond this functional relationship.

Upgrading Directory Proxy Server from Java ES Release 4

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

Introduction to Upgrading Directory Proxy Server

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

General Upgrade Approach. The upgrade is achieved by performing a fresh install of Release 5 Directory Proxy Server and then configuring new Directory Proxy Server instances using the Directory Service Control Center or Directory Server EE command-line utilities.
Upgrade Dependencies. Directory Proxy Server has dependencies on a number of Java ES shared components, see Table 1–7, all of which are automatically upgraded to Release 5 by the Java ES installer when you perform an upgrade of Directory Proxy Server.
Backward Compatibility. Release 5 Directory Proxy Server can be configured to be backwardly compatible with Release 4.
Upgrade Rollback. A rollback of the Release 5 upgrade is achieved by reverting to the previous version, which is left intact by the upgrade to Release 5.

Directory Proxy Server Upgrade

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

Pre-Upgrade Tasks

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

Upgrading Directory Proxy Server Dependencies

All Java ES components on a computer system and in a computing environment should be upgraded to Release 5.

When upgrading Directory Proxy Server dependencies, you should do so in the order below , before you upgrade Directory Proxy Server. Upgrade of shared components is normally achieved automatically by the Java ES installer.

Shared Components. Release 5 installer automatically installs all required shared components in the parallel path.
Directory Server (optional). Instructions for upgrading Directory Server to Release 5 are provided in Chapter 2, Directory Server. However, Release 5 Directory Proxy Server is supported by Release 4 Directory Server.

To Verify Current Version Information

Start the new Directory Proxy Server instance.

DirectoryServer-base\dps6\bin\dpadm start instancePath

Check for the Directory Proxy Server version.

DirectoryServer-base\dps6\bin\dpadm --version

The outputs that indicate the Java ES Directory Proxy Server release version are:

Release 5

Sun ONE Directory Proxy Server Version 6.0

Release 4

Sun ONE Directory Proxy Server Version 5.2_Patch_4

Upgrade Considerations

When upgrading Directory Proxy Server software to Java ES Release 5 you should take into account the following considerations:

In a deployment architecture in which there are multiple instances of Directory Proxy Server running on a single computer and all instances correspond to the same installed Directory Proxy Server image, upgrading the Directory Proxy Server image will require you to create new Directory Proxy Server instances.
In Release 4 deployment architectures involving Directory Proxy Server, an Administration Server was used to configure and manage Directory Proxy Server instances. In Release 5 the upgrade of Directory Proxy Server might entail deployment of the Directory Service Control Center, used to configure and manage Directory Proxy Server instances.

To Upgrade Directory Proxy Server

Before You Begin

Directory Proxy Server must run as the same user as Directory Server and Administration Server.
Any Java ES components using a Directory Proxy Server instance should be shut down and re-configured to access the corresponding new Release 5 instance.

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.

For information about how to shut down a Java ES component, see its respective administration guide.

Install Release 5 Directory Proxy Server.

For more information on Java ES 5 Directory Proxy Server installation instructions, see the Sun Java Enterprise System 5 Installation Guide for Microsoft Windows.

Create a Directory Proxy Server instance.

(Optional) Map Release 4 configuration attributes to the Release 5 Directory Proxy Server properties.

For more information on mapping procedure, see the Directory Server Enterprise Edition 6 Migration Guide.

All Java ES components dependent on Directory Proxy Server need to be re-configured to point to the new Directory Proxy Server instances.

To Verify the Upgrade

Change to the Server-Root\bin\dps\server\bin directory.

Type the following command:

ldapfwd -v

The outputs that indicate the Java ES Directory Proxy Server release version are:

Release 5

Sun ONE Directory Proxy Server Version 6.0

Release 4

Sun ONE Directory Proxy Server Version 5.2_Patch_4

Rolling Back the Upgrade

A rollback of the Release 5 upgrade is achieved by reverting to the previous version, which is left intact by the upgrade to Release 5.