JavaScript is required to for searching.
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
search filter icon
search icon

Document Information

Preface

1.  Installing and Maintaining Oracle's Sun Network-Attached Storage Devices in an Oracle Solaris Cluster Environment

2.  Installing and Maintaining Oracle's Sun ZFS Storage Appliances as NAS Devices in an Oracle Solaris Cluster Environment

Requirements, Recommendations, and Restrictions for Sun ZFS Storage Appliance NAS Devices

Requirements for Sun ZFS Storage Appliance NAS Devices

Requirements When Configuring Sun ZFS Storage Appliances

Requirements When Configuring Sun ZFS Storage Appliance NAS Devices for Oracle RAC or HA Oracle

Requirements When Configuring Sun ZFS Storage Appliance NAS Devices as Quorum Devices

Restrictions for Sun ZFS Storage Appliance NAS Devices

Installing a Sun ZFS Storage Appliance NAS Device in an Oracle Solaris Cluster Environment

How to Install a Sun ZFS Storage Appliance in a Cluster

Maintaining a Sun ZFS Storage Appliance NAS Device in an Oracle Solaris Cluster Environment

How to Prepare the Cluster for Sun ZFS Storage Appliance NAS Device Maintenance

How to Restore Cluster Configuration After Sun ZFS Storage Appliance NAS Device Maintenance

How to Remove a Sun ZFS Storage Appliance NAS Device From a Cluster

How to Add Sun ZFS Storage Appliance Directories and Projects to a Cluster

How to Remove Sun ZFS Storage Appliance Directories and Projects and From a Cluster

Index

Installing a Sun ZFS Storage Appliance NAS Device in an Oracle Solaris Cluster Environment

How to Install a Sun ZFS Storage Appliance in a Cluster

Before You Begin

This procedure relies on the following assumptions:

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.

  1. Set up the Sun ZFS Storage Appliance.

    You can set up the appliance at any point in your cluster installation. Follow the instructions in your Sun ZFS Storage Appliance's documentation. You can also click Help in the Sun ZFS Storage Appliance GUI to access information specific to the device you are installing.

    When setting up your Sun ZFS Storage Appliance, follow the standards that are described in Requirements, Recommendations, and Restrictions for Sun ZFS Storage Appliance NAS Devices.

  2. On each cluster node, add the Sun ZFS Storage Appliance 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:

    192.192.11.191 sunnas-123 
  3. In the /etc/nsswitch.conf file on every cluster node, ensure that files follows cluster and precedes any directory or name service (for example, nis, nisplus, ldap, or dns) for hosts and netmasks information types, as shown in the following example:
    hosts:     cluster files nis
  4. Configure the filer workflow for Oracle Solaris Cluster NFS.
    1. In the Sun ZFS Storage Appliance GUI, select Maintenance, select Workflows, and click the workflow called Configure for Oracle Solaris Cluster NFS.
    2. Provide a password for this workflow. This same password will be used again in Step 6.

    image:Configure the filer workflow by typing the password in the dialog box.

    Perform the workflow configuration from only one head in a dual-head configuration.


    Note - If the workflow of the specified name is not present, it is likely that the filer is not running the correct software release. See Requirements for Sun ZFS Storage Appliance NAS Devices for an example of a supported software release.


  5. Download the Oracle Solaris Cluster/NFS Plugin and install it in the global zone on all cluster nodes.
    1. In a web browser, go to the Oracle ZFS Storage Appliance Plugin Downloads site at http://www.oracle.com/technetwork/server-storage/sun-unified-storage/downloads/zfssa-plugins-1489830.html.
    2. Click the Accept License Agreement button.
    3. Click the Download link for the latest Oracle Solaris Cluster/NFS Plugin for Solaris 10.

      The zip file containing the SUNWsczfsnfs package is downloaded. Unzip the files until that package is extracted.

    On all nodes of the global cluster, navigate to the directory containing the extracted SUNWsczfsnfs package and install it. The installation should be done within the global zone.

    # ls
    SUNWsczfsnfs
    # pkgadd -d . SUNWsczfsnfs
  6. Configure Oracle Solaris Cluster fencing support for the Sun ZFS Storage Appliance. If you skip this step, Oracle Solaris Cluster will not provide fencing support for the appliance.
    1. Add the device and provide the cluster network addresses used to access the appliance.
      • Perform this command from any cluster node:
        # clnasdevice add -t sun_uss -p userid=osc_agent -p "nodeIPs{node_name}"
        =ip_address myfiler

        For example:

        # clnasdevice add -t sun_uss -p userid=osc_agent 
        -p "nodeIPs{node1}"=10.111.11.111 
        -p "nodeIPs{node2}"=10.111.11.112 device1.us.example.com
        Please enter password
        -t sun_uss

        Enter sun_uss as the type of device you are adding.

        ip_address

        Enter the IP address used to perform I/O to the appliance from this node.

        myfiler

        Enter the name of the Sun ZFS Storage Appliance that you are adding.

        node_name

        Enter the name of cluster node whose IP addresses is being added.

        This step allows the cluster fencing framework to restrict access to the filer for the specified IP address to read-only when nodes leave the cluster.


        Note - The IP addresses configured for the cluster nodes should match the ones configured in the Sun ZFS Storage Appliance as described in Requirements for Sun ZFS Storage Appliance NAS Devices.


      • If you want to add an appliance and provide the cluster network addresses used to access the appliance for 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_uss -p userid=osc_agent -Z zcname 
        -p "nodeIPs{node_name}"=ip_address myfiler
        Please enter password
        ip_address

        Enter the IP address used to perform I/O to the appliance from this node.

        myfiler

        Enter the name of the Sun ZFS Storage Appliance that you are adding.

        node_name

        Enter the name of cluster node whose IP addresses is being added.

        -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 ZFS Storage Appliance is being added.

    2. At the prompt, type the same password that you used in Step 4.
    3. Confirm that the device has been added to the cluster.
      • Perform this command from any cluster node:
        # clnasdevice show
        ===NAS Devices===
        Nas Device:                  device1.us.example.com
         Type:                       sun_uss
         userid:                     osc_agent
         nodeIPs{node1}                  10.111.11.111
         nodeIPs{node2}                  10.111.11.112
         nodeIPs{node3}                  10.111.11.113
         nodeIPs{node4}                  10.111.11.114

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

      • If you are checking for the device for a zone cluster but you need to issue the command from the global zone, use the clnasdevice show command with the -Z option:
        # clnasdevice show -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.

  7. To enable fencing support for the NFS file systems used by the cluster nodes, add the associated projects to the cluster configuration.

    Follow the directions in How to Add Sun ZFS Storage Appliance Directories and Projects to a Cluster.

  8. Configure a LUN on the Sun ZFS Storage Appliance NAS device as a quorum device.

    Note - You can skip this step if the cluster does not require a quorum device or if it has been configured with quorum services from other devices or quorum servers.


    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 ZFS Storage Appliance NAS quorum device.