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.
To perform this procedure, assume the root role or a role that provides solaris.cluster.read and solaris.cluster.modify 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.0.2.19 zfssa-123
For example:
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
This same password will be used again in Step 7.
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 (pkg) in Installing and Configuring an Oracle Solaris Cluster 4.4 Environment.
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
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
Specifies sun_uss as the type of device you are adding.
Specifies the IP address used to perform I/O to the appliance from this node.
Specifies the name of the Oracle ZFS Storage Appliance that you are adding.
Specifies 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
Specifies the name of the zone cluster where the Oracle ZFS Storage Appliance is being added.
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(8CL) 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(8CL) 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 Administering an Oracle Solaris Cluster 4.4 Configuration for instructions for configuring an Oracle ZFS Storage Appliance NAS quorum device.