vxbootsetup(ADM)

vxbootsetup - set up system boot information on a Volume Manager disk

Synopsis

/etc/vx/bin/vxbootsetup [ medianame ... ]

Description

The vxbootsetup utility configures physical disks so that they can be used to boot the system. Before vxbootsetup is called to configure a disk, mirrors of the root, swap, /usr and /var volumes (if they exist) should be created on the disk. These mirrors should be restricted mirrors of the volume. The vxbootsetup utility configures a disk by writing a boot track at the beginning of the disk and by creating physical disk partitions in the UNIX VTOC that match the mirrors of the root, swap, /usr and /var.

With no medianame arguments, all disks that contain usable mirrors of the root, swap, /usr and /var volumes are configured to be bootable. If medianame arguments are specified, only the named disks are configured.

vxbootsetup requires that the root volume is named rootvol and has a usage type of root. The swap volume is required to be named swapvol and to have a usage type of swap. The volumes containing /usr and /var (if any) are expected to be named usr and var, respectively.

Partitions which overlay restricted mirrors of the root volume are assigned a partition number of 0. Partitions created to overlay restricted mirrors of the swap volume are assigned a partition number of 1. Mirrors of the volumes containing /usr and /var are assigned one of the free partition numbers on the disk. All created partitions are given partition types appropriate for use with the system boot process.

Root, swap, /usr and /var volumes are created when the original system boot disk is encapsulated with the vxencap utility or when the Volume Manager is first set up on the system. (/usr and /var are only encapsulated if they existed on the system; see the vxencap(ADM) man page for details on encapsulating the boot disk.)

See the appendix on recovery in the VERITAS Volume Manager (VxVM) System Administrator's Guide for detailed information on how the system boots and how the Volume Manager impacts the system boot process.

The following utilities call vxbootsetup automatically: vxmirror, vxrootmir, vxresize, and vxencap. If you use vxassist or vxmake and vxplex to create mirrors of the root volume on a disk, you must call vxbootsetup directly to make that disk bootable.

References

vxassist(ADM), vxdisksetup(ADM), edvtoc(ADM), vxencap(ADM), vxevac(ADM), vxintro(ADM), vxmake(ADM), vxmirror(ADM), vxplex(ADM), vxresize(ADM), vxrootmir(ADM)

The appendix on recovery in the VERITAS Volume Manager (VxVM) System Administrator's Guide.