Changes between Version 1 and Version 2 of NagiosProbes

Show
Ignore:
Timestamp:
03/27/13 14:08:21 (11 years ago)
Author:
piontek
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • NagiosProbes

    v1 v2  
    1 '''QCG-Broker Nagios Probe - ver. 2.6''' 
     1= QCG Broker Nagios Probe Installation = 
    22 
    3 = Introduction = 
     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%" 
     11For SL5.x 
     12{{{#!sh 
     13yum 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%" 
     19For SL5.x 
     20{{{#!sh 
     21yum 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%" 
     27For SL5.x 
     28{{{#!sh 
     29yum 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 
     39wget https://dist.eugridpma.info/distribution/igtf/current/accredited/RPMS/ca_PolishGrid-1.42-1.noarch.rpm 
     40wget http://software.plgrid.pl/packages/general/ca_PLGRID-SimpleCA-1.0-2.noarch.rpm 
     41wget https://dist.eugridpma.info/distribution/util/fetch-crl/fetch-crl-2.8.5-1.noarch.rpm 
     42 
     43rpm -i ca_PolishGrid-1.40-1.noarch.rpm  
     44rpm -i ca_PLGRID-SimpleCA-1.0-2.noarch.rpm  
     45 
     46#install certificate revocation list fetching utility  
     47rpm -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 
     53cat > /etc/cron.daily/fetch-crl.cron << EOF 
     54#!/bin/sh  
     55/usr/sbin/fetch-crl 
     56EOF 
     57 
     58chmod a+x /etc/cron.daily/fetch-crl.cron 
     59}}} 
     60}}} 
     61* '''Proxy credential''' 
     62 
     63= Installation = 
     64The package is designed for Scientific Linux 5.x (recommended and tested version is 5.5). 
     65The 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 
     72rpm -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 
     79cat > /etc/yum.repos.d/qcg.repo << EOF 
     80[qcg] 
     81name=QosCosGrid YUM repository 
     82baseurl=http://fury.man.poznan.pl/qcg-packages/sl/x86_64/ 
     83enabled=1 
     84gpgcheck=0 
     85EOF 
     86}}} 
     87}}} 
     88* install QCG-Broker Nagios Probe YUM Package Manager: 
     89{{{ 
     90#!div style="font-size: 90%" 
     91{{{#!sh 
     92yum install nagios-plugins-qcg-broker 
     93}}} 
     94}}} 
     95 
    496 
    597= Usage = 
    698 
    7 ./qcg_nagios -H hostname [-p port] -n dn -x proxy [-t timeout -v -V] jobdesc 
     99'''qcg-nagios -H host [-p port] -n dn -x proxy [-t timeout -v -V -j jobdesc]''' 
     100'''qcg-nagios -u url -n dn -x proxy [-t timeout -v -V -j jobdesc]''' 
    8101 
    9 -'''H hostname''' - QCG-Broker host 
     102'''-v - verbose''' 
    10103 
    11 -'''p port''' - QCG-Broker port 
     104'''-V - help''' 
    12105 
    13 -'''l url''' - QCG-Broker url (can be used as alternative to hostname and port) 
     106== Usage example == 
     107{{{#!sh 
     108/usr/libexec/grid-monitoring/probes/pl.plgrid/QCG-Broker-probes/qcg-nagios \ 
     109                        -H elder7.man.poznan.pl \ 
     110                        -p 8443 \ 
     111                        -n /C=PL/O=GRID/O=PSNC/CN=qcg-broker/hostname.domain \ 
     112                        -x /tmp/x509up_u500 \ 
     113                        /usr/libexec/grid-monitoring/probes/pl.plgrid/QCG-Broker-probes/examples/example1.xml 
    14114 
    15 -'''n dn''' - distinguished name of QCG-Broker service 
     115}}} 
     116   
     117{{{#!sh 
     118/usr/libexec/grid-monitoring/probes/pl.plgrid/QCG-Broker-probes/qcg-nagios \ 
     119                        -u https://hostname.domain:8443/qcg/services/JobFactory \ 
     120                        -n /C=PL/O=GRID/O=PSNC/CN=qcg-broker/hostname.domain \ 
     121                        -x /tmp/x509up_u500 \ 
     122                        /usr/libexec/grid-monitoring/probes/pl.plgrid/QCG-Broker-probes/examples/example1.xml 
    16123 
    17 -'''x proxy''' - proxy certificate of QCG-Broker client  
     124}}} 
    18125 
    19 -'''t timeout''' - test timout given in seconds 
    20  
    21 -'''v/V''' - verbose mode                                                                                                                
    22                                                                                                                                
    23 jobdesc - job description                                                                                                               
    24  
    25 = Example = 
    26  
    27   ./qcg-nagios -H qcg-broker.man.poznan.pl -p 8443 \ 
    28                -n /C=PL/O=GRID/O=PSNC/CN=qcg-broker/qcg-broker.man.poznan.pl \ 
    29                -x /tmp/x509up_u500 \ 
    30                ./examples/example1.xml  
    31126 
    32127= Exit Codes =