Appendix B. Selectively Installing Red Hat Cluster Suite Packages

B.1. Installing the Red Hat Cluster Suite Packages

Red Hat Cluster Suite consists of the following RPM packages:

Also, you can optionally install Red Hat GFS on your Red Hat Cluster Suite. Red Hat GFS consists of the following RPMs:

TipTip
 

You can access the Red Hat Cluster Suite and Red Hat GFS products by using Red Hat Network to subscribe to and access the channels containing the Red Hat Cluster Suite and Red Hat GFS packages. From the Red Hat Network channel, you can manage entitlements for your cluster nodes and upgrade packages for each node within the Red Hat Network Web-based interface. For more information on using Red Hat Network, visit the following URL:

http://rhn.redhat.com 

You can install Red Hat Cluster Suite and Red Hat GFS RPMs using either of the following methods:

For automatic RPM installation, refer to Section B.1.1 Automatic RPM Installation. For custom RPM installation, refer to Section B.1.2 Custom RPM Installation.

B.1.1. Automatic RPM Installation

Automatic RPM installation consists of running the up2date utility at each node for the Red Hat Cluster Suite and Red Hat GFS products.

NoteNote
 

If you are installing the GFS RPMs, you must run up2date for Red Hat Cluster Suite before running it for Red Hat GFS.

To automatically install RPMs, do the following at each node:

  1. Log on as the root user.

  2. Run up2date --installall --channel Label for Red Hat Cluster Suite. The following example shows running the command for i386 RPMs:

    # up2date --installall --channel rhel-i386-as-4-cluster
  3. (Optional) If you are installing Red Hat GFS, run up2date --installall --channel Label for Red Hat GFS. The following example shows running the command for i386 RPMs:

    # up2date --installall --channel rhel-i386-as-4-gfs-6.1

B.1.2. Custom RPM Installation

Custom RPM installation consists of the following steps:

  1. Determine which RPMs to install. For information on determining which RPMs to install, refer to Section B.1.2.1 Determining RPMs To Install.

  2. Install the RPMs using the rpm utility. For information about installing the RPMs using the rpm utility, refer to Section B.1.2.2 Installing Packages with the rpm Utility.

NoteNote
 

If you are installing the GFS RPMs, you must install Red Hat Cluster Suite before Red Hat GFS.

B.1.2.1. Determining RPMs To Install

Determining which RPMs to install is based on the following criteria:

  • The lock manager Red Hat Cluster Suite is using — either DLM or GULM

  • The Red Hat Cluster Suite and Red Hat GFS functions you are using (besides the standard functions)

  • Whether to include development libraries

  • The type of kernel (or kernels) is installed

Use the following tables for determining which RPMs to install:

The tables contain the following information to assist you in determining which packages to install:

  • RPMs — The names of the RPMs (excluding revision numbers)

  • Inclusion — The tables provide the following information about whether an RPM should be included in the installation:

    • Req: Required RPM — You must install the RPM.

    • Opt: Optional RPM — Refer to the "Purpose" for more information about determining whether to include the RPM.

    • Dev: Development RPM — Used for development purposes. Refer to the "Purpose" for more information about determining whether to include the RPM.

  • Purpose — Provides a concise description of the RPM purpose. Assists in determining which RPMs to include other than the required RPMs.

To determine which RPMs to include in the installation, perform the following steps:

  1. Determine whether you are installing Red Hat Cluster Suite with DLM or Red Hat Cluster Suite with GULM.

    1. If you are installing Red Hat Cluster Suite with DLM, refer to Table B-1 to identify which RPMs are required, optional, and for development.

    2. If you are installing Red Hat Cluster Suite with GULM, refer to Table B-2 to identify which RPMs are required, optional, and for development.

  2. If you are installing Red Hat GFS, refer to Table B-3 to identify which RPMs are required, optional, and for development.

  3. With the information gathered in the previous steps, proceed to install the RPMs using the procedures in Section B.1.2.2 Installing Packages with the rpm Utility.

