User Tools

Site Tools


Upgrading Evergreen from a 1.2.x release to

  1. Install new and upgraded prerequisites. The easiest way to do this is to use the Makefile.install prerequisite installer; it will skip any prerequisites that are already installed on your system. Run the following command as root, where _distribution_ is one of debian or ubuntu:
    make -f Open-ILS/src/extras/Makefile.install _distribution_
  2. Install OpenSRF 1.0.7. See upgrading OpenSRF 0.9 to 1.0 for some gotchas. Otherwise, it's basically:
    ./configure --prefix=/openils --sysconfdir=/openils/conf
    make install
  3. Install Evergreen
    ./configure --prefix=/openils --sysconfdir=/openils/conf
    sudo make STAFF_CLIENT_BUILD_ID=rel_1_4_0_7 install
    # Build for the cgi-bin bootstrapping scripts
    # and for the offline staff client data uploader
    sudo perl Open-ILS/src/support-scripts/ \
      --create-bootstrap --create-offline --user evergreen --password evergreen \
      --hostname localhost --port 5432 --database evergreen
    # Change all files to be owned by the opensrf user/group
    chown -R opensrf:opensrf /openils
    1. From version 1.2 NOTE: it is recommended that you shut down PostgreSQL and make a copy of the data directory in order to restore to Evergreen 1.2 if anything goes wrong
      # Upgrading from Evergreen 1.2.3.x:
      psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.2.3-1.4-upgrade-db.sql
      # Or from Evergreen 1.2.4.x:
      psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.2.4-1.4-upgrade-db.sql
      # and then, for both:
      psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/
      psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/
      psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/
      psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/
      psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/
  1. Update opensrf_core.xml and opensrf.xml. A naive way would be to copy the new example files (/openils/conf/opensrf_core.xml.example and /openils/conf/opensrf.xml) and then update the username / password / hostname info and other customizations you might have made. The following step will automatically propagate database usernames and passwords into opensrf.xml:
    # Update opensrf.xml with the database connection info
    sudo perl Open-ILS/src/support-scripts/ --update-config \
      --service all --user evergreen --password evergreen --hostname localhost \
      --port 5432 --database evergreen

    See the OpenSRF install instructions and the Evergreen install instructions for information on setting up a multidomain OpenSRF environment. You will have to define new Jabber users and modify your Jabber configuration file to reflect the additional domains.

  2. Update Apache configuration:
    1. Update /etc/apache2/ with the example from Open-ILS/examples/apache/ (primarily to add the Vandelay Perl module).
    2. Update /etc/apache2/eg_vhost.conf with the example from Open-ILS/examples/apache/eg_vhost.conf for internationalization and JSON gateway format support.
    3. Update /etc/apache2/sites-available/eg.conf with the example from Open-ILS/examples/apache/eg.conf for internationalization support in the SlimPAC.
    4. Update the cached JavaScript with:
      sudo -u opensrf /openils/bin/ -c /openils/conf/opensrf_core.xml -u


  • Translation seed data for en-CA, fr-CA, hy-A and cs-CZ are available but not installed by default. See this page for instructions on installing these translations.
zzz_archive/upgrading/1.2_to_1.4.0/latest_version_of_evergreen.txt · Last modified: 2022/02/10 13:34 (external edit)

© 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.