SPARC: How to Remove a Node From a Raw Disk Device Group

Use this procedure to remove a cluster node from the list of potential primaries of a VERITAS Volume Manager (VxVM) disk device group (disk group).

Use this procedure to remove a cluster node from the list of potential primaries of a raw disk device group.

1. Become superuser on a node in the cluster other than the node to remove.

2. Identify the disk device groups that are connected to the node being removed.

   Look for the node name in the Device group node list entry.

   # scconf -pvv | grep Devicenodename | grep

   
   

3. Determine which disk device groups identified in Step 2 are raw disk device groups.

   Raw disk device groups are of the Disk or Local_Disk device group type.

   # scconf -pvv | grep group type

   
   

4. Disable the localonly property of each Local_Disk raw disk device group.

   # scconf -c -D name=rawdisk-device-group,localonly=false

   
   

   See the scconf_dg_rawdisk(1M) man page for more information about the localonly property.

5. Verify that you have disabled the localonly property of all raw disk device groups that are connected to the node being removed.

   The Disk device group type indicates that the localonly property is disabled for that raw disk device group.

   # scconf -pvv | grep group type

   
   

6. Remove the node from all raw disk device groups identified in Step 3.

   You must complete this step for each raw disk device group that is connected to the node being removed.

   # scconf -r -D name=rawdisk-device-group,nodelist=nodename

   
   

SPARC: Example--Removing a Node From a Raw Disk Device Group

This example shows how to remove a node (phys-schost-2) from a raw disk device group. All commands are run from another node of the cluster (phys-schost-1).

[Identify the disk device groups connected to the node being removed:]
phys-schost-1# scconf -pvv | grep phys-schost-2 | grep Device group node list
	(dsk/d4) Device group node list:  phys-schost-2
	(dsk/d2) Device group node list:  phys-schost-1, phys-schost-2
	(dsk/d1) Device group node list:  phys-schost-1, phys-schost-2
[Identify the are raw disk device groups:]
phys-schost-1# scconf -pvv | grep group type
	(dsk/d4) Device group type:          Local_Disk
	(dsk/d8) Device group type:          Local_Disk
[Disable the localonly flag for each local disk on the node:]
phys-schost-1# scconf -c -D name=dsk/d4,localonly=false
[Verify that the localonly flag is disabled:]
phys-schost-1# scconf -pvv | grep group type
    (dsk/d4) Device group type:          Disk
    (dsk/d8) Device group type:          Local_Disk
[Remove the node from all raw disk device groups:]
phys-schost-1# scconf -r -D name=dsk/d4,nodelist=phys-schost-2
phys-schost-1# scconf -r -D name=dsk/d2,nodelist=phys-schost-2
phys-schost-1# scconf -r -D name=dsk/d1,nodelist=phys-schost-2

How to Change Disk Device Properties

The method for establishing the primary ownership of a disk 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 disk 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 re-establish the order of nodes in the primary ownership preference list.

This procedure uses scsetup(1M) to set or unset the preferenced attribute and the failback attribute for Solstice DiskSuite/Solaris Volume Manager or VxVM disk device groups.

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

1. Become superuser on any node of the cluster.

2. Run the scsetup command.

   The Main Menu is displayed.

   # scsetup

   
   

3. To work with disk device groups, type 4 (Device groups and volumes).

   The Device Groups Menu is displayed.

4. To change key properties of a device group, type 6 (Change key properties of a VxVM or Solstice DiskSuite/Solaris Volume Manager device group).

   The Change Key Properties Menu is displayed

5. To change a device group property, type 1 (Change the preferenced and/or failback properties).

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

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

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

   # scconf -p

   
   

Example--Changing Disk Device Group Properties

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

# scconf -c -D name=dg-schost-1,nodelist=phys-schost-1:phys-schost-2,\
preferenced=true,failback=enabled,numsecondaries=1

# scconf -p | grep Device
Device group name:                             dg-schost-1
   Device group type:                          SDS
   Device group failback enabled:              yes
   Device group node list:                     phys-schost-1, phys-schost-2
   Device group ordered node list:             yes
   Device group desired number of secondaries: 1
   Device group diskset name:                  dg-schost-1

How to Change the Desired Number of Secondaries for a Device Group

The default number of secondary nodes for a device group is set to one. This setting specifies the number of nodes within a device group that can become primary owner of the group if the primary node fails. The desired number of secondaries value can be set to any integer between one and the number of non-primary provider nodes in the device group.

If the numsecondaries property is changed, secondary nodes are added or removed from the device group if the change causes a mismatch between the actual number of secondaries and the desired number.

This procedure uses scsetup(1M) to set or unset the numsecondaries property for Solstice DiskSuite/Solaris Volume Manager or VxVM disk device groups. Refer to scconf_dg_rawdisk(1M), scconf_dg_sds(1M), scconf_dg_svm(1M), and scconf_dg_vxvm(1M) for information about disk device group options when configuring any device group.

1. Become superuser on any node of the cluster.

2. Run the scsetup utility.

   # scsetup

   
   

   The Main Menu is displayed.

3. To work with disk device groups, type 4 (Device groups and volumes).

   The Device Groups Menu is displayed.

4. To change key properties of a device group, type 6 (Change key properties of a device group).

   The Change Key Properties Menu is displayed.

5. To change the desired number of secondaries, type 2 (Change the numsecondaries property).

   Follow the instructions and type the desired number of secondaries to be configured for the disk device group. After an appropriate value has been entered, the corresponding scconf command is executed, a log is printed, and the user returns to the previous menu.

6. Verify that the disk device group attribute has been changed.

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

   # scconf -p