Differences

This shows you the differences between two versions of the page.

--- upgrading:1.2_to_1.4.0:latest_version_of_evergreen [2009/03/26 22:28] – miker
+++ zzz_archive:upgrading:1.2_to_1.4.0:latest_version_of_evergreen [2018/04/25 15:41] – ↷ Links adapted because of a move operation dbwells
@@ Line 1: / Line 1: @@
+======Upgrading Evergreen from a 1.2.x release to 1.4.0.7 ======
+  - 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://open-ils.org/downloads/OpenSRF-1.0.7.tar.gz|OpenSRF 1.0.7]]. See [[zzz_archive:upgrading:opensrf:0.9_to_1.0|upgrading OpenSRF 0.9 to 1.0]] for some gotchas. Otherwise, it's basically:<code bash>
+./configure --prefix=/openils --sysconfdir=/openils/conf
+make
+make install</code>
+  - Install Evergreen 1.4.0.7.<code bash>
+./configure --prefix=/openils --sysconfdir=/openils/conf
+make
+sudo make STAFF_CLIENT_BUILD_ID=rel_1_4_0_7 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>
+    - From version 1.2 **NOTE: it is recommended that you shut down PostgreSQL and make a copy of the data directory in order to restore to Evergreen 1.2 if anything goes wrong**<code bash>
+# 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
+# and then, for both:
+psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.4.0.2-1.4.0.3-upgrade-db.sql
+psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.4.0.3-1.4.0.4-upgrade-db.sql
+psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.4.0.4-1.4.0.5-upgrade-db.sql
+psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.4.0.5-1.4.0.6-upgrade-db.sql
+psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.4.0.6-1.4.0.7-upgrade-db.sql
+</code>
+  - 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> See the [[zzz_archive:opensrf:1.0:install|OpenSRF install instructions]] and the [[zzz_archive:server:1.4.0:install|Evergreen install instructions]] for information on setting up a multidomain OpenSRF environment. You will have to define new Jabber users and modify your Jabber configuration file to reflect the additional domains.
+  - 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.
+    - Update the cached JavaScript with:<code bash>sudo -u opensrf /openils/bin/autogen.sh -c /openils/conf/opensrf_core.xml -u</code>
+======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.