NAME

tkadmin add mirror - adds a mirror to a logical volume

SYNOPSIS

tkadmin add mirror -server servername lvolname pvolname

ARGUMENTS

-server servername Specifies the server affected by the command. The server name is the name that is registered with the DCE Directory Service. If the server name is not specified in the command line, it is retrieved from an environment variable, ENCINA_TK_SERVER. 

lvolname Specifies the logical volume to be mirrored. 

pvolname Specifies the physical volume to be used as the mirror.  (This physical volume must be at least as large as the smallest physical volume backing the logical volume.) 

DESCRIPTION

The tkadmin add mirror command mirrors a logical volume by providing more than one copy of its data.  Mirroring is used to increase the availability of a logical volume. To be mirrored, logical volumes must first be enabled. You can list the existing logical volumes using the tkadmin list lvols command. 

The physical volume specified for use as a mirror should not be mapped to any other logical volume. If it is mapped to another logical volume, this command fails. 

When mirroring a logical volume, the content of the new physical volume remains indeterminate until the user invokes the tkadmin sync mirrors command.  Adding a mirror and synchronizing its contents can be done while a volume is enabled, that is, while I/O is taking place. If a mirror is added to a volume before the volume is in use, the two physical volumes do not have to be synchronized. 

NOTES

This command is not for use on the AIX operating system. 

EXAMPLES

The following command mirrors the logical volume named lvol8 by duplicating its data and storing it on the physical volume pvol3:

% tkadmin add mirror lvol8 pvol3

PRIVILEGE REQUIRED

Encina Monitor administer (a) permission to the node manager

Encina RQS administer (a) permission to the RQS server

Encina SFS administer (A) permission to the SFS server

RELATED INFORMATION

tkadmin sync mirrors

tkadmin remove mirror

  —  March 1997