 |
Index for Section 8 |
|
 |
Alphabetical listing for V |
|
vollvmencap(8)
NAME
vollvmencap, vol-lvm-reconfig - Encapsulate LVM volume groups
SYNOPSIS
/usr/sbin/vollvmencap [-g diskgroup] [-pvolprefix] { lvmvgname }
/usr/sbin/vollvmencap -k [lvmvgname|-a]
/sbin/vol-lvm-reconfig
OPTIONS
-g diskgroup
Place the encapsulated LVM volume group into the disk group specified
by disk group name. The disk group specified should be an existing disk
group.
-p volprefix
This option tells the command to use the volprefix specified as the
prefix for LSM volume names. This is useful if the LSM volume names
chosen by vollvmencap already exists. Also, LSM volume names are
limited to 14 characters and this option can be used to create smaller
LSM volume names.
-k This option tells the command to remove any previous encapsulation
command for the given LVM volume group name. If the -a option was
given, encapsulation commands for all LVM Volume Groups that have been
generated up until now are removed.
DESCRIPTION
Digital is retiring the Logical Volume Manager (LVM) in the Version 4.0
release of Digital UNIX. For information about the replacement disk storage
management product, called the Logical Storage Manager (LSM), please refer
to the Logical Storage Manager guide.
The encapsulation process adds LVM physical volumes and LVM logical volumes
in a LVM volume group specified by lvmvgname to a LSM disk group. Each LVM
volume is mapped to a LSM volume in the target disk group. vollvmencap
generates the necessary LSM commands to convert all LVM volumes to LSM
volumes. In the case of LVM volumes that contain file systems, the entries
in /etc/fstab are modified to use the new LSM volume special device files.
You execute the command scripts created by vollvmencap by running the vol-
lvm-reconfig script. This script needs to be run manually after all LVM
volume groups have been encapsulated using vollvmencap. Before executing
/sbin/vol-lvm-reconfig, the LVM volume group must be disabled (that is,
file systems unmounted). Refer to the vgchange(8) reference page for
information on disabling a volume group.
The vollvmencap utility creates an "undo" script for each LVM volume group,
and stores the script in /etc/reconfig.d/lvm.d/lvmvgname/lvm_undo.sh.
After successfully encapsulating LVM volumes to LSM volumes, execute the
undo script to remove the LVM volume group.
Refer to the Logical Storage Manager guide for more information about the
encapsulation process.
EXAMPLES
The following example shows the main steps in the encapsulation process for
a volume group named vg1.
1. To encapsulate all volumes in the volume group vg1, enter:
# /usr/sbin/vollvmencap /dev/vg1
2. To execute the scripts created by vollvmencap, enter:
# /sbin/vol-lvm-reconfig
3. Verify the LSM configuration that is created. Then execute the LVM
undo script:
# /etc/vol/reconfig.d/lvm.d/vg1/lvm_undo.sh
FILES
/etc/vol/reconfig.d/lvm.d/lvmvgname/lvm_undo.sh
A script generated by vollvmencap that is used for removing an LVM
volume group after its volumes have been encapsulated.
SEE ALSO
Commands: vgchange(8), volintro(8)
Guides: Logical Storage Manager