# Sun ONE Directory Server

> Overview
> Before Starting
> Installing Sun Cluster HA for Sun ONE Directory Server
> Customizing Sun Cluster HA for Sun ONE Directory Server

## Overview

The Sun Open Net Environment (Sun ONE) Directory Server is also called the NetscapeTM Directory Server. This server uses the Netscape Lightweight Directory Access Protocol (LDAP) and runs under the control of SunTM Cluster.

SunPlexTM Manager installs the Sun ONE Directory Server from the Sun ONE distribution. SunPlex Manager also configures Sun Cluster HA for Sun ONE Directory Server as a failover service. To obtain a list of Sun ONE Directory Server releases that are supported for use with Sun Cluster, ask your Sun sales representative.

SunPlex Manager installs Sun ONE Directory Server by using the Typical installation. The Typical installation installs the following components.

Component | Description
--- | ---
Netscape Console | Netscape Console provides the common user interface for all NetscapeTM server products. From the console, you can perform common server administrative functions, such as stopping and starting servers, installing new server instances, and managing user and group information. You can install Netscape Console as a standalone application on any machine on your network. You can also use Netscape Console to manage remote servers.
Administration Server | This server is a common front end to all Netscape servers. The Administration Server receives communications from Netscape Console and passes those communications on to the appropriate Netscape server. Your site has at least one Administration Server for each server root in which you have installed a Netscape server.
Directory Server | The Directory Server is Netscape's LDAP implementation. This server manages the directory database and responds to client requests.
Directory Server gateway | The Directory Server gateway is an LDAP client that you can access from a web browser. You use LDAP clients to access or change directory information. The Directory Server gateway is automatically installed when you install a Directory Server instance. You can access the gateway from the Administration Server, or you can configure a web server to manage the gateway.

You must configure Sun Cluster HA for Sun ONE Directory Server as a failover service.

Note: Multiple instances of Sun Cluster HA for Sun ONE Directory Server can run on the cluster as long as: The location of the configuration files and installation files is not the same for each installation The ports do not conflict

For a more advanced configuration, use the Administrative Console to manually customize your configuration after SunPlex Manager completes the installation. For more control over the installation than SunPlex Manager provides, perform the installation manually, following the procedures in the Sun Cluster 3.1 Data Services Installation and Configuration Guide.

Return to top

## Before Starting

Before you install the Sun ONE Directory Server package:

- Ensure that you have the Sun ONE distribution on a file system that all nodes of the cluster can access. If you received the Sun ONE distribution in a
  tar
  file, you must use the
  tar
  command to extract the distribution.

- Ensure that the logical host name is set up. In most cases, you set up the logical host name when you install Sun Cluster. If the logical host name is not set up, see Creating a Logical Host Name Resource.

- Ensure that you have enough disk space for the installation. For information on the amount of disk space the installation requires, check the Sun ONE Directory Server documentation.

- If you plan to run

  - Multiple instances of the Sun ONE Web Server data service
  - Multiple data services on the same node

  determine a unique network address and port number for each instance.

- Ensure that the Destination Installation Directory is located in a global file system. If the directory does not exist, the LDAP setup program creates the directory.

- Ensure that you have the CD that contains the Sun Cluster 3.1 data service.

Return to top

## Installing Sun Cluster HA for Sun ONE Directory Server

| The Sun ONE Directory Server data service takes approximately 10 minutes to install.
| When you exit SunPlex Manager or click Back in your web browser after you begin the installation, the data service disconnects you from the installation. This disconnection can result in an incomplete installation because of insufficient information or an unresolved error message. To clean up an incomplete installation, you must remove the application files and resources and resource groups that were created.

To install Sun ONE Directory Server, complete the following steps:

1. From the navigation frame in SunPlex Manager, choose [cluster name] Cluster.

   The Cluster window appears.

2. From the Install Data Service menu, choose Sun ONE LDAP Server.

   SunPlex Manager ensures that:

   - The Sun ONE Directory Server data service package is already installed.
   - The Sun ONE Directory Server data service is registered with RGM.

   If the Sun ONE Directory Server data service package is installed and is registered, proceed to the next step.

   If SunPlex Manager does not find the Sun ONE Directory Server data service package installed and registered, SunPlex Manager guides you through installation and registration. You need to provide the location of the CD that contains the Sun Cluster 3.1 data service.

   A window that contains configuration information appears.

3. Modify the information on the configuration page for your system.

   Field | Description
   --- | ---
   Installation Source Directory | The directory that contains the Sun ONE Directory Server distribution. The setup program is located in this directory.
   Desired Administrative Server Password | The password that you use when you want to log in with full privileges. The default password is admin . The Directory Administrator is the person who is responsible for managing all Netscape Servers that are accessible through Netscape Console. If you use the Administrative Server ID to log in, you can administer any Netscape server in the server topology area of Netscape Console.
   Desired Directory Manager Password | The password that accesses the Directory Manager. Think of the Directory Manager as your directory's superuser.
   LDAP Administrative Server Port | The port that contains the LDAP Administration Server. The Administration Server is a common front end to all Netscape servers. This server receives communications from Netscape Console and passes those communications on to the appropriate Netscape server. Your site has at least one Administration Server for each server root in which you have installed a Netscape server.
   LDAP Server Port | The port on which the directory server accepts requests. Choose the default (389) unless you already have another application that uses that port.
   LDAP Server ID | A unique value that is used as part of the name of the directory in which the Directory Server instance is installed. For example, if your machine's host name is phonebook , this name is the default. As a result, the Directory Server instance is installed in a directory that is labeled slapd-phonebook .
   LDAP Directory Suffix | A directory suffix is the directory entry that represents the first entry in a directory tree. You need at least one directory suffix for the tree that is to contain your enterprise's data. Therefore, choose a directory suffix that corresponds to the DNS host name that is used by your enterprise. For example, if your organization uses the DNS name airius.com , choose the suffix o=airius.com .
   Destination Installation Directory | The directory where the binaries for the Sun ONE Directory Server application are installed. This directory must be a global directory. Warning: If a partial or completed Sun ONE installation is located in this directory already, the installation fails.
   Network Resource | The logical host name or shared address that is used to access Sun ONE Directory Server over the network. If a logical host name is used, one Sun ONE Server instance runs as a failover service.
   LDAP Resource Name | The name of the Sun ONE Directory Server resource that is created. This name must be unique within the cluster.

4. Click Continue.

   SunPlex Manager verifies the information on the configuration page. If SunPlex Manager finds no errors, it installs the Sun ONE Directory Server data service package. If SunPlex Manager discovers errors, it displays an error message and displays the configuration page.

5. Click Continue.

   The installer configures and starts a resource. SunPlex Manager lists the commands that it executes to configure and start the resource.

6. To test the directory server, follow the instructions that are provided by SunPlex Manager.

Return to top

## Customizing Sun Cluster HA for Sun ONE Directory Server

Instructions about customizing your Sun ONE Directory Server data service installation are included in the Sun ONE Directory Server documentation in the Sun Cluster 3.1 Data Services Installation and Configuration Guide.