scconf_dg_rawdisk(1M) (Sun Cluster Reference Manual for Solaris OS)

Sun Cluster Reference Manual for Solaris OS

scconf_dg_rawdisk(1M)

NAME

scconf_dg_rawdisk– add, change or update rawdisk device group configuration

SYNOPSIS

scconf

-a

-D

generic_options

scconf

-a

-D

generic_options

scconf

-c

-D

scconf

-r

-D

device_service_name

DESCRIPTION

The scconf_dg_rawdisk utility adds, changes or updates rawdisk device group configuration

A rawdisk is a disk that is not being used as part of a volume manager volume or metadevice. Rawdisk device groups allow you to define a set of disks within a disk device group. At system boot, by default, a rawdisk device group is created for every Disk ID pseudo driver (DID) device in the configuration. By convention, the rawdisk device group names are assigned at initialization and are derived from the DID names. For every node added to a rawdisk disk device group, the scconf utility verifies that every device in the group is physically ported to the node.

The scconf add (-a) command can be used to create a rawdisk device group with multiple disk devices configured in it. A rawdisk device group is created for every disk device in the cluster at boot time. Before you can add a new rawdisk device group, devices to be used in the new group must be removed from the device group created at boot time. Then a new rawdisk device group can be created containing these devices. This is accomplished by creating a list of these devices in the globaldev option of scconf along with a potential primary node preference list in the nodelist option. If the device group already exists, only new nodes and global devices will be added and nodes or devices which are part of an existing device group will be ignored. If the preferenced suboption is not given at all with an add to create a new device group, then it is, by default, false. However, if the preferenced suboption is specified for the existing device group with a value of true or false, an error is returned. This is done in order to maintain the existing nodelist preference state. If a device group should be mastered by only a particular node then it should be configured with the otheroption set to localonly=true. Only one node can be specified in the nodelist to create a localonly device group.

The scconf change (-c) command is used to change the order of the potential primary node preference, to enable or disable failback, to set the desired nuber of secondarie, and to add more global devices to the device group.

If you want to change the order of node preference list, then all the nodes currently existing in the device group must be specified in the nodelist. In addition, if you are changing the the order of node preference, you must also set the preferenced suboption to true.

If the preferenced suboption is not specified with the change, the already established true or false setting is used.

New nodes cannot be added using the change form of the command. Change option can also be used for changing a device group to localonly device group and vice-versa. To change a device group to a localonly device group, set otheroption to localonly=true. Specify localonly=false to set it back to not the localonly device group. nodelist must already be set to a list of one node, or an error results. It is legal to specify a nodelist with the change form of the command, when you set localonly to true. This is, however, redundant, since the list can only contain the single node that is already configured. It would be an error to specify any other than the node that is already configured.

The scconf remove (-r) command can be used to remove the nodes, global devices, and the device group name from the cluster device group configuration. If nodes or global devices are specified with the device group name, they are removed from the device group first. After the last device and node are removed from the device group, the device group is also removed from cluster configuration. If only the name of the device group is given (no nodes or devices at all), the entire device group is removed.

If a rawdisk device name is registered in a rawdisk device group then it cannot be registered in an Solstice DiskSuite device group or a VERITAS Volume Manager device group.

OPTIONS

See scconf(1M) for the list of supported generic options.

The following action options are used to describe the actions performed by the command. Only one action option is allowed in the command.

The following action options are supported:

-a

Add a new rawdisk device group to the cluster configuration. You can also use this option to change the device group configuration.

-c

Change the ordering of the node preference list, change preference and failback policy, change the desired number of secondaries, and also add more devices to the device group with the globaldev option. It is also used to set a device group as local only.

-r

Remove the rawdisk device group name from the cluster.

The autogen flag is an indicator of the scstat and scconf commands. These two commands do not list devices with the autogen property unless the -v command line option is used. When a device is used with the change form of the scconf command, the device's autogen property is reset, or set to false, unless autogen=true is also specified.

EXAMPLES

Example 1 Using `scconf` Commands

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

phys-host# scconf -a -D type=rawdisk,name=rawdisk_groupname, 
nodelist=host1:host2:host3,preferenced=false,failback=enabled, 
numsecondaries=,globaldev=d1,globaldev=d2

phys-host# scconf -a -D type=rawdisk,name=rawdisk_groupname, 
nodelist=host1,globaldev=d1,globaldev=d2,localonly=true, 
globaldev=d1,globaldev=d2 

phys-host# scconf -c -D name=rawdisk_groupname, 
nodelist=host3:host2:host1,preferenced=true,failback=disabled, 
numsecondaries=2,globaldev=d4,globaldev=d5

phys-host# scconf -c -D name=rawdisk_groupname,localonly=true

phys-host# scconf -r -D name=rawdisk_groupname

phys-host# scconf -r -D name=rawdisk_groupname,nodelist=node1,node2

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Architecture	SPARC
Availability	SUNWcsu