Administering Disk Device Groups

The scsetup(1M) utility is an interactive interface to the scconf(1M) command. scsetup generates scconf commands. Generated commands are shown in the examples at the end of some procedures.

Note - Sun Cluster software automatically creates a raw disk device group for each disk and tape device in the cluster. However, cluster device groups remain in an offline state until you access the groups as global devices.

Table 4-2 Task List: Administering Disk Device Groups

How to Update the Global Device Namespace

When adding a new global device, manually update the global device namespace by running scgdevs(1M).

Note - The scgdevs command does not have any effect if the node that is running the command is not currently a cluster member. The command also has no effect if the /global/.devices/node@nodeID file system is not mounted.

1. Become superuser on any node of the cluster.

2. Use the scgdevs command to reconfigure the namespace.

   # scgdevs

   
   

Example--Updating the Global Device Namespace

The following example shows output generated by a successful run of scgdevs.

# scgdevs 
Configuring the /dev/global directory (global devices)...
obtaining access to all attached disks
reservation program successfully exiting

How to Add and Register a Disk Device Group (Solstice DiskSuite/Solaris Volume Manager)

Use the metaset command to create a Solstice DiskSuite/Solaris Volume Manager diskset and register the disk set as a Sun Cluster disk device group. When you register the diskset, the name that you assigned to the diskset is automatically assigned to the disk device group.

1. Become superuser on the node connected to the disks where you want to create the diskset.

2. Calculate the number of metadevice names needed for your configuration, and modify the /kernel/drv/md.conf file on each node.

   See "How to Set the Number of Metadevice Names and Disksets " in the Sun Cluster Software Installation Guide for Solaris OS.

3. Use the metaset(1M)command to add the Solstice DiskSuite/Solaris Volume Manager diskset and register it as a disk device group with Sun Cluster.

   # metaset -s diskset -a -h nodelist

   
   

   -s diskset	Specifies the diskset to be created.
   -a -h nodelist	Adds the list of nodes that can master the diskset.

   ---

   Note - Running the metaset command to set up a Solstice DiskSuite/Solaris Volume Manager device group on a cluster results in one secondary by default, regardless of the number of nodes that are included in that device group. You can change the desired number of secondary nodes by using the scsetup(1M) utility after the device group has been created. Refer to How to Change the Desired Number of Secondaries for a Device Group for more information about disk failover.

   ---

4. Verify that the disk device group has been added.

   The disk device group name matches the diskset name that is specified with metaset.

   # scconf -p | grep disk-device-group

   
   

Example--Adding a Solstice DiskSuite/Solaris Volume Manager Disk Device Group

The following example shows the creation of the diskset and disk device group and verifies that the disk device group has been created.

# metaset -s dg-schost-1 -a -h phys-schost-1
# scconf -p | grep dg-schost-1
Device group name: dg-schost-1

How to Remove and Unregister a Disk Device Group (Solstice DiskSuite/Solaris Volume Manager)

Disk device groups are Solstice DiskSuite/Solaris Volume Manager disksets that have been registered with Sun Cluster. To remove a Solstice DiskSuite/Solaris Volume Manager disk device group, use the metaclear and metaset commands. These commands remove the disk device group with the same name and unregister the disk group as a Sun Cluster disk device group.

Refer to the Solstice DiskSuite/Solaris Volume Manager documentation for the steps to remove a diskset.

How to Remove a Node From All Disk Device Groups

Use this procedure to remove a cluster node from all disk device groups that list the node in their lists of potential primaries.

1. Become superuser on the node you want to remove as a potential primary of all disk device groups.

2. Determine the disk device group(s) of which the node to be removed is a member.

   Look for the node name in the Device group node list for each disk device group.

   # scconf -p | grep ¨Device group"

   
   

3. Are any of the disk device groups identified in Step 2 of the device group type SDS/SVM?

   • If yes, perform the procedures in How to Remove a Node From a Disk Device Group (Solstice DiskSuite/Solaris Volume Manager).

   • If no, go to Step 4.

4. Are any of the disk device groups identified in Step 2 of the device group type VxVM?

   • If yes, perform the procedures in SPARC: How to Remove a Node From a Disk Device Group (VERITAS Volume Manager).

   • If no, go to Step 5.

5. Determine the raw disk device groups of which the node to be removed is a member.

   Note that the following command contains two "v"s in -pvv. The second "v" is needed to display raw disk device groups.

   # scconf -pvv | grep ¨Device group¨

   
   

6. Are any of the disk device groups listed in Step 5 of the device group types Disk, Local_Disk, or both?

   • If yes, perform the procedures in SPARC: How to Remove a Node From a Raw Disk Device Group.

   • If no, go to Step 7.

7. Verify that the node has been removed from the potential primaries list of all disk device groups.

   The command returns nothing if the node is no longer listed as a potential primary of any disk device group.

   # scconf -pvv | grep ¨Device group¨ | grep nodename