Maintaining a Network Appliance NAS Device in a Sun Cluster Environment

This section contains procedures about maintaining Network Appliance NAS devices that are attached to a cluster. If a device's maintenance procedure might jeopardize the device's availability to the cluster, you must always perform the steps in How to Prepare the Cluster for Network Appliance NAS Device Maintenance before performing the maintenance procedure. After performing the maintenance procedure, perform the steps in How to Restore Cluster Configuration After Network Appliance NAS Device Maintenance to return the cluster to its original configuration.

Network Appliance NAS Device Procedures That Do Not Require Cluster Preparation

The following Network Appliance clustered-filer procedures can be performed without affecting the filer's availability.

• Monitoring the status of the cluster as a whole

• Viewing information about the cluster

• Enabling and disabling takeover on a cluster to perform software upgrades or other maintenance

• Halting a filer in a cluster without causing a takeover

• Performing a takeover on the partner filer

• Performing license operations on the cluster feature

• Enabling and disabling the negotiated failover feature on a cluster

---

Caution - When performing any maintenance procedure other than those listed, perform the steps in How to Prepare the Cluster for Network Appliance NAS Device Maintenance before the maintenance procedure. Perform the steps in How to Restore Cluster Configuration After Network Appliance NAS Device Maintenance after performing the maintenance procedure. If you fail to prepare the cluster, you can experience loss of cluster availability. If the cluster loses access to the Network Appliance NAS device's directories, your cluster applications will experience I/O errors, might not be able to fail over correctly, and might fail. If your cluster experiences this kind of failure, you must reboot the entire cluster (booting Network Appliance NAS device before the cluster nodes). If your cluster loses access to a Network Appliance NAS quorum device, and then a node fails, the entire cluster can become unavailable. In this case, you must either reboot the entire cluster (booting Network Appliance NAS device before the cluster nodes) or remove the quorum device and configure it again.

---

How to Prepare the Cluster for Network Appliance NAS Device Maintenance

Follow the instructions in this procedure whenever the Network Appliance NAS device maintenance you are performing might affect the device's availability to the cluster nodes.

Before You Begin

This procedure provides the long forms of the Oracle Solaris Cluster commands. Most commands also have short forms. Except for the forms of the command names, the commands are identical.

To perform this procedure, become superuser or assume a role that provides solaris.cluster.read and solaris.cluster.modify RBAC authorization.

1. Stop I/O to the NAS device.
2. On each cluster node, unmount the Network Appliance NAS device directories.
3. Determine whether a LUN on this Network Appliance NAS device is a quorum device.

   # clquorum show

4. If the LUNs on this Network Appliance NAS device are not quorum devices, you are finished with this procedure.
5. If a LUN is a quorum device, perform the following steps:
   1. If your cluster uses other shared storage devices, select and configure another quorum device.
   2. Remove this quorum device.

      See Chapter 6, Administering Quorum, in Oracle Solaris Cluster System Administration Guide for instructions about adding and removing quorum devices.

      ---

      Note - If your cluster requires a quorum device (for example, a two-node cluster) and you are maintaining the only shared storage device in the cluster, your cluster is in a vulnerable state throughout the maintenance procedure. Loss of a single node during the procedure causes the other node to panic and your entire cluster becomes unavailable. Limit the amount of time for performing such procedures. To protect your cluster against such vulnerability, add a shared storage device to the cluster.

      ---

How to Restore Cluster Configuration After Network Appliance NAS Device Maintenance

Follow the instructions in this procedure after performing any Network Appliance NAS device maintenance that might affect the device's availability to the cluster nodes.

1. Mount the Network Appliance NAS directories.
2. Determine whether you want an iSCSI LUN on this Network Appliance NAS device to be a quorum device.
   • If no, continue to Step 3.
   • If yes, configure the LUN as a quorum device, following the steps in How to Add a Network Appliance Network-Attached Storage (NAS) Quorum Device in Oracle Solaris Cluster System Administration Guide.

     Remove any extraneous quorum device that you configured in How to Prepare the Cluster for Network Appliance NAS Device Maintenance.

3. Restore I/O to the Network Appliance NAS device.

How to Remove a Network Appliance NAS Device From a Cluster

Before You Begin

This procedure relies on the following assumptions:

• Your cluster is operating.

• You have prepared the cluster by performing the steps in How to Prepare the Cluster for Network Appliance NAS Device Maintenance.

• You have removed any device directories from the cluster by performing the steps in How to Remove Network Appliance NAS Directories From a Cluster.

This procedure provides the long forms of the Oracle Solaris Cluster commands. Most commands also have short forms. Except for the forms of the command names, the commands are identical.

To perform this procedure, become superuser or assume a role that provides solaris.cluster.read and solaris.cluster.modify RBAC authorization.

1. Remove the device.
   • If you are removing a NAS device from a global cluster, use the following command from any global cluster node:

     # clnasdevice remove myfiler

     myfiler

     Enter the name of the NAS device you are removing.

     For more information about the clnasdevice command, see the clnasdevice(1CL) man page.

   • If you are removing a NAS device from a zone cluster, use the following command from any global cluster node:

     # clnasdevice remove -Z zcname myfiler

     zcname

     Enter the name of the zone cluster where the NAS device is being removed.

