volmirror(8) System Manager's Manual volmirror(8)NAME
volmirror - Mirrors volumes on a disk or control default mirroring
SYNOPSIS
/usr/sbin/volmirror [-g diskgroup] [-d yes|no] medianame [new_medianame...]
/usr/sbin/volmirror [-g diskgroup] [-d yes|no] -a [new_medianame...]
/usr/sbin/volmirror [-g diskgroup] [-d yes|no]
/usr/sbin/volmirror [-g diskgroup] -D
OPTIONS
The volmirror command supports the following options: Limits operation of the command to the given disk group, as specified by disk group
ID or disk group name. The medianame operands will be evaluated relative to the given disk group. If no disk group is supplied to the
volmirror command, rootdg is presumed. Changes the default for subsequent volume creation, depending on the option argument. If the option
argument is yes, all subsequent volumes created using the volassist command will automatically be created as mirrored volumes. If the
option argument supplied is no, mirroring will be turned off for future volumes by default. Displays current default status for mirroring.
Mirrors all existing volumes for the specified disk group.
DESCRIPTION
The volmirror command provides a mechanism to mirror all the contents of a specified disk, to mirror all currently unmirrored volumes in
the specified disk group, or to change or display the current defaults for mirroring. All volumes that have only a single plex (mirror
copy), will be mirrored by adding an additional plex.
Volumes containing subdisks that reside on more than one disk will not be mirrored by volmirror.
The volmirror command is generally called from the voldiskadm menus. It is not an interactive command and once called, will continue until
completion of the operation or until a failure is detected.
Note
Due to the nature of generating mirror copies of volumes, this command may take a considerable time to complete.
In the first listed form of the command, the disk media name is supplied on the command line to volmirror. That name is taken to be the
only disk from which volumes should be mirrored. In the case of mirroring volumes from a specified disk, only simple single-subdisk volumes
are mirrored.
In the first and second listed forms of the command, the new_medianame ... parameter identifies a new disk media name (or set of names).
The mirroring operation being performed will use these names as targets on which to allocate the mirrors. An error will result if the same
disk is specified for both the source and target disk and if no other viable targets are supplied.
EXAMPLES
The following are examples of the use of the volmirror command. The following command mirrors the contents of the disk named disk01 to any
available space on any available disk. Subsequent calls to volassist will cause created volumes to be mirrored by default. volmirror -d
yes disk01 The following command displays the current status of default mirroring. It prints the string yes if mirroring is currently
enabled or no, if not. volmirror -D The following command mirrors any volumes on disk02 onto disk03. volmirror disk02 disk03
FILES
The defaults file for volassist parameters.
SEE ALSO volintro(8), volassist(8), volrootmir(8)volmirror(8)
Check Out this Related Man Page
vxrootmir(1M)vxrootmir(1M)NAME
vxrootmir - create a mirror of a Veritas Volume Manager root disk
SYNOPSIS
/etc/vx/bin/vxrootmir [-g diskgroup] [-t tasktag]
[-p Pool_1,Pool_2,...]
[[-v] [-b] [-R] root_mirror]
DESCRIPTION
The vxrootmir command creates mirrors of all of the volumes on a Veritas Volume Manager (VxVM) rootable boot disk, and makes the new disk
bootable.
A disk to be used as a mirror can be specified either by its VM disk name (disk media name) or by its device name (disk access name).
If a disk media name is specified, it is validated to make sure that it exists and that it has been properly initialized. This validation
includes making sure that the private region is at the same location and has the same length as the private region on the primary root
disk, and that the sum of the lengths of all of the subdisks located on the primary root disk will fit within the available space in the
public region of the specified disk.
If a disk access name is specified, it is validated to make sure it exists and is not in use, and that the total length of all the subdisks
on the primary root disk will fit within the public region. The disk is then initialized to contain a private region with the same offset
and length as the private region on the primary root disk. A new disk media name is assigned to the disk formed from the prefix rootdisk
followed by the next available number (for example, rootdisk02, rootdisk03, and so on).
All volumes that have a subdisk on the primary VxVM root disk are mirrored on the specified disk. When the root volume (rootvol) is mir-
rored, the vxassist command executes vxbootsetup to set up the new disk as a boot disk.
The -p option allows you to mirror the volumes on the root disk as stripe columns across several disks. The argument to this option is a
list of disks that are to be used for the stripe column mirrors. If not enough disks are specified, vxrootmir prints a message to the
standard error output, including information on how many disks are required, and then exits. When initialized for VxVM use, these stripe
column disks are named with the prefix rootaux followed by the next available number (for example, rootaux01, rootaux02, and so on).
OPTIONS -b If the system was booted from the VxVM root disk that is being mirrored, this option uses the setboot command to set the alter-
nate boot disk to the specified mirror. If the system was booted from another root disk (such as an LVM root disk), an alternate
root disk is not set. If the -v option is also specified, information is displayed on the current setboot settings, and on
whether the alternate boot disk is set to the specified mirror.
-g diskgroup
Specifies the boot disk group.
-p Pool_1,Pool_2,...
Specifies the disks that are to be used for stripe column targets when mirroring the VxVM root disk. The disks can be specified
either as disk access names, or as disk media names if they have previously been initialized for use with VxVM. If specified as
disk access names, the disks are checked for existence, correct size, and availability for use.
-R Indicates that only the volumes required to boot successfully from the new mirror are to be mirrored.
-t tasktag
Marks any tasks that are registered to track the progress of an operation with the tag tasktag. This option is passed to vxas-
sist when mirroring volumes, so any child tasks are also tagged with tasktag.
-v Displays verbose output including timestamps for operations in progress. This option is useful as mirroring large volumes can
take a long time.
ARGUMENTS
daname Specifies the disk to be used as a mirror by its disk access name (such as c0t2d0).
dmname Specifies the disk to be used as a mirror by its disk media name (such as rootdisk03).
EXAMPLES
This example shows the vxrootmir command being invoked in its simpliest form:
/etc/vx/bin/vxrootmir c5t1d0
The next example shows how to use the -R option with vxrootmir.
# /etc/vx/bin/vxrootmir -v -b -R c5t10d0
vxrootmir: 10:10:
Gathering information on the current VxVM root configuration
vxrootmir: 10:10: Checking specified disk(s) for usability
vxrootmir: 10:10: Preparing disk c5t10d0 as a VxVM disk
vxrootmir: 10:10: Adding disk c5t10d0 to rootdg as rootdisk02
vxrootmir: 10:10: Mirroring only volumes required for root mirror boot
vxrootmir: 10:10: Mirroring volume standvol
vxrootmir: 10:11: Mirroring volume swapvol
vxrootmir: 10:18: Mirroring volume rootvol
vxrootmir: 10:20: Current setboot values:
vxrootmir: 10:20: Primary: 0/4/0/1.11.0
vxrootmir: 10:20: Alternate: 0/4/0/1.13.0
vxrootmir: 10:20: Making c5t10d0 (0/4/0/1.10.0) the alternate boot disk
vxrootmir: 10:20: Disk c5t10d0 is now a mirrored root disk
The final example shows how to specify a list of disks for use as stripe column mirrors:
# /etc/vx/bin/vxrootmir -v -p c5t11d0,c5t12d0,c5t13d0 c5t10d0
vxrootmir: 12:11:
Gathering information on the current VxVM root configuration
vxrootmir: 12:11: Checking specified disk(s) for usability
vxrootmir: 12:11: Preparing disk c5t10d0 as a VxVM disk
vxrootmir: 12:11: Adding disk c5t10d0 to rootdg as rootdisk02
vxrootmir: 12:11: Preparing disk c5t11d0 as a VxVM disk
vxrootmir: 12:11: Adding disk c5t11d0 to rootdg as DM rootstpm01
vxrootmir: 12:11: Preparing disk c5t12d0 as a VxVM disk
vxrootmir: 12:11: Adding disk c5t12d0 to rootdg as DM rootstpm02
vxrootmir: 12:11: Preparing disk c5t13d0 as a VxVM disk
vxrootmir: 12:11: Adding disk c5t13d0 to rootdg as DM rootstpm03
vxrootmir: 12:11: Mirroring all volumes on root disk
vxrootmir: 12:11: Mirroring volume standvol
vxrootmir: 12:12: Mirroring volume swapvol
vxrootmir: 12:19: Mirroring volume rootvol
vxrootmir: 12:21: Mirroring volume optvol
vxrootmir: 12:24: Mirroring volume usrvol
vxrootmir: 12:27: Mirroring volume homevol
vxrootmir: 12:28: Mirroring volume tmpvol
vxrootmir: 12:28: Mirroring volume varvol
vxrootmir: 12:36: Disk c5t10d0 is now a mirrored root disk
NOTES
If the vxrootmir command aborts for any reason, or if you interrupt the command during execution, an attempt is made to clean up the VxVM
objects that had been generated up to the time of the abort or interruption. All mirror plexes that had already been added, or that were
in the process of being added when the interruption occurred, are removed. All Data Media (DM) objects that were created are also removed.
If a plex or a DM object cannot be removed, an explanatory message is displayed.
SEE ALSO setboot(1M), vxassist(1M), vxbootsetup(1M), vxintro(1M), vxmirror(1M), vxtask(1M)VxVM 5.0.31.1 24 Mar 2008 vxrootmir(1M)