= QCG Broker Nagios Probe Installation =

[[PageOutline]] 

= Requirements =
* '''Packages requirements'''. 
 All packages required by QCG-Broker client will be automatically instaled by YUM during the installation of qcg-broker-client package.
 * '''Java (>= 1.5)'''\\
{{{
#!div style="font-size: 90%"
For SL5.x
{{{#!sh
yum install java-1.6.0-sun-compat.x86_64
}}}
}}}
 * '''Apache Ant''' (>= 1.6) ("Optional tasks for ant" are required. For SL5.x the ''ant-nodeps.x86_64'' package must be installed)
{{{
#!div style="font-size: 90%"
For SL5.x
{{{#!sh
yum install ant.x86_64 ant-nodeps.x86_64
}}}
}}}
 * '''xml-commons-apis''' - installation of this package is not mandatory, but is recommended to avoid confusing information about not important errors.
{{{
#!div style="font-size: 90%"
For SL5.x
{{{#!sh
yum install xml-commons.x86_64 xml-commons-apis.x86_64
}}}
}}}
* '''trusted CA certificates'''
 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.

 For the PL-Grid project: Install Polish Grid and PL-Grid Simpla-CA certificates:
{{{
#!div style="font-size: 90%"
{{{#!sh
wget https://dist.eugridpma.info/distribution/igtf/current/accredited/RPMS/ca_PolishGrid-1.42-1.noarch.rpm
wget http://software.plgrid.pl/packages/general/ca_PLGRID-SimpleCA-1.0-2.noarch.rpm
wget https://dist.eugridpma.info/distribution/util/fetch-crl/fetch-crl-2.8.5-1.noarch.rpm

rpm -i ca_PolishGrid-1.40-1.noarch.rpm 
rpm -i ca_PLGRID-SimpleCA-1.0-2.noarch.rpm 

#install certificate revocation list fetching utility 
rpm -i fetch-crl-2.8.5-1.noarch.rpm

#get fresh CRLs now
/usr/sbin/fetch-crl 

#install cron job for it
cat > /etc/cron.daily/fetch-crl.cron << EOF
#!/bin/sh 
/usr/sbin/fetch-crl
EOF

chmod a+x /etc/cron.daily/fetch-crl.cron
}}}
}}}
* '''Proxy credential'''

= Installation =
The package is designed for Scientific Linux 5.x (recommended and tested version is 5.5).
The installation process requires root privileges.

* Install PL-Grid or/and QCG repositories:
 * Official PL-Grid repository
{{{
#!div style="font-size: 90%"
{{{#!sh
rpm -Uvh http://software.plgrid.pl/packages/repos/plgrid-repos-2010-2.noarch.rpm
}}}
}}}
 * !QosCosGrid testing repository
{{{
#!div style="font-size: 90%"
{{{#!sh
cat > /etc/yum.repos.d/qcg.repo << EOF
[qcg]
name=QosCosGrid YUM repository
baseurl=http://fury.man.poznan.pl/qcg-packages/sl/x86_64/
enabled=1
gpgcheck=0
EOF
}}}
}}}
* install QCG-Broker Nagios Probe YUM Package Manager:
{{{
#!div style="font-size: 90%"
{{{#!sh
yum install nagios-plugins-qcg-broker
}}}
}}}


= Usage =

'''qcg-nagios -H host [-p port] -n dn -x proxy [-t timeout -v -V -j jobdesc]'''
'''qcg-nagios -u url -n dn -x proxy [-t timeout -v -V -j jobdesc]'''

'''-v - verbose'''

'''-V - help'''

== Usage example ==
{{{#!sh
/usr/libexec/grid-monitoring/probes/pl.plgrid/QCG-Broker-probes/qcg-nagios \
                        -H elder7.man.poznan.pl \
                        -p 8443 \
                        -n /C=PL/O=GRID/O=PSNC/CN=qcg-broker/hostname.domain \
                        -x /tmp/x509up_u500 \
                        /usr/libexec/grid-monitoring/probes/pl.plgrid/QCG-Broker-probes/examples/example1.xml

}}}
  
{{{#!sh
/usr/libexec/grid-monitoring/probes/pl.plgrid/QCG-Broker-probes/qcg-nagios \
                        -u https://hostname.domain:8443/qcg/services/JobFactory \
                        -n /C=PL/O=GRID/O=PSNC/CN=qcg-broker/hostname.domain \
                        -x /tmp/x509up_u500 \
                        /usr/libexec/grid-monitoring/probes/pl.plgrid/QCG-Broker-probes/examples/example1.xml

}}}