2. Confirm that the device has been removed from the cluster.
   • If you are checking the NAS device for a global cluster, use the following command from any global cluster node:

     # clnasdevice list

   • If you are checking the NAS device for a zone cluster, use the following command from any global cluster node:

     # clnasdevice list -Z zcname

     You can also perform zone cluster-related commands inside the zone cluster by omitting the -Z option. For more information about the clnasdevice command, see the clnasdevice(1CL) man page.

How to Add Network Appliance NAS Directories to a Cluster

Before You Begin

The procedure relies on the following assumptions:

• Your cluster is operating.

• The Network Appliance NAS device is properly configured and the directories the cluster will use have been exported.

  See Requirements, Recommendations, and Restrictions for Network Appliance NAS Devices for the details about required device configuration.

• You have added the device to the cluster by performing the steps in How to Install a Network Appliance NAS Device in a Cluster.

This procedure provides the long forms of the Oracle Solaris Cluster commands. Most commands also have short forms. Except for the forms of the command names, the commands are identical.

To perform this procedure, become superuser or assume a role that provides solaris.cluster.read and solaris.cluster.modify RBAC authorization.

1. Add the directories.
   • If you are adding NAS directories to a global cluster, use the following command from any global cluster node:

     # clnasdevice add-dir -d /export/dir1,/export/dir2 myfiler

     -d /export/dir1, /export/dir2

     Enter the directory or directories that you are adding.

     myfiler

     Enter the name of the NAS device containing the directories.

     For more information about the clnasdevice command, see the clnasdevice(1CL) man page.

   • If you are adding NAS directories to a zone cluster, use the following command from any global cluster node:

     # clnasdevice add-dir -d /export/dir1,/export/dir2 -Z zcname myfiler

     zcname

     Enter the name of the zone cluster where the NAS directories are being added.

2. Confirm that the directories have been added.
   • If you are checking the NAS directories for a global cluster, use the following command from any global cluster node:

     # clnasdevice show -v

   • If you are checking the NAS directories for a zone cluster, use the following command from any global cluster node:

     # clnasdevice show -v -Z zcname

     You can also perform zone cluster-related commands inside the zone cluster by omitting the -Z option. For more information about the clnasdevice command, see the clnasdevice(1CL) man page.

3. If you do not use the automounter, mount the directories by performing the following steps:
   1. On each node in the cluster, create a mount-point directory for each Network Appliance NAS directory that you added.

      # mkdir -p /path-to-mountpoint

      path-to-mountpoint

      Name of the directory on which to mount the directory

   2. On each node in the cluster, add an entry to the /etc/vfstab file for the mount point.

      If you are using your Network Appliance NAS device for Oracle Real Application Clusters database files, set the following mount options:

      • forcedirectio

      • noac

      • proto=tcp

      When mounting Network Appliance NAS directories, select the mount options appropriate to your cluster applications. Mount the directories on each node that will access the directories. Sun Cluster places no additional restrictions or requirements on the options that you use.

How to Remove Network Appliance NAS Directories From a Cluster

Before You Begin

This procedure assumes that your cluster is operating.

This procedure provides the long forms of the Oracle Solaris Cluster commands. Most commands also have short forms. Except for the forms of the command names, the commands are identical.

To perform this procedure, become superuser or assume a role that provides solaris.cluster.read and solaris.cluster.modify RBAC authorization.

1. If you are using hard mounts rather than the automounter, unmount the NAS directories:
   1. On each node in the cluster, unmount the directories you are removing.

      # umount /mount-point

   2. On each node in the cluster, remove the entries in the /etc/vfstab file for the directories you are removing.
2. Remove the directories.
   • If you are removing NAS directories from a global cluster, use the following command from any global cluster node:

     # clnasdevice remove-dir -d /export/dir1 myfiler

     -d /export/dir1

     Enter the directory or directories that you are removing.

     myfiler

     Enter the name of the NAS device containing the directories.

     To remove all of this device's directories, specify all for the -d option:

     # clnasdevice remove-dir -d all myfiler

     For more information about the clnasdevice command, see the clnasdevice(1CL) man page.

   • If you are removing NAS directories from a zone cluster, use the following command from any global cluster node:

     # clnasdevice remove-dir -d /export/dir1 -Z zcname myfiler

     zcname

     Enter the name of the zone cluster where the NAS directories are being removed.

     To remove all of this device's directories, specify all for the -d option:

     # clnasdevice remove-dir -d all -Z zcname myfiler

3. Confirm that the directories have been removed.
   • If you are checking the NAS directories for a global cluster, use the following command from any global cluster node:

     # clnasdevice show -v

   • If you are checking the NAS directories for a zone cluster, use the following command from any global cluster node:

     # clnasdevice show -v -Z zcname

     You can also perform zone cluster-related commands inside the zone cluster by omitting the -Z option. For more information about the clnasdevice command, see the clnasdevice(1CL) man page.

See Also

To remove the device, see How to Remove a Network Appliance NAS Device From a Cluster.