LP#1390138: Updating Upgrade and Install docs for 2.7
authorJosh Stompro <stomproj@larl.org>
Tue, 27 Jan 2015 17:01:12 +0000 (11:01 -0600)
committerBen Shum <bshum@biblio.org>
Wed, 4 Feb 2015 18:13:36 +0000 (13:13 -0500)
 - Updated docs to use 2.7.3 as the base in case this gets included in 2.7.3

Signed-off-by: Josh Stompro <stomproj@larl.org>
Signed-off-by: Ben Shum <bshum@biblio.org>

docs/installation/server_upgrade.txt

index 04fea3b..65d07b8 100644 (file)
@@ -48,8 +48,8 @@ the http://evergreen-ils.org/opensrf-downloads/[OpenSRF download page].
 +
 [source, bash]
 -----------------------------------------------
-wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.7.1.tar.gz
-tar xzf Evergreen-ILS-2.7.1.tar.gz
+wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.7.3.tar.gz
+tar xzf Evergreen-ILS-2.7.3.tar.gz
 -----------------------------------------------
 +
 [NOTE]
@@ -59,7 +59,7 @@ For the latest edition of Evergreen, check the http://evergreen-ils.org/egdownlo
 +
 [source, bash]
 ---------------------------------------------
-cd /home/opensrf/Evergreen-ILS-2.7.1
+cd /home/opensrf/Evergreen-ILS-2.7.3
 ---------------------------------------------
 +
 On the next command, replace `[distribution]` with one of these values for your
@@ -86,7 +86,7 @@ make -f Open-ILS/src/extras/Makefile.install [distribution]
 +
 [source, bash]
 ------------------------------------------------------------
-cd /home/opensrf/Evergreen-ILS-2.7.1
+cd /home/opensrf/Evergreen-ILS-2.7.3
 PATH=/openils/bin:$PATH ./configure --prefix=/openils --sysconfdir=/openils/conf
 make
 ------------------------------------------------------------
@@ -97,8 +97,8 @@ These instructions assume that you have also installed OpenSRF under /openils/.
 +
 [source, bash]
 ------------------------------------------------------------
-cd /home/opensrf/Evergreen-ILS-2.7.1
-make STAFF_CLIENT_STAMP_ID=rel_2_7_1 install
+cd /home/opensrf/Evergreen-ILS-2.7.3
+make STAFF_CLIENT_STAMP_ID=rel_2_7_3 install
 ------------------------------------------------------------
 +
 . As the *root* user, change all files to be owned by the opensrf user and group:
@@ -134,7 +134,7 @@ Copying these configuration files will remove any customizations you have made t
 +
 [source, bash]
 -------------------------------------------------------------------------
-cd /home/opensrf/Evergreen-ILS-2.7.1
+cd /home/opensrf/Evergreen-ILS-2.7.3
 perl Open-ILS/src/support-scripts/eg_db_config --update-config --service all \
 --create-offline --database evergreen --host localhost --user evergreen --password evergreen
 -------------------------------------------------------------------------
@@ -158,21 +158,21 @@ The diff command can be used to show the differences between the distribution ve
 +
 [source, bash]
 ----------------------------------------------------------
-cp /home/opensrf/Evergreen-ILS-2.7.1/Open-ILS/examples/apache/eg_startup /etc/apache2/eg_startup
+cp /home/opensrf/Evergreen-ILS-2.7.3/Open-ILS/examples/apache/eg_startup /etc/apache2/eg_startup
 ----------------------------------------------------------
 +
 .. Update /etc/apache2/eg_vhost.conf by copying the example from Open-ILS/examples/apache/eg_vhost.conf.
 +
 [source, bash]
 ----------------------------------------------------------
-cp /home/opensrf/Evergreen-ILS-2.7.1/Open-ILS/examples/apache/eg_vhost.conf /etc/apache2/eg_vhost.conf
+cp /home/opensrf/Evergreen-ILS-2.7.3/Open-ILS/examples/apache/eg_vhost.conf /etc/apache2/eg_vhost.conf
 ----------------------------------------------------------
 +
 .. Update /etc/apache2/sites-available/eg.conf by copying the example from Open-ILS/examples/apache/eg.conf.
 +
 [source, bash]
 ----------------------------------------------------------
-cp /home/opensrf/Evergreen-ILS-2.7.1/Open-ILS/examples/apache/eg.conf /etc/apache2/sites-available/eg.conf
+cp /home/opensrf/Evergreen-ILS-2.7.3/Open-ILS/examples/apache/eg.conf /etc/apache2/sites-available/eg.conf
 ----------------------------------------------------------
 
 Upgrade the Evergreen database schema
@@ -195,21 +195,24 @@ anything goes wrong during the upgrade.
 =============
 Evergreen provides incremental upgrade scripts that allow you to upgrade
 from one minor version to the next until you have the current version of
-the schema. For example, if you want to upgrade from 2.5.1 to 2.7.1, you
+the schema. For example, if you want to upgrade from 2.5.1 to 2.7.3, you
 would run the following upgrade scripts:
 
 - 2.5.1-2.5.2-upgrade-db.sql
 - 2.5.2-2.5.3-upgrade-db.sql
 - 2.5.3-2.6.0-upgrade-db.sql (this is a major version upgrade)
+- 2.6.2-2.6.3-upgrade-db.sql (there was one update missed in the 2.6-2.7.0 script, this is needed)
 - 2.6-2.7.0-upgrade-db.sql (this is a major version upgrade)
 - 2.7.0-2.7.1-upgrade-db.sql
+- 2.7.1-2.7.2-upgrade-db.sql
+- 2.7.2-2.7.3-upgrade-db.sql
 
 Note that you do *not* want to run additional 2.5 scripts to upgrade to the
 newest version of 2.5, since currently there is no automated way to upgrade
 from 2.5.4+ to 2.6. Only upgrade as far as necessary to reach the major
 version upgrade script (in this example, as far as 2.5.3).
 
-To upgrade across multiple major versions (e.g. from 2.3.0 to 2.7.1), use
+To upgrade across multiple major versions (e.g. from 2.3.0 to 2.7.3), use
 the same logic to utilize the provided major version upgrade scripts. For
 example:
 
@@ -219,8 +222,11 @@ example:
 - 2.4.3-2.5.0-upgrade-db.sql
 - (run all incremental scripts from 2.5.0 to 2.5.3)
 - 2.5.3-2.6.0-upgrade-db.sql
+- 2.6.2-2.6.3-upgrade-db.sql (This is an exception to the pattern that needs to be run before 2.6-2.7.0)
 - 2.6-2.7.0-upgrade-db.sql
 - 2.7.0-2.7.1-upgrade-db.sql
+- 2.7.1-2.7.2-upgrade-db.sql
+- 2.7.2-2.7.3-upgrade-db.sql
 =============
 
 [CAUTION]
@@ -234,7 +240,7 @@ as a user with the ability to connect to the database server.
 
 [source, bash]
 ----------------------------------------------------------
-cd /home/opensrf/Evergreen-ILS-2.7.1/Open-ILS/src/sql/Pg
+cd /home/opensrf/Evergreen-ILS-2.7.3/Open-ILS/src/sql/Pg
 psql -U evergreen -h localhost -f version-upgrade/2.6-2.7.0-upgrade-db.sql evergreen
 ----------------------------------------------------------