How to Register and Configure HA for NFS (clsetup) - Oracle® Solaris Cluster Data Service for Network File System (NFS) Guide

Language:

How to Register and Configure HA for NFS (`clsetup`)

Perform this procedure during your initial set up of HA for NFS. Perform this procedure from one node only.

Note - The following instructions explain how to perform this operation by using the clsetup utility.

Before You Begin

Before you start the HA for NFS wizard, ensure that the following prerequisites are met:

Prerequisites for configuring a logical hostname resource are met.
Prerequisites for configuring a highly available storage resource are met.
The HA for NFS package is installed.

Assume the root role on any cluster node.

Ensure that the hosts and rpc entries in the /etc/nsswitch.conf file are correct.
The example output shows a configuration that uses the NIS external naming service.
1. Display the lookup entries for hosts and rpc.
  The following example shows the correct lookup entries.
```
# svccfg -s svc:/system/name-service/switch listprop config/host
hosts: cluster files [SUCCESS=return] nis
# svccfg -s svc:/system/name-service/switch listprop config/rpc
rpc: files nis
```
  - For hosts, files must follow cluster and precede any directory or name service. This modification enables HA for NFS to fail over correctly in the presence of public network failures.
  For rpc, files must precede any directory or name service. This configuration prevents timing-related errors for rpc lookups during periods of public network or name service unavailability.
2. If a lookup entry is not correct, set the correct lookups.
  - For hosts:
```
# svccfg -s svc:/system/name-service/switch \
setprop config/host = astring: \"cluster files [SUCCESS=return] nis\"
```
  - For rpc:
```
# svccfg -s svc:/system/name-service/switch \
setprop config/rpc = astring: \"files nis\"
```

Start the clsetup utility.
```
# clsetup
```
The clsetup main menu is displayed.

Select the option for Data Services and press Return.
The Data Services menu is displayed.
Select the option for configuring HA for NFS and press Return.
The clsetup utility displays the list of prerequisites for performing this task.
Verify that the prerequisites are met, and press Return.
The clsetup utility displays a list of all cluster nodes that are online.
Select the nodes where you require HA for NFS to run.
- To accept the default selection of all listed nodes in an arbitrary order, type a and press Return.
- To select a subset of the listed nodes, type a comma-separated or space-separated list of the numbers that correspond to the nodes and press Return.
  Ensure that the nodes are listed in the order in which the nodes are to appear in the resource group's node list. The first node in the list is the primary node of this resource group.
- To select all nodes in a particular order, type a comma-separated or space-separated ordered list of the numbers that correspond to the nodes and press Return.
  Ensure that the nodes are listed in the order in which the nodes are to appear in the resource group's node list. The first node in the list is the primary node of this resource group.

To confirm your selection of nodes, type d and press Return.
The clsetup utility displays a list of existing logical hostname resources on the cluster.
You can choose any of the following options.
- To use the existing logical hostname resource, select the option for the required logical hostname and press Return. Go to Step 17.
- To create a new logical hostname resource, type c and press Return. Go to Step 15

Type the logical hostname and press Return.
The clsetup utility displays a list of existing logical hostname resources.
Select the option for the logical hostname resource to be created and press Return.
The clsetup creates the logical hostname resource.

To confirm your selection of logical hostname resource, type d and press Return.
The clsetup utility displays information about file system mount points.
Press Return to continue.
The clsetup utility displays the existing file system mount points.
Select the file system mount points for HA for NFS data files.
- To select a subset of the listed file system mount points, type a comma-separated or space-separated list of the numbers that correspond to the file system node point and press Return.
- To select all file system mount points in a particular order, type a comma-separated or space-separated ordered list of the numbers that correspond to the file system mount points and press Return.
To confirm your selection of file system mount points, type d and press Return.
The clsetup utility displays a screen where you can specify the path prefix for HA for NFS resource group.
Select the path prefix for HA for NFS resource group and press Return.
The clsetup utility displays a screen where you can change the share option for the file system mount point that the NFS server is sharing.
Select the share option and press Return.
The clsetup utility displays the share options for the selected mount points.
If you require a different name for any Oracle Solaris Cluster objects, change each name as follows.
1. Select the option for the name that you are changing and press Return.
  The clsetup utility displays a screen where you can specify the new name.
2. At the New Value prompt, type the new name and press Return.
The clsetup utility returns you to the list of the names of the Oracle Solaris Cluster objects that the utility will create.
To confirm your selection of Oracle Solaris Cluster object names, type d and press Return.
The clsetup utility displays information about the Oracle Solaris Cluster configuration that the utility will create.
To create the configuration, type c and Press Return.
The clsetup utility displays a progress message to indicate that the utility is running commands to create the configuration. When configuration is complete, the clsetup utility displays the commands that the utility ran to create the configuration.
Press Return to continue.
The clsetup utility returns you to the Data Services Menu.
Type q and press Return.
The clsetup utility returns you to the Main Menu.
(Optional) Type q and press Return to quit the clsetup utility.
If you prefer, you can leave the clsetup utility running while you perform other required tasks before using the utility again. If you choose to quit clsetup, the utility recognizes your HA for NFS resource group when you restart the utility.

Determine whether the HA for NFS resource group and its resources are online.
Use the clresourcegroup command for this purpose. By default, the clsetup utility assigns the name nfs-mountpoint-admin-rg to the HA for NFS resource group.
```
# clresourcegroup status nfs-mountpoint-admin-rg
```
If the HA for NFS resource group and its resources are not online, bring them online.
```
# clresourcegroup online -eM nfs-rg
```