======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 [[http://open-ils.org/downloads/OpenSRF-1.0.2.tar.gz|OpenSRF 1.0.2]]. See [[zzz_archive:upgrading:opensrf:0.9_to_1.0|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:
- Update ''/etc/apache2/startup.pl'' with the example from ''Open-ILS/examples/apache/startup.pl'' (primarily to add the Vandelay Perl module).
- Update ''/etc/apache2/eg_vhost.conf'' with the example from ''Open-ILS/examples/apache/eg_vhost.conf'' for internationalization and JSON gateway format support.
- 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 [[http://open-ils.org/dokuwiki/doku.php?id=server_installation:adding_localizations|this page]] for instructions on installing these translations.
* In ''/openils/conf/opensrf_core.xml'', one additional public service, ''open-ils.fielder'', is required. See [[http://svn.open-ils.org/trac/ILS/changeset/11919|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.