This discusses the following topics:
Directory Proxy Server 6.3.1 update 1 is a patch that is applied to an existing installation of Directory Server Enterprise Edition 6.3.1. If you are running Directory Server Enterprise Edition version earlier than 6.3.1, you must first upgrade to version 6.3.1 as described in Chapter 2, Installation Notes before applying the patch for Directory Proxy Server 6.3.1 update 1.
You can download the Directory Proxy Server 6.3.1 update 1 patch from http://www.sun.com/software/products/directory_srvr_ee/get.jsp.
Directory Proxy Server 6.3.1 update 1 is a unique patch for all the DSEE platforms:
Solaris SPARC
Solaris 9 x86
Solaris 10 x86 and AMD x64
Red Hat Linux
SuSe Linux
HP-UX
Windows
For each platform, the following distributions are available:
Native package distribution (except for HP-UX)
Zip distribution
Directory Proxy Server 6.3.1 update 1 patch 141958-01 is available through SunSolve and applies to both of the following kinds of installation:
Directory Server Enterprise Edition 6.3.1 native packages installed using the Java ES installer
Directory Server Enterprise Edition 6.3.1 zip installations
This section describes how to install the Directory Proxy Server 6.3.1 update 1.
Back up the Directory Server Enterprise Edition installation directory before applying the Directory Proxy Server 6.3.1 update 1 patch, because you cannot restore an earlier Directory Proxy Server configuration later. This advice applies to both Zip and Native Packages installations.
Download Patch 141958-01 from Sunsolve to a downloaded-patch-path directory.
Stop the Directory Proxy Server instances associated with the installation that you intend to patch.
On Windows systems, open a Command Prompt window. On UNIX systems, open a terminal window.
Change the current directory to the directory with installation software for the platform and distribution (zip or native) that you want to update:
The following example shows a typical command for this purpose:
$ cd downloaded-patch-path/SunOS_x64/zip/delivery |
The following table shows the locations of installation software under the downloaded-patch-path directory.
Operating System |
Directory Containing the Zip Delivery |
Directory Containing the Native Package Delivery |
---|---|---|
Solaris SPARC |
SunOS/zip/delivery |
SunOS/native/delivery |
Solaris 9 x86 |
SunOS_x86/zip/delivery |
SunOS_x86/native/delivery |
Solaris 10 x86 and AMD x64 |
SunOS_x64/zip/delivery |
SunOS_x64/native/delivery |
Red Hat Linux |
Linux/zip/delivery |
Linux/native/delivery |
SuSE Linux |
Linux/zip/delivery |
Linux/native/delivery |
HP-UX |
Hpux/zip/delivery |
N/A |
Windows |
Windows/zip/delivery |
Windows/native/delivery |
On UNIX systems, launch the installation script.
Run the following command:
$ Install dsee631-install-path |
where dsee631-install-path is the path to the directory where Directory Server Enterprise Edition 6.3.1 is installed.
The following messages appear:
-------------------------------------------------------------------- IMPORTANT : Make sure all the DPS instances associated with the Directory Proxy Server installation being patched are shutdown prior to apply the Directory Proxy Server 6.3.1 Update 1 Patch -------------------------------------------------------------------- Do you want to proceed with the installation (y/Y to proceed, n/N to abort) [n] ? |
Enter y for yes. The installation program applies the patch on the Directory Server Enterprise Edition 6.3.1 installation that you specified.
On Windows installations, run the following command in the Command Prompt window:
Install.exe |
A wizard opens and requests that you browse and select the correct installation path for installing the Directory Proxy Server 6.3.1 update 1 patch. To patch a 6.3.1 ZIP installation, select the directory where you installed Directory Server Enterprise Edition 6.3.1. To patch a Native Package installation, select C:\Program Files\Sun\JavaES5\DSEE.
The wizard applies the patch on Directory Server Enterprise Edition 6.3.1.
Confirm that the installation is successful by running these two commands and verifying that the response is the same as shown here:
$ dpadm -V [dpadm] dpadm : 6.3.1.1 B2009.1106.0156 ZIP [DPS] Sun Microsystems, Inc. Sun-Java(tm)-System-Directory-Proxy-Server/6.3.1.1 B2009.1106.0259 $ dpconf -V [dpconf] clip.jar : 6.3.1 B2008.1121.0155 dpcfg.jar : 6.3.1.1 B2009.1106.0155 dpcfgcli.jar : 6.3.1.1 B2009.1106.0155 common.jar : 6.3.1 B2008.1121.0155 common_cfg.jar : 6.3.1 B2008.1121.0155 |
This step is required if the Directory Server Enterprise Edition 6.3.1 that you are patching includes hot fix for CR 6722222.
If the hot fix for CR 6722222 (Map bindDN when binding to a LDAP server (using DN mapping rule of the DV of the bindDN)) has been applied, run the following command in all the instances for every connection handler:
$ dpconf set-connection-handler-prop -p port -h host connection handler \ data-view-use-internal-client-identity:true |
This property is a flag that indicates that it is not always required to use incoming client identity at binding to a remote LDAP server. After CR 6722222 is applied, the default behavior can now be configured with a connection handler property, as shown in the example.
Restart all proxy server instances.