LVM Migration from Legacy to Agile Naming Model
Appendix : Using vgdsf
NAME
vgdsf – Script to migrate a LVM volume group from legacy to agile naming model.
SYNOPSIS
/usr/contrib/bin/vgdsf {-a | -d | -c} vg_name
DESCRIPTION
Migrate the volume group from legacy to the persistent DSF naming model.
The volume group vg_name should be active and can be in use during the migration operation. All legacy DSFs
in the volume group vg_name, will be replaced by their corresponding persistent DSFs. This script is aware of
physical volume groups (PVG) and maintains the same PVG configuration even after the migration. Both
/etc/lvmtab and /etc/lvmpvg configuration files are automatically updated. An automatic backup of the volume
group is performed after the migration is complete.
OPTIONS AND ARGUMENTS
vgdsf recognizes the following options and arguments:
-a For each of the legacy DSF configured in the volume group vg_name, a corresponding persistent
DSF will be added to the configuration, as an alternate link. Legacy DSFs continue to remain
configured as is. If a physical volume has more than seven alternate links, one of them will be
removed to make room for its corresponding persistent DSF. This option should precede the
invocation of –d option.
-d All legacy DSFs configured in the volume group vg_name are removed if their corresponding
persistent DSFs are also found configured. Legacy DSFs in the volume group without
corresponding persistent DSFs are not removed. This option should follow the invocation of –a
option.
-c Do a complete migration of the volume group from legacy to agile naming model. The
functionality is equivalent to the invocation of vgdsf –a followed by vgdsf –d.
vg_name volume group to be migrated.
NOTE
Use of –a and –d options is generally not required.
EXAMPLES
Migrate volume group vg_name, configured using legacy DSFs, to persistent DSFs.
/usr/contrib/bin/vgdsf –c /dev/vg_name
An equivalent of the above can also be achieved as below:
/usr/contrib/bin/vgdsf –a /dev/vg_name
16