NAME

tkadmin enable archfile - notifies a server that an archive file is now available online

SYNOPSIS

tkadmin enable archfile -server servername archFileName

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. 

archFileName Specifies an archive file. The file name is composed of the name of the archiveDevice (specified when the log volume on which this server’s log file is stored was initialized), followed by an operating-system-specific path separator, the name of the log volume, the .LA. string, and a sequence number. For example, on UNIX, an archive file might be specified as /opt/encinalocal/branch1/server/rqs1/archives/rqslogvol.LA.32. 

DESCRIPTION

The tkadmin enable archfile command informs an Encina server of the availability of a previously inaccessible (offline) log archive file. Encina servers that have media archiving enabled periodically write archive files into the archive device directory associated with the server’s log volume. You can move the archive files to offline storage to conserve online storage space. 

When the server needs to read data from an inaccessible archive file (when restoring a log or data volume or displaying an old backup) the server displays a message requesting that the operator fetch the file. The server then waits for an operator to indicate that the file is available via this command. 

The (offline) archive file should be restored to the archive device directory of its associated log volume (the directory specified as the archive device associated with the log volume on which this log file is stored). The name of the log volume’s archive device can be displayed via the tkadmin query logvol command. 

In some circumstances, you may not want to fetch a requested offline archive file, for example, when displaying a very old backup. In this case, the command should be issued with the specified file name without actually fetching the file. This serves as a negative acknowledgment of the request and results in unblocking the server thread that issued the request. The command that generated the request fails gracefully. 

EXAMPLES

UNIX

The following command notifies the RQS server named /.:/branch1/server/rqs1 that the /opt/encinalocal/branch1/server/rqs1/archives/rqslogvol.LA.17 archive file is now available:

% tkadmin enable archfile -server /.:/branch1/server/rqs1 /opt/encinalocal/branch1/server/rqs1/archives/rqslogvol.LA.17

Windows NT

The following command notifies the RQS server named /.:/branch1/server/rqs1 that the D:\opt\encinalocal\branch1\server\rqs1\archives\rqslogvol.LA.17 archive file is now available:

C:\> tkadmin enable archfile -server /.:/branch1/server/rqs1 D:\opt\encinalocal\branch1\server\rqs1\archives\rqslogvol.LA.17

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 query logvol

  —  March 1997