jura man page

jura — Job Usage Reporter of ARC

Description

The jura application is a resource-side accounting (usage logging) client.

Synopsis

jura [-E exp_time] [-L] [-u url [-u url -t topic -u url ...] ] [-r time_range] ctrl_dir [ctrl_dir ...]

Options

-E
expiration time (validity length) of job log files in days
-u
logging destination URL
-t
topic for a destination URL
-o
archived accounting records directory
-L
turns on timestamps and logging level in messages printed during execution
-r
time range of archived messages that will be resend
-v
show version of Jura (ARC)

Arguments

ctrl_dir
The A-REX control directory for a mapped local UNIX user

Extended Description

Normally, jura is invoked by A-REX periodically with the appropriate command line arguments, but it can also be executed interactively.

Job log files, i.e. files produced by A-REX for each job and stored under <ctrl_dir>/logs contain various usage data and configuration options for accounting (see NORDUGRID-TECH-24 for details of their content). These files are parsed by jura, converted into UR format, and submitted in batches to reporting destinations. A destination is a resource usage logging service; currently SGAS LUTS and CAR 1.2 message propagation are supported. Job log files older than the expiration time specified with the -E option are deleted without parsing.

If the -u option is absent, URs are submitted to the destination URLs specified in the job log files. If submitting succeeds, the corresponding job log files are deleted. This is the default, automatic mode of operation.

If destination URLs are specified with the -u option, URs are submitted only to these destinations (one UR per job to each destination). In this case, job log files are preserved even if submitting succeeds.

If the -r option is absent, <ctrl_dir> parameter be using as location of archived files, URs from the given directory are submitted to the destination URLs specified with -u option in the CLI.

Environment Variables

X509_USER_CERT
The location of the certificate of the reporting entity, used only if not specified in job log files. The default is the standard host certificate location, /etc/grid-security/hostcert.pem.
X509_USER_KEY
The location of the private key of the reporting entity, used only if not specified in job log files. The default is the standard host key location, /etc/grid-security/hostkey.pem.
X509_CERT_DIR
The path to the certificates of trusted CAs, used only if not specified in job log files. The default is the standard certificates directory, /etc/grid-security/certificates.
ARC_LOCATION
The location where ARC is installed can be specified by this variable. If not specified the install location will be determined from the path to the command being executed, and if this fails a WARNING will be given stating the location which will be used.
ARC_PLUGIN_PATH
The location of ARC plugins can be specified by this variable. Multiple locations can be specified by separating them by : (; in Windows). The default location is $ARC_LOCATION/lib/arc (\ in Windows).

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

Info

2016-11-19 NorduGrid ARC 5.3.0rc1 NorduGrid Users Manual