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.5.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.4+ from external repositories.

    • Debian (Wheezy) and Ubuntu (Trusty) comes with older versions of PostgreSQL, so steps are taken to automatically utilize the PostgreSQL community’s apt sources. (For complete details, see: https://wiki.postgresql.org/wiki/Apt)
    • Debian (Jessie) and Ubuntu (Xenial) comes with PostgreSQL 9.4+, so no additional steps are required.
  3. Issue the following commands as the root Linux account to install prerequisites using the Makefile.install prerequisite installer, substituting debian-jessie, debian-wheezy, ubuntu-xenial, or ubuntu-trusty for <osname> below:

    make -f Open-ILS/src/extras/Makefile.install <osname>
  4. 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

  5. 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 translations, use the <osname>-translator Makefile.install target.

      make -f Open-ILS/src/extras/Makefile.install <osname>-translator
    • 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