= The QCG-Accounting Agent =

== Architecture ==

[[Image(QCG-Accounting.png)]]
== Installation ==
You can install the package using the !QosCosGrid yum repository:
{{{
yum instal qcg-comp-accounting
}}}
== Configuration ==
The whole configuration of QCG-Accounting agent is stored in single properties files (`/opt/plgrid/qcg/etc/qcg-acc/config.properties`). List of configuration properties (subjected to changes):
=== Common ===
* qcg.db.pass - password of the QCG-Computing database (see `<Database>` section of the `qcg-compd.xml` file),
* qcg.site.name - your GOCDB site name, 
* qcg.batch.server - hostname where the batch server is running,
* qcg.parser - the name of the log parser plugin (e.g. `pbs`),
* qcg.publishers - the coma separated list of publisher plugins (e.g. `bat,ssm`)
* qcg.debug - if set to true produce more verbose messages,
If your database setup is not standard you may need to configure also the following properties:
* qcg.db.host - QCG-Computing database host,
* qcg.db.port - QCG-Computing database port,
* qcg.db.name - QCG-Computing database name,
* qcg.db.user -  QCG-Computing database name.
=== PBS Pro and Torque log parser ===
* qcg.pbs.home - the root of the Torque spool directory (e.g. `/var/torque`).
=== BAT publisher (PL-Grid only) ===
At first you must ask the BAT administrator to provide you all credentials (username/password and X.509 certificate) needed to connect to the BAT. Copy the received keystore into the file `/opt/plgrid/qcg/etc/qcg-acc/truststore.ts` (make sure that this file is only  readable by root). 
* qcg.bat.user and qcg.bat.pass - put here values provided by the BAT administrator
* qcg.bat.keystore.pass - keystore pass (provided with key by the BAT administrator)
* qcg.bat.test - enables test mode (i.e. do not send records to BAT broker) - default: false. 

=== APEL SSM publisher ===
At first you must install and configure APEL SSM to run in service mode ([https://wiki.egi.eu/wiki/APEL/RunningSSM#Running_the_SSM_as_a_service instructions]). Then configure the 
* qcg.ssm.msg.dir - directory for outgoing usage record messages (default: `/opt/apel/ssm/messages/outgoing/`),
* qcg.ssm.benchmark.type - benchmark name: either Si2k or  HEPSPEC,
* qcg.ssm.benchmark.value - benchmark value (if cluster is composed of machines various types provide here weighted mean.
== Troubleshooting ==
The QCG-Accounting Agent  stores all diagnostic information in the following log file: `/opt/plgrid/var/log/qcg-acc/qcg-acc-agent.log`.  You may also try to set the `qcg.debug`configuration property to `true` in order to get more verbosity of log messages.