SPARC: Example--Registering VERITAS Volume Manager Disk Group Configuration Changes

The following example shows the scconf command generated by scsetup when registering a changed VxVM disk device group (dg1). This example assumes that the VxVM disk group and volume were created previously.

# scsetup scconf -c -D name=dg1,sync

SPARC: How to Set the Desired Number of Secondaries (VERITAS Volume Manager)

The numsecondaries property specifies the number of nodes within a device group that can master the group if the primary node fails. The default number of secondaries for device services is one. The value can be set to any integer between one and the number of operational non-primary provider nodes in the device group.

This setting is an important factor in balancing cluster performance and availability. For example, increasing the desired number of secondaries increases the device group's opportunity to survive multiple failures that occur simultaneously within a cluster. Increasing the number of secondaries also decreases performance regularly during normal operation. A smaller number of secondaries typically results in better performance, but reduces availability. However, a larger number of secondaries does not always result in greater availability of the file system or device group in question. Refer to "Key Concepts for Administration and Application Development" in Sun Cluster Concepts Guide for Solaris OS for more information.

1. Become superuser on any node of the cluster.

2. Run the scsetup(1M) utility.

   # scsetup

   
   

   The Main Menu is displayed.

3. To work with VxVM 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 typed, the corresponding scconf command is executed. Following, a log is printed, and the user is returned to the previous menu.

6. Validate the device group configuration by using the scconf -p command.

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

   
   

   ---

   Note - If you change any configuration information for a VxVM disk group or volume that is registered with the cluster, you must reregister the disk device group by using scsetup. Such configuration changes include adding or removing volumes, as well as changing the group, owner, or permissions of existing volumes. Reregistration after configuration changes ensures that the global namespace is in the correct state. See How to Update the Global Device Namespace.

   ---

7. Verify the primary node and status for the disk device group.

   # scstat -D

   
   

SPARC: Example--Setting the Desired Number of Secondaries (VERITAS Volume Manager)

The following example shows the scconf command that is generated by scsetup when it configures the desired number of secondaries for a device group (diskgrp1). See How to Change the Desired Number of Secondaries for a Device Group for information about changing the desired number of secondaries after a device group is created.

# scconf -a -D type=vxvm,name=diskgrp1, nodelist=host1:host2:host3,preferenced=true, \ failback=enabled,numsecondaries=2

SPARC: How to Remove a Volume From a Disk Device Group (VERITAS Volume Manager)

Note - After removing the volume from the disk device group, you must register the configuration changes to the disk device group using the procedure SPARC: How to Register Disk Group Configuration Changes (VERITAS Volume Manager).

1. Become superuser on any node of the cluster.

2. Determine the primary node and status for the disk device group.

   # scstat -D

   
   

3. If the disk device group is offline, bring it online.

   # scswitch -z -D disk-device-group -h node[,...]

   
   

   -z	Performs the switch.
   -D disk-device-group	Specifies the device group to switch.
   -h node	Specifies the name of the node to switch to. This node becomes the new primary.

4. From the primary node (the node currently mastering the disk device group), remove the VxVM volume in the disk group.

   # vxedit -g diskgroup -rf rm volume

   
   

   -g diskgroup	Specifies the VxVM disk group containing the volume.
   -rf rm volume	Removes the specified volume.

5. Register the disk device group configuration changes to update the global namespace, using scsetup(1M).

   See SPARC: How to Register Disk Group Configuration Changes (VERITAS Volume Manager).

SPARC: How to Remove and Unregister a Disk Device Group (VERITAS Volume Manager)

Removing a Sun Cluster disk device group will cause the corresponding VxVM disk group to be deported, not destroyed. However, even though the VxVM disk group still exists, it cannot be used in the cluster unless re-registered.

This procedure uses the scsetup(1M) utility to remove a VxVM disk group and unregister it as a Sun Cluster disk device group.

1. Become superuser on any node of the cluster.

2. Take the disk device group offline.

   # scswitch -F -D disk-device-group

   
   

   -F	Places the disk device group offline.
   -D disk-device-group	Specifies the device group to take offline.

3. Enter the scsetup utility.

   The Main Menu is displayed.

   # scsetup

   
   

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

   The Device Groups Menu is displayed.

5. To unregister a VxVM disk group, type 3 (Unregister a VxVM device group).

   Follow the instructions and enter the VxVM disk group to be unregistered.

SPARC: Example--Removing and Unregistering a VERITAS Volume Manager Disk Device Group

The following example shows the VxVM disk device group dg1 taken offline, and the scconf command generated by scsetup when it removes and unregisters the disk device group.

# scswitch -F -D dg1
# scsetup

   scconf -r -D name=dg1