Home > Veritas Storage Foundation™ Volume Manager Manual Pages
VXDISKSETUP (1M) |
Maintenance Commands |
/etc/vx/bin/vxdisksetup [-if] disk_address format=cdsdisk [attribute...]
/etc/vx/bin/vxdisksetup [-if] disk_address format=simple [attribute...]
/etc/vx/bin/vxdisksetup [-ief] disk_address format=sliced [attribute...]
/etc/vx/bin/vxdiskunsetup [-C] disk_address...
Note: In release 4.0 of VxVM, the behavior of the vxdisksetup command has been changed so that it only creates auto-configured disks (with a disk access type of auto; see vxdisk(1M)), which can have one of the following formats:
Slice 7 is created to hold the private and public regions with all other slices (apart from slice 2) zeroed out. The private region is used by VxVM to store configuration information, and is followed by a public region from which subdisks can be allocated.
Note: As the CDS format is applied to the entire disk and is unsuitable for boot disks, options and attributes that relate to partitions, slices or booting are not applicable. The CDS format is also incompatible with EFI disks.
For an EFI disk, slice 2 does not refer to the whole disk.
Note: This value may be displayed, but it cannot be set as a valid format.
The sliced format is the default for EFI disks.
The disk_address argument passed to vxdisksetup or to vxdiskunsetup directs the command to the device that corresponds to the disk being operated upon. The address should be provided in the form c#t#d#, which define a controller number (c#), a SCSI target ID (t#), and a SCSI logical unit number (d#). Each number is specified in decimal and can be multiple digits. If the disks are named using the enclosure based naming scheme, the address usually takes the form enclosurename_diskno. The name must reference a valid disk with partition devices under the /dev/vx/rdmp directory.
The vxdiskunsetup command operates by removing the public and private regions that were created by the last invocation of vxdisksetup on the specified disks. After this operation, those disks are converted from the online to the online invalid (as displayed by vxdisk list).
The /etc/default/vxdisk file can be used to set the default values of the format and privlen attributes for the vxdisk and vxdisksetup commands. Values in this file override inbuilt values, and may themselves be overridden by values specified on the command line. For details, see the vxdisk(1M) manual page.
Note: This option is not supported for cdsdisk and simple format disks.
Note: A disk that is a member of an imported disk group cannot be initialized. The command also fails if the disk is a member of a deported disk group. The -f option can be used to override the latter restriction.
CAUTION: Take great care when using these attributes as they can render a disk unusable by VxVM.
All lengths and offsets are rounded up to cylinder boundaries due to restrictions on the layout of partitions.
If the -i option is not specified for a sliced format disk, an additional 256 blocks are also reserved. If the -i option is specified, the value of privlen is set to the size of slice 3 minus 256 blocks and minus the value of the private region offset. The reserved space allows for later conversion to the cdsdisk format.
For cdsdisk format disks, privlen is silently rounded up to the nearest multiple of 8KB if it is not already a multiple of 8KB.
An additional 256 blocks of disk space (rounded up to the nearest cylinder boundary) are reserved at the beginning of slice 3 unless this is overridden by the value of privoffset. The reserved space allows for later conversion to the cdsdisk format.
For the simple format, the specified value of privoffset is also rounded up to the nearest cylinder boundary.
For cdsdisk format disks, privoffset is silently rounded up to the nearest multiple of 8KB that is larger than or equal to 128KB if it is not already a multiple of 8KB or if its value is less than 128KB.
For cdsdisk format disks, publen is silently rounded up to the nearest multiple of 8KB if it is not already a multiple of 8KB.
For the sliced format, 256 blocks of disk space (rounded up to the nearest cylinder boundary) are reserved at the beginning of slice 4 unless this is overridden by the value of puboffset. The reserved space allows for later conversion to the cdsdisk format.
For the simple format, 256 blocks of disk space are reserved at the end of the private region unless this is overridden by the value of puboffset. The reserved space allows for later conversion to the cdsdisk format.
For cdsdisk format disks, puboffset is silently rounded up to the nearest multiple of 8KB if it is not already a multiple of 8KB.
/etc/vx/bin/vxdisksetup -i c2t1d0
or if enclosure-based naming is in use:
/etc/vx/bin/vxdisksetup -i sena1_4
To initialize a disk for normal use, but set the private region size to 1MB instead of the default size of 32MB, enter:
/etc/vx/bin/vxdisksetup -i c2t1d0 privlen=1m
Force deconfiguration of a VxVM-initialized disk, c0f4d0:
/etc/vx/bin/vxdiskunsetup -C c0t4d0
Last updated: 31 Aug 2008
Copyright ©2009 Symantec Corporation
All rights reserved.