5.5 Configuring Novell Cluster Services

After you install Novell Cluster Services, you use the Open Enterprise Server > OES Install and Configuration tool in YaST to set up the cluster or to add a node to the cluster.

IMPORTANT:The YaST-based configuration is not used to modify the settings for an existing cluster. For information about modifying the settings for an existing cluster, see Section 9.13, Moving a Cluster, or Changing the Node IP Addresses, LDAP Servers, or Administrator Credentials for a Cluster.

If you are creating a new cluster, the Novell Cluster Services configuration does the following:

Creates a new Cluster object and a Cluster Node object in eDirectory.
Creates a special cluster partition for the Split Brain Detector (SBD) if you have a shared disk system.

If you are adding a server to an existing cluster, the Novell Cluster Services configuration does the following:

Creates a new Cluster Node object in eDirectory.

Use the following procedures to configure Novell Cluster Services on a node:

5.5.1 Initializing and Sharing a Device to Use for the SBD Partition

If you plan to use shared storage in the cluster, the cluster needs a split-brain detector (SBD). You must create the SBD before you add a second node to the cluster. You can create the SBD when you set up the cluster on the first node. In preparation, you must initialize the partition, and mark its device as shareable for clustering. If you plan to mirror the SBD, you must also initialize the partition that you want to use as the mirrored SBD, and mark its device as shareable for clustering. You need at least 20 MB for the SBD.

Log in as the root user on the server that will be the first node of the cluster, then open a terminal console.
At the command prompt, enter
```
nssmu
```
In the NSSMU, select Devices and press Enter.
In the Devices list, select the device that you want to use for the SBD.
If the device has not been initialized or if you want to delete the current partitioning structures on the device, press F3, then press Y (Yes) to confirm and continue.

WARNING:Initializing a disk destroys all of the data on it.
Select the DOS or GPT partitioning scheme for the device, then press Enter.

DOS supports devices up to 2 TB in size. GPT supports devices of any size.

Wait for the page to refresh before continuing.
Press F6 to mark the device as shareable for clustering.

The Shareable for Clustering value changes from No to Yes.
If you plan to mirror the SBD, repeat Step 4 through Step 7 for the second device.
Exit NSSMU.
Continue with Section 5.5.2, Opening the Open Enterprise Server Configuration Page.

5.5.2 Opening the Open Enterprise Server Configuration Page

Log in to the server as the root user.
Verify that the OES Add-On DVD is mounted on or available to the server.
In YaST, select Open Enterprise Server > OES Install and Configuration.
On the Software Selection page under Open Enterprise Server, verify that the Novell Cluster Services option is already installed as indicated by a blue check mark.
Click Accept to proceed to the Open Enterprise Server Configuration page.
Do one of the following:
- Same Administrator: To use the same administrator credentials that were used to install Novell Cluster Services, continue with Section 5.5.4, Accessing the Novell Cluster Services Configuration Page in YaST.
- Different Administrator: To use different administrator credentials than those used to install Novell Cluster Services, continue with Section 5.5.3, Using Different LDAP Credentials for the Cluster Configuration.

5.5.3 Using Different LDAP Credentials for the Cluster Configuration

You can use different user credentials to configure Novell Cluster Services than were used during the installation of Open Enterprise Server on the server by reconfiguring the settings for the LDAP Configuration of Open Enterprise Services option.

For information about what rights are needed, see Section 5.3, Assigning Install Rights for Container Administrators or Non-Administrator Users.

On the Open Enterprise Server Configuration page under LDAP Configuration of Open Enterprise Services, click the disabled link to enable reconfiguration.

The sentence changes to Reconfiguration is enabled.
Click the LDAP Configuration of Open Enterprise Services link to open the LDAP Configuration page.
Specify the following values:
- Admin name and context: The user name and context (in LDAP form) of the container administrator user (or non-administrator user) who has the eDirectory rights needed to install Novell Cluster Services.
- Admin password: The password of the container administrator (or non-administrator user).
Click Next.

The install returns to the Open Enterprise Server Configuration page.
Continue with Section 5.5.4, Accessing the Novell Cluster Services Configuration Page in YaST.

5.5.4 Accessing the Novell Cluster Services Configuration Page in YaST