RPMsInclusionDepends on Kernel Type?Purpose
ccs-ver-rel.archReqNoThe Cluster Configuration System
cman-ver-rel.archReqNoThe Cluster Manager

cman-kernel-ver-rel.arch
cman-kernel-hugemem-ver-rel.arch
cman-kernel-smp-ver-rel.arch
Note: The types of RPMs available vary according to RHN channel.

ReqYesThe Cluster Manager kernel modules
dlm-ver-rel.archReqNoThe Distributed Lock Manager

dlm-kernel-ver-rel.arch
dlm-kernel-hugemem-ver-rel.arch
dlm-kernel-smp-ver-rel.arch
Note: The types of RPMs available vary according to RHN channel.

ReqYesThe Distributed Lock Manager kernel modules
fence-ver-rel.archReqNoThe cluster I/O fencing system
iddev-ver-rel.archReqNoA library that identifies device contents
magma-ver-rel.archReqNoA cluster/lock manager API abstraction library
magma-plugins-ver-rel.archReqNoCluster manager plugins for magma

gulm-ver-rel.arch
Note: The gulm module is required with DLM because the magma-plugins module has a dependency on the gulm RPM.

ReqNoThe Grand Unified Lock Manager (GULM, available for this release and earlier versions of Red Hat GFS)
perl-Net-Telnet-ver-rel.archReqNoNet-Telnet Perl module
rgmanager-ver-rel.archOptNoOpen source HA resource group failover
system-config-cluster-ver-rel.archReqNoGUI to manage cluster configuration
ipvsadm-ver-rel.archOptNoUtility to administer the Linux Virtual Server
piranha-ver-rel.archOptNoCluster administration tools
ccs-devel-ver-rel.archDevNoCCS static library
cman-kernheaders-ver-rel.archDevNocman kernel header files
dlm-devel-ver-rel.archDevNoThe Distributed Lock Manager user-space libraries
dlm-kernheaders-ver-rel.archDevNodlm kernel header files
iddev-devel-ver-rel.archDevNoiddev development libraries
magma-devel-ver-rel.archDevNoA cluster/lock manager API abstraction library

Table B-1. RPM Selection Criteria: Red Hat Cluster Suite with DLM

RPMsInclusionDepends on Kernel Type?Purpose
ccs-ver-rel.archReqNoThe Cluster Configuration System
fence-ver-rel.archReqNoThe cluster I/O fencing system
gulm-ver-rel.archReqNoThe Grand Unified Lock Manager (GULM, available for this release and earlier versions of Red Hat GFS)
iddev-ver-rel.archReqNoA library that identifies device contents
magma-ver-rel.archReqNoA cluster/lock manager API abstraction library
magma-plugins-ver-rel.archReqNoCluster manager plugins for magma
perl-Net-Telnet-ver-rel.archReqNoNet-Telnet Perl module
system-config-cluster-ver-rel.archReqNoGUI to manage cluster configuration
ipvsadm-ver-rel.archOptNoUtility to administer the Linux Virtual Server
piranha-ver-rel.archOptNoCluster administration tools
ccs-devel-ver-rel.archDevNoCCS static library
gulm-devel-ver-rel.archDevNogulm libraries
iddev-devel-ver-rel.archDevNoiddev development libraries
magma-devel-ver-rel.archDevNoA cluster/lock manager API abstraction library

Table B-2. RPM Selection Criteria: Red Hat Cluster Suite with GULM

RPMsInclusionDepends on Kernel Type?Purpose
GFS-ver-rel.archReqNoThe Red Hat GFS module

GFS-kernel-ver-rel.arch
GFS-kernel-hugemem-ver-rel.arch
GFS-kernel-smp-ver-rel.arch
Note: The types of RPMs available vary according to RHN channel.

