scconf_dg_vxvm(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | ATTRIBUTES | SEE ALSO

NAME

scconf_dg_vxvm– add, change, or update VxVM device group configuration.

SYNOPSIS

scconf -a -D type=vxvm,devicegroup-options
scconf -c -D devicegroup-options [,sync]
scconf -r -D name=devicegroupname

DESCRIPTION

The scconf_dg_vxvm(1M) command is used to add, change, and remove the VERITAS Volume Manager (VxVM) disk device groups to the Sun Cluster device-groups configuration.

The add (-a) option adds a new VxVM disk device group to the Sun Cluster device-groups configuration. With this option you define a name for the new device group, specify the nodes on which this group can be accessed, and specify a set of properties used to control actions.

For VxVM disk device groups, you can only assign one VxVM disk group to a disk device group, and the disk device group name must always match the name of the VxVM disk group. You cannot create a VxVM disk device group unless you first import the corresponding VxVM disk group on one of the nodes in that device's nodelist.

Before you can add a node to a VxVM disk device group, every physical disk in the disk group must be physically ported to that node. After you register the disk group as a VxVM disk device group, you must first deport the disk group from the current node owner and turn off the auto-import flag for the disk group.

To create a VxVM disk device group for a disk group, you must run the scconf(1M) command from the same node where the disk group was created.

The scconf change (-c) command changes the order of the potential primary node preference, to enable or disable failback, to add more global devices to the device group, and to change the desired number of secondaries.

To change the order-of-node preference list from false to true, you must specify in thenodelist all the nodes that currently exist in the device group. You must also set the preferenced suboption to true.

If you do not specify the preferenced suboption with the change form of the command, the already established true or false setting is used.

The sync option is used to synchronize the clustering software with VxVM disk-group volume information. The sync option is only valid with the change form of the command. Use the sync option whenever you add or remove a volume from a device group.

The remove (-r) option removes a VxVM device group from the Sun Cluster device-groups configuration. You can also use this form of command to remove the nodes from the VxVM disk device group configuration.

OPTIONS

See the scconf(1M) man page for the list of supported generic device-group options.

The following action options describe the actions that the command performs. Only one action option is allowed in the command.

The following action options are supported:

-a

Add a VxVM device group to the cluster configuration.

-c

Change the ordering of the node preference list, change preference and failback policy, and change the desired number of secondaries.

-r

Remove the specified VxVM device group from the cluster.

EXAMPLES

---

Example 1 Using scconf Commands




The following scconf commands create a VxVM device group, change the order of the potential primary nodes, change the preference and failback policy for the device group, change the desired number of secondaries, and remove the VxVM device group from the cluster configuration.

host1# scconf -a -D type=vxvm,name=diskgrp1, nodelist=host1:host2:host3,preferenced=false,failback=enabled host1# scconf -c -D name=diskgrp1, nodelist=host2:host1:host3,preferenced=true,failback=disabled, numsecondaries=2 host1# scconf -r -D name=diskgrp1,nodelist=node1

---

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Architecture	SPARC
Availability	SUNWcsu
Interface Stability	Evolving

SEE ALSO

scconf(1M), attributes(5)

Sun Cluster 3.1  Last Revised 17 Aug 2004

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | ATTRIBUTES | SEE ALSO