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.site.name - your GOCDB site name,
• qcg.batch.server - hostname where the batch server is running,
• qcg.parser.plugin - the name of the log parser plugin (e.g. pbs). Delete this property if the agent has no access to LRMS logs,
• qcg.publishers.plugins - the coma separated list of publisher plugins (e.g. bat,apel)
• qcg.debug - if set to true produce more verbose messages,
• qcg.state.dir - local state directory (default: /opt/plgrid/var/run/qcg-acc/)
• qcg.db.pass - password of the QCG-Computing database (see <Database> section of the qcg-compd.xml file),

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.

Also if you want to report job as different (by default the QCG-Accounting agent tries to guess local hostname automatically) submit host than you may want to set the following property:

• qcg.submit.host=host.second.alias

Parser plugins

PBS Pro and Torque log parser - pbs

• qcg.pbs.home - the root of the Torque spool directory (e.g. /var/torque).

Publishers plugins

BAT publisher (PL-Grid only) - bat

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.
• qcg.bat.grid.only - set this to true if you do not want to report LRMS specific job information.

APEL SSM publisher - apel

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-accounting.log. You may also try to set the qcg.debug configuration property to true in order to get more verbosity of log messages. The QCG-Accounting Agent stores all diagnostic information in the following log file: /opt/plgrid/var/log/qcg-acc/qcg-accounting.log. You may also try to set the qcg.debugconfiguration property to true in order to get more verbosity of log messages.