Previous  |  Next  >  
Product: Volume Manager Manual Pages for Storage Foundation   
Manual: Maintenance Commands (1m)   

vxcdsconvert

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   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.

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   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 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:


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.

SEE ALSO

fscdsconv(1M), fscdstask(1M), vxassist (1M), vxdg (1M), vxdiskadm (1M), vxinstall (1M), vxintro (1M), vxvmconvert (1M), vxmake (1M), vxprint (1M)
 ^ Return to Top Previous  |  Next  >  
Product: Volume Manager Manual Pages for Storage Foundation  
Manual: Maintenance Commands (1m)  
VERITAS Software Corporation
www.veritas.com