Installing Directory Server Enterprise Edition Using Native Packages

To install Directory Server Enterprise Edition 6.3 using native packages, you must have 6.0, 6.1, or 6.2 installed on your computer and then upgrade to 6.3. Refer to the following procedure to install Directory Server Enterprise Edition 6.3 successfully

1. Install Directory Server Enterprise Edition 6.0, 6.1, or 6.2. In this guide, the installation instructions for Directory Server Enterprise Edition 6.2 are shown.

   On Windows, you cannot install Directory Server Enterprise Edition 6.2 directly, so you must install version 6.0 then directly upgrade to 6.3.

2. Upgrade all the shared components to successfully upgrade to Directory Server Enterprise Edition 6.3. For detailed information, refer to To Upgrade Shared Components Using Patches.

3. Upgrade your Directory Server Enterprise Edition installation to 6.3 by applying the respective patches as mentioned in To Upgrade Directory Server Enterprise Edition Using Native Packages.

You can install Directory Service Control Center, Directory Server, and Directory Proxy Server on the same host but in the following procedure it is shown as if all the three components are being installed on different computers. If you install all the three components on the same computer, in the components selection screen shown in the following procedure, select all the three components to install.

To Install Only Directory Server From Native Packages

This procedure covers installation of Directory Server from native packages. You must be root to perform this procedure.

If you installed Directory Service Control Center, you automatically installed Directory Server from native packages. You can use the Directory Server software that is installed alongside DSCC to create your own additional Directory Server instances on the system.

Before You Begin

Obtain the Java Enterprise System update 1 distribution for this installation, as shown in the following figure:

Complete the following worksheet for your installation.

1. Install prerequisite patches or service packs for your platform.

   See Operating System Requirements in Sun Java System Directory Server Enterprise Edition 6.3 Release Notes.

2. Using the Java Enterprise System distribution, run the Java ES installer as root.

   root# ./installer

3. Select the Directory Server component for installation.

   

   If you do not want to install the multilingual packages, deselect the Install multilingual package(s) for all selected components check box.

4. Choose to configure the software later, as you will upgrade the software to 6.3.

   

5. Complete installation with the Java ES installer.

To Install Only Directory Proxy Server From Native Packages

This procedure covers installation of Directory Proxy Server from native packages. You must be root to perform this procedure.

Before You Begin

Obtain the Java Enterprise System update 1 distribution for this installation, as shown in the following figure:

Complete the following worksheet for your installation.

1. Install prerequisite patches or service packs for your platform.

   See Operating System Requirements in Sun Java System Directory Server Enterprise Edition 6.3 Release Notes.

2. Using the Java Enterprise System distribution, run the Java ES installer as root.

   root# ./installer

3. Select the Directory Proxy Server component for installation.

   

   If you do not want to install the multilingual packages, deselect the Install multilingual package(s) for all selected components check box.

4. Choose to configure the software later, as you will upgrade the software to 6.3.

   

5. Complete installation with the Java ES installer.

To Install Directory Service Control Center From Native Packages

This procedure covers installation of Directory Service Control Center, also known as DSCC, and remote administration command-line tools.

You must be root to perform this procedure.

You can also install Directory Service Control Center with the Zip distribution by deploying the WAR file provided with the software packages. For more information, see Installing Directory Service Control Center From Zip Distribution.

When you install DSCC, you automatically install Directory Server from native packages. DSCC uses its own local instance of Directory Server to store information about your directory service configuration. The instance is referred to as the DSCC Registry.

You can use the Directory Server software that is installed alongside DSCC to create your own additional Directory Server instances on the system.

Before You Begin

Obtain the Java Enterprise System update 1 distribution for this installation, as shown in the following figure:

Complete the following worksheet for your installation.

1. Install prerequisite patches or service packs for your platform.

   See Operating System Requirements in Sun Java System Directory Server Enterprise Edition 6.3 Release Notes.

2. With the Java Enterprise System distribution, run the Java ES installer as root.

   # ./installer

3. Select the Directory Service Control Center component for installation.

   

   If you do not want to install the multilingual packages, deselect the Install multilingual package(s) for all selected components check box.

4. Choose to configure the software later, as you will upgrade the software to 6.3.

   

5. Complete installation with the Java ES installer.

   The native packages are installed on the system.

6. See Getting Started With Directory Service Control Center.

To Upgrade Shared Components Using Patches

Before You Begin

Before upgrading Directory Server Enterprise Edition to 6.3 using native packages, you must upgrade the shared components. You must be root 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, when available.

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.

On Windows, before you upgrade Common Agent Container Runtime shared component, you must run the following command:

cacaoadm.exe prepare-uninstall

Before upgrading Directory Server Enterprise Edition 6.2 to 6.3, you need to upgrade only the Common Agent Container shared component.

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 table above.

   For more information on how to obtain the patches, see Getting the Software in Sun Java System Directory Server Enterprise Edition 6.3 Release Notes.

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.

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, or 6.2 installed, upgrade to version 6.3 using the following procedure.

You must be root to perform these steps.

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

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

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

   See Getting the Software in Sun Java System Directory Server Enterprise Edition 6.3 Release Notes for more details.

5. Change to the directory where you have saved the patch.

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 in Sun Java System Directory Server Enterprise Edition 6.3 Release Notes 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 rest of the Solaris OS, use the following command:

     # patchadd patch-id

   • Linux

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

     2. Run installpatch.

        # ./installpatch

     During installation, if installpatch reports an error, you must resolve the error and install the patch again.

   • Windows

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

     2. Double click patch-id.exe.

     The localized patches are delivered within the base patch.

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

Next Steps

After installing the software, see Environment Variables.