How to Install a Sun NAS Device in a Cluster (Sun Cluster 3.1 - 3.2 With Network-Attached Storage Devices Manual for Solaris OS)

Sun Cluster 3.1 - 3.2 With Network-Attached Storage Devices Manual for Solaris OS

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 Sun Cluster software installed.
You have administrative access to the Sun NAS device.

This procedure provides the long forms of the Sun Cluster commands. Most commands also have short forms. Except for the forms of the command names, the commands are identical. For a list of the commands and their short forms, see Appendix A, Sun Cluster Object-Oriented Commands, in Sun Cluster 3.1 - 3.2 Hardware Administration Manual for Solaris OS.

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:     files nis
```

Use Sun StorEdge^TM 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 the 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 graphical user interface (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. Sun 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 Sun Cluster fencing support for the Sun NAS device. If you skip this step, Sun Cluster will not provide fencing support for the NAS device.
1. From any cluster node, add the device.
  - If you are using Sun Cluster 3.2, use the following command:
    # 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 are using Sun Cluster 3.1, use the following command:
    # scnas -a -h myfiler -t sunnas
    -a
    
    Add the device to cluster configuration.
    
    -h myfiler
    
    Enter the name of the Sun NAS device you are adding.
2. Confirm that the device has been added to the cluster.
  - If you are using Sun Cluster 3.2, use the following command:
    # clnasdevice list
    For more information about the clnasdevice command, see the clnasdevice(1CL) man page.
  - If you are using Sun Cluster 3.1, use the following command:
    # scnas -p

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 Network Appliance Network-Attached Storage (NAS) Quorum Device in Sun Cluster System Administration Guide for Solaris OS for instructions for configuring a Sun NAS quorum device.