Click this button to go to the index for this section.

vollvmencap(8)
NAME
  vollvmencap, vol-lvm-reconfig - Encapsulate LVM volume groups

SYNOPSIS
  /usr/sbin/vollvmencap [ -g diskgroup ] [ -p volprefix ] { lvmvgname }

  /usr/sbin/vollvmencap -k [ lvmvgname | -a ]

  /sbin/vol-lvm-reconfig

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.

FLAGS
  -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.

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.

RELATED INFORMATION
  Commands: vgchange(8), volintro(8)

  Guides: Logical Storage Manager