Manualshelf

vgversion.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages
123456
v
vgversion(1M) vgversion(1M)
NAME
vgversion - handles volume group version migration of an existing LVM volume group
SYNOPSIS
/usr/sbin/vgversion
[-U unshare_unit ][-r
][-v] -V vg_version_new vg_name
Remarks
The original version of LVM volume group is version 1.0 which is supported on all HP-UX 11i releases.
LVM volume group version 2.0 was introduced in the HP-UX 11i v3 March 2008 update and is available
for all updates on HP 11i v3 going forward. Versions 2.0 or higher volume groups allow LVM to increase
many of the limits constraining the size of volume groups, logical volumes, and so on.
When constrained with the limits of the current configuration on version 1.0 volume group, the
vgmo-
dify command can be used to extend a few of the version 1.0 volume group configuration limits.
For the HP-UX 11i v3 March 2009 Update and forward, a new command,
vgversion, is provided to
take advantage of the improvements in volume group version 2.0 or higher. The
vgversion command
allows in-place volume group migration from 1.0 to 2.0 or higher. The
vgversion command also sup-
ports migration of a volume group from any version 2.x to any other version 2.y.
Note that the
-U option can be used only for converting to volume group version 2.2 and higher.
DESCRIPTION
The
vgversion command allows users to review and migrate the volume group version vg_version_old
of an existing volume group vg_name to the new volume group version vg_version_new.
Options and Arguments
-r Review mode. Review the effect of migrating the existing volume group to volume group ver-
sion vg_version_new but do not do the actual migration.
When run in this mode, no updates to
/etc/lvmtab or /etc/lvmtab_p
happens, nor the
volume group configuration files of the existing volume group present under
/etc/lvmconf
or under the configured path are modified. This option can be used on an active volume group.
-U unshare_unit
Only applicable when converting to volume group 2.2 and higher. Sets the unit at which data
will be unshared between a logical volume and its snapshots. See lvm(7) for information about
LVM snapshots. unshare_unit is expressed in units of kilobytes (KB) and the supported values
are 512, 1024, 2048, and 4096.
This is an optional parameter and if it is not specified, the default value of 1024 KB is
assumed. The unshare unit cannot be greater than the physical extent size of the volume
group.
-v Verbose mode. Be verbose in reporting.
-V vg_version_new
Specify the volume group version to which the existing volume group has to be migrated. The
vg_version_new should be in the format 2.x (where x starts from 0 and beyond).
vg_name The path name of a volume group to be migrated.
Supported Volume Group Migration
The
vgversion command allows the migration between any two supported volume group versions with
the exception of moving back to version 1.0.
The following steps list the typical usage scenario of the
vgversion command while migrating a volume
group vg_name to the volume group version vg_version_new:
1) Use the
-r option with the vgversion command, to review if vg_name can be migrated to volume
group version vg_version_new.
If required by the above step, prepare vg_name for actual migration by :
• Modifying the LVM configuration characteristics of vg_name , if it is found to be not supported by
the volume group version vg_version_new.
• Creating required space to accommodate vg_version_new’s metadata using either
pvmove or
increasing the LUN size.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (6 pages)