Updated the server instalation documentation to refer to the 2.0.7 release of EG...
authorYamil Suarez <github@yamil.com>
Wed, 29 Jun 2011 21:04:09 +0000 (17:04 -0400)
committerYamil Suarez <github@yamil.com>
Wed, 29 Jun 2011 21:04:09 +0000 (17:04 -0400)
2.0/admin/Upgrading-Evergreen-2.0.xml
2.0/admin/serversideinstallation_2.0.xml

index 44e1eb0..de44c7c 100644 (file)
@@ -59,7 +59,7 @@
                                2.0:</para>\r
 <screen><userinput>\r
 wget http://open-ils.org/downloads/opensrf-2.0.0.tar.gz\r
-tar xzf opensrf-1.6.3.tar.gz\r
+tar xzf opensrf-2.0.0.tar.gz\r
 </userinput></screen>\r
                                <para>A new directory opensrf-2.0.0 is created.</para>\r
                                <note><para>For the latest edition of OpenSRF, check the Evergreen download page at \r
@@ -201,15 +201,15 @@ cp /openils/conf/opensrf_core.xml.backup /openils/conf/opensrf_core.xml
                                <para>As the <systemitem class="username">opensrf</systemitem> user, download and extract <application>Evergreen 2.0</application>\r
                                </para>\r
 <screen><userinput>\r
-wget http://www.open-ils.org/downloads/Evergreen-ILS-2.0.6.tar.gz\r
-tar xzf Evergreen-ILS-2.0.6.tar.gz\r
+wget http://www.open-ils.org/downloads/Evergreen-ILS-2.0.7.tar.gz\r
+tar xzf Evergreen-ILS-2.0.7.tar.gz\r
 </userinput></screen>\r
                                <note><para>For the latest edition of Evergreen 2.0, check the Evergreen download page at\r
                                <ulink url="http://www.open-ils.org/downloads.php" /> and adjust upgrading instructions accordingly.</para></note>\r
                        </step>\r
                        <step>\r
                                <para>As the <systemitem class="username">root</systemitem> user, install the prerequisites:</para> \r
-                               <screen><userinput>cd /home/opensrf/Evergreen-ILS-2.0.6</userinput></screen>    \r
+                               <screen><userinput>cd /home/opensrf/Evergreen-ILS-2.0.7</userinput></screen>    \r
                                <para>On the next command, replace <option>[distribution]</option> with one of \r
                                these values for your distribution of Debian or Ubuntu:</para>\r
                                <itemizedlist>\r
@@ -228,14 +228,14 @@ tar xzf Evergreen-ILS-2.0.6.tar.gz
                        <step>\r
                                <para>As the <systemitem class="username">opensrf</systemitem> user, configure and compile \r
                                <application>Evergreen</application>:</para>\r
-                               <screen><userinput>cd /home/opensrf/Evergreen-ILS-2.0.6</userinput></screen>\r
+                               <screen><userinput>cd /home/opensrf/Evergreen-ILS-2.0.7</userinput></screen>\r
                                <screen><userinput>./configure --prefix=/openils --sysconfdir=/openils/conf</userinput></screen>\r
                                <screen><userinput>make</userinput></screen>\r
                        </step>\r
                        <step>\r
                                <para>As the <systemitem class="username">root</systemitem> user, install \r
                                <application>Evergreen</application>:</para>\r
-                               <screen><userinput>make STAFF_CLIENT_BUILD_ID=rel_2_0_6 install</userinput></screen>\r
+                               <screen><userinput>make STAFF_CLIENT_BUILD_ID=rel_2_0_7 install</userinput></screen>\r
                        </step>\r
                        <step>\r
                                <para>As the <emphasis>root</emphasis> user, change all files to be owned by the \r
@@ -247,13 +247,13 @@ tar xzf Evergreen-ILS-2.0.6.tar.gz
 <screen><userinput>\r
 cd /openils/var/web/xul/\r
 rm server\r
-ln -s rel_2_0_6/server\r
+ln -s rel_2_0_7/server\r
 </userinput></screen>\r
                        </step>\r
                        <step>\r
                                <para>Change to the <application>Evergreen</application> installation \r
                                directory:</para>\r
-                               <screen><userinput>cd /home/opensrf/Evergreen-ILS-2.0.6</userinput></screen>\r
+                               <screen><userinput>cd /home/opensrf/Evergreen-ILS-2.0.7</userinput></screen>\r
                        </step>\r
 \r
                        <step>\r
@@ -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\r
 psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.4-2.0.5-upgrade-db.sql evergreen\r
 psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.5-2.0.6-upgrade-db.sql evergreen\r
+psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.6-2.0.7-upgrade-db.sql evergreen\r
+\r
 </userinput>\r
 </screen>      \r
                              \r
index b447b74..00c4d94 100644 (file)
                <para>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.</para>
