From a2e12fee0622a8ef6a10e23a448ba76b7b5a5e11 Mon Sep 17 00:00:00 2001 From: Robert Soulliere Date: Wed, 2 Jul 2014 13:45:23 -0400 Subject: [PATCH] Documentation: Updated 2.5 upgrade instructions. - Added db upgrades up to 2.5.5. - Added a note about reingesting records after the upgrade has been completed. Signed-off-by: Robert Soulliere --- docs/installation/server_upgrade.txt | 34 +++++++++++++++++++++------------- 1 file changed, 21 insertions(+), 13 deletions(-) diff --git a/docs/installation/server_upgrade.txt b/docs/installation/server_upgrade.txt index 5c103b7849..3fefa97e7b 100644 --- a/docs/installation/server_upgrade.txt +++ b/docs/installation/server_upgrade.txt @@ -13,7 +13,7 @@ Software Prerequisites running an older version of these distributions, you may want to upgrade before upgrading Evergreen. For instructions on upgrading these distributions, visit the Debian or Ubuntu websites. - * **OpenSRF**: The minimum supported version of OpenSRF is 2.2.1. + * **OpenSRF**: The minimum supported version of OpenSRF is 2.2.2. In the following instructions, you are asked to perform certain steps as either the root or opensrf user. @@ -46,8 +46,8 @@ the http://evergreen-ils.org/opensrf-downloads/[OpenSRF download page]. + [source, bash] ----------------------------------------------- -wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.5.2.tar.gz -tar xzf Evergreen-ILS-2.5.2.tar.gz +wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.5.5.tar.gz +tar xzf Evergreen-ILS-2.5.5.tar.gz ----------------------------------------------- + [NOTE] @@ -57,7 +57,7 @@ For the latest edition of Evergreen, check the http://evergreen-ils.org/download + [source, bash] --------------------------------------------- -cd /home/opensrf/Evergreen-ILS-2.5.2 +cd /home/opensrf/Evergreen-ILS-2.5.5 --------------------------------------------- + On the next command, replace `[distribution]` with one of these values for your @@ -80,7 +80,7 @@ make -f Open-ILS/src/extras/Makefile.install [distribution] + [source, bash] ------------------------------------------------------------ -cd /home/opensrf/Evergreen-ILS-2.5.2 +cd /home/opensrf/Evergreen-ILS-2.5.5 ./configure --prefix=/openils --sysconfdir=/openils/conf make ------------------------------------------------------------ @@ -89,8 +89,8 @@ make + [source, bash] ------------------------------------------------------------ -cd /home/opensrf/Evergreen-ILS-2.5.2 -make STAFF_CLIENT_STAMP_ID=rel_2_5_2 install +cd /home/opensrf/Evergreen-ILS-2.5.5 +make STAFF_CLIENT_STAMP_ID=rel_2_5_5 install ------------------------------------------------------------ + . As the root user, change all files to be owned by the opensrf user and group: @@ -106,7 +106,7 @@ chown -R opensrf:opensrf /openils ----------------------------------------------------------- cd /openils/var/web/xul/ rm server -ln -sf rel_2_5_2/server server +ln -sf rel_2_5_5/server server ---------------------------------------------------------- + . As the opensrf user, update opensrf_core.xml and opensrf.xml by copying the @@ -126,7 +126,7 @@ Copying these configuration files will remove any customizations you have made t + [source, bash] ------------------------------------------------------------------------- -cd /home/opensrf/Evergreen-ILS-2.5.2 +cd /home/opensrf/Evergreen-ILS-2.5.5 perl Open-ILS/src/support-scripts/eg_db_config --update-config --service all \ --create-offline --database evergreen --host localhost --user evergreen --password evergreen ------------------------------------------------------------------------- @@ -143,21 +143,21 @@ For example, if you purchased an SSL certificate, you will need to edit eg.conf + [source, bash] ---------------------------------------------------------- -cp /home/opensrf/Evergreen-ILS-2.5.2/Open-ILS/examples/apache/eg_startup /etc/apache2/eg_startup +cp /home/opensrf/Evergreen-ILS-2.5.5/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.5.2/Open-ILS/examples/apache/eg_vhost.conf /etc/apache2/eg_vhost.conf +cp /home/opensrf/Evergreen-ILS-2.5.5/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.5.2/Open-ILS/examples/apache/eg.conf /etc/apache2/sites-available/eg.conf +cp /home/opensrf/Evergreen-ILS-2.5.5/Open-ILS/examples/apache/eg.conf /etc/apache2/sites-available/eg.conf ---------------------------------------------------------- Upgrade the Evergreen database schema @@ -187,11 +187,19 @@ database server. [source, bash] ---------------------------------------------------------- -cd /home/opensrf/Evergreen-ILS-2.5.2/Open-ILS/src/sql/Pg +cd /home/opensrf/Evergreen-ILS-2.5.5/Open-ILS/src/sql/Pg psql -U evergreen -h localhost -f version-upgrade/2.4.3-2.5.0-upgrade-db.sql evergreen psql -U evergreen -h localhost -f version-upgrade/2.5.0-2.5.1-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f version-upgrade/2.5.1-2.5.2-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f version-upgrade/2.5.2-2.5.3-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f version-upgrade/2.5.3-2.5.4-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f version-upgrade/2.5.4-2.5.5-upgrade-db.sql evergreen ---------------------------------------------------------- +[NOTE] +After the 2.4.3-2.5.0-upgrade-db.sql script finishes, you will see a note on how to reingest your bib records. You should reingest your records after you have completed the entire upgrade and tested your system. Reingesting records will take a long time depending on the number of bib and authority records in your system. Reingesting will need to be done before the new ``Browse the Catalogue'' feature can find all of your existing records. + + Restart Evergreen and Test ~~~~~~~~~~~~~~~~~~~~~~~~~~ . As the opensrf user, start all Evergreen and OpenSRF services: -- 2.11.0