vxdisksetup

NAME

vxdisksetup, vxdiskunsetup - configure a disk for use with VERITAS Volume Manager

SYNOPSIS

DESCRIPTION

The vxdisksetup command configures the disk for use by VERITAS Volume Manager (VxVM). vxdisksetup is called by the vxdiskadd command as part of initial disk configuration. It is not typically necessary to call this command directly.

cdsdisk

The disk is formatted as a CDS disk that is suitable for moving between different operating systems. This is the default format (provided that the -i option is used to write the disk header). It is not suitable for boot disks.

hpdisk

The disk is formatted to include a private region that VxVM uses to store configuration information. Following the private region, the remainder of the disk forms the public region from which subdisks can be allocated. This format can be applied to disks that can be used to boot the system. If the disk is not initialized as a boot disk, space is reserved on the disk to allow it to be converted to cdsdisk format if required.

none

The disk is unformatted.

The vxdiskunsetup command reverses the configuration done by vxdisksetup and makes the specified disks unusable by VxVM. vxdiskunsetup can be applied only to VxVM-initialized disks that are not in use within an imported disk group.

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 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 error state state (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.

• If the -B option is specified, and the disk is not already formatted as an EFI disk, the idisk(1M) utility is called to format the disk as an EFI partitioned disk. The partitioning creates an EFI header in the first 1K block, a 100MB partition (or slice) 1, and partition 2 (the HP-UX partition) on the remainder of the disk. If the vxbootsetup(1M) command is subsequently used to configure the disk as a boot disk, partition 1 is populated with an EFI file system, which contains the boot programs that are needed by an HP IPF system, and the HP-UX partition (partition 2) is set up as a logical simple VxVM disk with the same layout as a non-EFI disk. When vxdisksetup has completed setting up an EFI disk, the resulting disk must be addressed using the s2 suffix to select the logical simple VxVM disk.
• If the -B option is not specified and the target disk is currently formatted as an EFI partitioned disk, any EFI formatting is destroyed, and the disk is initialized as a non-EFI partitioned disk.

OPTIONS

-B

Initializes the VERITAS Volume Manager private region to begin at block number 2144. This block is designated as the private region offset for a VERITAS Volume Manager root disk. Without this option, the private region is initialized to start at the default block number 128.

-C

vxdiskunsetup usually does not 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-configuration of the disk, effectively removing the host locks that were detected by vxdiskunsetup.

-f

Forces a disk to be initialized even if it is a member of a deported disk group.

-F

By default, the vxdiskunsetup command only operates on online disks. It does not operate on disks that are imported or offline. This option forces an unsetup operation to be performed on such disks.

-i

Writes a disk header to the disk, initializes the private region of the disk and makes the disk directly usable (as a new disk in a disk group, for example).

ATTRIBUTES

You can specify attributes to affect the layout strategy used by vxdisksetup.

CAUTION: Take great care when using these attributes as they can render a disk unusable by VxVM.

config

Sets up kernel logs or configuration databases on the disk. This attribute has the opposite effect to the noconfig attribute. This is the default behavior if the -i option is specified. Otherwise, the attribute is ignored.

noconfig

Prevents setting up kernel logs or configuration databases on the disk. The size of the default private region is set to 160 blocks, which is the minimum allowed private region size. noconfig is ignored unless the -i option is specified.

noreserve

Do not reserve space for conversion to other formats such as cdsdisk.

privlen=length

Specifies the length of the private region of the disk. The default size of this area is 1024 blocks. The maximum possible size of the private region is 524288 blocks.

For cdsdisk format disks, privlen is silently rounded up to the nearest multiple of 8KB if it is not already a multiple of 8KB.

privoffset=offset

Indicates the sector offset of the private region on the disk. The default value for the private region offset is block number 128 for non-boot disks and block number 2144 for boot disks.

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.

publen=length

Specifies the length of the public region of the disk. This defaults to the size of the disk minus the private area on the disk.

For cdsdisk format disks, publen is silently rounded up to the nearest multiple of 8KB if it is not already a multiple of 8KB.

puboffset=offset

Sets the offset on the disk where the public region starts. By default, this is past the end of the private region.

For the hpdisk format, 128 blocks of disk space are reserved at the end of the private region unless this is overridden by the value of puboffset or the -B option is specified. 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.

EXAMPLES

To initialize a disk for regular use, enter:

To initialize a disk for normal use, but set the private region size to 2500 KB instead of the default size of 1024 blocks, enter:

Force deconfiguration of a VxVM-initialized disk, c0f4d0:

FILES

/etc/default/vxdisk

Defaults file used by the vxdisk and vxdisksetup utilities.

SEE ALSO

vxcdsconvert (1M), vxdisk (1M), vxdiskadd (1M), vxintro (1M)