From 618813663d69cf6ca183444eaa5fd6b92a112e34 Mon Sep 17 00:00:00 2001 From: Robert Soulliere Date: Mon, 3 Jan 2011 15:27:28 -0500 Subject: [PATCH] Upgrading evergreen reflect 1.6.2 updates. --- 1.6/admin/Upgrading-Evergreen_1.6.xml | 122 +++++++++++++++++++++++++--------- 1 file changed, 89 insertions(+), 33 deletions(-) diff --git a/1.6/admin/Upgrading-Evergreen_1.6.xml b/1.6/admin/Upgrading-Evergreen_1.6.xml index 5c2bae1..3bc0d19 100644 --- a/1.6/admin/Upgrading-Evergreen_1.6.xml +++ b/1.6/admin/Upgrading-Evergreen_1.6.xml @@ -2,10 +2,10 @@ - Upgrading Evergreen from 1.4 to 1.6.1 + Upgrading Evergreen from 1.4 to 1.6.2 This Chapter will explain the step-by-step process of upgrading Evergreen - from version 1.4 to 1.6.1, including steps to upgrade OpenSRF. Before + from version 1.4 to 1.6.2, including steps to upgrade OpenSRF. Before upgrading, it is important to carefully plan an upgrade strategy to minimize system downtime and service interruptions. All of the steps in this chapter are to be completed from the command line. @@ -19,7 +19,7 @@ To switch from the root user to a different user, issue the su - [user] command; for example, su - opensrf. Once you have become a non-root user, to become the root user again simply issue the exit command. In the following instructions, /path/to/OpenSRF/ represents the path to the OpenSRF source directory. - +
Stop Evergreen and back up data. @@ -41,18 +41,18 @@ database. - - - Upgrading OpenSRF to 1.4OpenSRF +
+
+ Upgrading OpenSRF to 1.6OpenSRF As the opensrf user, download and extract the source files for OpenSRF 1.4: -wget http://open-ils.org/downloads/OpenSRF-1.4.0.tar.gz +wget http://open-ils.org/downloads/OpenSRF-1.6.2.tar.gz tar xzf OpenSRF-1.4.0.tar.gz - A new directory OpenSRF-1.4.0 is created. + A new directory OpenSRF-1.6.2 is created. For the latest edition of OpenSRF, check the Evergreen download page at . @@ -62,7 +62,7 @@ tar xzf OpenSRF-1.4.0.tar.gz prerequisite installer. aptitude install make -cd /home/opensrf/OpenSRF-1.4.0 +cd /home/opensrf/OpenSRF-1.6.2 Replace below with the following value for your distribution: @@ -94,6 +94,9 @@ cd /home/opensrf/OpenSRF-1.4.0 for Ubuntu Lucid Lynx (10.04) + + for CentOS 5 + cd /path/to/OpenSRF @@ -121,7 +124,7 @@ make As the root user, return to your OpenSRF build directory and install OpenSRF: -cd /home/opensrf/OpenSRF-1.4.0 +cd /home/opensrf/OpenSRF-1.6.2 make install @@ -153,23 +156,23 @@ srfsh# of this documentation. - - - Upgrade <application>Evergreen</application> to 1.6.1.2 +
+
+ Upgrade <application>Evergreen</application> from 1.4 to 1.6.2 - As the opensrf user, download and extract Evergreen 1.6.1.2 + As the opensrf user, download and extract Evergreen 1.6.2.0 -wget http://open-ils.org/downloads/Evergreen-ILS-1.6.1.2.tar.gz -tar xzf Evergreen-ILS-1.6.1.2.tar.gz +wget http://open-ils.org/downloads/Evergreen-ILS-1.6.2.0.tar.gz +tar xzf Evergreen-ILS-1.6.2.0.tar.gz For the latest edition of Evergreen check the Evergreen download page at and adjust upgrading instructions accordingly. As the root user, install the prerequisites: - cd /home/opensrf/Evergreen-ILS-1.6.1.2 + cd /home/opensrf/Evergreen-ILS-1.6.2.0 On the next command, replace with one of these values for your distribution of Debian or Ubuntu: @@ -193,10 +196,7 @@ tar xzf Evergreen-ILS-1.6.1.2.tar.gz for Ubuntu Karmic Koala - (9.10) - - - for Ubuntu Lucid Lynx + (9.10) or Ubuntu Lucid Lynx (10.04) @@ -205,19 +205,19 @@ tar xzf Evergreen-ILS-1.6.1.2.tar.gz As the opensrf user, configure and compile Evergreen: - cd /home/opensrf/Evergreen-ILS-1.6.1.2 + cd /home/opensrf/Evergreen-ILS-1.6.2.0 ./configure --prefix=/openils --sysconfdir=/openils/conf make As the root user, install Evergreen: - make STAFF_CLIENT_BUILD_ID=rel_1_6_1_2 install + make STAFF_CLIENT_BUILD_ID=rel_1_6_2_0 install Change to the Evergreen installation directory: - cd /home/opensrf/Evergreen-ILS-1.6.1.2 + cd /home/opensrf/Evergreen-ILS-1.6.2.0 As the root user, change all files to be owned by the @@ -228,7 +228,7 @@ tar xzf Evergreen-ILS-1.6.1.2.tar.gz As the root user, build live-db-setup.pl for the cgi-bin bootstrapping scripts and offline-config.pl for the offline staff client data uploader: -cd /home/opensrf/Evergreen-ILS-1.6.1.2 +cd /home/opensrf/Evergreen-ILS-1.6.2.0 perl Open-ILS/src/support-scripts/eg_db_config.pl --create-bootstrap --create-offline \ --user evergreen --password evergreen --hostname localhost --port 5432 \ --database evergreen @@ -239,7 +239,7 @@ perl Open-ILS/src/support-scripts/eg_db_config.pl --create-bootstrap --create-of cd /openils/var/web/xul/ rm server -ln -s rel_1_6_1_2/server +ln -s rel_1_6_2_0/server @@ -255,6 +255,10 @@ psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.0.3-1.6.0.4-upgrade-db psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.0.4-1.6.1.0-upgrade-db.sql evergreen psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.0-1.6.1.1-upgrade-db.sql evergreen psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.1-1.6.1.2-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.2-1.6.1.3-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.3-1.6.1.4-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.4-1.6.1.5-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.1-1.6.2-upgrade-db.sql evergreen @@ -299,8 +303,60 @@ perl Open-ILS/src/support-scripts/eg_db_config.pl --update-config --service all SSLcertificates - - +
+
+ Upgrade <application>Evergreen</application>from 1.6.0 to 1.6.2 + + + Follow steps 1-8 of the instructions for upgrading Evergreen from 1.4 + + + + Update the Evergreen database: + it is recommended that you back up your Evergreen database in order to restore your data if anything goes wrong. + + +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.0.4-1.6.1.0-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.0-1.6.1.1-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.1-1.6.1.2-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.2-1.6.1.3-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.3-1.6.1.4-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.4-1.6.1.5-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.1-1.6.2-upgrade-db.sql evergreen + + + + + Follow steps 10-16 of the instructions for upgrading Evergreen from 1.4 + + + + +
+
+ Upgrade <application>Evergreen</application>from 1.6.1 to 1.6.2 + + + Follow steps 1-8 of the instructions for upgrading Evergreen from 1.4 + + + + Update the Evergreen database: + it is recommended that you back up your Evergreen database in order to restore your data if anything goes wrong. + + +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.1-1.6.2-upgrade-db.sql evergreen + + + + + Follow steps 10-16 of the instructions for upgrading Evergreen from 1.4 + + + + +
+
Restart Evergreen and Test @@ -335,10 +391,10 @@ cd /openils/bin section of this documentation for tips on finding solutions and seeking further assistance from the Evergreen community. - - +
+
Upgrading PostgreSQL from 8.2 to 8.4 - Evergreen 1.6.1 supports PostgreSQL version 8.4 and it is recommended that you upgrade PostgreSQL when you upgrade Evergreen to 1.6. + Evergreen 1.6.2 supports PostgreSQL version 8.4 and it is recommended that you upgrade PostgreSQL when you upgrade Evergreen to 1.6. The order of the following steps is very important.databasesPostgreSQL @@ -375,9 +431,9 @@ psql -f /usr/share/postgresql/8.4/contrib/pgxml.sql evergreen To point tsearch2 to proper function names in 8.4, run the SQL script - /home/opensrf/Evergreen-ILS*/Open-ILS/src/sql/Pg/000.english.pg83.fts-config.sql using the psql command. + /home/opensrf/Evergreen-ILS*/Open-ILS/src/sql/Pg/000.english.pg84.fts-config.sql using the psql command. cd /home/opensrf/Evergreen-ILS* - psql -f /Open-ILS/src/sql/Pg/000.english.pg83.fts-config.sql evergreen + psql -f /Open-ILS/src/sql/Pg/000.english.pg84.fts-config.sql evergreen Restart Evergreen and OpenSRF services -- 2.11.0