qcg-broker
) that will be used by the service to run in unprivileged mode
mkdir -p /opt/QCG
useradd -d /opt/QCG/qcg-broker -m -s /bin/bash qcg-broker
'''IMPORTANT:''' If you want to configure QCG-Broker to use its own list of trusted CA certificates, please do not forget to copy them into ''~/.globus/certificates'' directory.
= Database setup =
* Create new database user (e.g. qcg-broker) authenticated via password (the same password must be later used to setup QCG-Broker deployment):
su - postgres
createuser -P qcg-broker
Enter password for new role:
Enter it again:
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) n
CREATE ROLE
exit
* Create new database (e.g. qcg-broker) owned by the ''qcg-broker'' user:
su - qcg-broker
createdb -U qcg-broker qcg-broker
exit
{{Note}} The ''qcg-broker'' user must be allowed to create new databases
* Depending on the local PostgreSQL configuration you may need to edit the pg_hba.conf
file (''host based authentication'' configuration file) to enable password authentication to the ''qcg-broker'' database for the ''qcg-broker'' user.
For SL5.x: edit the ''/var/lib/pgsql/data/pg_hba.conf'' file.
If the PostgreSQL installation is fully dedicated for QCG-Broker replace the default configuration with rules (lines) given below, otherwise insert them to the configuration file in a proper place:
local qcg-broker qcg-broker md5
host qcg-broker qcg-broker 127.0.0.1/32 md5
{{Note|}} You must reload the PostgreSQL server in order to make the changes visible e.g:
service postgresql reload
=Installation=
'''IMPORTANT:''' Perform the installation as the "qcg-broker" user.
su - qcg-broker
* download the QCG-Broker archive from [http://node2.qoscosgrid.man.poznan.pl/~piontek/qcg-broker/qcg-broker.tgz qcg-broker.tgz]
wget http://node2.qoscosgrid.man.poznan.pl/~piontek/qcg-broker/qcg-broker.tgz
* unpack the archive
tar xzf qcg-broker.tgz
== Compilation [Optional step]==
The distribution contains precompiled version of QCB-Broker, 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
cd qcg-broker-# how many providers should be used for testing providers.count=1 provider.0.domain=PSNC provider.0.id=qcg_cluster provider.0.type=qcg-bes provider.0.location=httpg://qcg.man.poznan.pl:19000* For cross-clusters job submission, edit ''QCG-BROKER_DEPLOY_DIR/broker/etc/config.prop'' file, and set following variables: ** '''broker.qoscos.proactive.pncURL''' - ProActvie node coordinator address ** '''broker.qoscos.ompi.pncURL''' - OpenMPI node coordinator address See [[QCG-ProActive Coordinator]], [[QCG-OMPI Coordinator]] for detailed information about installation of 'ProActive' and 'OpenMPI' node coordinators. = Resource Providers setup = To allow QCG-Broker to create and manage advance reservations on resources accessible via [[SMOA Computing]] service some additional configuration steps are needed on Administrative Domain level. * the QCG-Broker credential must be mapped (in the
grid-mapfile
file) to the local user that is authorized to create and manage reservations. Usually the LRMS administrator user (like sgeadmin
in SGE or lsfadmin
in LSF) has sufficient rights, e.g.:
"/C=PL/O=GRID/O=PSNC/CN=qcg-broker/qcg.man.poznan.pl" sgeadmin
= Starting the service =
As the qcg-broker user type:
cd /opt/QCG/qcg-broker/service
./broker/bin/start-broker.sh
./service/bin/startup.sh
'''IMPORTANT:''' Do not forget to set ''JAVA_HOME'' or ''JRE_HOME'' environment variables.
= Stopping the service =
As the qcg-broker user type:
cd /opt/QCG/qcg-broker/service
./broker/bin/stop-broker.sh
./service/bin/shutdown.sh
= Veryfing the installation =
To verify the installtion please use [[QCG-BROKER CLIENT]].