From bfd68d5415a68db63bd5254032fdf363d096e2b9 Mon Sep 17 00:00:00 2001 From: Jason Stephenson Date: Thu, 28 Apr 2016 18:09:55 -0400 Subject: [PATCH] Update server upgrade instructions for 2.9.4. Signed-off-by: Jason Stephenson --- docs/installation/server_upgrade.txt | 33 +++++++++++++++++---------------- 1 file changed, 17 insertions(+), 16 deletions(-) diff --git a/docs/installation/server_upgrade.txt b/docs/installation/server_upgrade.txt index 554b599b57..0768391388 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.9.3.tar.gz -tar xzf Evergreen-ILS-2.9.3.tar.gz +wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.9.4.tar.gz +tar xzf Evergreen-ILS-2.9.4.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.9.3 +cd /home/opensrf/Evergreen-ILS-2.9.4 --------------------------------------------- + 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.9.3 +cd /home/opensrf/Evergreen-ILS-2.9.4 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.9.3 -make STAFF_CLIENT_STAMP_ID=rel_2_9_3 install +cd /home/opensrf/Evergreen-ILS-2.9.4 +make STAFF_CLIENT_STAMP_ID=rel_2_9_4 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_9_3/server server +ln -sf rel_2_9_4/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.9.3 +cd /home/opensrf/Evergreen-ILS-2.9.4 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.9.3/Open-ILS/examples/apache/eg_startup /etc/apache2/eg_startup +cp /home/opensrf/Evergreen-ILS-2.9.4/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.9.3/Open-ILS/examples/apache/eg_vhost.conf /etc/apache2/eg_vhost.conf +cp /home/opensrf/Evergreen-ILS-2.9.4/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.9.3/Open-ILS/examples/apache/eg.conf /etc/apache2/sites-available/eg.conf +cp /home/opensrf/Evergreen-ILS-2.9.4/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.9.3, you +the schema. For example, if you want to upgrade from 2.5.1 to 2.9.4, you would run the following upgrade scripts: - 2.5.1-2.5.2-upgrade-db.sql @@ -214,13 +214,14 @@ would run the following upgrade scripts: - 2.9.0-2.9.1-upgrade-db.sql - 2.9.1-2.9.2-upgrade-db.sql - 2.9.2-2.9.3-upgrade-db.sql +- 2.9.3-2.9.4-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.9.3), use +To upgrade across multiple major versions (e.g. from 2.3.0 to 2.9.4), use the same logic to utilize the provided major version upgrade scripts. For example: @@ -236,7 +237,7 @@ example: - 2.7.4-2.8.0-upgrade-db.sql - (run all incremental scripts from 2.8.0 to 2.8.4) - 2.8.4-2.9.0-upgrade-db.sql -- (run all incremental scripts from 2.9.0 to 2.9.3) +- (run all incremental scripts from 2.9.0 to 2.9.4) ============= [CAUTION] @@ -250,8 +251,8 @@ as a user with the ability to connect to the database server. [source, bash] ---------------------------------------------------------- -cd /home/opensrf/Evergreen-ILS-2.9.3/Open-ILS/src/sql/Pg -psql -U evergreen -h localhost -f version-upgrade/2.9.2-2.9.3-upgrade-db.sql evergreen +cd /home/opensrf/Evergreen-ILS-2.9.4/Open-ILS/src/sql/Pg +psql -U evergreen -h localhost -f version-upgrade/2.9.3-2.9.4-upgrade-db.sql evergreen ---------------------------------------------------------- [TIP] -- 2.11.0