On the Open Enterprise Server Configuration page under Novell Cluster Services, locate the Novell Cluster Services link.

The configuration is currently disabled.
Click the disabled link to enable configuration.

The sentence changes to Configure is enabled.
Click the Novell Cluster Services link to open the Novell Cluster Services Configuration page.
If you are prompted for credentials, specify the password of the specified Administrator user, then click OK.

This is either the LDAP administrator identity that was used when the Open Enterprise Server were installed, or the identity configured after the install in Section 5.5.3, Using Different LDAP Credentials for the Cluster Configuration.
On the Novell Cluster Services Configuration page, continue with one of the following:
- Section 5.5.5, Configuring a New Cluster
- Section 5.5.6, Adding a Node to an Existing Cluster

5.5.5 Configuring a New Cluster

Perform the following configuration for the first node that you configure for a cluster:

Go to the Novell Cluster Services Configuration page as described in Section 5.5.4, Accessing the Novell Cluster Services Configuration Page in YaST.

On the first configuration page, specify the following settings for a new cluster, then click Next:

Parameter	Action
New or existing cluster	Select New Cluster.
Directory Server Address	Select the check box next to the IP address of the LDAP server you want to use as the default for this node. The local LDAP server is selected by default. The IP addresses shown are the LDAP servers available for this service to use. The LDAP servers must have a master replica or a Read/Write replica of eDirectory. You can add, remove, or change the order of available LDAP servers for the node after the setup is complete. See Section 9.13.1, Changing the Administrator Credentials or LDAP Server IP Addresses for a Cluster.
Cluster FDN	Click Browse and navigate the tree to select the container where you want to create the cluster, then click OK. The FDN is automatically added to the field with a suggested cluster name. You can specify a different cluster name. You can also specify the typeful FDN (fully distinguished name) of the existing cluster. The name is case sensitive. Use the comma format illustrated in the example. Do not use dots. For example: cn=clus1,ou=ncs,o=mycompany You must specify an existing context. Specifying a new context does not create a new context. Cluster names must be unique. You cannot create two clusters with the same name in the same eDirectory tree.
Cluster IP Address	The cluster IP address represents the cluster on the network. It is different than the server IP address. For example: 10.10.10.44 The cluster IP address provides a single point for cluster access, configuration, and management. A Master IP Address resource is created automatically during the Cluster Services installation. The cluster IP address is bound to the master node and remains with the master node regardless of which server is the master node. The cluster IP address is required to be on the same IP subnet as the other servers in the same cluster, which is necessary for certain external network management programs to get cluster status alerts.
Select the storage device with shared media	Select the initialized and shared device that you want to use for the SBD from the drop-down list. For a new cluster, you can create the SBD partition now, or you can create it manually at any time before you add a second node to the cluster. A split-brain detector (SBD) is required if you plan to use shared disks in the cluster. For information about SBD requirements, see Section 4.8.2, SBD Partitions. The drop-down menus show only devices that have been initialized and shared. See Section 5.5.1, Initializing and Sharing a Device to Use for the SBD Partition.
Select the device where the mirror partition will be created	If you want to mirror the SBD, select a different shared device from the drop-down list.
Desired partition size of shared media	Specify a size of 20 MB or greater to use for the SBD partition, or select Use maximum size to use the entire device. If you selected a device for the SBD mirror, the specified size is also used for the mirror segment.

On the Proxy User Configuration page, specify one of the following users as the NCS Proxy user, then click Next.

Parameter	Action
OES Common Proxy User	If the OES Common Proxy User is enabled in eDirectory, the Use OES Common Proxy User check box is automatically selected and the NCS Proxy User Name and Specify NCS Proxy User Password fields are populated with the credentials of the OES Common Proxy User.
LDAP Admin User	If the OES Common Proxy User is disabled in eDirectory, the Use OES Common Proxy User check box is automatically deselected and the NCS Proxy User Name and Specify NCS Proxy User Password fields are populated with the credentials of the LDAP Admin user. The fields are also automatically populated with the LDAP Admin credentials if you deselect the Use OES Common Proxy User check box.
Another Admin User	Deselect the Use OES Common Proxy User check box, then specify the credentials of an existing administrator user.

