Oracle Fusion Middleware Installation Guide for Oracle Directory Server Enterprise Edition

Part I Installing and Uninstalling Directory Server Enterprise Edition

This part includes the following chapters:

Chapter 2 Installing Directory Server Enterprise Edition

This chapter focuses on the zip distribution based installation.


Note –

For information about the native package based installation, refer to Chapter 4, Installing and Uninstalling Directory Server Enterprise Edition Using Native Packages.


    The installation procedure can be divided into the following steps:

  1. Laying out the software elements in the chosen place on a host filesystem.

    See Installing Directory Server Enterprise Edition Using Zip Distribution.

  2. Pre-configuring installation, that is, running the minimum set of commands to make the software installation operational.

    See Pre-Configuring the Directory Server Enterprise Edition Installation.

  3. Checking the installation, that is, running a few commands to confirm if the software is fully operational.

    See Checking Your Directory Server Enterprise Edition Installation.

For information about installing Identity Synchronization for Windows, refer to Sun Java System Identity Synchronization for Windows 6.0 Installation and Configuration Guide and Installation Instructions for Identity Synchronization for Windows 6.0 Service Pack 1.

Installing Directory Server Enterprise Edition Using Zip Distribution

Before you proceed with the installation, check Operating System Requirements in Oracle Fusion Middleware Release Notes for Oracle Directory Server Enterprise Edition.

You can install the zip distribution as a non-root user.

ProcedureTo Install Directory Server Enterprise Edition Using Zip Distribution

  1. Download the Directory Server Enterprise Edition zip distribution binaries as specified in Getting the Software in Oracle Fusion Middleware Release Notes for Oracle Directory Server Enterprise Edition.

    When this operation is complete, you should have one of the following files in your temporary space, for example, /var/tmp/dsee:

    • ODSEE11_1_1_3_0_HP-UX.zip

    • ODSEE11_1_1_3_0_Linux-X64.zip

    • ODSEE11_1_1_3_0_Linux-X86.zip

    • ODSEE11_1_1_3_0_Solaris-Sparc.zip

    • ODSEE11_1_1_3_0_Solaris-X64.zip

    • ODSEE11_1_1_3_0_Solaris-X86.zip

    • ODSEE11_1_1_3_0_Windows-X86.zip

    These zip files contain the Directory Server Enterprise Edition software, idsktune, the Identity Synchronization for Windows software, and the relevant legal files.

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


    # mkdir -p install-dir 
    # cd /var/tmp/dsee
    # unzip -qq ODSEE11_1_1_3_0_xxx.zip
    # cd ODSEE_ZIP_Distribution
    # unzip -qq sun-dsee7.zip -d install-dir
    # cd install-dir/dsee7

    Note –

    You can remove the contents of /var/tmp/dsee at this point.


    The install-dir directory is where all the software elements are placed. A minimum of 1 GByte of space is required in this directory.

    The install-dir/dsee7 directory contains all of the Directory Server Enterprise Edition components, with the exception of the idsktune utility. (idsktune is located in /var/tmp/dsee/ODSEE_ZIP_Distribution.) For the remainder of this guide, install-dir/dsee7 is referred to as the install-path.

    You are now ready to start working with the Directory Server Enterprise Edition installation.


    Note –

    Directory Server Enterprise Edition 11g Release 1 (11.1.1) depends on the Microsoft Visual C++ 2008 Redistributable Package. If your computer does not have Visual C++ 2008 installed, you must install the Microsoft Visual C++ 2008 Redistributable Package (x86). A version of this package is provided with the Directory Server Enterprise Edition distribution, but it is recommended that you install the latest version from the Microsoft Download Center at http://www.microsoft.com/downloads (Product family: Developer tools).


    To use AES_256 with Java technology-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.

See Also

If you are already using Directory Server version 6 or 5.2, and want to use the same legacy instances with the 11g Release 1 (11.1.1) installation, refer to Oracle Fusion Middleware Upgrade and Migration Guide for Oracle Directory Server Enterprise Edition.

Pre-Configuring the Directory Server Enterprise Edition Installation

After installing the Directory Server Enterprise Edition software successfully, you must pre-configure the software to make it functional.

This section includes the following subsections:

ProcedureTo Pre-Configure Directory Service Control Center

