Symantec logo

vxbrk_rootmir

NAME

vxbrk_rootmir - break off a mirror of a VxVM root disk to create a separate root disk generation

SYNOPSIS

/etc/vx/bin/vxbrk_rootmir [-g diskgroup] [-v] [-b] [-t tasktag] {daname|dmname}

DESCRIPTION

The vxbrk_rootmir command creates a mirror of a Veritas Volume Manager (VxVM) rootable boot disk, breaks the mirror, and then makes the broken-off mirror into a completely separate root disk that is suitable for booting by itself.

The given disk access name, daname, or disk media name, dmname, is first checked to see if it is already a valid root disk mirror. If so, the mirror is broken off from the current VxVM root disk, and regenerated into a unique VxVM root disk. If the specified disk is not a valid root disk mirror, and is unused for other purposes, the vxrootmir command is first called to mirror the specified disk from the current VxVM root disk. After the mirroring operation is complete, the mirror is then broken off, and regenerated into a unique VxVM root disk.

OPTIONS

-b

Uses the setboot command to set the alternate boot disk to the specified disk. If the -v option is also specified, information is displayed about the current setboot settings.

-g diskgroup

Specifies the disk group into which the newly broken-off mirror is to be placed. The disk group is created if it does not already exist. If the disk group already exists, the broken-off mirror is added to it. If this option is not specified, the disk group of the broken-off mirror is set to the current default disk group. However, the generation number is made different from the default disk group to prevent the mirror from being automatically imported.

-t tasktag

Marks any tasks that are registered to track the progress of an operation with the specified tag, tasktag. This option is passed to vxrootmir if it is necessary first to mirror the specified disk that is to be broken off.

-v

Displays verbose output, including timestamps for operations that are in progress. This option is passed to vxrootmir if it is necessary first to mirror the specified disk that is to be broken off.

ARGUMENTS

daname

Specifies the disk to be used as the broken off mirror by its disk access name (such as c0t2d0).

dmname

Specifies the disk to be used as the broken off mirror by its disk media name (such as rootdisk03).

EXAMPLES

This example shows the vxbrk_rootmir command being executed on a disk that already contains a valid root mirror:

/etc/vx/bin/vxbrk_rootmir -g brkdg -vb c4t15d0

VxVM vxbrk_rootmir INFO V-5-2-4023 17:47:

Checking specified disk(s) for presence and type

VxVM vxbrk_rootmir INFO V-5-2-4025 17:47:

DA c4t15d0s2, DM rootdisk06 is a valid root mirror

VxVM vxbrk_rootmir INFO V-5-2-4052 17:47:

Saving configuration data for later restoration

VxVM vxbrk_rootmir INFO V-5-2-4022 17:47:

Breaking off root mirror on DA c4t15d0s2

VxVM vxbrk_rootmir INFO V-5-2-4054 17:47:

Setting broken off mirror on c4t15d0s2 as unique root disk

VxVM vxbrk_rootmir INFO V-5-2-2566 17:47:

Preparing disk c4t15d0s2 as a VxVM root disk

VxVM vxbrk_rootmir INFO V-5-2-4046 17:47:

Patching devnodes, fstab and volboot file in new Root FS

VxVM vxbrk_rootmir INFO V-5-2-4045 17:47:

Patching /stand/bootconf file to contain new root disk

VxVM vxbrk_rootmir INFO V-5-2-2462 17:48:

Current setboot values:

VxVM vxbrk_rootmir INFO V-5-2-4048 17:48:

Primary: 0/0/2/0.2.0

VxVM vxbrk_rootmir INFO V-5-2-4010 17:48:

Alternate: 0/2/1/0.8.0.255.2.5.0

VxVM vxbrk_rootmir INFO V-5-2-4042 17:48:

Making c4t15d0s2 (0/2/1/0.8.0.255.1.15.0) the alternate boot disk

VxVM vxbrk_rootmir INFO V-5-2-4028 17:48:

Disk c4t15d0s2 is now a broken off root disk

The next example shows the command being executed on a disk that does not contain a valid root mirror, and which requires vxrootmir be called to mirror the root disk first:

/etc/vx/bin/vxbrk_rootmir -g brkdg -vb c5t5d0

VxVM vxbrk_rootmir INFO V-5-2-4023 16:25:

Checking specified disk(s) for presence and type

VxVM vxbrk_rootmir INFO V-5-2-4043 16:25: Mirroring root disk

VxVM vxrootmir INFO V-5-2-2501 16:25:

Gathering information on the current VxVM root configuration

VxVM vxrootmir INFO V-5-2-2441 16:25:

Checking specified disk(s) for usability

VxVM vxrootmir INFO V-5-2-2566 16:25:

Preparing disk c5t5d0 as a VxVM root disk

VxVM vxrootmir INFO V-5-2-3766 16:25:

Disk c5t5d0 is now EFI partitioned disk c5t5d0s2

VxVM vxrootmir INFO V-5-2-2410 16:25:

Adding disk c5t5d0s2 to brkdg as DM rootdisk03

VxVM vxrootmir INFO V-5-2-1646 16:25:

Mirroring all volumes on root disk

VxVM vxrootmir INFO V-5-2-1648 16:25: Mirroring volume standvol

VxVM vxrootmir INFO V-5-2-1648 16:26: Mirroring volume swapvol

VxVM vxrootmir INFO V-5-2-1648 16:30: Mirroring volume rootvol

VxVM vxrootmir INFO V-5-2-1648 16:31: Mirroring volume homevol

VxVM vxrootmir INFO V-5-2-1648 16:31: Mirroring volume tmpvol

VxVM vxrootmir INFO V-5-2-1648 16:31: Mirroring volume usrvol

VxVM vxrootmir INFO V-5-2-1648 16:34: Mirroring volume optvol

VxVM vxrootmir INFO V-5-2-1648 16:36: Mirroring volume varvol

VxVM vxrootmir INFO V-5-2-1616 16:40:

Disk c5t5d0s2 is now a mirrored root disk

VxVM vxbrk_rootmir INFO V-5-2-4052 16:40:

Saving configuration data for later restoration

VxVM vxbrk_rootmir INFO V-5-2-4022 16:40:

Breaking off root mirror on DA c5t5d0s2

VxVM vxbrk_rootmir INFO V-5-2-4054 16:40:

Setting broken off mirror on c5t5d0s2 as unique root disk

VxVM vxbrk_rootmir INFO V-5-2-2566 16:40:

Preparing disk c5t5d0s2 as a VxVM root disk

VxVM vxbrk_rootmir INFO V-5-2-4046 16:41:

Patching devnodes, fstab and volboot file in new Root FS

VxVM vxbrk_rootmir INFO V-5-2-4045 16:41:

Patching /stand/bootconf file to contain new root disk

VxVM vxbrk_rootmir INFO V-5-2-2462 16:41: Current setboot values:

VxVM vxbrk_rootmir INFO V-5-2-4048 16:41:

Primary: 0/0/2/0.2.0

VxVM vxbrk_rootmir INFO V-5-2-4010 16:41:

Alternate: 0/2/1/0.8.0.255.2.0.0

VxVM vxbrk_rootmir INFO V-5-2-4042 16:41:

Making c5t5d0s2 (0/2/1/0.8.0.255.2.5.0) the alternate boot disk

VxVM vxbrk_rootmir INFO V-5-2-4028 16:41:

Disk c5t5d0s2 is now a broken off root disk

SEE ALSO

vxbootsetup(1M), vxdg(1M), vxintro(1M), vxrootmir(1M), vxtask(1M)