Configuring a ServiceGuard NFS Package

Except for the variables listed below, use the default values for the variables in the package configuration file, or change them as needed.

For instructions on modifying the default values, see the Managing ServiceGuard manual, or read the comments in the package configuration file.

Set the PACKAGE_NAME variable. For example:

PACKAGE_NAME pkg01

You can use the default package name if you are planning to run only one ServiceGuard NFS package on your ServiceGuard cluster. Each package must have a unique name.

Create a NODE_NAME variable for each node that will run the package. The first NODE_NAME should specify the primary node. All the NODE_NAME variables following the primary node should specify the adoptive nodes, in the order in which they will be tried. For example:

NODE_NAME thyme 
NODE_NAME basil
NODE_NAME sage

Set the RUN_SCRIPT and HALT_SCRIPT variables to the full path name of the control script. You do not have to specify a timeout for either script. For example:

RUN_SCRIPT /usr/local/cmcluster/pkg1/pkg1.cntl
RUN_SCRIPT_TIMEOUT NO_TIMEOUT
HALT_SCRIPT /usr/local/cmcluster/pkg1/pkg1.cntl
HALT_SCRIPT_TIMEOUT NO_TIMEOUT

If you want to run the NFS monitor script, set the SERVICE_NAME variable to indicate the NFS monitor script. For example:

SERVICE_NAME nfs1.monitor

Each package must have a unique service name. The SERVICE_NAME variable in the package configuration file must match the NFS_SERVICE_NAME variable in the NFS control script.

If you do not wish to run the NFS monitor script, comment out the SERVICE_NAME variable. For example:

# SERVICE_NAME nfs.monitor

You do not have to run the NFS monitor script. If your NFS package configuration file specifies AUTO_RUN YES, the package switches to the next adoptive node in the event of a node or package failure. The NFS monitor script causes the package to fail over if any of the monitored NFS services fails.

Set the SUBNET variable to the subnet that is monitored for the package. For example:

SUBNET 192.100.112.0

Specify the configuration file that will be used to define the MD raid devices for each package. For example:

RAIDTAB=”/usr/local/cmcluster/conf/raidtab.sg”

Specify which MD devices are used by this package. For example:

MD[0]=/dev/md0
MD[1]=/dev/md1

The MD devices are defined in the RAIDTAB file specified in Step 1.

Create a separate VG[n] variable for each volume group. For example:

VG[0]=vg01
VG[1]=vg02

Create a separate LV[n], FS[n], FS_TYPE[n], and FS_MOUNT_OPT[n] variable for each volume group and file system that will be mounted on the server. For example:

LV[0]=/dev/vg01/lvol1;FS[0]=/ha_root; FS_TYPE[0]=ext2;FS_MOUNT_OPT[0]=”-o rw”
LV[1]=/dev/vg01/lvol2;FS[1]=/users/scaf; FS_TYPE[0]=ext2;FS_MOUNT_OPT[1]=”-o rw”
LV[2]=/dev/vg02/lvol1;FS[2]=/ha_data; FS_TYPE[0]=ext2;FS_MOUNT_OPT[2]=”-o rw”

This example defines the variable for three NFS mounted file systems, ha_root, users/scaf, and ha_data.

Specify the IP address for the package and the address of the subnet to which the IP address belongs. For example:

IP[0]=15.13.114.243
SUBNET[0]=192.100.112.0

The IP address you specify is the relocatable IP address for the package. NFS clients that mount the file systems in the package will use this IP address to identify the server. You should configure a name for this address in the DNS or NIS database, or in the /etc/hosts file.

Specify that this package uses the high availability NFS server by uncommenting the HA_APP_SERVER variable. Uncomment the following line:

HA_APP_SERVER=”pre-IP”

If two packages have the same adoptive node, and you want to prevent a shared adoptive node from adopting both packages at once, specify the cmmodpkg command with the package control option (-d) in the customer_defined_run_cmds. For example:

function customer_defined_run_cmds
{
    cmmodpkg -d -n ‘hostname‘ pkg02 &
}

This package control function can prevent an adoptive node from becoming overloaded when multiple packages fail over. If an adoptive node becomes overloaded, it can fail.

In this example, if a host is an adoptive node for both pkg01 and pkg02, the above cmmodpkg -d command, in the control script for pkg01, would prevent the host that is running pkg01 from adopting pkg02.

Add a similar line in the control script for pkg02 to prevent the host that is running pkg02 from adopting pkg01.

The ampersand (&) causes the cmmodpkg command to run in the background. The cmmodpkg command in the background allows the control script to complete and finish bringing up the package.

There is a small window of time, during which if one package has begun to fail over but the cmmodpkg command has not executed, the other package can fail over and the host will adopt it. In other words, if two packages fail over at approximately the same time, a host may adopt both packages, even though the package control option is specified.

See “Configuring One Adoptive Node to Support Failover of Multiple Packages” for a sample configuration using the package control option.

Use the default values for the rest of the variables in the control script, or change them as needed. For instructions on modifying the default values, see the Managing ServiceGuard for Linux manual, or read the comments in the /usr/local/cmcluster/nfstoolkit/pkg.cntl template file.

Create a separate XFS[n] variable for each NFS directory to be exported. Specify the directory name and any export options. For example:

XFS[0]=”*:/ha_root”
XFS[1]=”*:/users/scaf”
XFS[2]=”-o ro *:/ha_data”

Do not configure these exported directories in the /etc/exports file. When an NFS server boots up, it attempts to export all file systems in its /etc/exports file. If those file systems are not currently present on the NFS server node, the node cannot boot properly. This happens if the server is an adoptive node for a file system, and the file system is available on the server only after failover of the primary node.

If you want to run the NFS monitor script:

If you do not want to run the NFS monitor script:

Comment out the NFS_SERVICE_NAME and NFS_SERVICE_CMD variables. For example:

# NFS_SERVICE_NAME[0]=nfs1.monitor

By default, the NFS_SERVICE_NAME and NFS_SERVICE_CMD variables are commented out, and the NFS monitor script is not run.

Use the cmapplyconf command to verify the content of your cluster and package configuration and to copy the binary configuration file to all the nodes in the cluster. In the following example, the cluster configuration file is /usr/local/cmcluster/cluster.conf. On your system, use the names of your own cluster configuration and package configuration files.

# cmapplyconf -v -C /usr/local/cmcluster/cluster.conf \

  -P /usr/local/cmcluster/pkg1/pkg1.conf

Use your favorite copy utility (for example, ftp or rcp) to copy the package control, NFS control, and monitor scripts to the same path names on all the nodes in the cluster. For example, to copy the files from host thyme to host basil, issue the following command from host thyme:

# rcp /usr/local/cmcluster/cluster.conf/pkg1/* \

  basil:/usr/local/cmcluster/cluster.conf/pkg1