Chapter 1. The Cluster Configuration Tool

The Cluster Configuration Tool allows users to configure Red Hat Cluster Manager for Red Hat Enterprise Linux systems. Red Hat Cluster Manager provides high availability of critical server applications in the event of planned or unplanned system downtime.

Use either of the following methods to access the Cluster Configuration Tool:

The first time that the application is started, the Cluster Configuration Tool is displayed. After you complete the cluster configuration, the command starts the Cluster Status Tool by default. To access the Cluster Configuration Tool from the Cluster Status Tool, select Cluster => Configure.

Figure 1-1. The Cluster Configuration Tool

The following tabbed sections are available within the Cluster Configuration Tool:

The Cluster Configuration Tool stores information about the cluster service and daemons, cluster members, and cluster services in the /etc/cluster.xml configuration file. The cluster configuration file is created the first time the Cluster Configuration Tool is started.

Save the configuration at any point (using File => Save) while running the Cluster Configuration Tool. When File => Quit is selected, it prompts you to save changes if any unsaved changes to the configuration are detected.

The Cluster Configuration Tool uses a hierarchical tree structure to show relationships between components in the cluster configuration. A triangular icon to the left of a component name indicates that the component has children. To expand or collapse the portion of the tree below a component, click the triangle icon.

Figure 1-2. Cluster Configuration Tool

To display the properties of a component, select the component and click Properties. As a shortcut, you can display the properties of a component by double-clicking on the component name.

To view or modify the properties of the cluster daemons, choose Cluster => Daemon Properties.

1.1. Configuring the Cluster Software

Before describing the steps to configure the cluster software, the hierarchical structure of cluster members and services needs to be considered. Cluster members and services can be thought of in terms of a parent/child tree structure, as shown in Figure 1-3.

Figure 1-3. Cluster Configuration Structure

Each member can have power controller children. Each service can have IP address children. Each Service can also have device children. Each device can have NFS export directory children. Each NFS export directory can have client children. This structure is reflected in the /etc/cluster.xml file syntax.

The steps to configure the cluster software consist of the following:

  1. Edit the /etc/sysconfig/rawdevices file on all cluster members and specify the raw device special files and character devices for the primary and backup shared partitions.

  2. Run the Cluster Configuration Tool on one cluster member.

  3. Enter a name for the cluster in the Cluster Name field.

  4. Choose Cluster => Shared State, and confirm that the Raw Primary and Raw Shadow settings match the settings specified in step 1. The default for Raw Primary is /dev/raw/raw1. The default for Raw Shadow is /dev/raw/raw2.

  5. Choose Cluster => Daemon Properties to edit the daemon properties. Each daemon has its own tab. Update the daemon options to suit your preferences and operating environment, and click OK when done. Refer to Section 1.3 Configuring Cluster Daemons for more details.

  6. Add member systems to the cluster by selecting the Members tab and clicking the New button. Refer to Section 1.9 Adding and Deleting Members for details.

    If the hardware configuration includes power controllers (power switches), then for each member connected to a power controller, configure that member's connection to the power controller by selecting the member and clicking Add Child. Refer to Section 1.10 Configuring a Power Controller Connection for more information.

  7. Set up one or more failover domains, if needed, to restrict the members on which a service can run or restrict the order of members followed when a service fails over from one failover domain member to another (or both). Refer to Section 1.11 Configuring a Failover Domain for details.

  8. Configure the application services to be managed by the cluster, specifying IP addresses, failover domain (if applicable) and user script that manages the service. Refer to Section 1.12 Adding a Service to the Cluster for more information.

  9. Save cluster configuration changes by selecting File => Save. When you save the cluster configuration, the command service clumanager reload command is executed to cause the cluster software to load the changed configuration file.

  10. Quit the application by selecting File => Quit.

    Running the Cluster Configuration Tool for the first time causes the cluster configuration file /etc/cluster.xml to be created automatically. When quiting after running it for the first time, you are prompted to Initialize Shared Storage, which uses the raw devices to pass quorum and service state information between cluster members. Click OK to initialize the shared storage.

    NoteNote
     

    Shared storage must be initialized before starting the cluster service for the first time, or the cluster will not run properly.

  11. After completing the cluster software configuration on one member, copy the configuration file /etc/cluster.xml to all other cluster members. The scp can be used to copy files from one host to another.