NAME

tkadmin expand lvol - expands a logical volume

SYNOPSIS

tkadmin expand lvol -server servername lvolname newsize

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

newsize Specifies the total size (in pages) of the new logical volume. 

DESCRIPTION

The tkadmin expand lvol command increases the size of a logical volume. It adds pages (new size - old size = additional pages) to the end of the logical volume. For instance, if the volume contained pages 0 through N and was expanded by E pages, the new pages are numbered N+1 through N+E. The output of the tkadmin query lvol command includes the current size of the volume. 

Each physical volume backing the logical volume must have at least newsize pages, the number of pages in the expanded logical volume. If the physical volumes are smaller than the logical volume, this command fails. To increase the size of each physical volume, use the tkadmin expand pvol command. 

A logical volume can be expanded while it is online and being used (I/O taking place). 

EXAMPLES

The following command expands the logical volume lvol1 to a size of 1024 pages:

% tkadmin expand lvol lvol1 1024

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 expand pvol

  —  March 1997