test veritas logo


vxcdsconvert(1M)

NAME

vxcdsconvert - make disks and disk groups portable between systems

SYNOPSIS

/etc/vx/bin/vxcdsconvert -g diskgroup [-A] [-d defaults_file] [-o novolstop] alignment [attribute=value]...

vxcdsconvert -g diskgroup [-A] [-d defaults_file] [-o novolstop] alldisks [attribute=value]...

vxcdsconvert -g diskgroup [-A] [-d defaults_file] [-o novolstop] disk name [attribute=value]...

vxcdsconvert -g diskgroup [-A] [-d defaults_file] [-o novolstop] group [attribute=value]...

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.
Note: Depending on the layout of the subdisks on the disk, conversion may take significantly longer when this option is specified. If you first stop the applications that are accessing the volumes, you can avoid having to use this option.
Note: This option must be specified for DOS labeled disks.

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.
Note: If a subdisk is located in a reserved area for a CDS disk (such as the first 128KB of the disk) or that would overlap the private region, and there is either no room to move the subdisk elsewhere on the disk or move_subdisks_ok is set to no, conversion cannot succeed unless evac_subdisks_ok is set to yes. (This is true irrespective of whether or not the -o novolstop option is specified.)
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 32m (32MB). 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:

o A line that is empty or that begins with a # character in the first column is treated as a comment and ignored.
o All non-comment lines must contain a single attribute definition.
o The name of each attribute must start in the first column.
o No white space is allowed in an attribute definition.
o 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:

vxcdsconvert -g mydg -A group

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


vxcdsconvert -g mydg -o novolstop group

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:


vxcdsconvert -g anodg -o novolstop group \ move_subdisks_ok=yes evac_subdisks_ok=yes \ evac_disk_list=anodg11,anodg12,anodg13,anodg14

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.


vxcdsconvert -g mydg alldisks

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


vxcdsconvert -g mydg group

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.

The default private region size increased from 1MB to 32MB in release 5.0.

SEE ALSO

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


VxVM 7.3.1 vxcdsconvert(1M)