Version 30 (modified by mmamonski, 12 years ago) (diff) |
---|
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.
Attachments
-
QCG-Accounting.png
(362.2 KB) -
added by mmamonski 11 years ago.
QCG-Accounting internal architecture