vxencap - encapsulate partitions on a new disk
/etc/vx/bin/vxencap [-F] [-c] [-f format] [-g diskgroup] [-s privlen] [-N]
/etc/vx/bin/vxencap -k -a | accessname
The vxencap script identifies any partitions on the specified disk that could be used for file systems or special areas such as swap devices, and then generates volumes to cover those areas on the disk. This process is known as encapsulation. In the case of partitions that contain file systems, the entries in /etc/fstab will be modified to use the new volume devices.
vxencap is generally called from the vxdiskadm menus or else is called at installation time from the vxinstall script. One (or more) reboots may be necessary to complete the process of encapsulation.
Specifies that all encapsulation requests are to be handled by this command. This option is only used with the -k option.
Creates a disk group if the disk group specified by the -g option does not exist.
Specifies the format for the disk. Two formats are supported:
Specifies that the disk is to be encapsulated with the Cross-platform Data Sharing (CDS) format. This is the default format unless overridden in the /etc/default/vxencap defaults file.
If the cdsdisk format is specified using the -f option, but it is not possible to encapsulate the disk with this format, the encapsulation fails. If the cdsdisk format is not specified on the command line, but it is not possible to encapsulate the disk with this format, the sliced format is used instead.
Note The cylinders covering the first 128KB of the disk must be free and available for use by CDS. One physical partition on the disk must be free and available for use. This format is not suitable for encapsulating root, boot or swap disks.
Specifies that the disk is to be encapsulated with the sliced format. If possible, 256 blocks are reserved at the end of the private region and within the public region to allow for future conversion to cdsdisk format.
Note Two free partitions must be available for use on the disk. This format is suitable for encapsulating root, boot or swap disks.
Forces the encapsulation even if the disk is already in use as a VxVM disk.
Caution: This option can make the data on the disk unusable.
Places the encapsulated disk into the disk group specified by disk group ID or disk group name.
Abandons encapsulation requests. If used with the -a option, all encapsulation requests are halted. Otherwise, specify the disk access name of the disk whose encapsulation is to be abandoned.
Specifies that the changes logged to be made during the next reboot are not committed. Usually any system failure before the reboot causes the operations to be completed on the next reboot. If the -N option is specified, the changes are left uncompleted and the operation aborted should the system fail at any point before the successful configuration change. This is accomplished by not creating the usual /etc/vx/reconfig.d/state.d/reconfig commit file.
Specifies the size of the private region on the encapsulated disk. This overrides the value specified in the defaults file.
The /etc/default/vxencap file can be used to set default values for the vxencap command. Values in this file override inbuilt values.
The following attributes may be specified in the defaults file:
Defines the default format. Supported values are cdsdisk and sliced. This may be overridden on the command line by specifying a format with the -f option.
Defines the default length for the private region. See the ATTRIBUTES section for a full definition. The setting of this attribute is considered for the init operation only. If not specified, the inbuilt default value is 32MB. This may be overridden on the command line by specifying a privlen value with the -s option.
Defines the default value for the offset from the start of the partition that contains the private region to the start of the private region. If not specified, the inbuilt default value is 0.
Defines the offset from the start of the partition that contains the public region to the start of the public region. If not specified, the inbuilt default value is 1 block.
The attributes and their values may be defined in any order in the file, the attribute keyword must start in the first column, and no white-space characters are allowed around the = character. If an attribute is defined multiple times, only the final occurrence in the file is used. Commands silently ignore any definition line that has an invalid format.
The default private region size increased from 1MB to 32MB in release 5.0.
Defaults file used by the vxencap utility.
Veritas Volume Manager Administrator's Guide