= QCG Broker Client Installation =

[[PageOutline]] 


= Requirements =
* '''Packages requirements'''. 
 All packages required by QCG-Broker client will be automatically installed by YUM during the installation of qcg-broker-client package.
 * '''Java (>= 1.5)'''\\
* '''trusted CA certificates'''
 To enable secure communication between client and QCG-Broker service set of trusted CA certificates must be copied either into the `/etc/grid-security/certificates` directory or configured for every user.

* '''For the PL-Grid project: Install Polish Grid and PL-Grid Simple-CA certificates:'''
 * Add appropriate YUM repositories
{{{
#!div style="font-size: 90%"
{{{#!sh
cat > /etc/yum.repos.d/plgrid.repo << EOF
[PLGRID-general]
name=PLGRID general packages repository
baseurl=http://software.plgrid.pl/packages/general/
enabled=1
metadata_expire=300
gpgcheck=0
EOF
}}}
}}}

{{{
#!div style="font-size: 90%"
{{{#!sh
cat > /etc/yum.repos.d/eugridpma.repo << EOF
[EUGRIDPMA-igtf]
name=EUGRIDPMA igtf repository
baseurl=https://dist.eugridpma.info/distribution/igtf/current
enabled=1
metadata_expire=300
gpgcheck=0

[EUGRIDPMA-fetch-crl]
name=EUGRIDPMA fetch-crl repository
baseurl=https://dist.eugridpma.info/distribution/util/fetch-crl/
enabled=1
metadata_expire=300
gpgcheck=0
EOF
}}}
}}}

 * Install certificates
{{{
#!div style="font-size: 90%"
{{{#!sh
yum install ca_PolishGrid
yum install ca_PLGRID-SimpleCA
}}}
}}}

 * Install certificate revocation list fetching utility 
{{{
#!div style="font-size: 90%"
{{{#!sh
yum install fetch-crl
}}}
}}}

 * Get fresh CRLs now
{{{
#!div style="font-size: 90%"
{{{#!sh
/usr/sbin/fetch-crl 
}}}
}}}

 * Install cron job for it
{{{
#!div style="font-size: 90%"
{{{#!sh
cat > /etc/cron.daily/fetch-crl.cron << EOF
#!/bin/sh 
/usr/sbin/fetch-crl
EOF
}}}
}}}

{{{
#!div style="font-size: 90%"
{{{#!sh
chmod a+x /etc/cron.daily/fetch-crl.cron
}}}
}}}

= 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 client using YUM Package Manager:
{{{
#!div style="font-size: 90%"
{{{#!sh
yum install qcg-broker-client
}}}
}}}


* setup deployment configuration - all configuration variables are placed in `/opt/plgrid/qcg/share/qcg-broker-client/client-deploy.prop` file
 * '''client.deploy.dir''' - directory where the QCG-Broker client was installed (`/opt/plgrid/qcg/share/qcg-broker-client`). Please do not modify this property.
 * '''client.service.host''' - QCG-Broker service hostname
 * '''client.service.port''' - QCG-Broker service port
 * '''client.service.dn''' - QCG-Broker credential DN
{{{
#!div style="font-size: 90%"
{{{#!sh
vim /opt/plgrid/qcg/qcg-broker/client/etc/qcg-broker-client.conf
}}}
}}}
*  configure QCG-Broker command-line client 
{{{
#!div style="font-size: 90%"
{{{#!sh
/opt/plgrid/qcg/share/qcg-broker-client/config.sh
}}}
}}}


= Usage =
For the description how to use the QCG-Broker client please see the [[client_user_guide|QCG-Broker User Guide]].