| 1 | = QCG Broker Client Installation = |
| 2 | |
| 3 | [[PageOutline]] |
| 4 | |
| 5 | = Requirements = |
| 6 | * '''Packages requirements'''. |
| 7 | All packages required by QCG-Broker client will be automatically instaled by YUM during the installation of qcg-broker-client package. |
| 8 | * '''Java (>= 1.5)'''\\ |
| 9 | {{{ |
| 10 | #!div style="font-size: 90%" |
| 11 | For SL5.x |
| 12 | {{{#!sh |
| 13 | yum install java-1.6.0-sun-compat.x86_64 |
| 14 | }}} |
| 15 | }}} |
| 16 | * '''Apache Ant''' (>= 1.6) ("Optional tasks for ant" are required. For SL5.x the ''ant-nodeps.x86_64'' package must be installed) |
| 17 | {{{ |
| 18 | #!div style="font-size: 90%" |
| 19 | For SL5.x |
| 20 | {{{#!sh |
| 21 | yum install ant.x86_64 ant-nodeps.x86_64 |
| 22 | }}} |
| 23 | }}} |
| 24 | * '''xml-commons-apis''' - installation of this package is not mandatory, but is recommended to avoid confusing information about not important errors. |
| 25 | {{{ |
| 26 | #!div style="font-size: 90%" |
| 27 | For SL5.x |
| 28 | {{{#!sh |
| 29 | yum install xml-commons.x86_64 xml-commons-apis.x86_64 |
| 30 | }}} |
| 31 | }}} |
| 32 | * '''trusted CA certificates''' |
| 33 | To enable secure communication between client and QCG-Broker service set of trusted CA certificates must be copied either into `/etc/grid-security/certificates` directory or configured for every user. |
| 34 | |
| 35 | For the PL-Grid project: Install Polish Grid and PL-Grid Simpla-CA certificates: |
| 36 | {{{ |
| 37 | #!div style="font-size: 90%" |
| 38 | {{{#!sh |
| 39 | wget https://dist.eugridpma.info/distribution/igtf/current/accredited/RPMS/ca_PolishGrid-1.40-1.noarch.rpm |
| 40 | wget http://software.plgrid.pl/packages/general/ca_PLGRID-SimpleCA-1.0-2.noarch.rpm |
| 41 | wget https://dist.eugridpma.info/distribution/util/fetch-crl/fetch-crl-2.8.5-1.noarch.rpm |
| 42 | |
| 43 | rpm -i ca_PolishGrid-1.40-1.noarch.rpm |
| 44 | rpm -i ca_PLGRID-SimpleCA-1.0-2.noarch.rpm |
| 45 | |
| 46 | #install certificate revocation list fetching utility |
| 47 | rpm -i fetch-crl-2.8.5-1.noarch.rpm |
| 48 | |
| 49 | #get fresh CRLs now |
| 50 | /usr/sbin/fetch-crl |
| 51 | |
| 52 | #install cron job for it |
| 53 | cat > /etc/cron.daily/fetch-crl.cron << EOF |
| 54 | #!/bin/sh |
| 55 | /usr/sbin/fetch-crl |
| 56 | EOF |
| 57 | |
| 58 | chmod a+x /etc/cron.daily/fetch-crl.cron |
| 59 | }}} |
| 60 | }}} |
| 61 | * '''Proxy credential''' |
| 62 | |
| 63 | = Installation = |
| 64 | The package is designed for Scientific Linux 5.x (recommended and tested version is 5.5). |
| 65 | The installation process requires root privileges. |
| 66 | |
| 67 | * Install PL-Grid or/and QCG repositories: |
| 68 | * Official PL-Grid repository |
| 69 | {{{ |
| 70 | #!div style="font-size: 90%" |
| 71 | {{{#!sh |
| 72 | rpm -Uvh http://software.plgrid.pl/packages/repos/plgrid-repos-2010-2.noarch.rpm |
| 73 | }}} |
| 74 | }}} |
| 75 | * !QosCosGrid testing repository |
| 76 | {{{ |
| 77 | #!div style="font-size: 90%" |
| 78 | {{{#!sh |
| 79 | cat > /etc/yum.repos.d/qcg.repo << EOF |
| 80 | [qcg] |
| 81 | name=QosCosGrid YUM repository |
| 82 | baseurl=http://fury.man.poznan.pl/qcg-packages/sl/x86_64/ |
| 83 | enabled=1 |
| 84 | gpgcheck=0 |
| 85 | EOF |
| 86 | }}} |
| 87 | }}} |
| 88 | * install QCG-Broker Nagios Probe YUM Package Manager: |
| 89 | {{{ |
| 90 | #!div style="font-size: 90%" |
| 91 | {{{#!sh |
| 92 | yum install nagios-plugins-qcg-broker |
| 93 | }}} |
| 94 | }}} |
| 95 | |
| 96 | |
| 97 | = Usage = |
| 98 | |
| 99 | qcg-nagios -H host [-p port] -n dn -x proxy [-t timeout -v -V -j jobdesc] |
| 100 | -v - verbose |
| 101 | -V - help |
| 102 | |
| 103 | == Usage example == |
| 104 | |
| 105 | /usr/libexec/grid-monitoring/probes/pl.plgrid/QCG-Broker-probes/qcg-nagios \ |
| 106 | -H elder7.man.poznan.pl \ |
| 107 | -p 8443 |
| 108 | -n /C=PL/O=GRID/O=PSNC/CN=grms/elder7.man.poznan.pl \ |
| 109 | -x /tmp/x509up_u500 \ |
| 110 | /usr/libexec/grid-monitoring/probes/pl.plgrid/QCG-Broker-probes/examples/example1.xml |