Go to main content

Installing and Configuring an Oracle® Solaris Cluster 4.4 Environment

Exit Print View

Updated: September 2019
 
 

Adding Storage Devices to a Zone Cluster

This section describes how to add the direct use of global storage devices by a zone cluster or add storage devices that are dedicated to a single zone-cluster node. Global devices are devices that can be accessed by more than one node in the cluster, either one node at a time or multiple nodes concurrently.

After a device is added to a zone cluster, the device is visible only from within that zone cluster.

You can also use the Oracle Solaris Cluster Manager to add a storage device to a zone cluster. For the browser interface log-in instructions, see How to Access Oracle Solaris Cluster Manager in Administering an Oracle Solaris Cluster 4.4 Configuration.

This section contains the following procedures:

How to Add a Global Storage Device to a Zone Cluster (clsetup)

Perform this procedure to add one of the following types of storage devices in cluster scope:

  • Raw-disk devices

  • Solaris Volume Manager disk sets (not including multi-owner)


Note -  Alternatively, you can use either the command line or the Oracle Solaris Cluster Manager browser interface to perform this task. To use the command line to perform this task, see the following procedures:

To add a raw-disk device to a specific zone-cluster node, go instead to How to Add a Raw-Disk Device to a Specific Zone-Cluster Node (CLI).

To use the Oracle Solaris Cluster Manager browser interface to perform this task, click Zone Clusters, click the zone cluster name to go to its page, click the Solaris Resources tab, then in the Storage Devices section click Add to start the storage device wizard. For Oracle Solaris Cluster Manager log-in instructions, see How to Access Oracle Solaris Cluster Manager in Administering an Oracle Solaris Cluster 4.4 Configuration.


