User Tools

Site Tools


Upgrading Evergreen 2.0.2 to 2.0.3

  • If you are currently on a version before 2.0.2, make sure you follow the upgrade instructions for all previous releases up to 2.0.2.
  1. As Root, Stop Apache.
  2. Stop all Evergreen and OpenSRF services. As the opensrf user: -l -a stop_all
    1. NOTE: You may skip this step if the latest version of OpenSRF 1.6.x was previously installed.
  3. Download and build Evergreen:
    1. As the opensrf user, download and extract the latest version of Evergreen (
      tar xzf Evergreen-ILS-2.0.3.tar.gz
    2. As the root user, install the prerequisites. Replace <distribution> below with one of these values for your actual distribution:
      • debian-sqeeze for Debian Squeeze
      • ubuntu-lucid for Ubuntu Lucid Lynx (10.04)
        cd /home/opensrf/Evergreen-ILS-2.0.3
        make -f Open-ILS/src/extras/Makefile.install <distribution>
    3. As the opensrf user, configure and compile Evergreen:
      cd /home/opensrf/Evergreen-ILS-2.0.3
      ./configure --prefix=/openils --sysconfdir=/openils/conf
    4. As the root user, install Evergreen:
      make STAFF_CLIENT_BUILD_ID=rel_2_0_3 install
    5. As the root user, change all files to be owned by the opensrf user/group:
      sudo chown -R opensrf:opensrf /openils
    6. As the opensrf user, update configuration files:
      cd /home/opensrf/Evergreen-ILS-2.0.3
      # and for the offline staff client data uploader
      perl Open-ILS/src/support-scripts/ \
        --create-offline --user evergreen --password evergreen \
        --hostname localhost --port 5432 --database evergreen
    7. As the opensrf user, update server symlink in /openils/var/web/xul/:
      cd /openils/var/web/xul/
      rm server
      ln -s rel_2_0_3/server server
  4. Upgrade the database:
    1. NOTE: it is recommended that you back up your Evergreen database in order to restore your data if anything goes wrong
    2. cd /home/opensrf/Evergreen-ILS-2.0.3
      psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.2-2.0.3-upgrade-db.sql evergreen
  5. Start all Evergreen and OpenSRF services. As the opensrf user: -l -a start_all
  6. As Root, Start Apache.
  7. As the opensrf user, run autogen to refresh the static organizational data files:
    cd /openils/bin
    ./ -c /openils/conf/opensrf_core.xml -u
  8. Generate and run a reingest SQL script using the reingest script generation script:
    cd /home/opensrf/Evergreen-ILS-2.0.3
    perl Open-ILS/src/sql/Pg/ --config /openils/conf/opensrf_core.xml --chunk_size 10000
    psql -U evergreen -h localhost -f reingest-1.6-2.0.sql evergreen
  9. Note: SQL file will be created in the current directory.
  10. Note This takes a long time if you have a lot of bibs and they can be run concurrently.
  1. Troubleshooting:

If you run into errors, see: Troubleshooting: Checking for Errors for help finding errors in the log files. You may also ask the evergreen community using the mailing lists. Including error information from the logs will be extremely helpful when seeking assistance.

upgrading/evergreen/2.0.2_to_2.0.3.txt · Last modified: 2011/04/19 23:07 by swills

© 2008-2017 GPLS and others. Evergreen is open source software, freely licensed under GNU GPLv2 or later.
The Evergreen Project is a member of Software Freedom Conservancy.