lvmmigrate(1M)

NAME

lvmmigrate — prepare root file system for migration from partitions to LVM logical volumes

SYNOPSIS

/usr/sbin/lvmmigrate [-d disk_special_file] [-e file_system ...] [-f] [-i file_system ...] [-n] [-v]

DESCRIPTION

The lvmmigrate command records the configuration information of the current system in the LIF volume of the boot section for use with a subsequent cold-install process. If there is no LIF volume on the disk, lvmmigrate creates it using lifinit(1), then records the information in a LIF file named CUSTOM. A copy of the LIF file is saved as /tmp/LVMMIGRATE.CFG. The information is also written to file /tmp/LVMMIGRATE for reviewing. The install process looks for the LIF file CUSTOM, and if it exists, uses the information found as the configuration defaults for the root volume group and the root file systems. After the install process has completed, a copy of the CUSTOM final configuration can be found on the newly created system in the file /usr/lib/sw/hpux.install/config.local.

All file system entries in the /etc/mnttab and /etc/fstab files are read. lvmmigrate also searches for unmounted file systems and possible character data sections in unused disk areas. The file systems appropriate for the root volume group are marked for migration. The default file systems are: /, /home, /opt, /tmp, /usr, /var, and any file system with a mount path beginning with: /home/, /opt/, /tmp/, /usr/, /var/.

lvmmigrate displays the following information on the standard output: disks and file system names that are marked for migration, disk areas and file systems to be backed up by the user, and instructions for reinstallation.

After executing lvmmigrate, the user must back up the file systems and any raw device section having useful data to tape. The system is then reinstalled on logical volumes using the configuration information recorded by lvmmigrate.

Options

lvmmigrate recognizes the following options:

-d disk_special_file: Use the specified root disk for reinstallation. Without this option, the current root disk (where root file system / is currently located) is assumed and the configuration is recorded in the boot section.
-e file_system ...: Exclude each specified default file system from the root volume group. Note that the / file system cannot be excluded.
-f: Force the recording of configuration information. Information is recorded in a LIF file named CUSTOM in the boot section. Without this option, if there is a file system or LVM record in the boot section, no write is done and a warning message is displayed.
-i file_system ...: Include each specified file system in the root volume group, along with the default file systems.
-n: Perform a "no write" operation for preview purposes. Migration information is displayed on the terminal screen, but is not recorded in the boot section of the disk. The CUSTOM LIF file is not written, but the files /tmp/LVMMIGRATE and /tmp/LVMMIGRATE.CFG are still created.
-v: Display all disks, file systems, and possible raw sections present in the system.

EXAMPLES

Prepare a system for migration to root logical volumes. Create a file in the LIF area that the cold-install can use to read default configuration information. Specify verbose mode. Create files /tmp/LVMMIGRATE and /tmp/LVMMIGRATE.CFG:

lvmmigrate -v 

Display a detailed list of the disks, file systems, and possible raw data sections present in the current system.

lvmmigrate -v -n 

Include file system /mnt in the root volume group for migration and exclude file system /usr/source. Write configuration information in the boot section of disk /dev/dsk/c1t0d0:

lvmmigrate -d /dev/dsk/c1t0d0 -i /mnt -e /usr/source 

WARNINGS

Use of the -f option results in overwriting the contents of the boot section. Before using the -f option be sure to back up all data on the boot section of the disk specified with the -d option.

If there is no LIF volume, lvmmigrate uses lifinit to create it (see lifinit(1)). If file CUSTOM already exists in the LIF volume, lvmmigrate rewrites it.

Caution: All data on disks being used for reinstallation must be backed up to a separate device because the install process overwrites data on all disks used in the new root volume group.

lvmmigrate(1M)

Technical documentation

» Table of Contents