From 114263972515edbdb838a837d7d085de51b867c1 Mon Sep 17 00:00:00 2001 From: Yamil Suarez Date: Wed, 29 Jun 2011 17:04:09 -0400 Subject: [PATCH] Updated the server instalation documentation to refer to the 2.0.7 release of EG and the 2.0 release of OpenSRF --- 2.0/admin/Upgrading-Evergreen-2.0.xml | 18 ++++---- 2.0/admin/serversideinstallation_2.0.xml | 76 ++++++++++++++++---------------- 2 files changed, 48 insertions(+), 46 deletions(-) diff --git a/2.0/admin/Upgrading-Evergreen-2.0.xml b/2.0/admin/Upgrading-Evergreen-2.0.xml index 44e1eb0..de44c7c 100644 --- a/2.0/admin/Upgrading-Evergreen-2.0.xml +++ b/2.0/admin/Upgrading-Evergreen-2.0.xml @@ -59,7 +59,7 @@ 2.0: wget http://open-ils.org/downloads/opensrf-2.0.0.tar.gz -tar xzf opensrf-1.6.3.tar.gz +tar xzf opensrf-2.0.0.tar.gz A new directory opensrf-2.0.0 is created. For the latest edition of OpenSRF, check the Evergreen download page at @@ -201,15 +201,15 @@ cp /openils/conf/opensrf_core.xml.backup /openils/conf/opensrf_core.xml As the opensrf user, download and extract Evergreen 2.0 -wget http://www.open-ils.org/downloads/Evergreen-ILS-2.0.6.tar.gz -tar xzf Evergreen-ILS-2.0.6.tar.gz +wget http://www.open-ils.org/downloads/Evergreen-ILS-2.0.7.tar.gz +tar xzf Evergreen-ILS-2.0.7.tar.gz For the latest edition of Evergreen 2.0, check the Evergreen download page at and adjust upgrading instructions accordingly. As the root user, install the prerequisites: - cd /home/opensrf/Evergreen-ILS-2.0.6 + cd /home/opensrf/Evergreen-ILS-2.0.7 On the next command, replace with one of these values for your distribution of Debian or Ubuntu: @@ -228,14 +228,14 @@ tar xzf Evergreen-ILS-2.0.6.tar.gz As the opensrf user, configure and compile Evergreen: - cd /home/opensrf/Evergreen-ILS-2.0.6 + cd /home/opensrf/Evergreen-ILS-2.0.7 ./configure --prefix=/openils --sysconfdir=/openils/conf make As the root user, install Evergreen: - make STAFF_CLIENT_BUILD_ID=rel_2_0_6 install + make STAFF_CLIENT_BUILD_ID=rel_2_0_7 install As the root user, change all files to be owned by the @@ -247,13 +247,13 @@ tar xzf Evergreen-ILS-2.0.6.tar.gz cd /openils/var/web/xul/ rm server -ln -s rel_2_0_6/server +ln -s rel_2_0_7/server Change to the Evergreen installation directory: - cd /home/opensrf/Evergreen-ILS-2.0.6 + cd /home/opensrf/Evergreen-ILS-2.0.7 @@ -270,6 +270,8 @@ psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.2-2.0.3-upgrade-db.sql psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.3-2.0.4-upgrade-db.sql evergreen psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.4-2.0.5-upgrade-db.sql evergreen psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.5-2.0.6-upgrade-db.sql evergreen +psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.6-2.0.7-upgrade-db.sql evergreen + diff --git a/2.0/admin/serversideinstallation_2.0.xml b/2.0/admin/serversideinstallation_2.0.xml index b447b74..00c4d94 100644 --- a/2.0/admin/serversideinstallation_2.0.xml +++ b/2.0/admin/serversideinstallation_2.0.xml @@ -87,12 +87,12 @@ Of course, after you successfully complete and test the entire Evergreen installation you should take a final snapshot backup of your system(s). This can be the first in the series of regularly scheduled system backups that you should probably also begin. -
+
OpenSRF installation - Installing OpenSRF 1.6.x On <systemitem class="osname">Ubuntu</systemitem> or + <title>Installing OpenSRF 2.0.x On <systemitem class="osname">Ubuntu</systemitem> or <systemitem class="osname">Debian</systemitem> Linux @@ -165,17 +165,17 @@ download The latest version of OpenSRF can be found here: - . + . As the opensrf user, change to the directory /home/opensrf then download and extract OpenSRF. The new subdirectory - /home/opensrf/opensrf-1.6.3 will be created: + /home/opensrf/opensrf-2.0.0 will be created: # as the opensrf user: cd /home/opensrf - wget http://evergreen-ils.org/downloads/opensrf-1.6.3.tar.gz - tar zxf opensrf-1.6.3.tar.gz + wget http://evergreen-ils.org/downloads/opensrf-2.0.0.tar.gz + tar zxf opensrf-2.0.0.tar.gz @@ -194,7 +194,7 @@ # as the root user: - cd /home/opensrf/opensrf-1.6.3 + cd /home/opensrf/opensrf-2.0.0 make -f src/extras/Makefile.install [DISTRIBUTION] @@ -308,7 +308,7 @@ # as the opensrf user: - cd /home/opensrf/opensrf-1.6.3 + cd /home/opensrf/opensrf-2.0.0 ./configure --prefix=/openils --sysconfdir=/openils/conf make @@ -323,7 +323,7 @@ # as the root user: - cd /home/opensrf/opensrf-1.6.3 + cd /home/opensrf/opensrf-2.0.0 make install This step will take several minutes to complete. @@ -875,7 +875,7 @@ Evergreen software is integrated with and depends on the Open Service Request Framework (OpenSRF) software system. For further information on installing, configuring and testing OpenSRF, see - . + . Follow the steps outlined in that section and run the specified tests to ensure that OpenSRF is properly installed and configured. Do not continue with @@ -885,18 +885,18 @@ Download and Unpack Latest Evergreen Version The latest version of Evergreen can be found here: - . + . As the opensrf user, change to the directory /home/opensrf then download and extract Evergreen. The new subdirectory - /home/opensrf/Evergreen-ILS-2.0.4 + /home/opensrf/Evergreen-ILS-2.0.7 will be created: # as the opensrf user: cd /home/opensrf - wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.4.tar.gz - tar zxf Evergreen-ILS-2.0.4.tar.gz + wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.7.tar.gz + tar zxf Evergreen-ILS-2.0.7.tar.gz @@ -917,7 +917,7 @@ # as the root user: - cd /home/opensrf/Evergreen-ILS-2.0.4 + cd /home/opensrf/Evergreen-ILS-2.0.7 make -f Open-ILS/src/extras/Makefile.install [DISTRIBUTION] @@ -1015,7 +1015,7 @@ # as the opensrf user: - cd /home/opensrf/Evergreen-ILS-2.0.4 + cd /home/opensrf/Evergreen-ILS-2.0.7 ./configure --prefix=/openils --sysconfdir=/openils/conf make @@ -1030,14 +1030,14 @@ # as the root user: - cd /home/opensrf/Evergreen-ILS-2.0.4 - make STAFF_CLIENT_BUILD_ID=rel_2_0_4 install + cd /home/opensrf/Evergreen-ILS-2.0.7 + make STAFF_CLIENT_BUILD_ID=rel_2_0_7 install The Staff Client will also be automatically built, but you must remember to set the variable STAFF_CLIENT_BUILD_ID to match the version of the Staff Client you will use to connect to the Evergreen server. The above commands will create a new subdirectory - /openils/var/web/xul/rel_2_0_4 + /openils/var/web/xul/rel_2_0_7 containing the Staff Client. To complete the Staff Client installation, as the root user execute the following commands to @@ -1049,7 +1049,7 @@ # as the root user: cd /openils/var/web/xul - ln -sf rel_2_0_4/server server + ln -sf rel_2_0_7/server server @@ -1145,7 +1145,7 @@ # as the root user: - cd /home/opensrf/Evergreen-ILS-2.0.4 + cd /home/opensrf/Evergreen-ILS-2.0.7 perl Open-ILS/src/support-scripts/eg_db_config.pl --update-config \ --service all --create-schema --create-offline \ --hostname HOSTNAME --port PORT \ @@ -1214,7 +1214,7 @@ # as the root user: - cd /home/opensrf/Evergreen-ILS-2.0.4 + cd /home/opensrf/Evergreen-ILS-2.0.7 cp Open-ILS/examples/apache/eg.conf /etc/apache2/sites-available/ cp Open-ILS/examples/apache/eg_vhost.conf /etc/apache2/ cp Open-ILS/examples/apache/startup.pl /etc/apache2/ @@ -1530,7 +1530,7 @@ Evergreen software is integrated with and depends on the Open Service Request Framework (OpenSRF) software system. For further information on installing, configuring and testing OpenSRF, see - . + . Follow the steps outlined in that section and run the specified tests to ensure that OpenSRF is properly installed and configured. Do not continue with @@ -1540,18 +1540,18 @@ Download and Unpack Latest Evergreen Version The latest version of Evergreen can be found here: - . + . As the opensrf user, change to the directory /home/opensrf then download and extract Evergreen. The new subdirectory - /home/opensrf/Evergreen-ILS-2.0.4 + /home/opensrf/Evergreen-ILS-2.0.7 will be created: # as the opensrf user: cd /home/opensrf - wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.4.tar.gz - tar zxf Evergreen-ILS-2.0.4.tar.gz + wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.7.tar.gz + tar zxf Evergreen-ILS-2.0.7.tar.gz @@ -1572,7 +1572,7 @@ # as the root user: - cd /home/opensrf/Evergreen-ILS-2.0.4 + cd /home/opensrf/Evergreen-ILS-2.0.7 make -f Open-ILS/src/extras/Makefile.install [DISTRIBUTION] @@ -1636,7 +1636,7 @@ # as the opensrf user: - cd /home/opensrf/Evergreen-ILS-2.0.4 + cd /home/opensrf/Evergreen-ILS-2.0.7 ./configure --prefix=/openils --sysconfdir=/openils/conf make @@ -1651,14 +1651,14 @@ # as the root user: - cd /home/opensrf/Evergreen-ILS-2.0.4 - make STAFF_CLIENT_BUILD_ID=rel_2_0_4 install + cd /home/opensrf/Evergreen-ILS-2.0.7 + make STAFF_CLIENT_BUILD_ID=rel_2_0_7 install The Staff Client will also be automatically built, but you must remember to set the variable STAFF_CLIENT_BUILD_ID to match the version of the Staff Client you will use to connect to the Evergreen server. The above commands will create a new subdirectory - /openils/var/web/xul/rel_2_0_4 + /openils/var/web/xul/rel_2_0_7 containing the Staff Client. To complete the Staff Client installation, as the root user execute the following commands @@ -1670,7 +1670,7 @@ # as the root user: cd /openils/var/web/xul - ln -sf rel_2_0_4/server server + ln -sf rel_2_0_7/server server @@ -1803,7 +1803,7 @@ # as the root user: - cd /home/opensrf/Evergreen-ILS-2.0.4 + cd /home/opensrf/Evergreen-ILS-2.0.7 perl Open-ILS/src/support-scripts/eg_db_config.pl --update-config \ --service all --create-schema --create-offline \ --hostname HOSTNAME --port PORT \ @@ -1852,7 +1852,7 @@ # as the root user: - cd /home/opensrf/Evergreen-ILS-2.0.4 + cd /home/opensrf/Evergreen-ILS-2.0.7 cp Open-ILS/examples/apache/eg.conf /etc/httpd/conf.d/ cp Open-ILS/examples/apache/eg_vhost.conf /etc/httpd/ cp Open-ILS/examples/apache/startup.pl /etc/httpd/ @@ -2221,7 +2221,7 @@ # as the opensrf user: cd /home/opensrf - ./Evergreen-ILS-2.0.4/Open-ILS/src/support-scripts/settings-tester.pl + ./Evergreen-ILS-2.0.7/Open-ILS/src/support-scripts/settings-tester.pl If the output of settings-tester.pl does not help you find the problem, please do not make any significant changes to your @@ -2254,7 +2254,7 @@ # as the root user: - xulrunner /home/opensrf/Evergreen-ILS-2.0.4/Open-ILS/xul/staff_client/build/application.ini + xulrunner /home/opensrf/Evergreen-ILS-2.0.7/Open-ILS/xul/staff_client/build/application.ini A login screen for the Staff Client similar to this should appear: @@ -2395,7 +2395,7 @@ /openils/conf/lib_ips.txt and modifying the Apache startup script /etc/apache2/startup.pl. First, copy the sample file - /home/opensrf/Evergreen-ILS-1.6.1.2/Open-ILS/examples/lib_ips.txt.example + /home/opensrf/Evergreen-ILS-2.0.0/Open-ILS/examples/lib_ips.txt.example to /openils/conf/lib_ips.txt. The example file contains the single line: "MY-LIB 127.0.0.1 127.0.0.254". You must modify the file to use the IP address ranges for your library system. Add new lines to represent the IP address -- 2.11.0