Configuring a MC/ServiceGuard NFS Package

Create a separate XFS[n] variable for each NFS directory to be exported. Specify the directory name and any export options. The directories must be defined in the above mounted file system FS list.

XFS[0]="-o ro /pkg1a"
XFS[1]="-o rw /pkg1b"

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 wish to monitor NFS services (with running the NFS monitor script), set the NFS_SERVICE_NAME variable.

NFS_SERVICE_NAME[0]=nfs1.monitor

If you do not want to run the NFS monitor script, comment out the NFS_SERVICE_NAME and NFS_SERVICE_CMD variables:

# NFS_SERVICE_NAME[0]=nfs.monitor
# NFS_SERVICE_CMD[0]=/etc/cmcluster/nfs/nfs.mon

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

You do not have to run the NFS monitor script. If your NFS package configuration file specifies AUTO_RUN YES and LOCAL_LAN_FAILOVER_ALLOWED YES (the defaults), the package will switch to the next adoptive node or to a standby network interface in the event of a node or network failure. The NFS monitor script causes the package to fail over if any of the monitored NFS services fails. NFS services are monitored if they are configured in the NFS configuration file, /etc/rc.config.d/nfsconf to be started at system boot. If you set the NFS_SERVER variable to 1, the nfsd, rpc.lockd, and rpc.statd processes are monitored. If you set the PCNFS_SERVER variable to 1, the pcnfsd process is monitored. If you set the START_MOUNTD variable to 1, the rpc.mountd process is monitored.

	NOTE: There are some changes in MC/ServiceGuard A.11.13 configuration file: AUTO_RUN replaces obsolete PKG_SWITCHING_ENABLED. LOCAL_LAN_FAILOVER_ALLOWED replaces obsolete NET_SWITCHING_ENABLED.

3. If you run the NFS monitor script, set the NFS_SERVICE_CMD variable to the full path name of the NFS monitor script.

NFS_SERVICE_CMD[0]=/etc/cmcluster/nfs/nfs.mon

The path name for the executable script does not have to be unique to each package. Every package can use the same script. Multiple instances of the monitor script can run on the same node without any problems, and if a package fails over, only the instance associated with that package is killed.

If you do not want to run the NFS monitor script, comment out the NFS_SERVICE_NAME and NFS_SERVICE_CMD variables:

# NFS_SERVICE_NAME[0]=nfs.monitor
# NFS_SERVICE_CMD[0]=/etc/cmcluster/nfs/nfs.mon

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

Set the PACKAGE_NAME variable.

PACKAGE_NAME pkg01

You can use the default package name if you will run only one MC/ServiceGuard NFS package on your MC/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.

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 (/etc/cmcluster/nfs/nfs.cntl or whatever you have renamed it). You do not have to specify a timeout for either script.

RUN_SCRIPT /etc/cmcluster/nfs/nfs1.cntl
RUN_SCRIPT_TIMEOUT NO_TIMEOUT
HALT_SCRIPT /etc/cmcluster/nfs/nfs1.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.

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 control script.

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

# SERVICE_NAME nfs.monitor

You do not have to run the NFS monitor script. If your NFS package configuration file specifies AUTO_RUN YES and LOCAL_LAN_FAILOVER_ALLOWED YES (the defaults), the package will switch to the next adoptive node or to a standby network interface in the event of a node or network failure. The NFS monitor script causes the package to fail over if any of the monitored NFS services fails. NFS services are monitored if they are configured in the /etc/rc.config.d/nfsconf file to be started at system boot. If you set the NFS_SERVER variable to 1, the nfsd, rpc.lockd, and rpc.statd processes are monitored. If you set the PCNFS_SERVER variable to 1, the pcnfsd process is monitored. If you set the START_MOUNTD variable to 1, the rpc.mountd process is monitored.

Set the SUBNET variable to the subnet that will be monitored for the package.

SUBNET 15.13.112.0

Make a copy of the /etc/cmcluster/nfs/nfs_xmnt script.

cd /etc/cmcluster/nfs
cp nfs_xmnt nfs1_xmnt

In the copy of the nfs_xmnt script, create an SNFS[n] and CNFS[n] variable for each file system in the package that will be NFS-mounted by servers. The SNFS[n] variable is the server location of the file system, and the CNFS[n] variable is the client mount point of the file system.

SNFS[0]="nfs1:/hanfs/nfsu011";CNFS[0]="/nfs/nfsu011"

In this example, "nfs1" is the name that maps to the package's relocatable IP address. It must be configured in the name service used by the server (DNS, NIS, or the /etc/hosts file).

If a server for the package will NFS-mount the package's file systems, the client mount point (CNFS) must be different from the server location (SNFS).

Copy the script you have just modified to all the servers that will NFS-mount the file systems in the package.

After the package is active on the primary node, execute the nfs_xmnt script on each server that will NFS-mount the file systems.

/etc/cmcluster/nfs/nfs1_xmnt start

Hewlett-Packard recommends that you execute the nfs_xmnt script from the command line after the package is active on the primary node. However, you can configure the nfs_xmnt script to be executed by the NFS control script in the customer_defined_run_cmds function.

function customer_defined_run_cmds
{
    /etc/cmcluster/nfs/nfs1_xmnt start
    remsh sage /etc/cmcluster/nfs/nfs1_xmnt start
}

The second line in the function invokes remsh to run the nfs_xmnt script on remote host sage.

Running the nfs_xmnt script from the NFS control script guarantees that the package is active before the mount command executes. It prevents cross-mounted servers from becoming deadlocked while each server hangs on the mount command, waiting for the other server's package to become active. However, if the package fails to activate, or if the remsh command fails, the file systems will not be mounted, and no error will be returned. The only way to be sure the file systems are mounted successfully is to run the nfs_xmnt script manually on each host where the file systems should be mounted.

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 /etc/cmcluster/cluster.conf, and the NFS package configuration file is /etc/cmcluster/nfs/nfs.conf. On your system, use the names of your own cluster configuration and package configuration files.

# cmapplyconf -v -C /etc/cmcluster/cluster.conf \
-P /etc/cmcluster/nfs/nfs.conf

Use your favorite copy utility (for example, ftp or rcp) to copy the package 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 /etc/cmcluster/nfs/* basil:/etc/cmcluster/nfs