vxcdsconvert(1M)														  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 fol-
		 lowed 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 speci-
		 fied.	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:	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,  conver-
		 sion  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  con-
		 form 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 addi-
       tional 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.

SEE ALSO

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

VxVM 5.0.31.1							    24 Mar 2008 						  vxcdsconvert(1M)