NAME

tkadmin remap lvol - remaps an AIX logical volume to an Encina logical volume

SYNOPSIS

tkadmin remap lvol -server servername lvolname oslvolname chunksize

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 created by remapping the AIX volume. 

oslvolname Specifies the AIX volume to be used to store the newly recreated logical volume. 

chunksize Specifies the number of pages that can be used by the Toolkit server as an allocation unit. 

DESCRIPTION

The tkadmin remap lvol command remaps an unmapped Encina logical volume to an AIX logical volume. This command is analogous to the tkadmin recreate lvol command (but is used when an Encina logical volume is backed by an AIX logical volume). 

This command is used to recreate a logical volume that once existed but had the AIX volume used as its backing storage destroyed (for example, by a disk crash). This is usually a prelude to restoring the contents of the logical volume from a backup via the tkadmin restore lvols command. 

The new logical volume inherits all the physical attributes of the AIX volume (for example, the disk layout and mirroring characteristics).  The physical attributes of the new logical volume can be manipulated via the AIX administrative facilities (for instance, the SMIT LVM utility).  The difference between this command and the tkadmin map lvol is that this makes the contents of the logical volume visible via the same logical volume name that was previously used. 

CAUTIONS

The user should not change the name of the AIX logical volume after mapping it to an Encina logical volume. 

As each Toolkit server manages its own physical storage, one server cannot know the location of another server’s volumes. You must prohibit multiple use of AIX logical volumes. 

NOTES

This command is for use on the AIX operating system only. It is the only way to recreate logical volumes on servers running on the AIX operating system. 

EXAMPLES

The following command remaps the operating system volume aix_lvol1 to the logical volume lvol1:

% tkadmin remap lvol lvol1 aix_lvol1 8

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 map lvol

tkadmin unmap lvol

  —  March 1997