The Directory Service Control Center (DSCC) is a web-based interface to manage Directory Server and Directory Proxy Server instances.

  1. Create the WAR file for DSCC.


    $ install-path/bin/dsccsetup war-file-create
    
    Created dscc-war-file-path
    

    Make a note of the dscc-war-file-path, which is the path of the DSCC war file.

  2. Initialize the DSCC registry.


    $ install-path/bin/dsccsetup ads-create
    Choose password for Directory Service Manager:directory-service-pwd
    Confirm password for Directory Service Manager:directory-service-pwd
    
    Creating DSCC registry...
    DSCC Registry has been created successfully

    The value that you provide for directory-service-pwd, will be needed to authenticate the DSCC login page and is also used as a DSCC registry password.

    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.

  3. Note the port and the path assigned to DSCC registry.


    # install-path/bin/dsccsetup status
    ...
    Path of DSCC registry is dscc-registry-path
    Port of DSCC registry is dscc-registry-port
    ...

    The dscc-registry-port is the port assigned to the DSCC registry by dsccsetup ads-create. The default port that is assigned to the DSCC registry is 3998.

  4. Deploy the WAR file in any of the supported application server instance.

    For example deployment procedures, refer to Appendix A, Deploying the DSCC WAR File.

ProcedureTo Pre-Configure the DSCC Agent

  1. Register the DSCC agent in Common Agent Container.


    $install-path/bin/dsccsetup cacao-reg
    
    Configuring Cacao...
    Cacao will listen on port dscc-agent-port
    

    The dscc-agent-port specifies the port of the DSCC agent.


    Note –

    On Windows 2008, for a non-administrator user, the Cacao configuration fails. To solve this problem, set the following Windows registry parameters to zero:


    HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\EnableInstallerDetection
    HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System\EnableLUA

Useful Information for Your Records

You must make a note of the following information that is gathered during the pre-configuration operation.

Information 

Description 

Comments 

install-path

Path under which Directory Server Enterprise Edition 11g Release 1 (11.1.1) is installed.

 

directory-service-pwd

Password assigned to the Directory Service Manager. 

 

dscc-war-file-path

Path of the DSCC WAR file that is to be deployed in your application server. 

install-path/var/dscc7.war

dscc-registry-path

Path of the DSCC Registry 

install-path/var/dcc/ads

dscc-registry-port

Port of the DSCC Registry 

3998 or random. The DSCC Registry port can be retrieved by typing the following command:


install-path/bin/dsccsetup status

dscc-agent-port

Port of the DSCC Agent 

11162 or random. The DSCC Agent port can be retrieved by typing the following command:  


install-path/bin/dsccsetup status

Checking Your Directory Server Enterprise Edition Installation

When you have successfully installed and pre-configured the Directory Server Enterprise Edition software, you can check your installation by creating server instances and working with them.

This section covers the following topics:

Creating Server Instances From Command Line

The following set of commands create a sample server instance, populates it with example data and registers it with DSCC. These commands should execute without any error if software is correctly installed and configured.

ProcedureTo Create a Directory Server Instance From the Command Line

Non-root users can create server instances.

