NAME

       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).

COPYRIGHT

       APACHE LICENSE Version 2.0

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