3.3.10 How to Register a Disk Group as a Disk Device Group (VERITAS Volume Manager)

This procedure uses the scsetup(1M) utility to register the associated VxVM disk group as a Sun Cluster disk device group.

Once a disk device group has been registered with the cluster, never import or deport a VxVM disk group using VxVM commands. If you make a change to the VxVM disk group or volume, use the procedure "3.3.11 How to Register Disk Group Configuration Changes (VERITAS Volume Manager)" to register the disk device group configuration changes. This will ensure that the global namespace is in the correct state.

The prerequisites to register a VxVM disk device group are:

• Superuser privilege on a node in the cluster.

• The name of the VxVM disk group to be registered as a disk device group.

• A preferred order of nodes to master the disk device group.

When you define the preference order, you also specify whether you want the disk device group to be switched back to the most preferred node in the event that the most preferred node goes down and later returns to the cluster.

See scconf(1M) for more information on node preference and failback options.

1. Become superuser on any node of the cluster.

2. Enter the scsetup 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 register a VxVM disk device group, type 1 (Register a VxVM disk group as a device group).

   Follow the instructions and enter the name of the VxVM disk group to be registered as a Sun Cluster disk device group.

5. If you encounter the following error while attempting to register the disk device group, reminor the disk device group.

   scconf: Failed to add device group - in use

   To reminor the disk device group, use the procedure "3.3.9 How to Assign a New Minor Number to a Disk Device Group (VERITAS Volume Manager)". This procedure enables you to assign a new minor number that does not conflict with a minor number used by an existing disk device group.

6. Verify that the disk device group is registered and online.

   If the disk device group is properly registered, information for the new disk device group displays when using the following command.

   # scstat -D

   ---

   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 "3.3.1 How to Update the Global Device Namespace".

   ---

3.3.10.1 Example--Registering a VERITAS Volume Manager Disk Device Group

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

# scsetup

scconf -a -D type=vxvm,name=dg1,nodelist=phys-schost-1:phys-schost-2

# scstat -D
-- Device Group Servers --
                         Device Group      Primary           Secondary
                         ------------      -------           ---------
Device group servers:    dg1              phys-schost-1      phys-schost-2
 
-- Device Group Status --
                              Device Group        Status              
                              ------------        ------              
  Device group status:        dg1                 Online

3.3.10.2 Where to Go From Here

To create a cluster file system on the VxVM disk device group, see "3.4.1 How to Add a Cluster File System".

If there are problems with the minor number, see "3.3.9 How to Assign a New Minor Number to a Disk Device Group (VERITAS Volume Manager)".