test veritas logo


vxrootadm(1M)

NAME

vxrootadm - create boot disk snapshots, add mirrors, remove mirrors, split mirrors, join mirrors

SYNOPSIS

vxrootadm [-v] [-Y] addmirror targetdisk

vxrootadm [-v] [-Y] [-F] join srcdg

vxrootadm [-v] [-g srcdg] [-s srcdisk] mksnap targetdisk targetdg

vxrootadm [-v] [-Y] rmmirror targetdisk

vxrootadm [-v] [-Y] [-F] split targetdg [targetdisk]

DESCRIPTION

The vxrootadm utility performs basic administrative operations on encapsulated boot disks. Operations include taking snapshots of the boot disk and administering root mirrors. The first operand is a keyword that determines the operation. The remaining operands specify the configuration objects to which the operation is to be applied.

KEYWORDS

addmirror Adds a mirror of the root disk to the root disk group, for redundancy in case the current root disk fails. Specify a target disk (targetdisk) on which to create the mirror. The target disk must have enough capacity to store all of the volumes on the current root disk. The addmirror command initializes the target disk, adds the target disk to the current root disk group, and mirrors all of the volumes on the root disk to the target disk.
join Reattaches mirrors from an alternate root disk group (srcdg) to the current (booted) root disk group. The srcdg must contain mirrors that were previously split from the current root disk. If the alternate root disk group srcdg contains any non-root disks, those disks and their volumes are also moved to the current root disk group. The vxrootadm join command removes the mirrors and disks from the alternate root disk group and destroys the alternate root disk group.
mksnap Makes a snapshot of the specified root disk for safekeeping in case the boot disk fails. By default, the command makes a snapshot of the current (booted) root disk. If the current root disk group already contains a mirror of the root disk, you can specify the mirror as the targetdisk.
If the current root disk group does not contain a mirror, you must specify a target disk (targetdisk) that has enough capacity to store all of the volumes on the root disk and that is not in use. In this case, the vxrootadm mksnap command initializes the target disk, adds the target disk to the booted root disk group, and mirrors all the volumes from the root disk onto the target disk.
The mksnap operation splits the target disk from the root disk group and creates an alternate root disk group (targetdg). This results in a bootable snapshot of the mirror.
To create a snapshot of an alternate root disk, specify the disk with the -s option. If the specified root disk is not in the current root disk group, specify the disk group with the -g option.
rmmirror Deletes a root disk mirror (targetdisk) from the current (booted) root disk group. The specified target disk must not be the last mirror associated with the disk group.
split Splits the root disk mirror into a new root disk group. If the current root disk group already contains a mirror of the root disk, splitting the root disk group moves the mirror to a new disk group with the specified name targetdg. If the current root disk group does not contain a mirror, you can specify a target disk (targetdisk) on which to create the root disk mirror. The vxrootadm split command removes the root mirror disks from the current root disk group and adds them to the newly-created alternate disk group (targetdg). If the current root disk group contains any non-root disks, those disks and their volumes are also moved to the target disk group. After you split the root disk mirror, the root disk group contains only the current root disk.

OPTIONS

-F Forces the split or join operation. For the split operation, use the force operation to split even if the root disk group has already been split. For the join operation, use the force operation to join even if the srcdg is not the latest split disk group.
-s Specifies the source disk.
-v Verbose mode. Displays current status and other utilities that are called during execution of vxrootadm.
-Y Suppresses the prompt to confirm the requested operation.

EXAMPLES

Take a snapshot of the root disk and put the snapshot of the root disk on the target disk sda in the new disk group, mynewdg:
# vxrootadm mksnap sda mynewdg
 
To add a mirror disk sda to the root disk:
# vxrootadm -Y addmirror sda
 
To split the booted root disk group to a new root disk group backupdg:
# vxrootadm -Y split backupdg
  When the split operation completes, the current root disk group contains only the booted root disk. Any other disks in the root disk group are now in the backupdg disk group.
To join the root disk group backupdg to the booted root disk group:
# vxrootadm -Y join backupdg
  When the join operation completes, the disks from the backupdg are in the current root disk group, and the backupdg does not exist.

FILES

/etc/vx/reconfig.d/state.d/vxrootadm
  Directory containing the saved file and state information.

SEE ALSO

vxassist(1M), vxdg(1M), vxdisk(1M), vxmirror(1M), vxplex(1M), vxprint(1M)


VxVM 7.3.1 vxrootadm(1M)