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