Upgrading Directory Server Enterprise Edition to 6.3.1 Using Native Packages

To Upgrade Shared Components Using Patches

Before You Begin

Before upgrading Directory Server Enterprise Edition to 6.3.1 using native packages, you must upgrade the shared components. On Solaris and Red Hat systems you must be root, on Windows systems, you must be Administrator to perform this procedure.

Using patches, you can upgrade shared components on Solaris, Linux, and Windows. On Linux, to install patches you must use installpatch. The installpatch script is delivered with the patch.

Select the platform as per your requirements and install all the patches specified for that platform. If newer patch revisions become available, use the newer ones instead of those shown in the table.

Choose the right NSS/NSPR/JSS patch for your system by getting the package version of SUNWpr and SUNtls on your system.

# pkginfo -l SUNWpr | grep VERSION
# pkginfo -l SUNWtls | grep VERSION    

Then choose the right patch series from the table below.

The following table lists the Shared Components patches for Windows platform.

Before upgrading Directory Server Enterprise Edition 6.0, 6.1, 6.2, or 6.3 to 6.3.1, you need to upgrade the shared components.

1. Shut down any processes using the shared components.

2. If applicable, shut down the shared components.

3. Obtain the latest upgrade patches as shown in the tables above.

   For more information on how to obtain the patches, see Getting the Software.

4. Apply the appropriate patches for the shared components.

   Read the README.patchID file for detailed patch installation procedures.

5. Verify that the patch upgrades were successful.

   Read the README.patchID file for verification procedure.

6. If applicable, restart the shared components.

7. To Upgrade the Common Agent Container shared component on Windows, run the following commands in the same order as listed below:

   # cacaoadm prepare-uninstall # 126183-04.exe # cacao-install-path\share\cacao_2\configure.bat # cacao-install-path\share\cacao_2\bin\cacaoadm rebuild-dependencies

8. If your installation uses Identity Synchronization for Windows and you have applied the latest NSS patch 3.12 on your system, set symbolic links to the new libraries delivered in NSS patch 3.12, as shown in the following example. The default value of the SERVER_ROOT path name is /var/mps/serverroot.

   $ cd /var/mps/serverroot/lib $ ln -s /usr/lib/mps/secv1/libnssdbm3.so libnssdbm3.so $ ln -s /usr/lib/mps/secv1/libnssutil3.so libnssutil3.so $ ln -s /usr/lib/mps/secv1/libsqlite3.so libsqlite3.so $ cd /var/mps/serverroot/lib/sparcv9 $ ln -s /usr/lib/mps/secv1/sparcv9/libnssdbm3.so libnssdbm3.so $ ln -s /usr/lib/mps/secv1/sparcv9/libnssutil3.so libnssutil3.so $ ln -s /usr/lib/mps/secv1/sparcv9/libsqlite3.so libsqlite3.so

To Upgrade Directory Server Enterprise Edition Using Native Packages

Before You Begin

Make sure all the shared components are up-to-date. For more information, see To Upgrade Shared Components Using Patches.

If you already have Directory Server Enterprise Edition 6.0, 6.1, 6.2, or 6.3 installed, upgrade to version 6.3.1 using the following procedure.

On Solaris and Red Hat systems, you must be root to perform these steps and Administrator on Windows systems.

All the Directory Server instances, Directory Proxy Server instances, and configuration information remain unaffected after you complete the Directory Server Enterprise Edition upgrade.

The following table displays the patch numbers that are required to upgrade Directory Server Enterprise Edition on different platforms. If newer patch revisions become available, use the newer ones instead of those shown in the table.

To make the localized Directory Server Enterprise Edition work successfully, install the localized patches before installing the core patches.

Each localization patch contains all the supported languages for the selected platform.

1. Stop the DSCC registry.

   • On Solaris

     # dsadm stop /var/opt/SUNWdsee/dscc6/dcc/ads

   • On Linux

     # dsadm stop /var/opt/sun/dscc6/dcc/ads

   • On Windows, the following dsadm command fails to stop the DSCC registry.

     dsadm.exe stop C:\Program Files\Sun\JavaES5\DSEE\var\dscc6\dcc\ads

     As a workaround, kill the bin_slapd.exe process using Task Manager, and log in as Administrator. You can now start and stop the DSCC registry successfully. The owner of the DSCC registry remains the same, that is, SYSTEM.

2. Stop any running instances of Directory Server and Directory Proxy Server.

3. Upgrade the shared components. See To Upgrade Shared Components Using Patches.

4. Download the Directory Server Enterprise Edition 6.3.1 patch.

   See Getting the Software for more details.

5. Change to the directory where you have saved the patch listed in the preceding table.

6. Run the following command to install the patch.

   • Solaris OS

     Before upgrading Directory Server Enterprise Edition, you must install 119254-38 on Solaris 10 SPARC and 119255-38 on Solaris 10 x86. See Getting the Software for information on downloading patches.

     Alternatively, use -G with the patchadd command on Solaris 10 SPARC and Solaris 10 x86 while applying the Directory Server Enterprise Edition upgrade patch. For example:

     # patchadd -G patch-id

     For other versions of Solaris, use the following command:

     # patchadd patch-id

   • Linux

     1. Open the directory where the installpatch file is located.

     2. Run installpatch.

        # ./installpatch

   • Windows

     1. Open the folder where the patch-id.exe executable file is located.

     2. Double-click patch-id.exe.

     3. After the successful installation of the patch, run the following commands:

        # dsccsetup console-unreg # dsccsetup console-reg

7. Start the Directory Server instances and Directory Proxy Server instances, if any.

8. Start Web Console and Common Agent Container.

9. Restart the DSCC registry.

   • On Solaris

     # dsadm start /var/opt/SUNWdsee/dscc6/dcc/ads

   • On Linux

     # dsadm start /var/opt/sun/dscc6/dcc/ads

   • On Windows

     dsadm.exe start C:\Program Files\Sun\JavaES5\DSEE\var\dscc6\dcc\ads