This is an old revision of the document!

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:
```
make -f Open-ILS/src/extras/Makefile.install _distribution_
```

Install OpenSRF 1.2.0. It's basically:

./configure --prefix=/openils --sysconfdir=/openils/conf
make
make install

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

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
```

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:
```
# 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
```

(In the final release tarball, this step should not be necessary). Install the Dojo toolkit.

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

Then run this command as root:

cp -r dojo-release-1.3.2/* /openils/var/web/js/dojo/.

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