Sun Cluster 3.1 Data Service for Sun ONE Directory Server Guide

Installing and Configuring Sun ONE Directory Server

Sun Cluster HA for Sun ONE Directory Server is the Sun ONE Directory Server that uses Netscape Lightweight Directory Access Protocol (LDAP) and runs under the control of the Sun Cluster software. This section describes the steps to install Sun ONE Directory Server and enable Sun ONE Directory Server to run as Sun Cluster HA for Sun ONE Directory Server.

The Sun ONE Directory Server software requires some variation from the default installation parameters. When you install and configure Sun ONE Directory Server, consider the following points.

For the service to fail over correctly, when prompted for the computer name, instead of specifying a physical machine, you must specify a network resource (IP address) that can fail over between nodes. This requirement means that before you begin the installation, you must set up the network resource in your name services. You normally perform this step as part of the Sun Cluster installation. See the Sun Cluster 3.1 Concepts Guide document for details on network resources.

Do not use the default server root disk path when prompted. Place your files on the cluster file system.

Note –

Do not remove or relocate any of the installed files or directories that the Sun ONE Directory Server installation places on the cluster file system. For example, do not relocate any of the client binaries, such as ldapsearch, that are installed with the rest of the Sun ONE Directory Server software.

To install Sun ONE Directory Server, see one of the following sections.

How to Install Sun ONE Directory Server for Solaris 8

This procedure describes the interaction with the Sun ONE or iPlanetsetup command. Only the sections that are specific to Sun Cluster HA for Sun ONE Directory Server are included here. For the other sections, choose or change the default values as appropriate. This procedure includes only basic steps. See the Sun ONE Directory Server documentation for details.

Become superuser on a cluster member.

Run the setup command from the install directory on the Sun ONE or iPlanet CD.

From setup, choose the menu items to install Sun ONE Directory Server with a custom installation.

Custom installation allows you to specify the physical hostname for the administrative server. This enables you to access the administrative server whether the logical host is up or down.

For the install location, select a location on the cluster file system, for example, /global/nsldap.

Note –
The logical host that you specify must be online on the node from which you run the Sun ONE Directory Server installation. This state is necessary because at the end of the Sun ONE Directory Server installation, Sun ONE Directory Server automatically starts and will fail if the logical host is offline on that node.

Select the network resource along with your domain for the computer name, for example, phys-schost-1.eng.sun.com.

Supply the hostname that is associated with a network resource when the setup command prompts you for the full server name.

When prompted for the IP address to be used as the Sun ONE Directory Server Administrative Server, specify an IP address for one of the cluster nodes.

As part of the installation, you set up an Sun ONE Directory Server Administrative Server. The IP address that you specify for this server must be that of a physical cluster node, not the name of the logical host that will fail over.

Where to Go From Here

After you configure and activate the network resources, go to How to Configure Sun ONE Directory Server.

How to Install Sun ONE Directory Server for Solaris 9

The Sun ONE Directory Server is bundled with the Solaris 9.0 operating system. If you are using Solaris 9.0, use the Solaris 9.0 CDs to install the Sun ONE Directory Server.

Install the Sun ONE Directory Server packages (these packages might be called iPlanet Directory Server) on all the nodes of the cluster, if they are not already installed.

Identify a location on a global file system where you intend to keep all your directory servers (for example, /global/nsldap).

If you want to, you may create a separate directory for this file system.

On all nodes, create a link to this directory from /var/ds5. If /var/ds5 already exists on a node, remove it and create the link.
# rmdir /var/ds5 # ln -s /global/nsldap /var/ds5

On any one node, set up the directory server(s) in the usual way.
# directoryserver setup
On this node, a link, /usr/iplanet/ds5/slapd-<instance-name>, will be created automatically. On all other nodes, create the link manually

In the following example, dixon-1 is the name of the Directory Server.
# ln -s /var/ds5/slapd-dixon-1 /usr/iplanet/ds5/slapd-dixon-1

Supply the logical hostname when the setup command prompts you for the server name.

This step is required for failover to work correctly.

Note –
The logical host that you specify must be online on the node from which you run the directoryserver setup command. This state is necessary because at the end of the Sun ONE Directory Server installation, Sun ONE Directory Server automatically starts and will fail if the logical host is offline on that node.

If prompted for the logical hostname, select the logical hostname along with your domain for the computer name, for example, phys-schost-1.eng.sun.com.

Supply the hostname that is associated with a network resource if the setup command prompts you for the full server name.

If prompted for the IP address to be used as the Sun ONE Directory Server Administrative Server, specify the IP address of the cluster node on which you are running directoryserver setup.

Where to Go From Here

After you configure and activate the network resources, go to How to Configure Sun ONE Directory Server.

How to Configure Sun ONE Directory Server

Use the Sun ONE Administration Server to configure and test Sun ONE Directory Server.

See your Sun ONE or iPlanet documentation for details.

After completing the configuration, Sun ONE Directory Server starts automatically. Before you proceed to the next part of the installation and configuration process, you must use stop-slapd to stop the server.

Where to Go From Here

If you have not installed the data service packages for Sun ONE Directory Server from the Sun Cluster Agents CD-ROM, go to Installing Sun Cluster HA for Sun ONE Directory Server Packages. If you have installed the packages, go to Completing the Sun Cluster HA for Sun ONE Directory Server Configuration.