<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>
<userinput>
# as the root user:
echo "/openils/lib" > /etc/ld.so.conf.d/osrf.conf
- echo "/usr/local/lib >> /etc/ld.so.conf.d/osrf.conf
+ echo "/usr/local/lib" >> /etc/ld.so.conf.d/osrf.conf
ldconfig</userinput>
</screen>
</step>
<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">
below to build the prerequisites from the software distribution that you just downloaded
and unpacked. Remember to replace <emphasis>[DISTRIBUTION]</emphasis> in the following
example with the keyword corresponding to the name of one of the
- <systemitem class="osname">Linux</systemitem> distributions listed in the following
- distribution list.
+ <systemitem class="osname">Linux</systemitem> distributions listed in the in the
+ distribution keywords table <xref linkend="serversideinstallation-keywords-evergreen"/>.
For example, to install the prerequisites for Ubuntu version 10.05 (Lucid Lynx) you would
enter this command: <command>make -f Open-ILS/src/extras/Makefile.install
ubuntu-lucid</command>.</para>
<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>
+
+ <table xml:id="serversideinstallation-keywords-evergreen">
+ <?dbfo keep-together="always" ?>
+ <title>Keyword Targets for Evergreen <application>"make"</application> Command</title>
+ <tgroup align="left" cols="2" colsep="1" rowsep="1">
+ <colspec colname="keyword" colnum="1" colwidth="1.0*"/>
+ <colspec colname="linux_version" colnum="2" colwidth="3.0*"/>
+ <thead>
+ <row>
+ <entry>Keyword</entry>
+ <entry>Linux Version</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>debian-squeeze</entry>
+ <entry>Debian "Squeeze" (6.0)</entry>
+ </row>
+ <row>
+ <entry>debian-lenny</entry>
+ <entry>Debian "Lenny" (5.0)</entry>
+ </row>
+ <row>
+ <entry>ubuntu-hardy</entry>
+ <entry>Ubuntu "Hardy Heron" (8.04)</entry>
+ </row>
+ <row>
+ <entry>ubuntu-lucid</entry>
+ <entry>Ubuntu "Lucid Lynx" (10.04)</entry>
+ </row>
+ <row>
+ <entry>fedora13</entry>
+ <entry>Fedora "Goddard" (13)</entry>
+ </row>
+ <row>
+ <entry>centos</entry>
+ <entry>CentOS 5</entry>
+ </row>
+ <row>
+ <entry>rhel</entry>
+ <entry>Red Hat Enterprise Linux 5</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ <indexterm>
+ <primary>Linux</primary>
+ <secondary>Debian</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>Linux</primary>
+ <secondary>Fedora</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>Linux</primary>
+ <secondary>Ubuntu</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>Linux</primary>
+ <secondary>CentOS</secondary>
+ </indexterm>
+ <indexterm>
+ <primary>Linux</primary>
+ <secondary>Red Hat</secondary>
+ </indexterm>
</step>
<step performance="optional">
<title>(OPTIONAL) Install the PostgreSQL Server</title>
<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>The following updates are needed to allow the logs
to function properly, but it may break other Apache
applications on your server:</para>
- <para>Edit the Apache configuration file and
+ <para>As the <systemitem class="username">root</systemitem> user, edit the Apache configuration file <filename>/etc/apache2/envvars</filename> and
change the lines:</para>
<screen>
- <userinput>export APACHE_RUN_USER=www-data</userinput>
- <userinput>export APACHE_RUN_GROUP=www-data</userinput>
+ <userinput>
+ export APACHE_RUN_USER=www-data
+ export APACHE_RUN_GROUP=www-data</userinput>
</screen>
<para>to instead read:</para>
<screen>
<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
projects / working / Evergreen.git / commitdiff