Home > Veritas Storage Foundation™ Volume Manager Manual Pages
VXCDSCONVERT (1M) |
|
Maintenance Commands |
Table of contents
vxcdsconvert - make disks and disk groups portable between systems
/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]...
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.
-
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.
-
-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.
-
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:
-
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.
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
-
/etc/default/vxcdsconvert
-
Standard default attribute settings file.
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
512KB to 1MB in release 3.2, and from
1MB to 32MB in release 5.0.
fscdsconv(1M),
fscdstask(1M),
vxassist(1M),
vxdg(1M),
vxdiskadm(1M),
vxinstall(1M),
vxintro(1M),
vxmake(1M),
vxprint(1M)
Last updated: 5 Jan 2005
Copyright ©2009 Symantec Corporation
All rights reserved.