10.1 Clustering eDirectory Services on Linux

This section describes how to configure eDirectory 8.8 by using high availability clustering on Linux.

10.1.1 Prerequisites

  • Two or more Linux servers with clustering software

  • External shared storage supported by the cluster software, with sufficient disk space to store all eDirectory and NICI data

  • Virtual IP address

  • NetIQ eDirectory 8.8 SP8 or later

    NOTE:The nds-cluster-config utility only supports configuring the root eDirectory instance. eDirectory does not support configuring multiple instances and non-root installations of eDirectory in a cluster environment.

10.1.2 Installing and Configuring eDirectory

  1. Install and configure eDirectory on the server you want to use as the primary cluster node. For more information on installation and configuration procedures, refer to the Section 2.6.2, Using the nds-install Utility to Install eDirectory Components.

    NOTE:

    • When configuring eDirectory, the default NCP server name is the host server name of the computer on which you installed eDirectory. Because eDirectory is hosted on multiple hosts in a clustered environment, however, you should specify an NCP server name that is unique to the cluster instead of using the default name. For example, you can specify the name clusterserver for the NCP server when you configure eDirectory on the primary cluster node.

    • During the configuration process, ensure you set the virtual IP address for your eDirectory installation. In a clustered environment, eDirectory only listens on the virtual IP address, not on the system IP address.

  2. After you install and configure eDirectory, navigate to the nds.conf file, which is located in the /etc/opt/novell/eDirectory/conf.

  3. Edit the nds.conf file to set the value of the n4u.nds.preferred-server setting to the virtual IP address of the clustered installation, then save and close the file.

  4. Verify the eDirectory installation by using the ndsstat command.

    eDirectory must be up and running on the primary cluster node.

  5. Mount the shared file system by using the cluster manager.

  6. Back up all data in the following directories before running the configuration utility:

    • /var/opt/novell/nici

    • /var/opt/novell/eDirectory/data (n4u.server.vardir)

    • /var/opt/novell/eDirectory/data/dib (n4u.nds.dibdir)

    • /etc/opt/novell/eDirectory/conf (n4u.server.configdir)

    • /var/opt/novell/eDirectory/log

    NOTE:If you install eDirectory in a non-default location, you can use the ndsconfig get command to find the vardir, dir paths used in your installation. nds.conf should be in the default location, which is /etc/opt/novell/eDirectory/conf/nds.conf.

  7. On the primary cluster node server, open a terminal and run the following command to stop the eDirectory service:

    ndsmanage stopall
  8. In the terminal, navigate to the location of the configuration utility, nds-cluster-config. The utility is located in the /opt/novell/eDirectory/bin directory.

  9. Run the following command:

    nds-cluster-config -s /<sharedfilesystem>

    Where <sharedfilesystem> is the location you want to use for the eDirectory shared cluster data.

    NOTE:You can also run the utility in unattended mode by using the -u option. If you use this option, the utility does not ask for confirmation when configuring eDirectory on a cluster.

    If you use the unattended option, you must also use the -s option and specify the shared cluster file system.

  10. After the utility verifies t