Refer to the following procedure to create a Directory Server instance using the command line:

  1. Create a new Directory Server instance.


    $ dsadm create -p 1389 -P 1636 /local/dsInst
    
    Choose the Directory Manager password:secret12
    Confirm the Directory Manager password:secret12
    Use 'dsadm start /local/dsInst' to start the instance

    The dsInst instance is created under the existing directory, /local/ and secret12 is assigned as the Directory Manager password.

  2. Start the instance.


    $ dsadm start /local/dsInst
    Server started: pid=2845
  3. (Optional) Prepare an example suffix.

    1. Create an empty suffix.


      $ dsconf create-suffix -p 1389 -e dc=example,dc=com
      Enter "cn=Directory Manager" password:secret12
      

      A suffix with root dc=example,dc=com is created.

    2. Populate the suffix with LDIF data.


      $ dsconf import -p 1389 -e\
      install-path/resources/ldif/Example.ldif dc=example,dc=com
      
      Enter "cn=Directory Manager" password:
      
      New data will override existing data of the suffix "dc=example,dc=com".
      Initialization will have to be performed on replicated suffixes.
      
      ...
      ...
      ## Closing files...
      ## Import complete.  Processed 160 entries in 4 seconds. (40.00 entries/sec)
      
      Task completed (slapd exit code: 0).

      The suffix is populated with sample data from Example.ldif.

    3. Search for data in the new instance.


      $ ldapsearch -p 1389 -b dc=example,dc=com "(uid=bjensen)" mail
      
      version: 1
      dn: uid=bjensen, ou=People, dc=example,dc=com
      mail: bjensen@example.com
  4. (Optional) Manage your server instance using DSCC.

    The following steps assume that DSCC is installed and pre-configured on dscc-host.

    1. Register the server instance with DSCC:


      $ dsccreg add-server -h dscc-host -p dscc-registry-port /local/dsInst
      
      Enter DSCC administrator's password: directory-service-pwd
      /local/dsInst is an instance of DS
      Enter password of "cn=Directory Manager" for /local/dsInst: secret12
      This operation will restart /local/dsInst.
      Do you want to continue ? (y/n) y
      Connecting to /local/dsInst (using ldap://127.0.0.1:1389)
      Enabling DSCC access to /local/dsInst
      Restarting /local/dsInst
      Registering /local/dsInst in DSCC on dscc-host:dscc-registry-port.
    2. List the server that are currently registered into DSCC


      # dsccreg list-servers -h dscc-host -p dscc-registry-port
      
      Enter DSCC administrator's password: directory-service-pwd
      Hostname        Port      sPort  Type  Owner  Flags  iPath       Description
      --------------  --------  -----  ----  -----  -----  ----------  -----------
      current-host    1389      1636   DS    uid           /local/dsInst
  5. (Optional) If you need to use the installation for production and want to clean the system, type the following commands:


    # dsccreg remove-server -h dscc-host -p dscc-registry-port /local/dsInst
    # dsadm delete /local/dsInst
Next Steps

You can add more suffixes, configure replication with other server instances, tune the instance, and generally proceed with other configuration operations.

See Part I, Directory Server Administration, in Oracle Fusion Middleware Administration Guide for Oracle Directory Server Enterprise Edition for instructions on configuring Directory Server with command-line administration tools.

For information about creating Directory Proxy Server instances using the command line, see Chapter 17, Directory Proxy Server Instances, in Oracle Fusion Middleware Administration Guide for Oracle Directory Server Enterprise Edition.

Creating Server Instances Using Directory Service Control Center

After successfully deploying DSCC, use the following procedure to create a sample Directory Server instance.

ProcedureTo Create Server Instances with Directory Service Control Center

Non-root users can create server instances.

Refer to the following procedure to create server instances using DSCC.

  1. Access DSCC by using http://dscc-host:port/dscc7.

  2. Log in to DSCC as Directory Service Manager.

    Directory Service Manager's entry is stored in the DSCC registry. Directory Service Manager also has administrator access to the server instances registered with DSCC.

    1. Type the following values:


          *  Directory Server Manager: admin
          * Password: directory-service-pwd
      
    2. Click the Log In button.

  3. Under the Directory Servers tab, click New Server.

    The Directory Service Control Center New Directory Server wizard displays.

    Directory Servers tab for Directory Service Control Center
  4. Follow the instructions in the Directory Service Control Center New Directory Server wizard to create the server instance.

    Web-based wizard for creating a Directory Server instance

    While creating the new server instances, you need to provide the following information:


        *  Host: server-host   # Host where DSCC agent has been configured
        *  LDAP Port: 1389
        * LDAPS Port: 1636
        * Instance Path: /local/dsInst
        * Directory Manager Password: secret12
        * Confirm Password: secret12
        * Runtime User ID: install-user
        * Runtime User Password: install-user-pw
        * DSCC Agent Port: dscc-agent-port
    

    Note –

    The instance path does not support non-ASCII characters.



    Note –

    To successfully create an instance on Windows 2003 Primary Domain Controller, type domainname\username in Runtime User Id.


  5. Complete the create server instance process by following the instructions provided in the graphical user interface.

  6. (Optional) You can choose to delete the server instance by clicking Delete in the More Server Actions drop-down menu.

See Also

Similarly, you can create Directory Proxy Server instances using the Proxy Server tab.

For further configuration and administration of Directory Server and Directory Proxy Server instances, refer to Oracle Fusion Middleware Administration Guide for Oracle Directory Server Enterprise Edition.

See the online help for Directory Service Control Center for hints on configuring Directory Server and Directory Proxy Server through the graphical user interface.


Note –

If you setup your browser for your preferred language, DSCC may sometimes report few messages in other language. The language in which such messages are shown is the language that was effective when the dsccsetup cacao-reg command was executed. Such a language usually is the default locale of the host.


Environment Variables

This section lists environment variables that you can set to facilitate creating server instances and using Directory Server Resource Kit and software development kits.

Environment Variable 

Description 

Reference 

DIR_PROXY_HOST

Hostname of Directory Proxy Server, used when the --hostname option is not specified.

dpconf(1M) command

DIR_PROXY_PORT

Port number of Directory Proxy Server, used when the --port and --secure-port options are not specified.

dpconf(1M) command

DIRSERV_HOST

Hostname of Directory Server, used when the --hostname option is not specified.

dsconf(1M) command

DIRSERV_PORT

Port number of Directory Server, used when the --port and --secure-port options are not specified.

dsconf(1M) command

DSCC_HOST

Hostname of the DSCC registry, used when the --hostname option is not specified.

dsccreg(1M), dsccmon(1M) commands

DSCC_PORT

Port number of the DSCC registry, used when the --port and --secure-port options are not specified.

dsccreg(1M), dsccmon(1M) commands

LDAP_ADMIN_PWF

Path to the file that contains a password, used when the --pwd-file option is not specified.

When server instances are registered with Directory Service Control Center, setting this variable to a file containing the Directory Service Manager password allows to manage all the server instances even if they have different Directory Manager passwords. 

dpconf(1M), dsconf(1M), dsccreg(1M), dsccmon(1M) commands

LDAP_ADMIN_USER

Directory administrator DN, used when the --user-dn option is not specified.

When server instances are registered with Directory Service Control Center, you may set this variable to cn=admin,cn=Administrators,cn=dscc or any other administrator DN create using DSCC.

dpconf(1M), dsconf(1M), dsccreg(1M), dsccmon(1M) commands

MANPATH

Zip distribution:  


install-path/resources/man/:\
$install-path/ext/cacao_2/usr/share/man

Native packages: /opt/SUNWdsee7/man

Online manual pages to browse with the man command

MANSECT

Add any of the following sections that are not listed in your MANSECT environment variable.

1:1m:4:5dsconf:5dpconf:5dssd:5dsat:5dsoc:5

Alternatively, specify the sections to search explicitly when using the man command.

The man command uses the MANSECT environment variable to identify the sections to search by default.

PATH

Zip distribution: install-path/bin

Native packages: /opt/SUNWdsee7/man

Directory Server Enterprise Edition commands 

Zip distribution: install-path/dsrk/bin

Directory Server Resource Kit and LDAP client commands 

Chapter 3 Uninstalling Directory Server Enterprise Edition

This chapter guides you through removing the Directory Server Enterprise Edition software and covers the following topics:

Removing Server Instances

Before uninstalling the Directory Server Enterprise Edition software, you must remove all the server instances.

The following sections describe how to remove Directory Proxy Server and Directory Server instances:

ProcedureTo Delete a Directory Proxy Server Instance With DSCC

  1. Access Directory Service Control Center.

    Use http://dscc-host:port/dscc7 or https://dscc-host:port/dscc7 to access DSCC, where port depends on your application server configuration.

  2. Under the Proxy Servers tab, select the server to delete and click Delete in the More Server Actions drop-down list.

  3. Delete the server instance with the Delete command in the action drop-down list.

ProcedureTo Delete a Directory Proxy Server Instance From the Command Line

  1. (Optional) If you have used DSCC to manage the server instance, remove registration for the server.


    $ dsccreg remove-server -h dscc-host -p dscc-registry-port /local/dps
    
    Enter DSCC administrator's password: directory-service-pwd
    /local/dps is an instance of DPS
    Enter password of "cn=Proxy Manager" for /local/dps:
    Unregistering /local/dps from DSCC on hostname.
    Connecting to /local/dps
    Disabling DSCC access to /local/dps

    For details, see the dsccreg(1M) man page.

  2. Delete the server instance.


    $ dpadm delete /local/dps
    Directory Proxy Server instance '/local/dps' stopped
    Directory Proxy Server instance '/local/dps' removed.
See Also

After you have removed all server instances on the system, go to Removing the Software.

ProcedureTo Delete a Directory Server Instance With DSCC


Caution – Caution –

Deleting a Directory Server instance completely removes all the instance files, including all LDAP entries managed by the instance. Before you delete an instance, back up your data as described in Chapter 8, Directory Server Backup and Restore, in Oracle Fusion Middleware Administration Guide for Oracle Directory Server Enterprise Edition.


  1. Access Directory Service Control Center.

    Use http://dscc-host:port/dscc7 or https://dscc-host:port/dscc7 to access DSCC, where port depends on your application server configuration.

  2. Under the Directory Servers tab, select the server to delete and click Delete in the More Server Actions drop-down list.

  3. Delete the server instance with the Delete command in the action drop-down list.

ProcedureTo Delete a Directory Server Instance From the Command Line

Deleting a Directory Server instance completely removes all the files under the instance-path directory. If the databases and logs are saved in another directory, they are not removed when you delete the Directory Server instance.

Before you delete a server instance, back up your data as described in Chapter 8, Directory Server Backup and Restore, in Oracle Fusion Middleware Administration Guide for Oracle Directory Server Enterprise Edition.

  1. (Optional) If you have used DSCC to manage the server instance, remove registration for the server.


    $ dsccreg remove-server -h dscc-host -p dscc-registry-port /local/dsInst
    
    Enter DSCC administrator's password: directory-service-pwd
    /local/dsInst is an instance of DS
    Enter password of "cn=Directory Manager" for /local/dsInst:
    This operation will restart /local/dsInst.
    Do you want to continue ? (y/n) y
    Unregistering /local/dsInst from DSCC on hostname.
    Connecting to /local/dsInst
    Disabling DSCC access to /local/dsInst
    Restarting /local/dsInst

    For details, see dsccreg(1M)

  2. Delete the server instance.


    $ dsadm delete /local/dsInst
    Server stopped
    /local/dsInst deleted
See Also

After you have removed all the server instances on the system, go to Removing the Software.

Removing the Software

After you have removed all the server instances that depend on the installed product, you can remove the Directory Server Enterprise Edition software.

The following sections describe how to unconfigure and remove the Directory Server Enterprise Edition software:

ProcedureTo Unconfigure Directory Service Control Center

  1. Undeploy DSCC from your application server.

  2. Run dsccsetup dismantle to remove and clean up the DSCC installation.

    For example, on a Solaris system the following command removes DSCC.


    $ ./dsccsetup dismantle
    ***
    Unregistering DSCC Agent from Cacao...
    Stopping Cacao...
    ***
    Deleting DSCC Registry...
    All server registrations will be definitively erased.
    Existing server instances will not be modified.
    Do you really want to delete the DSCC Registry ? [y/n]y
    Directory Server instance 'install-path/dsee7/var/dcc/ads' stopped
    DSCC Registry has been deleted successfully
    ***
    Deleted install-path/dsee7/var/dscc7.war
    ***

    On a Windows system, the following command removes DSCC.


    C:\install-path\bin>dsccsetup.exe dismantle 

    On Solaris, the dsccsetup command is located in install-path/bin. See Default Paths to determine the default install-path for your system.

ProcedureTo Remove Directory Server Enterprise Edition Installed From the Zip Distribution

  1. Remove Directory Server Enterprise Edition with a system command.


    $ rm -r install-path
    

    On Windows, delete the install-path folder or run the following commands to remove the components:


    C:\>del /s install-path
    C:\>del install-path
    

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. This procedure can only be performed by the root user.

This chapter contains all the information related to installing and uninstalling Directory Server Enterprise Edition using native packages, and covers the following topics:

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:

ProcedureTo Install Shared Components

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

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

If you encounter problems with an existing Java ES installation after you have upgraded the shared components, refer to the README file of the NSS/NSPR patch. The compatibility issue described in this file might be the reason for the problem.


Note –

To use AES_256 with Java-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

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


Note –

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

Check the version of the SUNWpr, SUNWtls, and SUNWtlsu packages installed on your system and choose the appropriate patch.

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


The following tables list all the shared components on which Directory Server Enterprise Edition relies. These tables do not intend to list all the packages that are updated by a patch, only those 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-23

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

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

SUNWj6rtx

1.6.0,REV=2006.11.29.04.58

125137-22

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

Sun Java Monitoring Framework (MFWK) 


SUNWmfwk-rt

2.0,REV=2006.11.24

125444-13

LDAP C SDK 


SUNWldapcsdk-libs
SUNWldapcsdk-tools
SUNWldapcsdk-dev

VERSION=6.00,REV=2006.12.11.00.08

136798-03
 

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

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

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

SUNWj6rtx

1.6.0,REV=2006.11.29.04.58

125137-22

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

Sun Java Monitoring Framework (MFWK) 


SUNWmfwk-rt

2.0,REV=2006.11.24

125444-13

LDAP C SDK 


SUNWldapcsdk-libs
SUNWldapcsdk-tools
SUNWldapcsdk-dev

6.00,REV=2006.12.11.00.08

136798-03
 

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

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

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

SUNWj6rtx

1.6.0,REV=2006.11.29.02.51

125139-22

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

Sun Java Monitoring Framework (MFWK) 


SUNWmfwk-rt

2.0,REV=2006.11.24

125446-13

LDAP C SDK 


SUNWldapcsdk-libs
SUNWldapcsdk-tools
SUNWldapcsdk-dev

6.00,REV=2006.12.11.00.35

136800-03
 

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

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

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

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

Sun Java Monitoring Framework (MFWK) 


SUNWmfwk-rt

2.0,REV=2006.11.24

125445-13

LDAP C SDK 


SUNWldapcsdk-libs
SUNWldapcsdk-tools
SUNWldapcsdk-dev

6.00,REV=2006.12.11.00.35

136799-03
 

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 
     SUNWtlsu 
     SUNWpr 
     SUNWprd 
     SUNWsasl 
     SUNWsaslx 
SunOS5.10:
     SUNWsasl 
patches:
     125358-11 
     119044-03 
     123893-22 
     136798-03 
     125136-22 
     125137-22 
     125444-13 
     119725-06 
     SunOS5.9
           119211-23 
           114677-15 
           115342-08 
     SunOS5.10
           119213-23 
           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-22 
     136800-03 
     125138-22
     125139-22
     125359-11 
     119214-23 
     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 
SUNWprd 
SUNWsasl 
SUNWj6rt 
SUNWljdk 
patches
     119044-03 
     123896-22 
     136799-03 
     125138-22 
     119212-23 
     125359-11 
     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.

Installing Directory Server Enterprise Edition

Before you proceed with the installation, check Operating System Requirements in Oracle Fusion Middleware Release Notes for Oracle Directory Server Enterprise Edition.

ProcedureTo Install Directory Server Enterprise Edition

  1. Download the Directory Server Enterprise Edition binaries as specified in Getting the Software in Oracle Fusion Middleware Release Notes for Oracle Directory Server Enterprise Edition.

    After this operation is complete, you should have one of the following files in your temporary space, for example, /var/tmp/dsee:

    • ODSEE11_1_1_3_0_Solaris-Sparc-pkg.zip

    • ODSEE11_1_1_3_0_Solaris-X86-pkg.zip

    • ODSEE11_1_1_3_0_Solaris-X64-pkg.zip

    Directory Server Enterprise Edition is also installed in French, German, Japanese, Simplified Chinese, and Spanish. All the localized resources are a part of the SUNWdsee7 package.

  2. Type the following commands to unzip the bundled file:


    # cd /var/tmp/dsee
    # unzip -qq ODSEE11_1_1_3_0_Solaris-xxx-pkg.zip
  3. Prepare your system for the Directory Server Enterprise Edition software installation.

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

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


    cd /var/tmp/dsee/ODSEE_PKG_Distribution
    # pkgadd -d . SUNWdsee7
    # pkgadd -d . SUNWdsee7-var
    # pkgadd -d . SUNWdsee7-man
  5. If you are running the 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 11g Release 1 (11.1.1) software. Any prior version of Directory Server Enterprise Edition that is installed remains intact. The version 11g Release 1 (11.1.1) installation does not upgrade the version 6.x software but performs the fresh installation.

ProcedureTo Remove Directory Server Enterprise Edition

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

    For more information, see Removing Server Instances.

  2. Remove DSCC.

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

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