The QCG-Accounting Agent

Architecture

Installation

You can install the package using the QosCosGrid yum repository:

yum instal qcg-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:

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 ( 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.debugconfiguration property to true in order to get more verbosity of log messages.