From 4e461a4ebfa026bbde4cd0a64a07607d2808bada Mon Sep 17 00:00:00 2001 From: Robert Soulliere Date: Thu, 10 Oct 2013 13:18:53 -0400 Subject: [PATCH] Documentation: Update server upgrade instructions to 2.3.10 Signed-off-by: Robert Soulliere --- docs/installation/server_upgrade.txt | 37 +++++++++++++++++----------- 1 file changed, 22 insertions(+), 15 deletions(-) diff --git a/docs/installation/server_upgrade.txt b/docs/installation/server_upgrade.txt index 0a535fca22..2b5df52d48 100644 --- a/docs/installation/server_upgrade.txt +++ b/docs/installation/server_upgrade.txt @@ -41,23 +41,23 @@ osrf_ctl.sh -l -a stop_all + .. Back up the /openils directory. . Upgrade OpenSRF. Download and install the latest version of OpenSRF from -the http://evergreen-ils.org/opensrf.php[OpenSRF download page]. +the http://evergreen-ils.org/opensrf-downloads/[OpenSRF download page]. . As the opensrf user, download and extract Evergreen 2.3: + [source, bash] ----------------------------------------------- -wget http://www.open-ils.org/downloads/Evergreen-ILS-2.3.3.tar.gz -tar xzf Evergreen-ILS-2.3.3.tar.gz +wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.3.10.tar.gz +tar xzf Evergreen-ILS-2.3.10.tar.gz ----------------------------------------------- + [NOTE] -For the latest edition of Evergreen, check the http://evergreen-ils.org/downloads.php[Evergreen download page] and adjust upgrading instructions accordingly. +For the latest edition of Evergreen, check the http://evergreen-ils.org/egdownloads/[Evergreen download page] and adjust upgrading instructions accordingly. + . As the root user, install the prerequisites: + [source, bash] ---------------------------------------------- -cd /home/opensrf/Evergreen-ILS-2.3.3 +cd /home/opensrf/Evergreen-ILS-2.3.10 --------------------------------------------- + On the next command, replace `[distribution]` with one of these values for your @@ -81,7 +81,7 @@ make -f Open-ILS/src/extras/Makefile.install [distribution] + [source, bash] ------------------------------------------------------------ -cd /home/opensrf/Evergreen-ILS-2.3.3 +cd /home/opensrf/Evergreen-ILS-2.3.10 ./configure --prefix=/openils --sysconfdir=/openils/conf make ------------------------------------------------------------ @@ -90,8 +90,8 @@ make + [source, bash] ------------------------------------------------------------ -cd /home/opensrf/Evergreen-ILS-2.3.3 -make STAFF_CLIENT_STAMP_ID=rel_2_3_3 install +cd /home/opensrf/Evergreen-ILS-2.3.10 +make STAFF_CLIENT_STAMP_ID=rel_2_3_10 install ------------------------------------------------------------ + . As the root user, change all files to be owned by the opensrf user and group: @@ -107,7 +107,7 @@ chown -R opensrf:opensrf /openils ----------------------------------------------------------- cd /openils/var/web/xul/ rm server -ln -sf rel_2_3_3/server server +ln -sf rel_2_3_10/server server ---------------------------------------------------------- + . As the opensrf user, update opensrf_core.xml and opensrf.xml by copying the @@ -127,7 +127,7 @@ Copying these configuration files will remove any customizations you have made t + [source, bash] ------------------------------------------------------------------------- -cd /home/opensrf/Evergreen-ILS-2.3.3 +cd /home/opensrf/Evergreen-ILS-2.3.10 perl Open-ILS/src/support-scripts/eg_db_config.pl --update-config --service all \ --create-offline --database evergreen --host localhost --user evergreen --password evergreen ------------------------------------------------------------------------- @@ -144,21 +144,21 @@ For example, if you purchased an SSL certificate, you will need to edit eg.conf + [source, bash] ---------------------------------------------------------- -cp /home/opensrf/Evergreen-ILS-2.3.3/Open-ILS/examples/apache/startup.pl /etc/apache2/startup.pl +cp /home/opensrf/Evergreen-ILS-2.3.10/Open-ILS/examples/apache/startup.pl /etc/apache2/startup.pl ---------------------------------------------------------- + .. 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.3.3/Open-ILS/examples/apache/eg_vhost.conf /etc/apache2/eg_vhost.conf +cp /home/opensrf/Evergreen-ILS-2.3.10/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.3.3/Open-ILS/examples/apache/eg.conf /etc/apache2/sites-available/eg.conf +cp /home/opensrf/Evergreen-ILS-2.3.10/Open-ILS/examples/apache/eg.conf /etc/apache2/sites-available/eg.conf ---------------------------------------------------------- Upgrade the Evergreen database schema @@ -180,7 +180,7 @@ anything goes wrong during the upgrade. [CAUTION] Pay attention to error output as you run the upgrade scripts. If you encounter errors that you cannot resolve yourself through additional troubleshooting, please -report the errors to the http://evergreen-ils.org/listserv.php[Evergreen +report the errors to the http://evergreen-ils.org/communicate/mailing-lists/[Evergreen Technical Discussion List]. Run the following script as a user with the ability to connect to the @@ -189,11 +189,18 @@ database server connection information: [source, bash] ---------------------------------------------------------- -cd /home/opensrf/Evergreen-ILS-2.3.3/Open-ILS/src/sql/Pg +cd /home/opensrf/Evergreen-ILS-2.3.10/Open-ILS/src/sql/Pg psql -U evergreen -h localhost -f version-upgrade/2.2-2.3.0-upgrade-db.sql evergreen psql -U evergreen -h localhost -f version-upgrade/2.3.0-2.3.1-upgrade-db.sql evergreen psql -U evergreen -h localhost -f version-upgrade/2.3.1-2.3.2-upgrade-db.sql evergreen psql -U evergreen -h localhost -f version-upgrade/2.3.2-2.3.3-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f version-upgrade/2.3.3-2.3.4-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f version-upgrade/2.3.4-2.3.5-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f version-upgrade/2.3.5-2.3.6-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f version-upgrade/2.3.6-2.3.7-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f version-upgrade/2.3.7-2.3.8-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f version-upgrade/2.3.8-2.3.9-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f version-upgrade/2.3.9-2.3.10-upgrade-db.sql evergreen ---------------------------------------------------------- Restart Evergreen and Test -- 2.43.2