Sun Directory Server Enterprise Edition 7.0 Installation Guide

Chapter 4 Installing and Uninstalling Directory Server Enterprise Edition Using Native Packages

Using native packages, you can install Directory Server Enterprise Edition only on the Solaris operating system.

You must be root to perform this procedure.

This chapter contains all the information related to installing and uninstalling Directory Server Enterprise Edition using native packages. Refer to the following procedures:

Installing Directory Server Enterprise Edition

Before you proceed with the installation, check Operating System Requirements in Sun Directory Server Enterprise Edition 7.0 Release Notes.

To Install Directory Server Enterprise Edition

Download the Directory Server Enterprise Edition binaries as specified in Getting the Software in Sun Directory Server Enterprise Edition 7.0 Release Notes.

After this operation is complete, you should have one of the following files in your temporary space, for example, /var/tmp/dsee:
- DSEE.7.0.Solaris-Sparc-pkg.tar.gz
- DSEE.7.0.Solaris10-X86-pkg.tar.gz
- DSEE.7.0.Solaris9-X86-pkg.tar.gz
Directory Server Enterprise Edition is also installed in French, German, Spanish, Japanese, Korean, Simplified Chinese, and Traditional Chinese languages. All the localized resources are a part of the SUNWdsee7 package.

Type the following commands to unzip the bundled file:

# cd /var/tmp/dsee
# gunzip DSEE.7.0.xxx-pkg.tar.gz
# tar -xf DSEE.7.0.xxx-pkg.tar

Prepare your system for the Directory Server Enterprise Edition software installation.

For more information, see Preparing Your System for Directory Server Enterprise Edition Installation.

Type the following commands to install the Directory Server Enterprise Edition software.

cd /var/tmp/dsee
# pkgadd -d . SUNWdsee7
# pkgadd -d . SUNWdsee7-var
# pkgadd -d . SUNWdsee7-man

If you are running Solaris 9 operating system, you must install the SUNWdsee7–config package.
- On a Solaris SPARC system, type:
  # pkgadd -d SunOS5.9 SUNWdsee7-config
- On a Solaris x86 system, type:
  # pkgadd -d . SUNWdsee7-config

Pre-Configuring the Directory Server Enterprise Edition Installation

The pre-configuration steps are the same for both zip and native packages installations except the following differences:

Key Difference	Summary
Root privileges	The `dsccsetup` must be executed with root privileges.
DSCC WAR file location	The `dsccsetup` command generates DSCC WAR file at `/var/opt/SUNWdsee7/dscc7.war`.
DSCC Registry location	The `dsccsetup` command creates the DSCC registry under `/var/opt/SUNWdsee7/dcc/ads` and sets its owner to `noaccess`.
DSCC Registry startup	DSCC Registry must be started as `root`. The registry runs as `noaccess`.
Application Server Hosting DSCC	Application Server must have read-write access to the DSCC registry instance, that is, `/var/opt/SUNWdsee7/dcc/ads`. The easiest is to run the Application Server as `noaccess` too.
DSCC Agent	The `dsccsetup` command plugs the DSCC Agent into the Common Agent Container framework available on Solaris. Type `man —s 5 cacao`.

See Pre-Configuring the Directory Server Enterprise Edition Installation and Checking Your Directory Server Enterprise Edition Installation.

Uninstalling Directory Server Enterprise Edition

The following procedure removes only the Directory Server Enterprise Edition 7.0 software. Any prior version of Directory Server Enterprise Edition that is installed remains intact.

To Remove Directory Server Enterprise Edition

Remove the server instances that depend on the software to be removed.

For more information, see Removing Server Instance.

Remove DSCC.

For more information, see To Unconfigure Directory Service Control Center .

Remove the Directory Server Enterprise Edition software.
1. If you are using the Solaris 9 operating system, remove the SUNWdsee7-config package.
  # pkgrm SUNWdsee7-config
2. Remove the following packages in the given sequence to remove Directory Server Enterprise Edition software from your computer.
  # pkgrm SUNWdsee7-var # pkgrm SUNWdsee7-man # pkgrm SUNWdsee7

Preparing Your System for Directory Server Enterprise Edition Installation