ReqYesThe Red Hat GFS kernel modules
gnbd-ver-rel.archOptNoThe GFS Network Block Device

gnbd-kernel-ver-rel.arch
gnbd-kernel-hugemem-ver-rel.arch
gnbd-kernel-smp-ver-rel.arch
Note: The types of RPMs available vary according to RHN channel.

OptYesKernel module for GFS Network Block Device
lvm2-cluster-ver-rel.archReqNoCluster extensions for the logical volume manager
GFS-kernheaders-ver-rel.archDevNoGFS kernel header files
gnbd-kernheaders-ver-rel.archDevNognbd kernel header files

Table B-3. RPM Selection Criteria: Red Hat GFS

B.1.2.2. Installing Packages with the rpm Utility

You can use the rpm utility to install RPMs from CDs created with RHN ISOs. The procedure consists of copying RPMs to a local computer, removing the RPMs that are not needed for the installation, copying the RPMs to the cluster nodes, and installing them.

To install the RPMs, follow these instructions:

  1. At a local computer (one that is not part of the cluster) make a temporary directory to contain the RPMs. For example:

    $ mkdir /tmp/RPMS/
  2. Insert the Red Hat Cluster Suite CD into the CD-ROM drive.

    NoteNote
     

    If a Question dialog box is displayed that asks if you want to run autorun, click No.

  3. Copy all the RPM files from the CD (located in /media/cdrom/RedHat/RPMS/) to the temporary directory created earlier. For example:

    $ cp /media/cdrom/RedHat/RPMS/*.rpm  /tmp/RPMS/

    NoteNote
     

    If your local computer is running a version of Red Hat Enterprise Linux that is earlier than Red Hat Enterprise Linux 4, the path to the RPMs on the CD may be different. For example, on Red Hat Enterprise Linux 3, the path is /mnt/cdrom/RedHat/RPMS/.

  4. Eject the CD from the CD-ROM drive.

  5. (Optional) If you are installing Red Hat GFS, insert a Red Hat GFS CD into the CD-ROM drive. If you are not installing Red Hat GFS, proceed to step 8.

    NoteNote
     

    If a Question dialog box is displayed that asks if you want to run autorun, click No.

  6. Copy all the RPM files from the CD (located in /media/cdrom/RedHat/RPMS/) to the temporary directory created earlier. For example:

    $ cp /media/cdrom/RedHat/RPMS/*.rpm  /tmp/RPMS/

    NoteNote
     

    If your local computer is running a version of Red Hat Enterprise Linux that is earlier than Red Hat Enterprise Linux 4, the path to the RPMs on the CD may be different. For example, on Red Hat Enterprise Linux 3, the path is /mnt/cdrom/RedHat/RPMS/.

  7. Eject the CD from the CD-ROM drive.

  8. Change to the temporary directory containing the copied RPM files. For example:

    $ cd /tmp/RPMS/
  9. Remove the "-kernel" RPMs for kernels that are not installed in the cluster node, and any other RPMs that are not being installed (for example, optional or development RPMS). The following example removes SMP and hugemem "-kernel" RPM files:

    $ rm *-kernel-smp* *-kernel-hugemem*

    For information about selecting the RPMs to install, refer to Section B.1.2.1 Determining RPMs To Install.

  10. Log in to each cluster node as the root user and make a directory to contain the RPMs. For example:

    # mkdir /tmp/node-RPMS/
  11. Copy the RPMs from the temporary directory in the local computer to directories in the cluster nodes using the scp command. For example, to copy the RPMs to node rhcs-node-01, run the following command at the local computer:

    $ scp /tmp/RPMS/*.rpm root@rhcs-node-01:/tmp/node-RPMS/
  12. At each node (logged in as root), change to the temporary directory created earlier (/tmp/node-RPMS) and install the RPMs by running the rpm utility as follows:

    # cd /tmp/node-RPMS/
    # rpm -Uvh *