Sun Java System Reference Configuration Series: Portal Service on Application Server Cluster

Setting Up Directory Server on ds1

This task consists of the following procedures:

ProcedureTo Install Directory Server on ds1

This procedure assumes that you are installing Directory Server on Solaris 10 8/07 OS or later version. Hence, no operating system patches need to be installed. The Java ES installer evaluates the state of the operating system and indicates if you need to install a patch. If you are using versions of the operating system older than Solaris 10 8/07 OS, it is better to install any required patches before you begin the actual Directory Server installation procedure.

The following procedure runs the Java ES installer without saving a state file. You can choose to run the installer and capture your input in a state file (-saveState state-filename). You could then use the state file to re-create the installation if, for example, you needed to reinstall Directory Server.

  1. Download the Java ES software distribution to ds1.

    The procedure is documented in To Download the Software Distribution.

  2. Log in as root or become superuser.

    # su -

  3. Start the Java ES installer.

    # cd /portdist_71u2/Solaris_sparc

    # ./installer

    This procedure uses the GUI installer. The installer can also be run in text mode by using the - nodisplay option.

    The Welcome panel opens.

  4. In the Welcome panel, click Next.

    The Software License Agreement panel opens.

  5. In the Software License Agreement panel, review the license terms and click Yes, Accept License.

    The Choose Software Components panel opens.

  6. In the Choose Software Components panel, select the following components:

    • Directory Server Enterprise Edition 6.2

      • Directory Server 6 Core Server

      • Directory Service Control Center

      • Directory Server Command-line Utility

    • Directory Preparation Tool 6.4 (selected automatically)

    • Install Multilingual Package(s) for all selected components (selected automatically, but optional if using English)

  7. Click Next.

    The Java SE Software Development Kit Upgrade Required panel opens.

  8. In the Java SE Software Development Kit Upgrade Required panel, select Automatic Upgrade to the Version Included with the Installer and click Next.

    The installer evaluates the Java ES shared components on the computer and determines if any upgrades are required. On a fresh copy of the Solaris 10 8/07 OS, shared component upgrades are needed, and the Shared Components Upgrades Required panel opens.

  9. In the Shared Components Upgrades Required panel, click Next.

    The installer upgrades the shared components. The Specify Installation Directories panel opens.

  10. In the Specify Installation Directories panel, type the following values and click Next.

    Input Field 

    Value 

    Directory Preparation Tool 

    /opt/SUNWcomds

    Directory Server 

    /opt/SUNWdsee

    The installer checks the system, and the System Check panel opens.

  11. In the System Check panel, evaluate the results of the system check.

    If the system check is favorable, click Next.

    The Choose a Configuration Type panel opens.

  12. In the Choose a Configuration Type panel, select Configure Now and click Next.

    The Common Server Settings panel opens.

  13. In the Common Server Settings panel, type the following values and click Next.

    Be sure to first read Administrator Account Specification.

    Input Field 

    Value 

    Host Name 

    ds1

    DNS Domain Name 

    pstest.com

    Host IP Address 

    10.0.1.1

    Administrator User ID  

    admin

    Administrator Password 

    directory-admin-password

    System User 

    root

    System Group 

    root

    The Directory Server: Create Directory Instance panel opens.

  14. In the Directory Server: Create Directory Instance panel, type the following value and click Next.

    Input Field 

    Value 

    Create a Directory Server Instance 

    Yes

    The Directory Server: Specify Instance Creation Information panel opens.

  15. In the Directory Server: Specify Instance Creation Information panel, type the following values and click Next.

    Input Field 

    Value 

    Instance Directory 

    /var/opt/SUNWdsee/ds-inst-ds1

    Directory Instance Port 

    389

    Directory Instance SSL Port 

    636

    Directory Manager DN 

    cn=Directory Manager

    System User 

    root

    System Group  

    root

    Directory Manager Password 

    directory-manager-password

    Suffix 

    dc=pstest,dc=com

    The Ready to Install panel opens.

  16. In the Ready to Install panel, indicate whether you want to open the software registration window during installation.

    This panel enables you to register the components that you have selected for installation with Sun Connection. Sun Connection is a Sun-hosted service that helps you track, organize, and maintain Sun hardware and software. For example, Sun Connection can inform you of the latest available security fixes, recommended updates, and feature enhancements.

    If you choose to register, information about the installation is sent to the Sun Connection database. You can also register at a later date, after installation has been completed.

  17. Click Install.

    The installer copies files to the computer, creates a Directory Server instance and a database using the information in Step 15.

  18. During the installation process, click N to decline an Internet connection.

    Directory Server is being installed behind two firewalls, so it is unlikely that an Internet connection can be established for updates.

  19. When the installation is complete, review the installation in the Summary field.

  20. Click Exit to exit the installer.

  21. Check the installation log files for any installation errors.

    # cd /var/sadm/install/logs

    # egrep -i 'fall|error' Java*

ProcedureTo Start and Verify Directory Server on ds1

The following procedure confirms that Directory Server has been installed by starting and connecting to a Directory Server instance on ds1.

  1. Start the Directory Server instance on ds1.

    # /opt/SUNWdsee/ds6/bin/dsadm start /var/opt/SUNWdsee/ds-inst-ds1

  2. Check that the Directory Server instance is running.

    # /opt/SUNWdsee/ds6/bin/dsadm info /var/opt/SUNWdsee/ds-inst-ds1

    The State: line in the output should indicate that the instance is running.

  3. Check that you can connect to the Directory Server instance and perform a basic operation.

    # ldapsearch -b "dc=pstest,dc=com" -h ds1 -p 389 -D "cn=Directory Manager" "objectClass=*"

    When prompted, type the directory-manager-password.

    The response should resemble the following:


    version: 1
    dn: dc=pstest,dc=com
    dc: pstest
    objectClass: top
    objectClass: domain