To prepare your system for the Directory Server Enterprise Edition installation, you must install the shared components mentioned in this section. You must install the shared components in the sequence specified in the tables below:

To Install Shared Components

Install the packages in the List of Packages Required Before Installing Directory Server Enterprise Edition.

Based on your operating system and system architecture, see an appropriate table. For example, if you are working on a Solaris 10 SPARC system, see Table 4–1. Each component has one or more related packages. Each package has the minimum version required to be installed on your system. If the required package is not installed on your system, install the package or if the minimum required version of the package is not installed, install the corresponding patch that is mentioned in the PatchId column.

For each package, retrieve the current version of the package installed.

For the complete list of packages, refer to List of Packages Required Before Installing Directory Server Enterprise Edition.
# pkgparam -v pkgname VERSION PATCHLIST
- If pkgname is not installed, refer to Location of Packages and Patches Required to Install Directory Server Enterprise Edition to locate the directory to find the package pkglocation.
  
  Type the following command to install packages:
  # pkgadd -d pkglocation pkgname
- If one of the packages has no value for PATCHLIST or a revision lower than the required version number, install the required patch. Refer to Location of Packages and Patches Required to Install Directory Server Enterprise Edition to locate the directory to find the patch patchlocation.
  
  Type the following command to install patches:
  # cd patchlocation # patchadd PATCHID

Troubleshooting

After upgrading shared components, if you face any difficulty in working with your Java ES 4.0 installation, refer to the README.119212–20 file. The compatibility issue mentioned in the file could be reason of the failure.

Note –

To use AES_256 with Java(tm) based applications and utilities, you must download the JCE Unlimited Strength Jurisdiction Policy Files from http://java.sun.com/javase/downloads/index.jsp and install them.

List of Packages Required Before Installing Directory Server Enterprise Edition

Based on your operating system architecture, you must install the following packages on your system before installing Directory Server Enterprise Edition.

Note –

The earlier versions of Directory Server Enterprise Edition install the Network Security Services/Netscape Portable Runtime (NSS/NSPR) component as a part of the Java Enterprise System distribution or as a Directory Server Enterprise Edition standalone delivery. Based on this difference, there are two different patches to patch the installed Network Security Services/Netscape Portable Runtime (NSS/NSPR)) component.

You must check the version of SUNWpr, SUNWtls, and SUNWtlsu packages installed on your computer and choose the appropriate patch to install on your system.

The SUNWj6rtx patch is required only if you want to run JRE in the 64–bit mode.

The following tables list all the shared components that Directory Server Enterprise Edition relies on. The tables do not intend to list all the packages that a patch updates but list the packages that impact Directory Server Enterprise Edition.

Table 4–1 Solaris 10 SPARC System

Components

Package Name

Version

Patch Id

SASL

SUNWsasl

2.17,REV=2004.04.06.15.24

119345-07

Network Security Services/Netscape Portable Runtime (NSS/NSPR))

SUNWpr
SUNWtls
SUNWtlsu

4.5.1,REV=2004.11.05.02.30
3.9.5,REV=2005.01.14.17.27
3.9.5,REV=2005.01.14.17.27

119213-20

SUNWpr
SUNWtls
SUNWtlsu

4.6.4,REV=2006.11.16.20.40
3.11.4,REV=2006.11.16.20.40
3.11.4,REV=2006.11.16.20.40

125358-09

International Components for Unicode (ICU)

SUNWicu

1.2,REV=2005.01.06.14.13

119810-05

Java Development Kit 1.6

SUNWj6rt

1.6.0,REV=2006.11.29.05.57

125136-17

SUNWj6rtx

1.6.0,REV=2006.11.29.04.58

125137-17

Java Dynamic Management^TM Kit Runtime

SUNWjdmk-runtime
SUNWjdmk-runtime-jmx

5.1,REV=34

119044-03

Common Agent Container Runtime

SUNWcacaort

2.0,REV=15

123893-15

Sun Java Monitoring Framework (MFWK)

SUNWmfwk-rt

2.0,REV=2006.11.24

125444-13

LDAP C SDK

SUNWldapcsdk-libs
SUNWldapcsdk-tools

VERSION=6.00,REV=2006.12.11.00.08

