NAME

tkadmin init logvol - initializes a logical volume for the storage of log data

SYNOPSIS

tkadmin init logvol -server servername logVolName archDevName [-extentsize extentsize]

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. 

logVolName Specifies the logical volume to be initialized to store log data. 

archDevName Specifies the offline archive device. The name of the device is prefixed with the device type, either FILE or TAPE, and a : (colon) separator. For example, on UNIX, an example archive device name is FILE:/opt/encinalocal/branch1/server/rqs1/archives. 

[-extentsize extentsize]
Specifies the log extent size in bytes. The size must be a power of two. If -extentsize is not specified, Encina automatically calculates the extent size, based on the size of the log volume. We recommend that you allow Encina to automatically calculate the extent size (that is, do not specify the extent size). 

DESCRIPTION

The tkadmin init logvol command initializes the specified logical volume so that it can be used to store log data. Before issuing this command, you must first create a logical volume via tkadmin commands. This command should be issued only once. 

If the -extentsize option is not specified, Encina computes a reasonable extent size for the logical volume, based on the size of the volume. If -extentsize is specified, Encina rounds the value up to a power of two to determine the extent size in kilobytes. 

CAUTIONS

You should verify that the specified logical volume is not being used. Issuing this command on a logical volume that stores data for a different server makes all data present on that logical volume unusable. 

EXAMPLES

UNIX

The following command initializes the sfslogvol logical volume to be used to store a server’s log data. The offline archive device associated with this log volume is the /opt/encinalocal/branch1/server/sfs1/archives directory. 

% tkadmin init logvol sfslogvol FILE:/opt/encinalocal/branch1/server/sfs1/archives

Windows NT

The following command initializes the sfslogvol logical volume to be used to store a server’s log data. The offline archive device associated with this log volume is the D:\opt\encinalocal\branch1\server\sfs1\archives directory. 

C:\> tkadmin init logvol sfslogvol D:\opt\encinalocal\branch1\server\sfs1\archives

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 create logfile

  —  March 1997