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.4.0 or later). You can download OpenSRF releases from http://evergreen-ils.org/opensrf-downloads/
  2. On some distributions, it is necessary to install PostgreSQL 9.1+ from external repositories.

    • Debian (Wheezy and Jessie) and Ubuntu (Trusty and Xenial) comes with PostgreSQL 9.1+, so no additional steps are required.
    • Fedora 19 and 20 come with PostgreSQL 9.2+, 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-jessie, debian-wheezy, fedora, ubuntu-xenial, or ubuntu-trusty 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 Trusty, Ubuntu Xenial or Debian Jessie. The Ubuntu and Debian Jessie targets use libdbd-pgsql from packages.

    Debian Wheezy. 

    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

  6. OPTIONAL: Developer additions

    To perform certain developer tasks from a Git source code checkout, additional packages may be required. As the root Linux account:

    • To install packages needed for retrieving and managing web dependencies, use the <osname>-developer Makefile.install target. Currently, this is only needed for building and installing the (preview) browser staff client.

      make -f Open-ILS/src/extras/Makefile.install <osname>-developer
    • To install packages required for building Evergreen release bundles, use the <osname>-packager Makefile.install target.

      make -f Open-ILS/src/extras/Makefile.install <osname>-packager