User Tools

Site Tools


zzz_archive:upgrading:evergreen:1.4_to_2.0

Upgrading Evergreen 1.4 to 2.0

  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.2.0. It's basically:
    ./configure --prefix=/openils --sysconfdir=/openils/conf
    make
    make install
  3. Install Evergreen 1.6.
    ./autogen.sh
    ./configure --prefix=/openils --sysconfdir=/openils/conf
    make
    sudo make STAFF_CLIENT_BUILD_ID=foobar install
     
    # Build live-db-setup.pl for the cgi-bin bootstrapping scripts
    # and offline-config.pl for the offline staff client data uploader
    sudo perl Open-ILS/src/support-scripts/eg_db_config.pl \
      --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
  4. Upgrade the database
    1. From version 1.4.0.6 NOTE: it is recommended that you shut down Postgres and make a copy of the data directory in order to restore to Evergreen 1.4 if anything goes wrong
      # Upgrading from Evergreen 1.4.0.6:
      psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.4.0.5-1.6.0.0-upgrade-db.sql
  1. cp /openils/conf/oils_web.xml.example /openils/conf/oils_web.xml (needed for acquisitions templates)
  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/eg_db_config.pl --update-config \
      --service all --user evergreen --password evergreen --hostname localhost \
      --port 5432 --database evergreen
  2. (In the final release tarball, this step should not be necessary). Install the Dojo toolkit.
    1. Run the following commands as opensrf:
      wget http://download.dojotoolkit.org/release-1.3.2/dojo-release-1.3.2.tar.gz
      tar xzf dojo-release-1.3.2.tar.gz
    2. Then run this command as root:
      cp -r dojo-release-1.3.2/* /openils/var/web/js/dojo/.
  3. Update Apache configuration:
    1. Update /etc/apache2/startup.pl with the example from Open-ILS/examples/apache/startup.pl
    2. Update /etc/apache2/eg_vhost.conf with the example from Open-ILS/examples/apache/eg_vhost.conf
    3. Update /etc/apache2/sites-available/eg.conf with the example from Open-ILS/examples/apache/eg.conf
zzz_archive/upgrading/evergreen/1.4_to_2.0.txt · Last modified: 2022/02/10 13:34 by 127.0.0.1

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki

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