| 502 | | = Configuring BAT Updater = |
| 503 | | **Warning**: Since June 2012 the bat updater agent is obsolate. Please use [http://www.qoscosgrid.org/trac/qcg-computing/wiki/QCG-Accounting QCG-Accounting] instead. |
| 504 | | == Installation == |
| 505 | | * install BAT using YUM |
| 506 | | {{{ |
| 507 | | yum install qcg-bat-updater |
| 508 | | }}} |
| 509 | | == Configuration == |
| 510 | | 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 to the file `/opt/plgrid/qcg/etc/qcg-bat-updater/truststore.ts` (make sure this file is only readable by root). Now you are ready to edit the QCG BAT configuration file `/opt/plgrid/qcg/etc/qcg-bat-updater/config.properties`. You should change the following properties: |
| 511 | | * qcg.db.pass - password of the QCG-Computing database (see `<Database>` section of the `qcg-compd.xml` file) |
| 512 | | * qcg.bat.user and qcg.bat.pass - put values provided by the BAT administrator |
| 513 | | * qcg.bat.keystore.pass - keystore pass (provided with key by the BAT administrator) |
| 514 | | * qcg.site.name - your site name |
| 515 | | * qcg.batch.server - hostname where the batch server is running |
| 516 | | * qcg.pbs.home - the root of the Torque spool directory (e.g. `/var/torque`) |
| 517 | | * qcg.bat.debug - controls verbosity of the log messages |
| 518 | | |
| 519 | | |
| 520 | | |
| 521 | | == Operations == |
| 522 | | Usage records are sent to the main BAT server (BAT Broker) every hour by the QCG BAT Updater (acting as BAT agent). The QCG BAT Updater is started every hour via a cron job (installed in `/etc/cron.hourly/qcg-bat-updater.cron`). The QCG BAT Updater is a Java batch application that on every run: |
| 523 | | * reads jobs accounting information from the QCG-Computing database |
| 524 | | * converts it to a proper XML format |
| 525 | | * sends it over ActiveMQ channel (SSL secured) to BAT-Broker |
| 526 | | * stores id of the last record sent to the file `/opt/plgrid/var/run/qcg-bat-updater/last.id`. |
| 527 | | The QCG-BAT Updater logs can be found in `/opt/plgrid/var/log/qcg-bat-updater/qcg-bat-updater.log`. |
| 528 | | |
| | 502 | = Configuring QCG-Accounting = |
| | 503 | Please use [http://www.qoscosgrid.org/trac/qcg-computing/wiki/QCG-Accounting QCG-Accounting] agent. You must enable `bat` as one of the publisher plugins. |
