vxcdsconvert

NAME

vxcdsconvert - make disks and disk groups portable between systems

SYNOPSIS

DESCRIPTION

The vxcdsconvert command is used to make a VERITAS Volume Manager (VxVM) disk or disk group portable between different operating systems that are running versions of VxVM with the Cross-platform Data Sharing (CDS) feature. If a disk group is made portable, all the disks within the disk group are also converted.

KEYWORDS

alignment

Converts the alignment of the disk group specified by the -g option to be compatible with CDS.

alldisks

Converts all non-compatible disks within the disk group specified by the -g option to be compatible with CDS. This is equivalent to performing an disk operation on all the disks in the disk group.

disk

Converts the non-compatible disk specified by its disk media name (for example, mydg01) to be compatible with CDS. The disk group must also be specified using the -g option. If the disk is already CDS-compatible, no conversion is performed.

group

Converts the disk group specified by the -g option to be compatible with CDS. This is equivalent to performing an alignment followed by an alldisks operation.

OPTIONS

-A

Analyses and report what conversion is required without performing the conversion.

-d defaults_file

Specifies the pathname of a file that contains additional attribute specifications. These settings override any corresponding values defined in the standard defaults file, /etc/default/vxcdsconvert, and can themselves be overridden by attributes that are specified on the command line.

-g diskgroup

Specifies the disk group on which the conversion is to be performed. This option is mandatory.

-o novolstop

Performs the conversion online without stopping any active volumes. If this requires subdisks to be moved from the disk before conversion starts, these subdisks are moved back to the disk after conversion is complete.

ATTRIBUTES

evac_disk_list=dm1[,dm2]...

Specifies an ordered, comma-separated, list of disk media names that are to be used when evacuating subdisks. Each disk must exist in the disk group specified by the -g option to be considered. If a disk is not a member of the specified disk group, it is ignored. This attribute is only meaningful if the value of evac_subdisks_ok is set to yes. The default behavior is to use any disk in the disk group giving preference to CDS-compatible disks and disks with the most free space.

evac_subdisks_ok={yes|no}

Indicates whether subdisks can be evacuated to a different disk to make the public region conform to CDS restrictions. If the values of evac_subdisks_ok and move_subdisks_ok are both set to yes, preference is given to moving subdisks. The default value is no.

min_split_size=minsize}

Indicates the minimum size into which a subdisk may be split. For subdisks that are part of a striped or RAID-5 layout, this value is rounded up to the next integral multiple of the stripe width unit. The value of this attribute is only meaningful if the value of split_subdisks_ok is not set to no. The default value is 64k (64KB).

move_subdisks_ok={yes|no}

Indicates whether subdisks can be moved to a different location on the same disk to allow the public (or private) region to conform to CDS restrictions. The default value is yes.

split_subdisks_ok={yes|move|evac|no}

Indicates whether subdisks can be split before moving or evacuating the subdisk. This allows portions of subdisks to be moved or evacuated. Otherwise, only entire subdisks can be moved or evacuated. The value yes allows subdisks to be moved or evacuated. The values move and evac allow subdisks only to be moved or evacuated respectively after being split. The default value is move.

privlen=privsize

Specifies the size of the private region that should exist after converting a disk to be CDS-compatible. The specified value must be an integral multiple of 8k (8KB), and greater than 512k (512KB). The default size of the private region is 2m (2MB). This is overridden by the value specified in the /etc/default/vxdisk file. However, if the disk already has a private region which is larger than either of these values, the size of the existing private region is preserved as a minimum value. The value selected is rounded up to the nearest integral multiple of 8KB.

Note the following restriction on entries in a defaults file:

• A line that is empty or that begins with a # character in the first column is treated as a comment and ignored.
• All non-comment lines must contain a single attribute definition.
• The name of each attribute must start in the first column.
• No white space is allowed in an attribute definition.
• The final character of each value must be the last character on the line.

The command exits with an error if there is a syntax error in a defaults file.

EXAMPLES

Check if the disk group, mydg, and all its disks can be made portable:

Make the disk group, mydg, and all its disks portable while its volumes are still online:

Make the disk group, anodg, and all its disks portable while its volumes are still online, and allow subdisks to be evacuated to disks anodg11 through anodg14 if required:

You can avoid using the -o novolstop option during disk conversion if you first stop all applications that are using volumes on the disks that are to be converted. In the following example, this has already been done for all the volumes in the disk group mydg.

After disk conversion has completed, restart the applications, and enter this command:

FILES

/etc/default/vxcdsconvert

Standard default attribute settings file.

NOTES

This utility cannot be used with EFI disks or with disk groups that contain EFI disks.

Converting a disk group that contains RAID-5 volumes and logs fails if there is insufficient space in the disk group to create an additional temporary RAID-5 log.

SEE ALSO

fscdsconv(1M), fscdstask(1M), vxassist (1M), vxdg (1M), vxdiskadm (1M), vxinstall (1M), vxintro (1M), vxvmconvert (1M), vxmake (1M), vxprint (1M)