Changes between Version 39 and Version 40 of installation_guide_rpm

Show
Ignore:
Timestamp:
06/19/13 13:48:30 (11 years ago)
Author:
pkopta
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • installation_guide_rpm

    v39 v40  
    2222To install QCG-Broker service please configure the system with [[http://www.qoscosgrid.org/trac/qcg/wiki/Software%20repositories | QCG Software Repositories]]. 
    2323 
    24 == Creation of the user == 
    25  '''IMPORTANT:''' Although it's possible to run QCG-Broker service on any account (`root`, regular user) we strongly recommend to run QCG-Broker service on the unprivileged account designated specifically for this service (`qcg-broker` for example). 
    26  
    27 We recommend to create a new user (e.g. `qcg-broker`) that will be used by the service to run in unprivileged mode. 
    28 Please create the qcg-broker user (as root). 
    29 {{{ 
    30 #!div style="font-size: 90%" 
    31 {{{#!sh   
    32 useradd -m -s /bin/bash qcg-broker  
    33 }}} 
    34 }}} 
    35  
    36 == Configuration of the range of opened ports == 
    37 * Please specify the range of opened ports for communication with NotificationsService and gridFTP 
    38   
    39 The port range must be set in ~/.globus/cog.properties file. 
    40 {{{#!sh 
    41 su - qcg-broker 
    42 mkdir -p ~/.globus 
    43 echo "tcp.port.range=5000,5100" >> ~/.globus/cog.properties 
    44 }}} 
     24= Installation = 
     25 
     26'''IMPORTANT:''' Perform the installation as the administrator (`root` user). 
     27 
     28'''IMPORTANT:''' A new account (`qcg-broker`) will be created during the installation. 
     29 
     30* install QCG-Broker service and all dependencies using YUM Package Manager: 
     31{{{ 
     32#!div style="font-size: 90%" 
     33{{{#!sh 
     34yum install qcg-broker 
     35}}} 
     36}}} 
     37 
     38= Configuration = 
    4539 
    4640== Database setup == 
     41* If PostgreSQL service has not been initialized (e.g. has been installed as dependency of qcg-broker package), perform initialization before service starting: 
     42{{{ 
     43#!div style="font-size: 90%" 
     44{{{#!sh 
     45su - 
     46service postgresql initdb 
     47}}} 
     48}}} 
     49 
    4750* Start the PostgreSQL service: 
    4851{{{ 
    … …  
    105108}}} 
    106109 
    107 = Installation = 
    108  
    109 '''IMPORTANT:''' Perform the installation as the administrator (`root` user). 
    110  
    111 * install QCG-Broker service and all dependencies using YUM Package Manager: 
    112 {{{ 
    113 #!div style="font-size: 90%" 
    114 {{{#!sh 
    115 yum install qcg-broker 
     110 
     111== QCG Broker setup == 
     112 
     113'''Note:''' All changes should be made as 'qcg-broker' user: 
     114{{{ 
     115#!div style="font-size: 90%" 
     116{{{#!sh 
     117su - qcg-broker 
    116118}}} 
    117119}}} 
    … …  
    138140}}} 
    139141 
    140 = Configuration = 
    141 * Edit the `QCG-BROKER-DEPLOY_DIR/broker/etc/providers.list` file specifying list of resource providers (instances of QCG BES/AR services controlling resources and creating together virtual pool of resources) 
     142 
     143== QCG Broker resource providers setup == 
     144'''Note:''' All changes should be made as 'qcg-broker' user: 
     145{{{ 
     146#!div style="font-size: 90%" 
     147{{{#!sh 
     148su - qcg-broker 
     149}}} 
     150}}} 
     151 
     152* Edit the `/opt/plgrid/qcg/share/qcg-broker/broker/etc/providers.list` file specifying list of resource providers (instances of QCG BES/AR services controlling resources and creating together virtual pool of resources) 
    142153 
    143154 '''providers.count'''=<n> - number of providers 
    … …  
    173184}}} 
    174185 
    175 * For cross-clusters job submission, edit the `QCG-BROKER_DEPLOY_DIR/broker/etc/config.prop` file, and set following variables: 
     186* For cross-clusters job submission, edit the `/opt/plgrid/qcg/share/qcg-broker/broker/etc/config.prop` file, and set following variables: 
    176187 * '''broker.qoscos.proactive.pncURL''' - !ProActvie node coordinator address 
    177188 * '''broker.qoscos.ompi.pncURL''' - OpenMPI node coordinator address 
    … …  
    179190 See [http://www.qoscosgrid.org/trac/qcg/wiki/installation_QCG_ProActive_Coordinator QCG-ProActive Coordinator], [http://www.qoscosgrid.org/trac/qcg/wiki/installation_QCG_OpenMPI_Coordinator QCG-OpenMPI Coordinator] for detailed information about installation of !ProActive and OpenMPI node coordinators. 
    180191 
    181 = Resource Providers setup = 
     192 
     193== QCG Broker advance reservations setup (optional) == 
     194 
     195'''Note:''' All changes should be made as 'qcg-broker' user: 
     196{{{ 
     197#!div style="font-size: 90%" 
     198{{{#!sh 
     199su - qcg-broker 
     200}}} 
     201}}} 
     202 
    182203To allow QCG-Broker  to create and manage advance reservations on resources accessible via [http://apps.man.poznan.pl/trac/qcg-computing QCG BES/AR] service some additional configuration steps are needed on Administrative Domain level:  
    183204* 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.: 
    … …  
    189210}}} 
    190211 
     212 
    191213= Starting the service = 
    192214As the `qcg-broker` user type: 
    … …  
    195217{{{#!sh 
    196218cd /opt/plgrid/qcg/share/qcg-broker 
     219export JAVA_HOME=/usr/lib/jvm/java 
    197220./broker/bin/start-broker.sh 
    198 export JAVA_HOME=/usr/lib/jvm/java; ./service/bin/startup.sh 
     221./service/bin/startup.sh 
    199222}}} 
    200223}}} 
    … …  
    207230{{{#!sh 
    208231cd /opt/plgrid/qcg/share/qcg-broker 
     232export JAVA_HOME=/usr/lib/jvm/java 
    209233./broker/bin/stop-broker.sh 
    210 export JAVA_HOME=/usr/lib/jvm/java; ./service/bin/shutdown.sh 
     234./service/bin/shutdown.sh 
    211235}}} 
    212236}}}