-               <section xml:id="serversideinstallation-opensrf-1.6.3">
+               <section xml:id="serversideinstallation-opensrf-2.0.0">
                        <indexterm>
                                <primary>OpenSRF</primary>
                                <secondary>installation</secondary>
                        </indexterm>
-                       <title>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></title>
                        <indexterm>
                                <primary>Linux</primary>
                                                <secondary>download</secondary>
                                        </indexterm>
                                        <para>The latest version of OpenSRF can be found here:
-                                       <ulink url="http://evergreen-ils.org/downloads/opensrf-1.6.3.tar.gz"></ulink> .
+                                       <ulink url="http://evergreen-ils.org/downloads/opensrf-2.0.0.tar.gz"></ulink> .
                                        As the <systemitem class="username">opensrf</systemitem> user, change to
                                        the directory <filename class="directory">/home/opensrf</filename> then download
                                        and extract OpenSRF. The new subdirectory
-                                       <filename class="directory">/home/opensrf/opensrf-1.6.3</filename> will be created:</para>
+                                       <filename class="directory">/home/opensrf/opensrf-2.0.0</filename> will be created:</para>
                                        <screen>
                                                <userinput>
        # 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</userinput>
+       wget http://evergreen-ils.org/downloads/opensrf-2.0.0.tar.gz
+       tar zxf opensrf-2.0.0.tar.gz</userinput>
                                        </screen>
                                </step>
                                <step>
                                        <screen>
                                                <userinput>
        # 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]</userinput>
                                        </screen>
                                        <table xml:id="serversideinstallation-keywords-opensrf">
                                                        <screen>
                                                                <userinput>
        # 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</userinput>
                                                        </screen>
                                                        <screen>
                                                                <userinput>
        # as the root user:
-       cd /home/opensrf/opensrf-1.6.3
+       cd /home/opensrf/opensrf-2.0.0
        make install</userinput>
                                                        </screen>
                                                        <para>This step will take several minutes to complete.</para>
                                        <para>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 
-                                       <xref linkend="serversideinstallation-opensrf-1.6.3"/>.</para>
+                                       <xref linkend="serversideinstallation-opensrf-2.0.0"/>.</para>
                                        <para>Follow the steps outlined in that section and run the specified tests to
                                        ensure that OpenSRF is properly installed and configured. Do 
                                        <emphasis><emphasis role="bold">not</emphasis></emphasis> continue with
                                <step>
                                        <title>Download and Unpack Latest Evergreen Version</title>
                                        <para>The latest version of Evergreen can be found here:
-                                       <ulink url="http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.4.tar.gz"></ulink> .
+                                       <ulink url="http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.7.tar.gz"></ulink> .
                                        As the <systemitem class="username">opensrf</systemitem> user, change to
                                        the directory <filename class="directory">/home/opensrf</filename> then download
                                        and extract Evergreen. The new subdirectory
-                                       <filename class="directory">/home/opensrf/Evergreen-ILS-2.0.4</filename>
+                                       <filename class="directory">/home/opensrf/Evergreen-ILS-2.0.7</filename>
                                        will be created:</para>
                                        <screen>
                                                <userinput>
        # 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</userinput>
+       wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.7.tar.gz
+       tar zxf Evergreen-ILS-2.0.7.tar.gz</userinput>
                                        </screen>
                                </step>
                                <step xml:id="serversideinstallation-installprereq">
                                        <screen>
                                                <userinput>
        # 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]</userinput>
                                        </screen>
                                </step>
                                        <screen>
                                                <userinput>
        # 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</userinput>
                                        </screen>
                                        <screen>
                                                <userinput>
        # as the root user:
-       cd /home/opensrf/Evergreen-ILS-2.0.4
-       make STAFF_CLIENT_BUILD_ID=rel_2_0_4 install</userinput>
+       cd /home/opensrf/Evergreen-ILS-2.0.7
+       make STAFF_CLIENT_BUILD_ID=rel_2_0_7 install</userinput>
                                        </screen>
                                        <para>The Staff Client will also be automatically built, but you must remember
                                        to set the variable <envar>STAFF_CLIENT_BUILD_ID</envar> to match the version of the 
                                        Staff Client you will use to connect to the Evergreen server.</para>
                                        <para>The above commands will create a new subdirectory
-                                       <filename class="directory">/openils/var/web/xul/rel_2_0_4</filename> 
+                                       <filename class="directory">/openils/var/web/xul/rel_2_0_7</filename> 
                                        containing the Staff Client.</para>
                                        <para>To complete the Staff Client installation, as the
                                        <systemitem class="username">root</systemitem> user execute the following commands to
                                                <userinput>
        # as the root user:
        cd /openils/var/web/xul
-       ln -sf rel_2_0_4/server server</userinput>
+       ln -sf rel_2_0_7/server server</userinput>
                                        </screen>
                                </step>
                                <step>
                                                        <screen>
                                                                <userinput>
        # 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 \
                                                        <screen>
                                                                <userinput>
        # 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/</userinput>
                                        <para>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 
