Upgrading Evergreen from a 1.2.x release to 1.4.0.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.0.2. See upgrading OpenSRF 0.9 to 1.0 for some gotchas. Otherwise, it's basically:
```
./configure --prefix=/openils --sysconfdir=/openils/conf
make
make install
```
Remove the symbolic link /openils/var/web/reports/fm_IDL.xml - this will be replaced by an entityized version for internationalization support, but /openils/conf/fm_IDL.xml will break horribly if it gets replaced by an entityized version, so we have to disentangle the two.

Install Evergreen 1.4.0.0.

./autogen.sh
./configure --prefix=/openils --sysconfdir=/openils/conf
make
sudo make 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

From version 1.2 NOTE: it is recommended that you shut down Postgres 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

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
```
Update Apache configuration:
1. Update /etc/apache2/startup.pl with the example from Open-ILS/examples/apache/startup.pl (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.

ERRATA

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.
In /openils/conf/opensrf_core.xml, one additional public service, open-ils.fielder, is required. See changeset 11919 for details. This will be added by default in the next release.
An issue with hold freezing was discovered after the official release was cut. A thaw date is required in 1.4.0.0. This will also be fixed in the next release.
The current default logging level for the Apache modules it debug, which is extremely verbose. You can adjust this in /etc/apache2/sites-available/eg.conf, and info is a reasonable value. info will be the default in the next release.