NAME

tkadmin unmap lvol - unmaps an Encina logical volume from an AIX volume

SYNOPSIS

tkadmin unmap lvol -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 Encina logical volume to be deleted by unmapping it from an AIX logical volume. 

DESCRIPTION

The tkadmin unmap lvol command unmaps a logical volume from an AIX volume. The names of the logical volumes are permanently retained by the Toolkit server. This is to facilitate the recreation of the logical volume at a future time (via the tkadmin remap lvol command) and the restoration of its contents from a backup. Users that want to reuse the name of a logical volume after unmapping it can rename it. 

CAUTIONS

The logical volume must be disabled. (You must start the server in administrative mode.) 

If you later need the contents of an unmapped logical volume, the volume can be remapped and restored from backup tapes. 

NOTES

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

EXAMPLES

The following command unmaps the logical volume lvol1 from an operating system volume serving as its backing store:

% tkadmin unmap lvol lvol1

PRIVILEGE REQUIRED

Encina Monitor administer (a) permission to the server

Encina RQS administer (a) permission to the RQS server

Encina SFS administer (A) permission to the SFS server

RELATED INFORMATION

tkadmin map lvol

tkadmin remap lvol

  —  March 1997