NAME

tkadmin map lvol - maps an AIX logical volume to an Encina logical volume

SYNOPSIS

tkadmin map 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 Encina logical volume to be created by mapping it to an AIX logical volume. 

oslvolname Specifies the AIX logical volume that is to be used as a backing store for the Encina logical volume. 

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

DESCRIPTION

The tkadmin map lvol command creates a new logical volume by using an AIX logical volume as the backing store for it. 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 example, the SMIT LVM utility. 

The advantage of creating a logical volume in this way is that you can set the disk storage attributes of all applications using the same tools provided by the operating system. 

After mapping the Encina logical volume to an AIX logical volume, the Encina logical volume must be enabled. 

The chunk size is normally used to specify the minimum size of the volume physically contiguous on disk. However, when mapping an AIX volume, the Toolkit volume service has no control over the physical layout of the volume. The chunk size is merely stored by the volume service for possible use by its clients. It should be set in accordance with the physical characteristics of the AIX volume. 

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 create logical volumes on servers running on the AIX operating system. 

EXAMPLES

The following command creates a new logical volume named lvol1 using the AIX volume aix_lvol1 as the backing store and sets the chunk size of the volume to 8 pages:

% tkadmin map 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 unmap lvol

tkadmin remap lvol

  —  March 1997