Installing a Sun NAS Device in an Oracle Solaris Cluster Environment

How to Install a Sun NAS Device in a Cluster

Before You Begin

This procedure relies on the following assumptions:

Your cluster nodes have the operating system and Oracle Solaris Cluster software installed.
You have administrative access to the Sun NAS device.

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 (role-based access control) authorization.

Set up the Sun NAS device.
You can set up the Sun NAS device at any point in your cluster installation. Follow the instructions in your Sun NAS device's documentation.
When setting up your Sun NAS device, follow the standards that are described in Requirements, Recommendations, and Restrictions for Sun NAS Devices.
On each cluster node, add the Sun NAS device name to the /etc/inet/hosts file.
Add a hostname-to-address mapping for the device in the /etc/inet/hosts file on all cluster nodes, as shown in the following example:
```
sunnas-123 192.168.11.123
```
On each node in the cluster, add the device netmasks to the /etc/inet/netmasks file.
Add an entry to the /etc/inet/netmasks file for the subnet on which the filer is located, as shown in the following example.
```
192.168.11.0 255.255.255.0
```
In /etc/nsswitch.conf on every cluster node, ensure that files precedes nis and dns information sources for hosts and netmasks information types, as shown in the following example.
```
hosts:     cluster files nis
```
Use Oracle's Sun StorEdge Web Administrator to add net addresses for all cluster nodes to the Sun NAS device.
“Product Overview” in the Sun StorageTek NAS OS Administration Guide describes the Sun StorEdge Web Administrator graphical user interface (GUI). “Adding and Editing Hosts” in the Sun StorageTek NAS OS Administration Guide describes how to add net addresses.
Log into your Sun NAS device and use the Sun StorEdge hostlook command to verify that the net address for each cluster node resolves correctly, 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 > hostlook pschost-1
pschost-1:
  Name:  pschost-1
  Addr:  10.8.165.42
```
If the NIS+ configuration is correct and is used as the primary Host Order naming service, information about the entered host is displayed.
If you are attaching the cluster to Oracle's Sun StorageTek 5320 NAS Cluster Appliance filer for the first time, log into the NAS device and use the load command to load the NAS fencing command, 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 > load fencing
n1nas20 > 
```
If you are attaching the cluster to the Sun StorageTek 5320 NAS Cluster Appliance filer for the first time, configure the fencing command so that it loads automatically after the filer reboots.
1. Use ftp(1) to get the /dvol/etc/inetload.ncf file from your Sun NAS device onto your local machine.
2. Using a text editor, in the inetload.ncf file on your local machine, add the following entry.
```
fencing
```
3. Use ftp to put back the inetload.ncf file onto your Sun NAS device (in /dvol/etc/inetload.ncf).
Use Sun StorEdge Web Administrator to add trusted administrator access to every cluster node.
“Product Overview” in the Sun StorageTek NAS OS Administration Guide describes the Sun StorEdge Web Administrator GUI.
1. In Web Administrator, create a host group for the cluster, which includes every node in the cluster, by selecting, in the Navigation Pane, UNIX Configuration→Configure NFS→Set Up Hostgroups.
2. Use ftp(1) to get the /dvol/etc/approve file from your Sun NAS device onto your local machine.
3. Using a text editor, in the approve file on your local machine, add the following entry.
```
admin * @cluster-host-group access=trusted
```
  Note - You must add this entry before any existing entries in the approve file, as shown in the following example.
```
admin * @schostgroup access=trusted
admin * @general access=granted
```
  This approve file is searched in sequence and stops at the first match. Placing the entry that you add before any existing entries ensures that it is matched first.
  admin
  
  A service type that controls administrative access to StorEdge configuration menus and commands through rlogin and rsh or ssh clients. Each admin entry in the approve file specifies the users and hosts that are allowed administrative access.
  
  @cluster-host-group
  
  The name of the host group that you previously created (preceded by the “at” symbol (@)).
  
  access=trusted
  
  How the host group can access administrative services on the Sun NAS device. Oracle Solaris Cluster requires that you grant trusted access for the cluster nodes. Trusted access grants the user access without having to specify an administrative password.
  
  For example, change the contents of your approve file from that shown in the first example to that shown in the second example.
```
# Approve file -- controls client access to resources
files / @trusted access=rw uid0=0
```
```
# Approve file -- controls client access to resources
files / @trusted access=rw uid0=0
admin * @schostgroup access=trusted
```
4. Use ftp to put back the approve file onto your Sun NAS device (in /dvol/etc/approve).

Log into your NAS device and use the Sun StorEdge reload command to reload the updated 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 reload
n1nas20 >

Configure Oracle Solaris Cluster fencing support for the Sun NAS device. If you skip this step, Oracle Solaris Cluster will not provide fencing support for the NAS device.
1. Add the device.
  - Perform this command from any cluster node:
```
# clnasdevice add -t sun myfiler
```
    -t sun
    
    Enter sun as the type of device you are adding.
    
    myfiler
    
    Enter the name of the Sun NAS device that you are adding.
  - If you want to add a NAS device 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 -t sun -Z zcname myfiler
```
    -Z
    
    Specify the cluster where the nas-device-type is registered and where you will operate.
    
    zcname
    
    Enter the name of the zone cluster where the Sun NAS device is being added.
2. Confirm that the device has been added to the cluster.
  - Perform this command from any cluster node:
```
# clnasdevice list
```
    For more information about the clnasdevice command, see the clnasdevice(1CL) man page.
  - If you want to check a 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
```
    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.
Add the Sun NAS directories to the cluster when the NAS device has been configured to support fencing.
Follow the directions in How to Add Sun NAS Directories to a Cluster.
(Optional) Configure a LUN on the Sun NAS device as a quorum device.
See How to Add a Sun NAS or Sun ZFS Storage Appliance NAS Quorum Device in Oracle Solaris Cluster System Administration Guide for instructions for configuring a Sun NAS quorum device.

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