From 61bdd9fe6528ca8014403c8ad6ed5d55e18e9962 Mon Sep 17 00:00:00 2001 From: Bill Erickson Date: Wed, 17 Feb 2016 14:10:17 -0500 Subject: [PATCH] Modify server upgrade doc for 2.8.7 Signed-off-by: Bill Erickson --- docs/installation/server_upgrade.txt | 31 ++++++++++++++-------------- 1 file changed, 16 insertions(+), 15 deletions(-) diff --git a/docs/installation/server_upgrade.txt b/docs/installation/server_upgrade.txt index 10a78c02d6..645ab17af4 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.8.6.tar.gz -tar xzf Evergreen-ILS-2.8.6.tar.gz +wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.8.7.tar.gz +tar xzf Evergreen-ILS-2.8.7.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.8.6 +cd /home/opensrf/Evergreen-ILS-2.8.7 --------------------------------------------- + On the next command, replace `[distribution]` with one of these values for your @@ -84,7 +84,7 @@ make -f Open-ILS/src/extras/Makefile.install [distribution] + [source, bash] ------------------------------------------------------------ -cd /home/opensrf/Evergreen-ILS-2.8.6 +cd /home/opensrf/Evergreen-ILS-2.8.7 PATH=/openils/bin:$PATH ./configure --prefix=/openils --sysconfdir=/openils/conf make ------------------------------------------------------------ @@ -95,8 +95,8 @@ These instructions assume that you have also installed OpenSRF under /openils/. + [source, bash] ------------------------------------------------------------ -cd /home/opensrf/Evergreen-ILS-2.8.6 -make STAFF_CLIENT_STAMP_ID=rel_2_8_6 install +cd /home/opensrf/Evergreen-ILS-2.8.7 +make STAFF_CLIENT_STAMP_ID=rel_2_8_7 install ------------------------------------------------------------ + . As the *root* user, change all files to be owned by the opensrf user and group: @@ -112,7 +112,7 @@ chown -R opensrf:opensrf /openils ----------------------------------------------------------- cd /openils/var/web/xul/ rm server -ln -sf rel_2_8_6/server server +ln -sf rel_2_8_7/server server ---------------------------------------------------------- + . As the *opensrf* user, update opensrf_core.xml and opensrf.xml by copying the @@ -132,7 +132,7 @@ Copying these configuration files will remove any customizations you have made t + [source, bash] ------------------------------------------------------------------------- -cd /home/opensrf/Evergreen-ILS-2.8.6 +cd /home/opensrf/Evergreen-ILS-2.8.7 perl Open-ILS/src/support-scripts/eg_db_config --update-config --service all \ --create-offline --database evergreen --host localhost --user evergreen --password evergreen ------------------------------------------------------------------------- @@ -156,21 +156,21 @@ The diff command can be used to show the differences between the distribution ve + [source, bash] ---------------------------------------------------------- -cp /home/opensrf/Evergreen-ILS-2.8.6/Open-ILS/examples/apache/eg_startup /etc/apache2/eg_startup +cp /home/opensrf/Evergreen-ILS-2.8.7/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.8.6/Open-ILS/examples/apache/eg_vhost.conf /etc/apache2/eg_vhost.conf +cp /home/opensrf/Evergreen-ILS-2.8.7/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.8.6/Open-ILS/examples/apache/eg.conf /etc/apache2/sites-available/eg.conf +cp /home/opensrf/Evergreen-ILS-2.8.7/Open-ILS/examples/apache/eg.conf /etc/apache2/sites-available/eg.conf ---------------------------------------------------------- Upgrade the Evergreen database schema @@ -193,7 +193,7 @@ 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.8.6, you +the schema. For example, if you want to upgrade from 2.5.1 to 2.8.7, you would run the following upgrade scripts: - 2.5.1-2.5.2-upgrade-db.sql @@ -212,13 +212,14 @@ would run the following upgrade scripts: - 2.8.3-2.8.4-upgrade-db.sql - 2.8.4-2.8.5-upgrade-db.sql - 2.8.5-2.8.6-upgrade-db.sql +- 2.8.6-2.8.7-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.8.6), use +To upgrade across multiple major versions (e.g. from 2.3.0 to 2.8.7), use the same logic to utilize the provided major version upgrade scripts. For example: @@ -232,7 +233,7 @@ example: - 2.6.3-2.7.0-upgrade-db.sql - (run all incremental scripts from 2.7.0 to 2.7.4) - 2.7.4-2.8.0-upgrade-db.sql -- (run all incremental scripts from 2.8.0 to 2.8.6) +- (run all incremental scripts from 2.8.0 to 2.8.7) ============= [CAUTION] @@ -246,7 +247,7 @@ as a user with the ability to connect to the database server. [source, bash] ---------------------------------------------------------- -cd /home/opensrf/Evergreen-ILS-2.8.6/Open-ILS/src/sql/Pg +cd /home/opensrf/Evergreen-ILS-2.8.7/Open-ILS/src/sql/Pg psql -U evergreen -h localhost -f version-upgrade/2.7.4-2.8.0-upgrade-db.sql evergreen ---------------------------------------------------------- -- 2.43.2