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 (3.0.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.

    • Ubuntu (Trusty) comes with an older version of PostgreSQL and Ubuntu (Bionic) comes with a newer version 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/Stretch) 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-stretch,debian-jessie,ubuntu-bionic,ubuntu-xenial, or ubuntu-trusty for <osname> below:

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