Summary of Contents for Novell OPEN ENTERPRISE SERVER CLUSTER SERVICES 1.8.2 - ADMINISTRATION
Page 1
OES Novell Cluster Services 1.8.2 Administration Guide for Linux Novell Open Enterprise Server w w w . n o v e l l . c o m N O V E L L C L U S T E R S E R V I C E S 1 .
Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.
Page 3
Novell Authorized Reseller is a Service mark of Novell Inc. Novell Cluster Services is a trademark of Novell, Inc. Novell Directory Services and NDS are registered trademarks of Novell, Inc. in the United States and other countries. Novell Storage Services is a trademark of Novell, Inc.
Please use the User Comments feature at the bottom of each page of the online documentation, or go to www.novell.com/documentation/feedback.html and enter your comments there. Documentation Updates The latest version of this Novell Cluster Services for Linux Administration Guide is available on the OES documentation Web site (http://www.novell.com/documentation/lg/oes). Documentation Conventions In Novell documentation, a greater-than symbol (>) is used to separate actions within a step and...
Page 8
OES Novell Cluster Services 1.8.2 Administration Guide for Linux...
1.2 Product Benefits Novell Cluster Services allows you to configure up to 32 Linux servers into a high-availability cluster, where resources can be dynamically switched or moved to any server in the cluster. Resources can be configured to automatically switch or be moved in the event of a server failure, or they can be moved manually to troubleshoot hardware or balance the workload.
Page 10
Storage Consolidation Shared disk fault tolerance can be obtained by implementing RAID on the shared disk subsystem. An example of the benefits Novell Cluster Services provides can be better understood through the following scenario. Suppose you have configured a three-server cluster, with a Web server installed on each of the three servers in the cluster.
Web Server 1, and Web Server operation will return back to the way it was before Web Server 1 failed. Novell Cluster Services also provides resource migration capabilities. You can move applications, Web sites, etc. to other servers in your cluster without waiting for a server to fail.
Page 12
SCSI or iSCSI. The following figure shows how a typical shared SCSI cluster configuration might look. Typical Shared SCSI Cluster Configuration Figure 1-4 Network Hub Server 1 Server 2 Network Network SCSI SCSI Interface Interface Adapter Adapter Card Card Shared Disk System OES Novell Cluster Services 1.8.2 Administration Guide for Linux...
From 2 to 32 Linux servers, each containing at least one local disk device. Novell Cluster Services software running on each Linux server in the cluster. A shared disk subsystem connected to all servers in the cluster (optional, but recommended for most configurations).
Page 14
OES Novell Cluster Services 1.8.2 Administration Guide for Linux...
What’s New ® The following changes and enhancements were added to Novell Cluster Services for Linux for Novell Open Enterprise Server (OES) Support Pack 2. It is now possible to choose a device for the SBD partition from a list rather than entering it manually.
Page 16
OES Novell Cluster Services 1.8.2 Administration Guide for Linux...
8.7.3 Administration Guide for more information. The browser that will be used to manage Novell Cluster Services is set to a supported language. The iManager plug-in for Novell Cluster Services might not operate properly if the highest priority Language setting for your Web browser is set to a language other than one of the supported languages.
It is necessary to install SLES 9/OES on every server you want to add to a cluster. You can install Novell Cluster Services and create a new cluster, or add a server to an existing cluster either during the SLES 9/OES installation or afterwards, using YaST.
3.5.1 Novell Cluster Services Licensing You can add up to 32 nodes to a cluster. Novell Cluster Services for Linux includes licenses for two cluster nodes. You only need additional Cluster Server Licenses if you have a three-node or larger cluster.
3.5.3 Installing Novell Cluster Services after the OES Installation If you did not install Novell Cluster Services during the OES installation, you can install it later by completing the following steps: 1 At the Linux server console, type yast2 ncs.
IMPORTANT: If you are using iSCSI for shared disk system access, ensure you have configured iSCSI intiators and targets to start prior to starting Novell Cluster Services. You can do this by entering chkconfig iscsi on at the Linux server console.
Page 22
Consult your SAN vendor documentation for SAN setup and connectivity instructions. 7 Install Cluster Services and add the node to your existing NetWare 6.5 cluster. Section 3.5.3, “Installing Novell Cluster Services after the OES Installation,” on page 20 for more information.
Consult your SAN vendor documentation for SAN setup and connectivity instructions. 3 Install Cluster Services and add the new node to your existing NetWare 6.5 cluster. Section 3.5.3, “Installing Novell Cluster Services after the OES Installation,” on page 20 for more information.
3.6.3 Mixed NetWare and Linux Clusters Novell Cluster Services includes some specialized functionality to help NetWare and Linux servers coexist in the same cluster. This functionality is also beneficial as you migrate NetWare cluster servers to Linux. It automates the conversion of the Master IP Address resource and cluster-enabled NSS pool resource load and unload scripts from NetWare to Linux.
Page 25
NetWare cluster resources. The cluster resource name is used in the load and unload script filenames. The path to the files is /etc/opt/novell/ncs/. The following examples provide a sample comparison between NetWare cluster load and unload scripts, and their corresponding Linux cluster load and load scripts.
If you have converted all nodes in a former NetWare cluster to Linux, you must finalize the conversion process by issuing the cluster convert command on one Linux cluster node. The cluster convert command moves cluster resource load and unload scripts from the files OES Novell Cluster Services 1.8.2 Administration Guide for Linux...
NSS pools if they do not already exist and, if necessary, configure the shared disk NSS pools to work with Novell Cluster Services. Configuring shared disk NSS pools to work with Novell Cluster Services can include cluster enabling the pools.
Page 28
NSS pools can be cluster enabled at the same time they are created or they can be cluster enabled at a later time after they are created. To learn more about NSS pools, see “Pools” in the Novell Storage Services Administration Guide.
You can select or deselect NCP. NCP is selected by default, and is the protocol used by Novell clients. Selecting NCP causes commands to be added to the pool resource load and unload scripts to activate the NCP protocol on the cluster.
Page 30
Flush Files Immediately feature improves file system reliability but hampers performance. You should consider this option only if necessary. 8 Choose whether you want the volume activated and mounted when it is created, then click Finish. OES Novell Cluster Services 1.8.2 Administration Guide for Linux...
3.7.3 Cluster Enabling NSS Pools and Volumes If you have a shared disk system that is part of your cluster and you want the pools and volumes on the shared disk system to be highly available to NCP clients, you will need to cluster enable those pools and volumes.
Novell clients. Selecting NCP will cause commands to be added to the pool resource load and unload scripts to activate the NCP protocol on the cluster. This lets you ensure that the cluster- enabled pool you just created is highly available to Novell clients.
Page 33
The following sections provide the necessary information for using EVMS to create a tradtional Linux volume and file system on a shared disk: “Ensuring That the Shared Disk Is not a Compatibility Volume” on page 33 “Removing Other Segment Managers” on page 33 “Creating a Cluster Segment Manager Container”...
Page 34
Segment Manager (CSM) plug-in for EVMS to create a CSM container. NOTE: CSM containers require Novell Cluster Services (NCS) to be running on all nodes that access the CSM container. Do not make to modifications to EVMS objects unless NCS is running.
Creating an EVMS Volume 1 In evmsgui, click Actions, select Create, and then EVMS Volume. 2 Select the container you just created (either the CSM container or the additional segment manager container) and specify a volume name. 3 Click Create, then click Save. Creating a File System on the EVMS Volume 1 In evmsgui, click the Volumes tab and right-click the volume you just created.
“Creating a Traditional Linux Volume Cluster Resource” on page 37 “Configuring Traditonal Linux Volume Load Scripts” on page 37 “Configuring Traditional Linux Volume Unload Scripts” on page 39 OES Novell Cluster Services 1.8.2 Administration Guide for Linux...
Page 37
The load script from the generic file system template should appear similar to the following example: #! /bin/bash . /opt/novell/ncs/lib/ncsfuncs # define the IP address RESOURCE_IP=a.b.c.d # define the file system type...
Page 38
RESOURCE_IP=123.123.12.12 # define the file system type MOUNT_FS=reiserfs #define the container name container_name=cont1 # define the device MOUNT_DEV=/dev/evms/$container_name/vol_one # define the mount point MOUNT_POINT=/mnt/vol_onemount #activate the container exit_on_error activate_evms_container $container_name $MOUNT_DEV OES Novell Cluster Services 1.8.2 Administration Guide for Linux...
Page 39
The unload script from the generic file system template should appear similar to the following example: #!/bin/bash . /opt/novell/ncs/lib/ncsfuncs # define the IP address RESOURCE_IP=a.b.c.d #define the container name...
You can create templates for any server application or resource you want to add to your cluster. Novell Cluster Services provides the following cluster resource templates: DHCP iFolder 2...
6 Enter the name of the resource you want to create. NOTE: Do not use periods in cluster resource names. Novell clients interpret periods as delimiters. If you use a space in a cluster resource name, that space will be converted to an underscore.
3.7.11 Setting Start, Failover, and Failback Modes You can configure the start, failover, and failback of cluster resources to happen manually or automatically. With the resource Start Mode set to AUTO, the resource automatically starts on a OES Novell Cluster Services 1.8.2 Administration Guide for Linux...
5 (Conditional) Check the Ignore Quorum check box if you don't want the cluster-wide timeout period and node number limit enforced. The quorum default values were set when you installed Novell Cluster Services. You can change the quorum default values by accessing the properties page for the Cluster object.
This is the number of nodes that must be running in the cluster before resources will start to load. When you first bring up servers in your cluster, Novell Cluster Services reads the number specified in this field and waits until that number of servers is up and running in the cluster before it starts loading resources.
This value is set by default, and should not be changed. 3.8.3 Cluster IP Address and Port Properties The Cluster IP address is assigned when you install Novell Cluster Services. The Cluster IP address normally does need to be changed, but can be if needed.
5 Click the Apply button to save changes made to resource priorities. 3.8.5 Cluster E-Mail Notification Novell Cluster Services can automatically send out e-mail messages for certain cluster events like cluster and resource state changes or nodes joining or leaving the cluster.
7 Click the Apply button to save changes. IMPORTANT: Novell Cluster Services uses Postfix to send e-mail alerts. If you have a cluster resource that uses SMTP, that resource might not work in the cluster unless you change the Postfix ®...
3.9 Additional Information For additional information on managing Novell Cluster Services, see Chapter 4, “Managing Novell Cluster Services,” on page OES Novell Cluster Services 1.8.2 Administration Guide for Linux...
Managing Novell Cluster Services ® After you have installed, set up, and configured Novell Cluster Services for your specific needs, some additional information can be useful to help you effectively manage your cluster. This information consists of instructions for migrating resources, identifying cluster and resource states, and customizing cluster management.
4.3 Novell Cluster Services Console Commands Novell Cluster Services provides several server console commands to help you perform certain cluster-related tasks. The following table lists the cluster-related server console commands and gives a brief description of each command. To execute a cluster console command, enter cluster...
Page 51
JOIN Adds the node where the command is executed to the cluster and makes the node visible to other servers in the cluster. Novell Cluster Services software must already be installed on a node for it to join the cluster.
Page 52
Lists all resources that currently exist in the cluster. The resources do not need to be online or running. RESTART {seconds} Restarts Novell Cluster Services software on all servers in the cluster. OES Novell Cluster Services 1.8.2 Administration Guide for Linux...
Page 53
XML format. Not specifying any value with this parameter will turn notification in XML format off. STATS {Display, Clear} Reports the node number, node name, and heartbeat information. You must switch to the log console screen to see cluster statistics. Managing Novell Cluster Services...
XML virtual files in the \\cluster/_admin/Novell/Cluster directory. There are two types of virtual files in the _admin/Novell/Cluster directory, XML files and CMD files. The XML files are read-only and contain cluster configuration or cluster state information. The CMD files are write-then-read command files that are used to issue commands to the cluster and retrieve resulting status.
4.5 Novell Cluster Services File Locations Knowing the location and purpose of the files that make up Novell Cluster Services can be useful in helping you troubleshoot problems and resolve version issues. The following table lists the path and purpose for some of the files that are part of Novell Cluster Services (NCS).
Page 56
Shared library commands for load/unload /opt/novell/ncs/lib/ncsfuncs scripts NCS Schema file /opt/novell/ncs/schema/ncs.ldif NCS Schema file /opt/novell/ncs/schema/ncs.sch NCS SDK /usr/include/ncssdk.h NCS SDK /usr/lib/libncssdk.so NCS SDK /usr/lib/libncssdk.so.1.0.0 Link to etc/init.d/novell-ncs /usr/sbin/rcnovell-ncs SBDUTIL Man page /usr/share/man/man7/sbdutil.7.gz OES Novell Cluster Services 1.8.2 Administration Guide for Linux...
4.6 Additional Cluster Operating Instructions The following instructions provide additional information for operating Novell Cluster Services. 4.6.1 Connecting to an iSCSI Target For instructions on configuring an OES Linux server as an iSCSI initiator and connecting to an iSCSI target, go to “Accessing iSCSI Targets on NetWare Servers from Linux...
Linux initiator server that will access the iSCSI target. 4.6.2 Adding a Node That Was Prevously in the Cluster 1 If necessary, install NetWare and Novell Cluster Services, including the latest Service Pack on the server using the same node name and IP address.
4.6.9 Creating a Cluster Partition (SBD Partition) after Installation If you did not create a cluster partition during the Novell Cluster Services installation, you can create one later using the SBDUTIL utility. You must have a shared disk system (a Storage Area Network or SAN) connected to your cluster nodes before attempting to create a cluster partition.
20 for more information on SBD partitions.) If an SBD partition was created during the Novell Cluster Services installation or later using the sbdutil command, delete it. 1 Enter cluster down at the server console of one cluster server.
Documentation Updates This Novell Cluster Services 1.8.2 Administration Guide for Linux has been updated with the following information on December 23, 2005: A.1 December 23, 2005 (Open Enterprise Server SP2) Location Change Entire guide. Page design reformatted to comply with revised ®...
Need help?
Do you have a question about the OPEN ENTERPRISE SERVER CLUSTER SERVICES 1.8.2 - ADMINISTRATION and is the answer not in the manual?
Questions and answers