The clsetup utility discovers and displays the available storage devices that are configured on the cluster nodes where the selected zone cluster is configured. After you use the clsetup utility to add a storage device to an existing zone cluster , use the clzonecluster command to modify the configuration. For instructions on using the clzonecluster command to remove a storage device from a zone cluster, see How to Remove a Storage Device From a Zone Cluster in Administering an Oracle Solaris Cluster 4.4 Configuration.

  1. Assume the root role on a node of the global cluster that hosts the zone cluster.

    You perform all steps of this procedure from a node of the global cluster.

  2. Identify the device to add to the zone cluster and determine whether it is online.
    phys-schost# cldevicegroup status
  3. If the device that you are adding is not online, bring it online.
    phys-schost# cldevicegroup online device
  4. Start the clsetup utility.
    phys-schost# clsetup

    The Main Menu is displayed.


    Tip  -  To return to a previous screen, type the < key and press Return.
  5. Choose the Zone Cluster menu item.

    The Zone Cluster Tasks Menu is displayed.

  6. Choose the Add File System/Storage Device to a Zone Cluster menu item.

    The Select Zone Cluster menu is displayed.

  7. Choose the zone cluster where you want to add the storage device.

    The Storage Type Selection menu is displayed.

  8. Choose the Device menu item.

    A list of the available devices is displayed.

  9. Choose a storage device from the list.

    You can also type e to manually specify properties for a storage device.

    The Storage Device Property for the Zone Cluster menu is displayed.

  10. Add or change any properties for the storage device you are adding.

    Note -  An asterisk (*) is used as a wildcard character in the path name.

    When, finished, type d and press Return. The Review File Systems/Storage Devices for the Zone Cluster menu is displayed.

  11. Type c to save the configuration change.

    The results of your configuration change are displayed. For example:

     >>> Result of Configuration Change to the Zone Cluster(sczone) <<<
    
    Adding file systems or storage devices to sczone zone cluster...
    
    The zone cluster is being created with the following configuration
    
    /usr/cluster/bin/clzonecluster configure sczone
    add device
    set match=/dev/md/ddg/*dsk/*
    end
    add device
    set match=/dev/md/shared/1/*dsk/*
    end
    
    Configuration change to sczone zone cluster succeeded.
    The change will become effective after the zone cluster reboots.
  12. When finished, exit the clsetup utility.
  13. Verify the addition of the device.
    phys-schost# clzonecluster show -v zoneclustername

How to Add a DID Device to a Zone Cluster (CLI)

Perform this procedure to add a DID device to a zone cluster.


Note -  Alternatively, you can use the clsetup utility to perform this task. See How to Add a Global Storage Device to a Zone Cluster (clsetup).
  1. Assume the root role on a node of the global cluster that hosts the zone cluster.

    You perform all steps of this procedure from a node of the global cluster.

  2. Identify the DID device to add to the zone cluster.

    The device you add must be connected to all nodes of the zone cluster.

    phys-schost# cldevice list -v
  3. Add the DID device for use by the zone cluster.

    Note -  An asterisk (*) is used as a wildcard character in the path name.
    phys-schost# clzonecluster configure zone-cluster-name
    clzc:zone-cluster-name> add device
    clzc:zone-cluster-name:device> set match=/dev/did/*dsk/dNs*
    clzc:zone-cluster-name:device> end
    clzc:zone-cluster-name> verify
    clzc:zone-cluster-name> commit
    clzc:zone-cluster-name> exit
    match=/dev/did/*dsk/dNs*

    Specifies the full device path of the DID device

  4. Reboot the zone cluster.

    The change becomes effective after the zone cluster reboots.

    phys-schost# clzonecluster reboot zone-cluster-name

    Note -  To reduce downtime, you can reboot the zone cluster nodes one by one. See Shutting Down and Booting a Single Node in a Cluster in Administering an Oracle Solaris Cluster 4.4 Configuration.
Example 21  Adding a DID Device to a Zone Cluster (CLI)

The following example adds the DID device d10 to the sczone zone cluster.

phys-schost-1# clzonecluster configure sczone
clzc:sczone> add device
clzc:sczone:device> set match=/dev/did/*dsk/d10s*
clzc:sczone:device> end
clzc:sczone> verify
clzc:sczone> commit
clzc:sczone> exit

phys-schost-1# clzonecluster reboot sczone

How to Add a Disk Set to a Zone Cluster (CLI)

Perform this procedure to add an entire Solaris Volume Manager disk set to a zone cluster.


Note -  Alternatively, you can use the clsetup utility to perform this task. See How to Add a Global Storage Device to a Zone Cluster (clsetup).
  1. Assume the root role on a node of the global cluster that hosts the zone cluster.

    You perform all steps of this procedure from a node of the global cluster.

  2. Identify the disk set to add to the zone cluster and determine whether it is online.
    phys-schost# cldevicegroup status
  3. If the disk set that you are adding is not online, bring it online.
    phys-schost# cldevicegroup online diskset
  4. Determine the set number that corresponds to the disk set to add.
    phys-schost# ls -l /dev/md/diskset
    lrwxrwxrwx  1 root root  8 Jul 22 23:11 /dev/md/diskset -> shared/set-number
  5. Add the disk set for use by the zone cluster.

    You must use a separate add device session for each set match= entry.


    Note -  An asterisk (*) is used as a wildcard character in the path name.
    phys-schost# clzonecluster configure zone-cluster-name
    clzc:zone-cluster-name> add device
    clzc:zone-cluster-name:device> set match=/dev/md/diskset/*dsk/*
    clzc:zone-cluster-name:device> end
    clzc:zone-cluster-name> add device
    clzc:zone-cluster-name:device> set match=/dev/md/shared/set-number/*dsk/*
    clzc:zone-cluster-name:device> end
    clzc:zone-cluster-name> verify
    clzc:zone-cluster-name> commit
    clzc:zone-cluster-name> exit
    match=/dev/md/diskset/*dsk/*

    Specifies the full logical device path of the disk set

    match=/dev/md/shared/N/*dsk/*

    Specifies the full physical device path of the disk set number

  6. Reboot the zone cluster.

    The change becomes effective after the zone cluster reboots.

    phys-schost# clzonecluster reboot zone-cluster-name
Example 22  Adding a Disk Set to a Zone Cluster (CLI)

The following example adds the disk set oraset to the sczone zone cluster. The set number of the disk set is 3.

phys-schost-1# clzonecluster configure sczone
clzc:sczone> add device
clzc:sczone:device> set match=/dev/md/oraset/*dsk/*
clzc:sczone:device> end
clzc:sczone> add device
clzc:sczone:device> set match=/dev/md/shared/3/*dsk/*
clzc:sczone:device> end
clzc:sczone> verify
clzc:sczone> commit
clzc:sczone> exit

phys-schost-1# clzonecluster reboot sczone

How to Add a Raw-Disk Device to a Specific Zone-Cluster Node (CLI)

Perform this procedure to add a raw-disk device to a specific zone-cluster node. This device would not be under Oracle Solaris Cluster control. Perform all steps of the procedure from a node of the global cluster.


Note -  To add a raw-disk device for use by the full zone cluster, go instead to How to Add a Global Storage Device to a Zone Cluster (clsetup) or How to Add a DID Device to a Zone Cluster (CLI).
  1. Assume the root role on a node of the global cluster that hosts the zone cluster.

    You perform all steps of this procedure from a node of the global cluster.

  2. Identify the device (cNtXdYsZ) to add to the zone cluster and determine whether it is online.
  3. Add the device to the zone-cluster configuration in the node scope.

    Note -  An asterisk (*) is used as a wildcard character in the path name.
    phys-schost# clzonecluster configure zone-cluster-name
    clzc:zone-cluster-name> select node physical-host=baseclusternode
    clzc:zone-cluster-name:node> add device
    clzc:zone-cluster-name:node:device> set match=/dev/*dsk/cNtXdYs*
    clzc:zone-cluster-name:node:device> end
    clzc:zone-cluster-name:node> end
    clzc:zone-cluster-name> verify
    clzc:zone-cluster-name> commit
    clzc:zone-cluster-name> exit
    match=/dev/*dsk/cNtXdYs*

    Specifies the full device path of the raw-disk device

  4. Verify the addition of the device.
    phys-schost# clzonecluster show -v zoneclustername
Example 23  Adding a Raw-Disk Device to a Specific Zone-Cluster Node (CLI)

The following example adds the raw–disk device c1t1d0s0 for use by a node of the sczone zone cluster. This zone-cluster node is hosted on global – cluster node phys-schost-1.

phys-schost-1# clzonecluster configure sczone
clzc:sczone> select node physical-host=phys-schost-1
clzc:sczone:node> add device
clzc:sczone:node:device> set match=/dev/*dsk/c1t1d0s0
clzc:sczone:node:device> end
clzc:sczone:node> end
clzc:sczone> verify
clzc:sczone> commit
clzc:sczone> exit

phys-schost-1# clzonecluster show -v sczone
…
--- Solaris Resources for phys-schost-1 ---
…
Resource Name:                                device
name:                                          /dev/*dsk/c1t1d0s0