-                                       <xref linkend="serversideinstallation-opensrf-1.6.3"/>.</para>
+                                       <xref linkend="serversideinstallation-opensrf-2.0.0"/>.</para>
                                        <para>Follow the steps outlined in that section and run the specified tests to
                                        ensure that OpenSRF is properly installed and configured. Do 
                                        <emphasis><emphasis role="bold">not</emphasis></emphasis> continue with
                                <step>
                                        <title>Download and Unpack Latest Evergreen Version</title>
                                        <para>The latest version of Evergreen can be found here:
-                                       <ulink url="http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.4.tar.gz"></ulink> .
+                                       <ulink url="http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.7.tar.gz"></ulink> .
                                        As the <systemitem class="username">opensrf</systemitem> user, change to
                                        the directory <filename class="directory">/home/opensrf</filename> then 
                                        download and extract Evergreen. The new subdirectory
-                                       <filename class="directory">/home/opensrf/Evergreen-ILS-2.0.4</filename> 
+                                       <filename class="directory">/home/opensrf/Evergreen-ILS-2.0.7</filename> 
                                        will be created:</para>
                                        <screen>
                                                <userinput>
        # 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</userinput>
+       wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.7.tar.gz
+       tar zxf Evergreen-ILS-2.0.7.tar.gz</userinput>
                                        </screen>
                                </step>
                                <step xml:id="serversideinstallation-installprereq-2.0">
                                        <screen>
                                                <userinput>
        # 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]</userinput>
                                        </screen>
                                </step>
                                        <screen>
                                                <userinput>
        # 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</userinput>
                                        </screen>
                                        <screen>
                                                <userinput>
        # as the root user:
-       cd /home/opensrf/Evergreen-ILS-2.0.4
-       make STAFF_CLIENT_BUILD_ID=rel_2_0_4 install</userinput>
+       cd /home/opensrf/Evergreen-ILS-2.0.7
+       make STAFF_CLIENT_BUILD_ID=rel_2_0_7 install</userinput>
                                        </screen>
                                        <para>The Staff Client will also be automatically built, but you must remember
                                        to set the variable <envar>STAFF_CLIENT_BUILD_ID</envar> to match the version of the 
                                        Staff Client you will use to connect to the Evergreen server.</para>
                                        <para>The above commands will create a new subdirectory
-                                       <filename class="directory">/openils/var/web/xul/rel_2_0_4</filename> 
+                                       <filename class="directory">/openils/var/web/xul/rel_2_0_7</filename> 
                                        containing the Staff Client.</para>
                                        <para>To complete the Staff Client installation, as the
                                        <systemitem class="username">root</systemitem> user execute the following commands
                                                <userinput>
        # as the root user:
        cd /openils/var/web/xul
-       ln -sf rel_2_0_4/server server</userinput>
+       ln -sf rel_2_0_7/server server</userinput>
                                        </screen>
                                </step>
                                <step>
                                                        <screen>
                                                                <userinput>
        # 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 \
                                                        <screen>
                                                                <userinput>
        # 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/</userinput>
                                                        <userinput>
        # as the opensrf user:
        cd /home/opensrf
-       ./Evergreen-ILS-2.0.4/Open-ILS/src/support-scripts/settings-tester.pl</userinput>
+       ./Evergreen-ILS-2.0.7/Open-ILS/src/support-scripts/settings-tester.pl</userinput>
                                                </screen>
                                                <para>If the output of <command>settings-tester.pl</command> does not help
                                                you find the problem, please do not make any significant changes to your
                                <screen>
                                        <userinput>
        # as the root user:
-       xulrunner /home/opensrf/Evergreen-ILS-2.0.4/Open-ILS/xul/staff_client/build/application.ini</userinput>
+       xulrunner /home/opensrf/Evergreen-ILS-2.0.7/Open-ILS/xul/staff_client/build/application.ini</userinput>
                                </screen>
                                <para>A login screen for the Staff Client similar to this should appear:</para>
                                <mediaobject>
                                <filename>/openils/conf/lib_ips.txt</filename> and modifying the Apache startup script
                                <filename>/etc/apache2/startup.pl</filename>.</para>
                                <para>First, copy the sample file
-                               <filename>/home/opensrf/Evergreen-ILS-1.6.1.2/Open-ILS/examples/lib_ips.txt.example</filename>
+                               <filename>/home/opensrf/Evergreen-ILS-2.0.0/Open-ILS/examples/lib_ips.txt.example</filename>
                                to <filename>/openils/conf/lib_ips.txt</filename>. The example file contains the single
                                line: <literal>"MY-LIB 127.0.0.1 127.0.0.254"</literal>. You must modify the file to use
                                the IP address ranges for your library system. Add new lines to represent the IP address