lvlnboot(1M) — Series 800 Only

NAME

lvlnboot − prepare a Logical Volume to be a root, primary swap, or dump volume

SYNOPSIS

/etc/lvlnboot [-v] [-r root_lv] [-s swap_lv] [-d dump_lv] [-R volume_group_name]

DESCRIPTION

lvlnboot updates all Physical Volumes in the Volume Group such that the Logical Volume becomes the root, primary swap, or a dump volume when the system is next booted on the Volume Group. If a non-existent logical volume is specified, this command fails. If a different logical volume is already linked to the root or primary swap, the command fails.

If the length or mirrored copies of a root, swap, or dump logical volume changes via the lvextend command (see lvextend(1M)), lvlnboot must be run again on each logical volume that has changed.

Options

lvlnboot recognizes the following options and arguments:

-v Prints verbose messages. With no other arguments present, this option prints information on all Volume Groups.

-rroot_lv Defines root_lv to be the root volume the next time the system is booted on this Volume Group. Updates the Boot Data Reserved Area such that the Volume Group is used to locate the root file system. This allows the root_lv to be used as the root volume during a maintenance mode boot. The Physical Volume or volumes containing the root_lv must have been created using the pbcreate -B option (see pvcreate(1M)), indicating that that Physical Volume is to be used as a Bootable Physical Volume. Also, the mkboot(1M) command must have been run on the Physical Volume to create the LIF area at the top of the Physical Volume. The root_lv must be a contiguous Logical Volume and cannot have Bad Block Relocation enabled.

-sswap_lv Defines swap_lv to be the primary swap volume next time the system is booted on the Volume Group. Updates the Boot Data Reserved Area. Any existing swap areas previously defined are removed. swap_lv must be a contiguous Logical Volume, and a Root Logical Volume must have been previously defined by use of this command.

-ddump_lv Defines dump_lv to be one of the dump volumes next time the system is booted on the Volume Group. Updates the Boot Data Reserved Area. The combined size of all the dump volume should be atleast 2048 bytes larger than the total memory of the system. The additional 2 Kbytes is used to safeguard against dump to the bottom of the disk. Multiple dump devices can be configured, but each dump_lv must be entered on a separate lvlnboot command line. dump_lv must be an unmirrored, contiguous logical volume.

-Rvolume_group_name
Recovers any missing links to all of the logical volumes specified in the Boot Data Reserved Area on each of the Physical Volumes in the Volume Group.

EXTERNAL INFLUENCES

Environment Variables

LANG determines the language in which messages are displayed.

If LANG is not specified or is set to the empty string, a default of "C" (see lang(5)) is used instead of LANG.

If any internationalization variable contains an invalid setting, lvlnboot behaves as if all internationalization variables are set to "C". See environ(5).

EXAMPLES

Specify that logical volume /dev/vg00/lvol3 should be used as the Root Logical Volume:

lvlnboot -r /dev/vg00/lvol3

Specify that logical volume /dev/vg00/swap1, /dev/vg00/dump2, and /dev/vg00/dump3, should be used as the Dump Logical Volumes and that /dev/vg00/swap1 should also be used as Primary Swap:

lvlnboot -s /dev/vg00/swap1

lvlnboot -d /dev/vg00/swap1

lvlnboot -d /dev/vg00/dump2

lvlnboot -d /dev/vg00/dump3

Museum

Related Articles