= QCG Broker Client Installation = [[PageOutline]] = Requirements = * '''Required Packages''' * '''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.44-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 }}} }}} = Installation = The client can be installed using the QCG-Broker precompiled source distribution. This kind of installation is designed for every Linux distribution meeting described above requirements. The installation can be performed as well by system administrator (to deploy one common instance of client accesible for all users) as every regular user (that wants to have his own instance of client). === Downloading distribution === * download the [[http://www.qoscosgrid.org/trac/qcg-broker/downloads/qcg-broker-2.0.0.tar.gz | QCG-Broker source installer]] from [[http://www.qoscosgrid.org/trac/qcg-broker/downloads | Downloads]] {{{ #!div style="font-size: 90%" {{{#!sh wget http://www.qoscosgrid.org/trac/qcg-broker/downloads/qcg-broker.tar.gz }}} }}} * unpack the archive {{{ #!div style="font-size: 90%" {{{#!sh tar xzf qcg-broker.tgz }}} }}} === Compilation === The distribution contains precompiled version of QCB-Broker command-line client, that can be deployed as it is. The compilation step is optional and can be skiped, except the situation in which some specific compiler options should be added or changed. * compile sources {{{ #!div style="font-size: 90%" {{{#!sh cd qcg-broker- ant client-stubs client }}} }}} === Setup === * setup deployment configuration - all configuration variables are placed in `client-deploy.prop` file * '''client.deploy.dir''' - directory where QCG-Broker client will be deployed * '''client.service.host''' - QCG-Broker service hostname * '''client.service.port''' - QCG-Broker service port * '''client.service.dn''' - QCG-Broker credential DN === Deployment === * deploy QCG-Broker command-line client {{{ #!div style="font-size: 90%" {{{#!sh ant deploy-client }}} }}} = Usage = For the description how to use the QCG-Broker client please see the [[client_user_guide|QCG-Broker User Guide]]. = License = For license details please visit the [http://www.qoscosgrid.org/trac/qcg/wiki/license QCG License] page.