136798-02

SUNWldapcsdk-dev

VERSION=6.00,REV=2006.12.11.00.08

N/A

LDAP Java SDK

SUNWljdk

1.0,REV=2004.10.11.06.02

119725-06

Table 4–2 Solaris 9 SPARC System

Components

Package Name

Version

Patch Id

SASL

SUNWsasl
SUNWsaslx

2.17,REV=2002.10.18.11.13

115342-08

Network Security Services/Netscape Portable Runtime (NSS/NSPR))

SUNWpr
SUNWprx
SUNWtls
SUNWtlsx
SUNWtlsu

4.1.2,REV=2002.09.03.00.17
4.1.2,REV=2002.09.03.00.17
3.3.2,REV=2002.09.18.12.49
3.3.2,REV=2002.09.18.12.49
3.3.7,REV=2003.12.01.12.23

119211-21

SUNWpr
SUNWtls
SUNWtlsu

4.6.4,REV=2006.11.16.20.40
3.11.4,REV=2006.11.16.20.40
3.11.4,REV=2006.11.16.20.40

125358-09

International Components for Unicode (ICU)

SUNWicu
SUNWicux

1.1,REV=2002.08.14.12.32

114677-15

Java Development Kit 1.6

SUNWj6rt

1.6.0,REV=2006.11.29.05.57

125136-17

SUNWj6rtx

1.6.0,REV=2006.11.29.04.58

125137-17

Java Dynamic Management Kit Runtime

SUNWjdmk-runtime
SUNWjdmk-runtime-jmx

5.1,REV=34

119044-03

Common Agent Container Runtime

SUNWcacaort

2.0,REV=15

123893-15

Sun Java Monitoring Framework (MFWK)

SUNWmfwk-rt

2.0,REV=2006.11.24

125444-13

LDAP C SDK

SUNWldapcsdk-libs
SUNWldapcsdk-tools

6.00,REV=2006.12.11.00.08

136798-02

SUNWldapcsdk-dev

6.00,REV=2006.12.11.00.08

N/A

LDAP Java SDK

SUNWljdk

1.0,REV=2004.10.11.06.02

119725-06

Table 4–3 Solaris 10 x86 or Solaris 10 x64 System

Components

Package Name

Version

Patch Id

SASL

SUNWsasl

2.17,REV=2003.07.18.13.13

119346-07

Network Security Services/Netscape Portable Runtime (NSS/NSPR))

SUNWpr
SUNWtls
SUNWtlsu

4.6.4,REV=2006.11.16.21.41
3.11.4,REV=2006.11.16.21.41
3.11.4,REV=2006.11.16.21.41

125359-09

SUNWpr
SUNWtls
SUNWtlsu

4.5.1,REV=2004.11.05.03.44
3.9.5,REV=2005.01.14.19.03
3.9.5,REV=2005.01.14.19.03

119214-20

International Components for Unicode (ICU)

SUNWicu

1.2,REV=2005.01.06.14.13

119811-05

Java Development Kit 1.6

SUNWj6rt

1.6.0,REV=2006.11.29.05.03

125138-17

SUNWj6rtx

1.6.0,REV=2006.11.29.02.51

125139-17

Java Dynamic Management Kit Runtime

SUNWjdmk-runtime
SUNWjdmk-runtime-jmx

5.1,REV=34

119044-03

Common Agent Container Runtime

SUNWcacaort

2.0,REV=15

123896-15

Sun Java Monitoring Framework (MFWK)

SUNWmfwk-rt

2.0,REV=2006.11.24

125446-13

LDAP C SDK

SUNWldapcsdk-libs
SUNWldapcsdk-tools

6.00,REV=2006.12.11.00.35

136800-02

SUNWldapcsdk-dev

6.00,REV=2006.12.11.00.35

N/A

LDAP Java SDK

SUNWljdk

1.0,REV=2004.10.11.06.02

119725-06

Table 4–4 Solaris 9 x86 System

Components

Package Name

Version

Patch Id

SASL

SUNWsasl

2.17,REV=2003.07.18.13.13

115343-08

Network Security Services/Netscape Portable Runtime (NSS/NSPR))

