HP-UX Reference (11i v2 04/09) - 1M System Administration Commands A-M (vol 3)

l
lvmmigrate(1M) 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 sys-
tems. 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 informa-
tion 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 sys-
tem.
Section 1M−−412 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: September 2004