cta-admin sends the specified command to the CTA Frontend (see CONFIGURATION below) and displays the response.
.SH DESCRIPTION
Invoking cta-admin with no command line parameters gives a list of valid commands.
To show the subcommands and options for a specific command, type:
cta-admin \fIcommand\fR help
.SH COMMANDS
Commands have a long version and an abbreviated version (shown in brackets).
admin (ad)
Add, change, remove or list the administrators of the system. In order to use cta-admin, users must exist in the administrator list and must authenticate themselves with a valid Kerberos KRB5 credential.
archivefile (af)
List files which have been archived to tape.
archiveroute (ar)
Add, change, remove or list the archive routes, which are the policies linking namespace entries to tapepools.
drive (dr)
Bring tape drives up or down, list tape drives or remove tape drives from the CTA system.
groupmountrule (gmr)
Add, change, remove or list the group mount rules.
listpendingarchives (lpa)
List pending archive requests.
listpendingretrieves (lpr)
List pending retrieve requests.
logicallibrary (ll)
Add, change, remove or list the logical libraries, which are logical groupings of tapes and drives based on physical location and tape drive capabilities. A tape can be accessed by a drive if it is in the same physical library and if the drive is capable of reading or writing the tape. In this case, that tape and that drive should normally also be in the same logical library.
mountpolicy (mp)
Add, change, remove or list the mount policies.
repack (re)
Manage tape repacking.
requestermountrule (rmr)
Add, change, remove or list the requester mount rules.
showqueues (sq)
Show the status of all active queues.
shrink (sh)
Shrink a tapepool.
storageclass (sc)
Add, change, remove or list the storage classes. Storage classes are associated with directories, to specify the number of tape copies the files in the directory should have. Storage classes should be changed only rarely.
tape (ta)
Add, change, remove, reclaim, list or label tapes. This command is used to manage the physical tape cartridges in each library.
tapepool (tp)
Add, change, remove or list the tapepools, which are logical sets of tapes. Tapepools are used to manage the life cycle of tapes (label → supply → user pool → erase → label). Listing the tapepools shows statistics such as the total number of tapes in the pool, number of free tapes, etc.
test (te)
Test tape read/writes. This is a synchronous command that returns performance stats and errors. It should be run on an empty self-dedicated drive.
verify (ve)
Manage tape verification.
.SH CONFIGURATION FILE
The cta-admin configuration is specified in \fI/etc/cta/cta-cli.conf\fR. The following configuration options can be specified:
cta.endpoint (mandatory)
Specifies the CTA Frontend hostname (FQDN) and TCP port.
cta.resource.options (default: \fInone\fR)
Currently the only supported option is \fIReusable\fR. For an explanation of XRootD SSI reusable resources, see \fIhttp://xrootd.org/doc/dev49/ssi_reference-V2.htm#_Toc506323429\fR
cta.log (default: \fInone\fR)
Sets the client log level (see \fIXrdSsiPbLogLevel\fR below).
cta.log.hiRes (default: \fIfalse\fR)
Specify whether log timestamps should have second (\fIfalse\fR) or microsecond (\fItrue\fR) resolution.
Example configuration file:
cta.endpoint cta-frontend.cern.ch:10955
cta.resource.options Reusable
.SH ENVIRONMENT VARIABLES
XrdSsiPbLogLevel
Set the desired log level (default: \fInone\fR). Logging is sent to stderr. Available log levels are:
