User Tools

Site Tools


Installing an Evergreen cluster on Redhat

Obviously this document is a little dated now anyway, and the reader should know that as of May 2012 RHEL and CentOS targets in the prerequisites installer "Makefile.install" have been removed. It's not that we think it's impossible to get Evergreen working on these systems (we know it isn't, at least in the former case), but that we haven't had anyone share with the community up-to-date working Redhat configs or volunteer to test them. Start here if you want to resurrect what we had from our version control system to try to get it working again:;a=shortlog;h=refs/heads/user/dbs/update_makefile_prereqs

On a typical cluster install you will have an apache server, multiple drones, a database server, and a utility server. You will need to refer to this document for the next few steps: Installation instructions for OpenSRF trunk on redhat

  1. On every server except the database server follow all the steps stopping after the "make install" step.
  2. On the apache server follow the rest of the instructions.
  3. If you want to put the memcached server somewhere other than the apache server then run the memcached chkconfig command there. We typically use the util server for memcached but you can put it anywhere that makes sense.
  4. On the database server you can stop after the "make -f src/extras/Makefile.install rhel" step.

Now you will need to use various parts of this document on the various servers: Installation instructions for Evergreen trunk on redhat

Database server configuration:

  1. Follow the instructions down to the "make -f Open-ILS/src/extras/Makefile.install rhel" step

Drone&Util server configuration:

  1. Follow the entire length of the instructions stopping after the "make STAFF_CLIENT_BUILD_ID=current install" step
  2. Be sure and skip the postgresql configuration steps.

Apache server configuration:

  1. On the apache server follow all of the instructions.
  2. For the postgresql steps remember to perform these steps on the database server, not the apache server. When you get to the pg_hba.conf section edit it with the following lines replacing the marked sections with your network info:
    local all all trust 
    host all all md5
    host all all <> <local.subnet> md5
  3. Now edit /var/lib/pgsql/data/postgresql.conf and edit the line:
    “listen_addresses = 'localhost'” 
    to look like 
    “listen_addresses = 'localhost,'”
    Obviously replace my ip address with yours.
  4. Run the perl Open-ILS/src/support-scripts/ command from the apache server
  5. Now edit opensrf.xml, fill in the db information in every place that asks for it. At the bottom, you want to make a section for your apache machine, each drone machine, and the util machine. The apache config should only contain the settings module. The drones config should contain every module but settings. The util config should run every module. Delete the localhost config.
  6. Export /openils and /usr/lib/perl5/site_perl/5.8.8 via NFS and mount those directories on your drone&util servers.
  7. Install ssh keys from the opensrf user on apache to the opensrf user on the drones and util server. As the opensrf user:
    scp ~/.ssh/ opensrf@target.machine:.ssh/authorized_keys2
  8. As the opensrf user, download the script and it's corresponding config file. Edit it the config file to contain your settings:
    cd /openils/bin
    chmod +x
    cd ~
    mv oils_brick.cfg.example .oils_brick.cfg
    vi .oils_brick.cfg
  9. Start up your cluster as the opensrf user! -a start_all
redhat_evergreen_cluster.txt · Last modified: 2022/02/10 13:34 by

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki

© 2008-2022 GPLS and others. Evergreen is open source software, freely licensed under GNU GPLv2 or later.
The Evergreen Project is a U.S. 501(c)3 non-profit organization.