NAME

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

SYNOPSIS

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

DESCRIPTION

lvmmigrate records the configuration information of the current system in the LIF volume of the boot section (6) for use with the install command (see install(1M)). If there is no LIF volume on the disk, lvmmigrate creates it using lifinit(1), then records the information in a LIF file named LVMMIGRATE.  The information is also written to file /tmp/LVMMIGRATE for reviewing.  install looks the for the LIF file LVMMIGRATE, and if it exists, uses the information found as the configuration defaults for the root volume group and the root file systems.  After install has completed, a copy of the LVMMIGRATE file can be found on the newly created system in the file /local/LVMMIGRATE. 

All file system entries in the /etc/mnttab and /etc/checklist files are read.  lvmmigrate also searches for unmounted file systems and possible character data sections in unused disk areas.  The list of file systems appropriate for the root volume group are marked for migration.  They are /, /tmp, /usr, and any file system with mount path beginning as /usr/. 

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 execution of lvmmigrate, users must backup the file systems and any character device sections to tape.  The system is then reinstalled on logical volumes using the configuration information recorded by lvmmigrate. 

Options

lvmmigrate recognizes the following options:

-v (verbose) lvmmigrate displays all disks, file systems, possible raw sections, and tape devices present in the system. 

-n Specifies 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. 

-d disk_special_file
Specifies the root disk to be used 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. 

-f Forces recording of configuration information.  Information is recorded in a LIF file LVMMIGRATE 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 ... 
Specifies a list of file systems to be included in the root volume group along with /, /tmp, and usr file systems. 

-e filesystem ...
Specifies a list of file systems to be excluded from the root volume group.  Note that the / file system cannot be excluded. 

EXAMPLES

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

lvmmigrate -v

Display a detailed list of disks, file systems, and possible raw data sections present in the current system.  The -n option disables writing of the LVMMIGRATE LIF file, but file /tmp/LVMMIGRATE is still created:

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/c1d0s2:

lvmmigrate -d /dev/dsk/c1d0s2 -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 backup 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 LVMMIGRATE already exists in the LIF volume, lvmmigrate rewrites it. 

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. 

SEE ALSO

lifinit(1), install(1M). 

Hewlett-Packard Company  —  HP-UX Release 9.0: August 1992