Maintaining a Sun NAS Device in an Oracle Solaris Cluster Environment

This section contains procedures about maintaining Sun 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 Sun NAS Device Maintenance before performing the maintenance procedure. After performing the maintenance procedure, perform the steps in How to Restore Cluster Configuration After Sun NAS Device Maintenance to return the cluster to its original configuration.

How to Prepare the Cluster for Sun NAS Device Maintenance

Follow the instructions in this procedure whenever the Sun 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.

Stop I/O to the Sun NAS device.
On each cluster node, unmount the Sun NAS device directories.
Determine whether a LUN on this Sun NAS device is a quorum device.
```
# clquorum show
```
If the LUNs on this Sun NAS device are not quorum devices, you are finished with this procedure.
If a LUN is a quorum device, perform the following steps:
1. If your cluster uses other shared storage devices or a quorum server, 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 Sun NAS Device Maintenance

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

Mount the Sun NAS directories.
Determine whether you want an iSCSI LUN on this Sun NAS device to be a quorum device.
- If no, continue to How to Prepare the Cluster for Sun NAS Device Maintenance.
- If yes, configure the LUN as a quorum device following the steps in Adding a Quorum Device in Oracle Solaris Cluster System Administration Guide.
  Remove any extraneous quorum device that you configured in How to Prepare the Cluster for Sun NAS Device Maintenance.
Restore I/O to the Sun NAS device.

How to Remove a Sun 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 Sun NAS Device Maintenance.
You have removed any device directories from the cluster by performing the steps in How to Remove a Sun NAS Device From a Cluster.

Note - When you remove the device from cluster configuration, the data on the device is not available to the cluster. Ensure that other shared storage in the cluster can continue to serve the data when the Sun NAS device is removed.

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.

Remove the device.
- Perform this command from any cluster node:
```
# clnasdevice remove myfiler
```
  myfiler
  
  Enter the name of the Sun NAS device that you are removing.
  
  For more information about the clnasdevice command, see the clnasdevice(1CL) man page.
- If you want to remove a NAS device from a zone cluster but you need to issue the command from the global zone, use the clnasdevice command with the -Z option:
```
# clnasdevice remove -Z zcname myfiler
```
  zcname
  
  Enter the name of the zone cluster where the Sun NAS device is being removed.
Confirm that the device has been removed from the cluster.
- Perform this command from any cluster node:
```
# clnasdevice list
```
- If you want to check the NAS device for a zone cluster but you need to issue the command from the global zone, use the clnasdevice command with the -Z option:
```
# clnasdevice list -Z zcname
```
Note - 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 Sun NAS Directories to a Cluster

Before You Begin

The procedure relies on the following assumptions:

Your cluster is operating.
The Sun NAS device is properly configured and the directories the cluster will use have been exported to all cluster nodes.

See Requirements, Recommendations, and Restrictions for Sun 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 Sun 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.

Use Sun StorEdge Web Administrator to create the Sun NAS volumes.
“Product Overview” in the Sun StorageTek NAS OS Administration Guide describes the Sun StorEdge Web Administrator GUI. “Creating File Volumes or Segments” in the Sun StorageTek NAS OS Administration Guide describes how to create file volumes.
Use Sun StorEdge Web Administrator to add read/write access to every cluster node.

Caution - You must explicitly grant read/write access to each cluster node. Do not enable general access and do not add access by specifying a cluster host group.

“Setting Up NFS Exports” in the Sun StorageTek NAS OS Administration Guide describes how to add read/write access to nodes in the cluster.

Log into your NAS device and use the Sun StorEdge list command to verify the changes that you made to the approve file, as shown in the following example.

pschost-2# telnet 10.8.165.42
Trying 10.8.165.42...
Connected to 10.8.165.42.
Escape character is '^]'.
connect to (? for list) ? [menu] admin
password for admin access ? ********
n1nas20 > approve list
====================
acache: approve
====================
files / @trusted access=rw uid0=0
admin * @schostgroup access=trusted
files /vol1 schost1 access=rw
files /vol1 schost2 access=rw
files /vol2 schost1 access=rw
files /vol2 schost2 access=rw
====================
acache: hostgrps
====================
trusted schostgroup
n1nas20 >

Add the directories.
- Perform this command from any 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 Sun NAS device containing the directories.
  
  For more information about the clnasdevice command, see the clnasdevice(1CL) man page.
- If you want to add the NAS directories to a zone cluster but you need to issue the command from the global zone, use the clnasdevice command with the -Z option:
```
# clnasdevice add-dir -d /export/dir1,/export/dir2 -Z zcname myfiler
```
  zcname
  
  Enter the name of the zone cluster where the Sun NAS directories are being added.
Confirm that the directories have been added.
- Perform this command from any cluster node:
```
# clnasdevice show -v
```
- If you want to check the NAS directories for a zone cluster but you need to issue the command from the global zone, use the clnasdevice command with the -Z option:
```
# clnasdevice show -v -Z zcname
```
  Note - 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.
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 Sun 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 Sun NAS device for Oracle Real Application Clusters database files, set the following mount options:
  - forcedirectio
  - noac
  - proto=tcp
  When mounting Sun NAS directories, select the mount options appropriate to your cluster applications. Mount the directories on each node that will access the directories. Oracle Solaris Cluster places no additional restrictions or requirements on the options that you use.

How to Remove Sun NAS Directories From a Cluster

Before You Begin

This procedure assumes that your cluster is operating.

Note - When you remove the device directories, the data on those directories is not available to the cluster. Ensure that other device directories or shared storage in the cluster can continue to serve the data when these directories have been removed.

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.

If you are using hard mounts rather than the automounter, unmount the Sun 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.
Remove the directories.
- Perform this command from any 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 Sun 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 want to remove the NAS directories from a zone cluster but you need to issue the command from the global zone, use the clnasdevice command with the -Z option:
```
# clnasdevice remove-dir -d /export/dir1 -Z zcname myfiler
```
  zcname
  
  Enter the name of the zone cluster where the Sun 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
```
  For more information about the clnasdevice command, see the clnasdevice(1CL) man page.
Confirm that the directories have been removed.
- Perform this command from any cluster node:
```
# clnasdevice show -v
```
- If you want to check the NAS directories for a zone cluster but you need to issue the command from the global zone, use the clnasdevice command with the -Z option:
```
# clnasdevice show -v -Z zcname
```
Note - 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.

Skip Navigation Links
Exit Print View
	Oracle Solaris Cluster 3.3 3/13 With Network-Attached Storage Device Manual Oracle Solaris Cluster 3.3 3/13