======Upgrading Evergreen 1.4 to 2.0======

  - 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'':<code bash>
make -f Open-ILS/src/extras/Makefile.install _distribution_
</code>
  - Install [[http://evergreen-ils.org/downloads/OpenSRF-1.2.0.tar.gz|OpenSRF 1.2.0]]. It's basically:<code bash>
./configure --prefix=/openils --sysconfdir=/openils/conf
make
make install</code>
  - Install Evergreen 1.6.<code bash>
./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</code>
  - Upgrade the database
    - 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**<code bash>
# 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

</code>

  - cp /openils/conf/oils_web.xml.example /openils/conf/oils_web.xml (needed for acquisitions templates)

  - 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'':<code bash>
# 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
</code>
  - (In the final release tarball, this step should not be necessary). Install the Dojo toolkit. 
    - Run the following commands as **opensrf**:<code bash>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</code>
    - Then run this command as **root**:<code bash>
cp -r dojo-release-1.3.2/* /openils/var/web/js/dojo/.
</code>
  - Update Apache configuration:
    - Update ''/etc/apache2/startup.pl'' with the example from ''Open-ILS/examples/apache/startup.pl''
    - Update ''/etc/apache2/eg_vhost.conf'' with the example from ''Open-ILS/examples/apache/eg_vhost.conf''
    - Update ''/etc/apache2/sites-available/eg.conf'' with the example from ''Open-ILS/examples/apache/eg.conf''