Sun Cluster HA for iPlanet Directory Server is the iPlanet 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 iPlanet Directory Server (using the setup command) and enable iPlanet Directory Server to run as Sun Cluster HA for iPlanet Directory Server.
The iPlanet Directory Server software requires some variation from the default installation parameters. When you install and configure iPlanet 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.0 12/01 Concepts 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.
Do not remove or relocate any of the installed files or directories that the iPlanet 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 iPlanet Directory Server software.
This procedure describes the interaction with the iPlanet setup command. Only the sections that are specific to Sun Cluster HA for iPlanet 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 iPlanet Directory Server documentation for details.
Become superuser on a cluster member.
Run the setup command from the install directory on the iPlanet CD.
From setup, choose the menu items to install iPlanet 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.
The logical host that you specify must be online on the node from which you run the iPlanet Directory Server installation. This state is necessary because at the end of the iPlanet Directory Server installation, iPlanet 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, 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 iPlanet Directory Server Administrative Server, specify an IP address for one of the cluster nodes.
As part of the installation, you set up an iPlanet 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.
Use the iPlanet Administration Server to configure and test iPlanet Directory Server.
See your iPlanet documentation for details.
After completing the configuration, iPlanet 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.
If you have not installed the data service packages for iPlanet Directory Server from the Sun Cluster 3.0 Agents 12/01 CD-ROM, go to "Installing Sun Cluster HA for iPlanet Directory Server Packages". If you have installed the packages, go to "Completing the Sun Cluster HA for iPlanet Directory Server Configuration".