NAME

tkadmin delete lvol - deletes a logical volume

SYNOPSIS

tkadmin delete 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 logical volume to be deleted. 

DESCRIPTION

The tkadmin delete lvol command deletes the logical volume specified. This command unmaps the last physical volume from this logical volume.  Thus, all but one replica of the data must be removed prior to deleting the logical volume (via the tkadmin remove mirror command). 

The names of logical volumes are permanently retained by the Toolkit server even after the logical volume has been deleted. This facilitates the recreation of a logical volume at a future time (after it has been deleted) via the tkadmin recreate lvol command. The contents of the recreated logical volume are restored from a backup. Users that want to reuse the name of a logical volume after deleting it can rename it. 

CAUTIONS

This command fails if the logical volume is enabled. 

If you later need the contents of a deleted logical volume, it may require a restore from backup tapes. 

NOTES

This command is not for use on the AIX operating system. To “delete” logical volumes on AIX, delete the mapping between the Encina logical volume and the AIX operating system logical volume with the tkadmin unmap lvol command. 

EXAMPLES

The following command deletes the logical volume lvol1:

% tkadmin delete lvol lvol1

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

tkadmin init disk

  —  March 1997