.\" -*- nroff -*-
.TH ARCCTL 1 "2019-12-02" "NorduGrid ARC 6.4.1" "NorduGrid ARC"
.SH NAME
arcctl \- Nordugrid ARC Computing Element Control Tool
.SH SYNOPSIS
.B arcctl
[\fB-d\fR, \fB--debug\fR \fILEVEL\fR] [\fB-c\fR, \fB--config\fR \fICONFIG\fR] [\fB-h\fR, \fB--help\fR] \fICOMPONENT\fR \fIACTION\fR [...]
.SH DESCRIPTION
.PP
This man page is not the ultimate source of information about \fBarcctl\fR. 
Please use \fB--help\fR to see all options available for each component!
.PP
The \fBarcctl\fR(1) utility is aimed to automate ARC CE operations, like controlling 
Services, Jobs, RunTime Environments, Accounting, etc.
.PP
The main goal is to provide a single point of control for different ARC CE subsystems
to the system administrator.
.PP 
\fBarcctl\fR designed with bash-completion in mind, so make sure you have 
\fBpython-argcomplete\fR installed and enabled to use all features.

.SH OPTIONS
.TP
\fB\-d\fR, \fB\-\-debug\fR \fILEVEL\fR
Choose the verbosity level from CRITICAL, ERROR, WARNING, INFO, DEBUG (default is ERROR).
.TP
\fB\-c\fR, \fB\-\-config \fIFILE\fR
Specifies the configuration file to be used. By default the \fBarc.conf\fP(5) is used. 
.TP
\fB\-h\fR, \fB\-\-help\fR
Show help messages

.SH COMPONENTS
The following components can be controlled by arcctl at the time of writting:
.TP 16
.I services
Controlling ARC CE services.
.TP
.I rte
Controlling RunTime Envronents available on the ARC CE.
.TP
.I job
A-REX Jobs control (actions, information, logs).
.TP
.I accounting
Accounting records operations (republishing, stats).
.TP
.I config
ARC configuration control: get/set/dump configuration values, inline options help.
.TP
.I test-ca
Self-signed CA for test certificates deployment for both hosts and users.
.TP
.I deploy
Third party components deployment (IGTF CA, VOMS LSC, Firewall configuration).
.PP
Use \fB--help\fR argument to list all available actions for each component.

.SH EXAMPLES
Enable ENV/PROXY RunTime Environment
.IP
\f(CW# arcctl rte enable ENV/PROXY\fR
.PP
Configure ENV/PROXY RunTime Environment to disable CA certificates copying
.IP
\f(CW# arcctl rte params-set ENV/PROXY COPY_CACERT_DIR No\fR
.PP
Use ENV/RTE RunTime Environment by default for every job (even if not explicitely 
requested in job description)
.IP
\f(CW# arcctl rte default ENV/RTE\fR
.PP
Clean all jobs in DELETED state
.IP
\f(CW# arcctl job cleanall -s DELETED\fR
.PP
Get job submission interface
.IP
\f(CW# arcctl job attr 21PKDmF0Aasnfk581mkC9sunABFKDmABFKDmDgFKDmUzFKDmqfGG0n interface\fR
.PP
Enable and start all ARC CE services as configured in \fBarc.conf\fR(5)
.IP
\f(CW# arcctl service enable --as-configured --now \fR
.PP
Get inline help for \fBsessiondir\fR option of \fB[arex]\fR block
.IP
\f(CW# arcctl config describe arex sessiondir\fR
.PP
Get the brief summary of configured storage areas for ARC services
.IP
\f(CW# arcctl config brief --type storage\fR
.PP
Generage tarball with test user certificate to tranfer to another machine
.IP
\f(CW# arcctl test-ca usercert --export-tar\fR
.PP
Deploy VOMS LSC files for atlas VO from EGI VO Database
.IP
\f(CW# arcctl deploy voms-lsc atlas --egi-vo\fR
.PP
Show archived APEL accounting records statistics
.IP
\f(CW# arcctl accounting stats -t apel\fR

.SH REPORTING BUGS
Report bugs to http://bugzilla.nordugrid.org/

.SH COPYRIGHT
APACHE LICENSE Version 2.0

.SH AUTHOR
ARC software is developed by the NorduGrid Collaboration  
(http://www.nordugrid.org), please consult the AUTHORS file distributed with  
ARC. Please report bugs and feature requests to http://bugzilla.nordugrid.org 

.SH SEE ALSO
.BR arc.conf (5)