Installing prerequisites

Evergreen has a number of prerequisite packages that must be installed before you can successfully configure, compile, and install Evergreen.

  1. Begin by installing the most recent version of OpenSRF (2.3.0 or later). You can download OpenSRF releases from http://evergreen-ils.org/opensrf-downloads/
  2. On many distributions, it is necessary to install PostgreSQL 9 from external repositories.

    • On Debian Squeeze, open /etc/apt/sources.list in a text editor as the root Linux account and add the following line:

      deb http://backports.debian.org/debian-backports squeeze-backports main contrib
    • On Ubuntu Lucid, you can use a PPA (personal package archive), which are package sources hosted on Launchpad. The one most commonly used by Evergreen Community members is maintained by Martin Pitt, who also maintains the official PostgreSQL packages for Ubuntu. As the root Linux account, issue the following commands to add the PPA source:

      apt-get install python-software-properties
      add-apt-repository ppa:pitti/postgresql
    • Ubuntu Precise comes with PostgreSQL 9, so no additional steps are required.
    • Fedora comes with PostgreSQL 9, so no additional steps are required.
  3. On Debian and Ubuntu, run aptitude update as the root Linux account to retrieve the new packages from the backports repository.
  4. Issue the following commands as the root Linux account to install prerequisites using the Makefile.install prerequisite installer, substituting debian-squeeze, debian-wheezy, fedora, ubuntu-lucid, or ubuntu-precise for <osname> below:

    make -f Open-ILS/src/extras/Makefile.install <osname>
  5. Add the libdbi-libdbd libraries to the system dynamic library path by issuing the following commands as the root Linux account:

    Note

    You should skip this step if installing on Ubuntu Precise. The ubuntu-precise target uses libdbd-pgsql from packages.

    Debian / Ubuntu Lucid. 

    echo "/usr/local/lib/dbd" > /etc/ld.so.conf.d/eg.conf
    ldconfig

    Fedora. 

    echo "/usr/lib64/dbd" > /etc/ld.so.conf.d/eg.conf
    ldconfig