NAME

tkadmin sync mirrors - synchronizes a logical volume

SYNOPSIS

tkadmin sync mirrors -server servername lvolname

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 synchronized. 

DESCRIPTION

The tkadmin sync mirrors command brings the physical volumes backing a logical volume into synchronization by copying data from a consistent physical volume to all appropriate available intermediate or stale physical volumes. This command is rather expensive in terms of I/O; however, it is cheaper than the equivalent sequence of client page I/O operations. 

This command does not return until the synchronization is complete.  If a server crashes during this command, one or more of the physical volumes that were out of date at the beginning of this command remain so. The command should be reissued after the server recovers. This command can be issued while a volume is enabled, that is, while I/O is being performed on the volume. 

Only execute this command after a server’s data volumes have been recovered whether the server has been restarted in normal operations mode or after the tkadmin restore lvols command has been executed following a restoration of data. 

NOTES

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

EXAMPLES

In the following example, the physical volumes backing the lvol8 logical volume (an up-to-date copy and a new mirror) are synchronized. 

% tkadmin sync mirrors lvol8

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 remove mirror

  —  March 1997