From f472fc0b7c16f981f6063902e39207204f0cb7a9 Mon Sep 17 00:00:00 2001 From: Robert Soulliere Date: Thu, 3 Jan 2013 14:23:54 -0500 Subject: [PATCH] Documentation: Update upgrade instructions. Also add a few index terms. Signed-off-by: Robert Soulliere --- docs/installation/server_upgrade.txt | 33 ++++++++++++++++++++++----------- 1 file changed, 22 insertions(+), 11 deletions(-) diff --git a/docs/installation/server_upgrade.txt b/docs/installation/server_upgrade.txt index 308e2bc1d0..1fb849c2a5 100644 --- a/docs/installation/server_upgrade.txt +++ b/docs/installation/server_upgrade.txt @@ -46,8 +46,8 @@ the http://evergreen-ils.org/opensrf.php[OpenSRF download page]. + [source, bash] ----------------------------------------------- -wget http://www.open-ils.org/downloads/Evergreen-ILS-2.3.1.tar.gz -tar xzf Evergreen-ILS-2.3.1.tar.gz +wget http://www.open-ils.org/downloads/Evergreen-ILS-2.3.2.tar.gz +tar xzf Evergreen-ILS-2.3.2.tar.gz ----------------------------------------------- + [NOTE] @@ -57,12 +57,17 @@ For the latest edition of Evergreen, check the http://evergreen-ils.org/download + [source, bash] ---------------------------------------------- -cd /home/opensrf/Evergreen-ILS-2.3.1 +cd /home/opensrf/Evergreen-ILS-2.3.2 --------------------------------------------- + On the next command, replace `[distribution]` with one of these values for your distribution of Debian or Ubuntu: +indexterm:[Linux, Debian] + +indexterm:[Linux, Ubuntu] + + * `debian-squeeze` for Debian Squeeze (6.0) * `ubuntu-lucid` for Ubuntu Lucid Lynx (10.04) * `ubuntu-precise` for Ubuntu Precise Pangolin (12.04) @@ -76,7 +81,7 @@ make -f Open-ILS/src/extras/Makefile.install [distribution] + [source, bash] ------------------------------------------------------------ -cd /home/opensrf/Evergreen-ILS-2.3.1 +cd /home/opensrf/Evergreen-ILS-2.3.2 ./configure --prefix=/openils --sysconfdir=/openils/conf make ------------------------------------------------------------ @@ -85,8 +90,8 @@ make + [source, bash] ------------------------------------------------------------ -cd /home/opensrf/Evergreen-ILS-2.3.1 -make STAFF_CLIENT_STAMP_ID=rel_2_3_1 install +cd /home/opensrf/Evergreen-ILS-2.3.2 +make STAFF_CLIENT_STAMP_ID=rel_2_3_2 install ------------------------------------------------------------ + . As the root user, change all files to be owned by the opensrf user and group: @@ -102,7 +107,7 @@ chown -R opensrf:opensrf /openils ----------------------------------------------------------- cd /openils/var/web/xul/ rm server -ln -sf rel_2_3_1/server server +ln -sf rel_2_3_2/server server ---------------------------------------------------------- + . As the opensrf user, update opensrf_core.xml and opensrf.xml by copying the @@ -129,6 +134,8 @@ perl Open-ILS/src/support-scripts/eg_db_config.pl --update-config --service all + . As the _root_ user, update the Apache files: + +indexterm:[Apache] ++ [CAUTION] Copying these Apache configuration files will remove any customizations you have made to them. Remember to redo your customizations after copying them. For example, if you purchased an SSL certificate, you will need to edit eg.conf to point to the appropriate SSL certificate files. @@ -137,25 +144,28 @@ For example, if you purchased an SSL certificate, you will need to edit eg.conf + [source, bash] ---------------------------------------------------------- -cp /home/opensrf/Evergreen-ILS-2.3.1/Open-ILS/examples/apache/startup.pl /etc/apache2/startup.pl +cp /home/opensrf/Evergreen-ILS-2.3.2/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.1/Open-ILS/examples/apache/eg_vhost.conf /etc/apache2/eg_vhost.conf +cp /home/opensrf/Evergreen-ILS-2.3.2/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.1/Open-ILS/examples/apache/eg.conf /etc/apache2/sites-available/eg.conf +cp /home/opensrf/Evergreen-ILS-2.3.2/Open-ILS/examples/apache/eg.conf /etc/apache2/sites-available/eg.conf ---------------------------------------------------------- Upgrade the Evergreen database schema ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +indexterm:[database schema] + The upgrade of the Evergreen database schema is the lengthiest part of the upgrade process for sites with a significant amount of production data. @@ -179,9 +189,10 @@ database server connection information: [source, bash] ---------------------------------------------------------- -cd /home/opensrf/Evergreen-ILS-2.3.1/Open-ILS/src/sql/Pg +cd /home/opensrf/Evergreen-ILS-2.3.2/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 ---------------------------------------------------------- Restart Evergreen and Test -- 2.11.0