SUNWpr
SUNWtls
SUNWtlsu

4.6.4,REV=2006.11.16.21.41
3.11.4,REV=2006.11.16.21.41
3.11.4,REV=2006.11.16.21.41

125359-09

SUNWpr
SUNWtls
SUNWtlsu

4.1.3,REV=2003.01.09.13.59
3.3.3,REV=2003.01.09.17.07
3.3.7,REV=2003.12.01.12.23

119212-21

International Components for Unicode (ICU)

SUNWicu

1.1,REV=2002.08.14.12.33

114678-15

Java Development Kit 1.6

SUNWj6rt

1.6.0,REV=2006.11.29.05.03

125138-17

Java Dynamic Management Kit Runtime

SUNWjdmk-runtime
SUNWjdmk-runtime-jmx

5.1,REV=34

119044-03

Common Agent Container Runtime

SUNWcacaort

2.0,REV=15

123896-15

Sun Java Monitoring Framework (MFWK)

SUNWmfwk-rt

2.0,REV=2006.11.24

125445-13

LDAP C SDK

SUNWldapcsdk-libs
SUNWldapcsdk-tools

6.00,REV=2006.12.11.00.35

136799-02

SUNWldapcsdk-dev

6.00,REV=2006.12.11.00.35

N/A

LDAP Java SDK

SUNWljdk

1.0,REV=2004.10.11.06.02

119725-06

Location of Packages and Patches Required to Install Directory Server Enterprise Edition

Based on the operating system and system architecture, the following lists describe the location of the packages or patches in the DSEE_PKG_Distribution directory. These packages and patches are required to install all the shared components and Directory Server Enterprise Edition binaries on your system.

Install the following packages and patches on your system:

Solaris SPARC System

SUNWdsee7
SUNWdsee7-var
SUNWdsee7-man
SUNWjdmk-runtime 
SUNWjdmk-runtime-jmx 
SUNWcacaort 
SUNWmfwk-rt
SUNWldapcsdk-libs 
SUNWldapcsdk-tools 
SUNWldapcsdk-dev 
SUNWj6rt 
SUNWj6rtx 
SUNWljdk 
SunOS5.9:
     SUNWdsee7-config
     SUNWtls 
     SUNWtlsx 
     SUNWtlsu 
     SUNWpr 
     SUNWprx 
     SUNWsasl 
     SUNWsaslx 
SunOS5.10:
     SUNWsasl 
patches:
     125358-09 
     119044-03 
     123893-15 
     136798-02 
     125136-17 
     125137-17 
     125444-13 
     119725-06 
     SunOS5.9
           119211-21 
           114677-15 
           115342-08 
     SunOS5.10
           119213-20 
           119810-05 
           119345-07

Solaris 10 x86 or Solaris 10 x64 System

SUNWdsee7
SUNWdsee7-var
SUNWdsee7-man
SUNWjdmk-runtime 
SUNWjdmk-runtime-jmx 
SUNWcacaort 
SUNWmfwk-rt
SUNWldapcsdk-libs 
SUNWldapcsdk-tools 
SUNWldapcsdk-dev 
SUNWsasl 
SUNWj6rt
SUNWj6rtx
SUNWljdk
patches:
     119044-03 
     123896-15 
     136800-02 
     125138-17
     125139-17
     125359-09 
     119214-20 
     119346-07 
     119811-05 
     125446-13
     119725-06

Solaris 9 x86 System

SUNWdsee7
SUNWdsee7-var
SUNWdsee7-man
SUNWjdmk-runtime 
SUNWjdmk-runtime-jmx 
SUNWcacaort 
SUNWmfwk-rt
SUNWldapcsdk-libs 
SUNWldapcsdk-tools 
SUNWldapcsdk-dev 
SUNWdsee7-config
SUNWtls 
SUNWtlsu 
SUNWpr 
SUNWsasl 
SUNWj6rt 
SUNWljdk 
patches
     119044-03 
     123896-15 
     136799-02 
     125138-17 
     119212-21 
     125359-09 
     119343-08 
     114678-15 
     125445-13 
     119725-06

All the packages that are not listed in this section should be retrieved from the Solaris OS distribution or from http://sunsolve.sun.com.