You can reset the default settings by clicking Back to return to the Novell Cluster Services Configuration page, then clicking Next to continue again to the Proxy User Configuration page.

On the third Configuration page, configure the following settings, then click Finish.

Parameter	Action
IP address of this node	From the drop-down list, select the IP address that Novell Cluster Services will use for this node. Some servers have multiple IP addresses. This step lets you choose which IP address Novell Cluster Services uses.
Start Clustering Services now	Select the check box to start Novell Cluster Services software on this node after configuring it.

Parameter

Action

IP address of this node

From the drop-down list, select the IP address that Novell Cluster Services will use for this node.

Some servers have multiple IP addresses. This step lets you choose which IP address Novell Cluster Services uses.

Start Clustering Services now

Select the check box to start Novell Cluster Services software on this node after configuring it.

On the OES Server Configuration page, scroll down to the Novell Cluster Services entry to review the summary of the Cluster Services configuration, then click Next.
Continue through the setup process, then click Finish to exit the OES Configuration

Start Novell Cluster Services using one of these methods:

Setup Condition	Instructions
Start Cluster Services now was enabled	Novell Cluster Services starts automatically after the configuration completes.
Start Cluster Services now was disabled	Start Novell Cluster Services manually by using one of these methods: Reboot the cluster server. At a command prompt, go to the /etc/init.d directory, then enter the following as the root user: ./novell-ncs start At a command prompt, enter the following as the root user: rcnovell-ncs start

Continue with Section 5.6, Configuring Additional Administrators.

5.5.6 Adding a Node to an Existing Cluster

Perform the following configuration for each node that you add to an existing cluster:

If you have not previously configured the SBD partition for the cluster, create an SBD partition for the cluster by using one of the following procedures:
- Section 10.18.3, Creating a Non-Mirrored Cluster SBD Partition with SBDUTIL
- Section 10.18.5, Creating a Mirrored Cluster SBD Partition with SBDUTIL
If you have a shared disk system attached to your cluster servers, an SBD partition is required and must be created before you configure the second node in the cluster.

IMPORTANT:An SBD partition requires least 20 MB of free space on a device that has been previously initialized and marked as shareable for clustering.
Go to the Novell Cluster Services Configuration page as described in Section 5.5.4, Accessing the Novell Cluster Services Configuration Page in YaST.

Specify the following settings for adding this node to an existing cluster, then click Next:

Parameter	Action
New or existing cluster	Select Existing Cluster.
Directory Server Address	Select the check box next to the IP address of the LDAP server you want to use as the default for this node. The local LDAP server is selected by default. The IP addresses shown are the LDAP servers available for this service to use. The LDAP servers must have a master replica or a Read/Write replica of eDirectory. You can add, remove, or change the order of available LDAP servers for the node after the setup is complete. See Section 9.13.1, Changing the Administrator Credentials or LDAP Server IP Addresses for a Cluster.
Cluster FDN	Click Browse and navigate the tree to select the Cluster object of the existing cluster, then click OK. The FDN is automatically added to the field. You can also specify the typeful FDN (fully distinguished name) of the existing cluster. The name is case sensitive. Use the comma format illustrated in the example. Do not use dots. For example: cn=clus1,ou=ncs,o=mycompany
Select the device where the mirror partition will be created	If you want to mirror the SBD, select a different shared device from the drop-down list.

On the Proxy User Configuration page, specify one of the following users as the NCS Proxy user for this node, then click Next.

Parameter	Action
OES Common Proxy User	If the OES Common Proxy User is enabled in eDirectory, the Use OES Common Proxy User check box is automatically selected and the NCS Proxy User Name and Specify NCS Proxy User Password fields are populated with the credentials of the OES Common Proxy User.
LDAP Admin User	If the OES Common Proxy User is disabled in eDirectory, the Use OES Common Proxy User check box is automatically deselected and the NCS Proxy User Name and Specify NCS Proxy User Password fields are populated with the credentials of the LDAP Admin user. The fields are also automatically populated with the LDAP Admin credentials if you deselect the Use OES Common Proxy User check box.
Another Admin User	Deselect the Use OES Common Proxy User check box, then specify the credentials of an existing administrator user.