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 Oracle ZFS Storage Appliance.
You can also add an Oracle ZFS Storage Appliance using the Oracle Solaris Cluster Manager GUI. For GUI log-in instructions, see How to Access Oracle Solaris Cluster Manager in Oracle Solaris Cluster System Administration Guide . After you install the appliance, you can also use the GUI to edit the Export List property.
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.
You can set up the appliance at any point in your cluster installation. Follow the instructions in your Oracle ZFS Storage Appliance's documentation. You can also click Help in the Oracle ZFS Storage Appliance GUI to access information specific to the device you are installing.
When setting up your Oracle ZFS Storage Appliance, follow the standards that are described in Requirements, Recommendations, and Restrictions for Oracle ZFS Storage Appliance NAS Devices.
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
hosts: cluster files nis
# /usr/sbin/svccfg -s svc:/system/name-service/switch listprop config/host config/host astring "cluster files nis dns" # /usr/sbin/svccfg -s svc:/system/name-service/switch listprop config/netmask config/netmask astring "cluster files nis"
# /usr/sbin/svccfg -s svc:/system/name-service/switch setprop config/host = astring: \"cluster files nis\" # /usr/sbin/svccfg -s svc:/system/name-service/switch setprop config/netmask = astring: \"cluster files nis\" # /usr/sbin/svcadm refresh svc:/system/name-service/switch
# /usr/sbin/svccfg -s svc:/system/name-service/switch listprop config/host # /usr/sbin/svccfg -s svc:/system/name-service/switch listprop config/netmask
Perform the workflow configuration from only one head in a dual-head configuration.
On all nodes within the global zone, install the zfssa-client package from the repository. You can use the pkg publisher command to check that the publisher is already set for the zfssa-client package. For example, the pkg publisher command might return the following location: https://pkg.oracle.com/ha-cluster/release. For more information about setting the publisher, see How to Install Oracle Solaris Cluster Software Packages in Oracle Solaris Cluster Software Installation Guide .
For example:
# pkg publisher # pkg list -af zfssa-client # pkg install zfssa-client ========================== # Packages to install: 1 Create boot environment: No Create backup boot environment: No DOWNLOAD PKGS FILES XFER (MB) Completed 1/1 7/7 0.2/0.2$<3> PHASE ACTIONS Install Phase 17/17 PHASE ITEMS Package State Update Phase 1/1 Image State Update Phase 2/2 # ==========================
# pkg install zfssa-client
# 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
Enter sun_uss as the type of device you are adding.
Enter the IP address used to perform I/O to the appliance from this node.
Enter the name of the Oracle ZFS Storage Appliance that you are adding.
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.
# clnasdevice add -t sun_uss -p userid=osc_agent -Z zcname -p "nodeIPs{node_name}"=ip_address myfiler Please enter password
Enter the IP address used to perform I/O to the appliance from this node.
Enter the name of the Oracle ZFS Storage Appliance that you are adding.
Enter the name of cluster node whose IP addresses is being added.
Specify the cluster where the nas-device-type is registered and where you will operate.
Enter the name of the zone cluster where the Oracle ZFS Storage Appliance is being added.
# 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.
# 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.
Follow the directions in How to Add Oracle ZFS Storage Appliance Directories and Projects to a Cluster.
See How to Add an Oracle ZFS Storage Appliance NAS Quorum Device in Oracle Solaris Cluster System Administration Guide for instructions for configuring an Oracle ZFS Storage Appliance NAS quorum device.