How to Register and Configure HA for NFS (clsetup) - Oracle® Solaris Cluster Data Service for 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. This includes adding an entry for each logical hostname to the name service database.
Prerequisites for configuring a highly available storage resource are met.
The HA for NFS package is installed.
If you are using PNM objects, the objects are configured on the nodes where the logical hostname resource can be brought online. Public network management (PNM) objects include Internet Protocol network multipathing (IPMP) groups, trunk and datalink multipathing (DLMP) link aggregations, and VNICs that are directly backed by link aggregations.

Have available the logical hostnames that you plan to add to the resource group.

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
```
  Note - 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.
The Data Services menu is displayed.
Select the option for configuring HA for NFS.
The clsetup utility displays the list of prerequisites for performing this task.
Verify that the prerequisites are met.
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.
- To select a subset of the listed nodes, type a comma-separated or space-separated list of the numbers that correspond to the nodes.
  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.
  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.
The clsetup utility displays the list of available logical hostname resources.
- If you need to create a new logical hostname resource, type c.
  Proceed to Step 9
- If the logical hostname resources you need already exist, skip to Step 11.

Create a new logical hostname.
At the prompt, type the logical hostname to use.
- If more than one PNM object is configured for the specified logical hostname, the clsetup utility provides a screen where you can specify the PNM objects to use.
  Proceed to Step 10.
- If only one PNM object is configured for the specified logical hostname, the clsetup utility lists the names of the Oracle Solaris Cluster logical hostname resources that the utility will create.
  Skip to Step 11.

Select from the list of available PNM objects one object for each cluster node.
The clsetup utility displays the names of the Oracle Solaris Cluster logical hostname resources that the utility will create.

Type a comma-separated or space-separated list of the numbers that corespond to the logical hostname resources that your data service requires.
The clsetup utility displays the numbers of the logical hostname resources you selected.
To confirm your selection of logical hostname resources, type d.
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.
- 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.
To confirm your selection of file system mount points, type d.
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.
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.
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.
  The clsetup utility displays a screen where you can specify the new name.
2. At the New Value prompt, type the new name.
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.
The clsetup utility displays information about the Oracle Solaris Cluster configuration that the utility will create.
To create the configuration, type c.
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.
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
```