vxdisksetup(ADM)

vxdisksetup - set up a disk for use with the Volume Manager

Synopsis

/etc/vx/bin/vxdisksetup [ -nie ] diskaddress [ attribute...]
/etc/vx/bin/vxdiskunsetup [ -C ] diskaddress ...

Description

The vxdisksetup command is normally called by the vxdiskadd command as part of initial disk configuration. It should not normally be necessary to call this command directly. The vxdisksetup command configures the disk for use by the Volume Manager. vxdisksetup will create two partitions on the specified disk, a Volume Manager private configuration region (called the private region partition), and a partition used for allocating subdisks (called the public region partition). These two partitions have tags that identify them as appropriate to the Volume Manager.

The vxdiskunsetup command undoes the configuration setup by vxdisksetup and makes the specified disks unusable by the Volume Manager. It can be applied only to disks that are not in active use within an imported disk group.

The diskaddress argument passed to vxdisksetup or vxdiskunsetup directs the command to the disk being operated upon. The address should be provided in the form c#b#t#d#, which define a controller number (c#), a bus ID (b#), a SCSI target ID (t#), and a SCSI logical unit number (d#, normally 0). Each number is specified in decimal and can be multiple digits. The name must reference a valid disk with partition devices under the /dev/rdsk directory.

Options

-n: Skip surface analysis of the disk. Surface analysis is normally performed by default on systems where this is applicable. vxdisksetup).
-i: Normally, vxdisksetup simply creates partitions for use with the Volume Manager. If -i is specified, then a disk header will be written to the disk, making the disk directly usable (as a new disk in a disk group, for example).
-e: If the -e option is specified (this can also be specified as the attribute privoffset=-0, then the private region partition is allocated at the end of the disk, and the public region partition is (by default) allocated at the beginning, with an overlap of the VTOC.

Attributes can be specified to affect the layout strategy used by vxdisksetup. Attributes that can be specified are:

publen=length: This attribute represents the length of the public region partition of the disk. This defaults to the size of the disk minus the private area on the disk.
privlen=length: This attribute represents the length of the private region partition of the disk. The default for this area is 1024 sectors.
puboffset=offset: This attribute sets the offset on the disk where the public region partition will start. This defaults to the end of the private region partition, unless the private region partition is moved from the beginning of the disk, in which case the public region offset defaults to following the private region partition.
privoffset=[-]offset: This attribute indicates the sector offset of the private area on the disk. The default offset for the private area is at the beginning of the disk. The -e option can be used to relocate the private region to the end of the disk. A negative offset can be specified to relocate the private region at an offset relative to the end of the disk.
noconfig: This attribute causes no kernel logs or configuration databases to be set up on the disk. The size of the default private region partition will be adjusted to be 80 blocks, which is the minimum allowed private region size. This attribute is ignored unless the -i option is supplied on the command line.
config: This attribute is the converse of the noconfig attribute and is the default. This attribute is ignored unless the -i option is supplied on the command line.

The vxdiskunsetup command operates by removing the partitions that were created by the last invocation of vxdisksetup on the given disks. After this operation, those disks will be converted from the online to the error state (as displayed by vxdisk list). The command refuses to operate on disks that are active members of an imported disk group.

Normally, vxdiskunsetup also refuses to operate on disks that appear to be imported by some other host (for example, a host that shares access to the disk). In this case, the -C option can be specified to force de-partioning of the disk, effectively removing the host locks that were detected by vxdiskunsetup.

References

vxdisk(ADM), vxdiskadd(ADM), vxintro(ADM)