Go to main content

Administering an Oracle® Solaris Cluster 4.4 Configuration

Exit Print View

Updated: November 2019

How to Change Device Group Properties

The method for establishing the primary ownership of a device group is based on the setting of an ownership preference attribute called preferenced. If the attribute is not set, the primary owner of an otherwise unowned device group is the first node that attempts to access a disk in that group. However, if this attribute is set, you must specify the preferred order in which nodes attempt to establish ownership.

If you disable the preferenced attribute, then the failback attribute is also automatically disabled. However, if you attempt to enable or re-enable the preferenced attribute, you have the choice of enabling or disabling the failback attribute.

If the preferenced attribute is either enabled or re-enabled, you are required to reestablish the order of nodes in the primary ownership preference list.

This procedure uses the clsetup utility to set or unset the preferenced attribute and the failback attribute for Solaris Volume Manager device groups.

Before You Begin

To perform this procedure, you need the name of the device group for which you are changing attribute values.

The phys-schost# prompt reflects a global-cluster prompt. Perform this procedure on a global cluster.

This procedure provides the long forms of the Oracle Solaris Cluster commands. Most commands also have short forms. Except for the long and short forms of the command names, the commands are identical.

  1. Assume the root role or a role that provides solaris.cluster.read and solaris.cluster.modify authorization on any node of the cluster.
  2. Start the clsetup utility.
    # clsetup

    The Main Menu is displayed.

  3. To work with device groups, type the number for the option for device groups and volumes.

    The Device Groups Menu is displayed.

  4. To change key properties of a device group, type the number for the option for changing key properties of a Solaris Volume Manager device group.

    The Change Key Properties Menu is displayed.

  5. To change a device group property, type the number for option for changing the preferences or failback properties.

    Follow the instructions to set the preferenced and failback options for a device group.

  6. Verify that the device group attributes have been changed.

    Look for the device group information displayed by the following command.

    # cldevicegroup show -v devicegroup 
Example 34  Changing Device Group Properties

The following example shows the cldevicegroup command generated by clsetup when it sets the attribute values for a device group (dg-schost-1).

# cldevicegroup set -p preferenced=true -p failback=true -p numsecondaries=1 \
-p nodelist=phys-schost-1,phys-schost-2 dg-schost-1
# cldevicegroup show dg-schost-1

=== Device Groups ===                          

Device Group Name:                        dg-schost-1
  Type:                                     SVM
  failback:                                 yes
  Node List:                                phys-schost-1, phys-schost-2
  preferenced:                              yes
  numsecondaries:                           1
  diskset names:                            dg-schost-1