From b671b65b636826b2a257bb06caa5705e37c3df30 Mon Sep 17 00:00:00 2001 From: Josh Stompro Date: Tue, 27 Jan 2015 11:01:12 -0600 Subject: [PATCH] LP#1390138: Updating Upgrade and Install docs for 2.7 - Updated docs to use 2.7.3 as the base in case this gets included in 2.7.3 Signed-off-by: Josh Stompro Signed-off-by: Ben Shum --- docs/installation/server_upgrade.txt | 32 +++++++++++++++++----------- 1 file changed, 19 insertions(+), 13 deletions(-) diff --git a/docs/installation/server_upgrade.txt b/docs/installation/server_upgrade.txt index 04fea3bd0f..65d07b8ad1 100644 --- a/docs/installation/server_upgrade.txt +++ b/docs/installation/server_upgrade.txt @@ -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 ---------------------------------------------------------- -- 2.43.2