<title>Upgrade <application>Evergreen</application> from 1.4 to 1.6.1</title>\r
<procedure>\r
<step>\r
- <para>As the <systemitem class="username">opensrf</systemitem> user, download and extract <application>Evergreen 1.6.1.8</application>\r
+ <para>As the <systemitem class="username">opensrf</systemitem> user, download and extract <application>Evergreen 1.6.1.9</application>\r
</para>\r
<screen><userinput>\r
-wget http://open-ils.org/downloads/Evergreen-ILS-1.6.1.8.tar.gz\r
-tar xzf Evergreen-ILS-1.6.1.8.tar.gz\r
+wget http://open-ils.org/downloads/Evergreen-ILS-1.6.1.9.tar.gz\r
+tar xzf Evergreen-ILS-1.6.1.9.tar.gz\r
</userinput></screen>\r
<note><para>For the latest edition of Evergreen 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-1.6.1.8</userinput></screen> \r
+ <screen><userinput>cd /home/opensrf/Evergreen-ILS-1.6.1.9</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
<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-1.6.1.8</userinput></screen>\r
+ <screen><userinput>cd /home/opensrf/Evergreen-ILS-1.6.1.9</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_1_6_1_8 install</userinput></screen>\r
+ <screen><userinput>make STAFF_CLIENT_BUILD_ID=rel_1_6_1_9 install</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-1.6.1.8</userinput></screen>\r
+ <screen><userinput>cd /home/opensrf/Evergreen-ILS-1.6.1.9</userinput></screen>\r
</step>\r
<step>\r
<para>As the <emphasis>root</emphasis> user, change all files to be owned by the \r
<para>As the <systemitem class="username">root</systemitem> user, build <filename>live-db-setup.pl</filename> for the cgi-bin \r
bootstrapping scripts and <filename>offline-config.pl</filename> for the offline staff client data uploader:</para>\r
<screen><userinput>\r
-cd /home/opensrf/Evergreen-ILS-1.6.1.8\r
+cd /home/opensrf/Evergreen-ILS-1.6.1.9\r
perl Open-ILS/src/support-scripts/eg_db_config.pl --create-bootstrap --create-offline \ \r
--user evergreen --password evergreen --hostname localhost --port 5432 \\r
--database evergreen\r
<screen><userinput>\r
cd /openils/var/web/xul/\r
rm server\r
-ln -s rel_1_6_1_8/server\r
+ln -s rel_1_6_1_9/server\r
</userinput></screen>\r
</step>\r
<step>\r
psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.4-1.6.1.5-upgrade-db.sql evergreen\r
psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.5-1.6.1.6-upgrade-db.sql evergreen\r
psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.6-1.6.1.7-upgrade-db.sql evergreen\r
-psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.8-1.6.1.8-upgrade-db.sql evergreen\r
+psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.7-1.6.1.8-upgrade-db.sql evergreen\r
+psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.8-1.6.1.9-upgrade-db.sql evergreen\r
</userinput>\r
</screen> \r
</step>\r
psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.5-1.6.1.6-upgrade-db.sql evergreen\r
psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.6-1.6.1.7-upgrade-db.sql evergreen\r
psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.7-1.6.1.8-upgrade-db.sql evergreen\r
+psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.1.8-1.6.1.9-upgrade-db.sql evergreen\r
</userinput>\r
</screen> \r
</step>\r
<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-1.6.1.8.tar.gz"></ulink> .
+ <ulink url="http://evergreen-ils.org/downloads/Evergreen-ILS-1.6.1.9.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-1.6.1.8</filename> will be created:</para>
+ <filename class="directory">/home/opensrf/Evergreen-ILS-1.6.1.9</filename> will be created:</para>
<screen>
<userinput>
# as the opensrf user:
cd /home/opensrf
- wget http://evergreen-ils.org/downloads/Evergreen-ILS-1.6.1.8.tar.gz
- tar zxf Evergreen-ILS-1.6.1.8.tar.gz</userinput>
+ wget http://evergreen-ils.org/downloads/Evergreen-ILS-1.6.1.9.tar.gz
+ tar zxf Evergreen-ILS-1.6.1.9.tar.gz</userinput>
</screen>
</step>
<step xml:id="serversideinstallation-installprereq">
<screen>
<userinput>
# as the root user:
- cd /home/opensrf/Evergreen-ILS-1.6.1.8
+ cd /home/opensrf/Evergreen-ILS-1.6.1.9
make -f Open-ILS/src/extras/Makefile.install [DISTRIBUTION]</userinput>
</screen>
<table xml:id="serversideinstallation-keywords-evergreen">
for more information.</para>
<note>
<para>PostgreSQL versions 8.3 or 8.4 are the recommended versions to work
- with Evergreen version 1.6.1.8 . If you have an older version of PostgreSQL,
+ with Evergreen version 1.6.1.9 . If you have an older version of PostgreSQL,
you should upgrade before installing Evergreen. To find your current version
of PostgreSQL, as the <systemitem class="username">postgres</systemitem>
user execute the command <command>psql</command>, then type
<screen>
<userinput>
# as the opensrf user:
- cd /home/opensrf/Evergreen-ILS-1.6.1.8
+ cd /home/opensrf/Evergreen-ILS-1.6.1.9
./configure --prefix=/openils --sysconfdir=/openils/conf
make</userinput>
</screen>
<screen>
<userinput>
# as the root user:
- cd /home/opensrf/Evergreen-ILS-1.6.1.8
- make STAFF_CLIENT_BUILD_ID=rel_1_6_1_8 install</userinput>
+ cd /home/opensrf/Evergreen-ILS-1.6.1.9
+ make STAFF_CLIENT_BUILD_ID=rel_1_6_1_9 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_1_6_1_8</filename>
+ <filename class="directory">/openils/var/web/xul/rel_1_6_1_9</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_1_6_1_8/server server</userinput>
+ ln -sf rel_1_6_1_9/server server</userinput>
</screen>
</step>
<step>
<screen>
<userinput>
# as the root user:
- cd /home/opensrf/Evergreen-ILS-1.6.1.8
+ cd /home/opensrf/Evergreen-ILS-1.6.1.9
perl Open-ILS/src/support-scripts/eg_db_config.pl --update-config \
--service all --create-schema --create-bootstrap --create-offline \
--hostname HOSTNAME --port PORT \
<screen>
<userinput>
# as the root user:
- cd /home/opensrf/Evergreen-ILS-1.6.1.8
+ cd /home/opensrf/Evergreen-ILS-1.6.1.9
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>
<userinput>
# as the opensrf user:
cd /home/opensrf
- ./Evergreen-ILS-1.6.1.8/Open-ILS/src/support-scripts/settings-tester.pl</userinput>
+ ./Evergreen-ILS-1.6.1.9/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-1.6.1.8/Open-ILS/xul/staff_client/build/application.ini</userinput>
+ xulrunner /home/opensrf/Evergreen-ILS-1.6.1.9/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.8/Open-ILS/examples/lib_ips.txt.example</filename>
+ <filename>/home/opensrf/Evergreen-ILS-1.6.1.9/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
<screen>
<userinput>
# as the opensrf user
- cd /home/opensrf/Evergreen-ILS-1.6.1.8/Open-ILS
+ cd /home/opensrf/Evergreen-ILS-1.6.1.9/Open-ILS
xulrunner-1.9 xul/staff_client/build/application.ini</userinput>
</screen>
<para>Connect to
by getting your host-based connection running (see
<xref linkend="serversideinstallation-virtual-vm-host-based"/>).
Once you have a host-based connection, you can install and use the
- <systemitem class="osname">Windows</systemitem> 1.6.1.8 staff
+ <systemitem class="osname">Windows</systemitem> 1.6.1.9 staff
client available from
- <ulink url="http://evergreen-ils.org/downloads/evergreen-setup-rel_1_6_1_8.exe">
- http://evergreen-ils.org/downloads/evergreen-setup-rel_1_6_1_8.exe</ulink>
+ <ulink url="http://evergreen-ils.org/downloads/evergreen-setup-rel_1_6_1_9.exe">
+ http://evergreen-ils.org/downloads/evergreen-setup-rel_1_6_1_9.exe</ulink>
to connect to the virtual Evergreen system from another
<systemitem class="osname">Windows</systemitem> machine.</para>
</step>
<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.9.tar.gz\r
-tar xzf Evergreen-ILS-2.0.9.tar.gz\r
+wget http://www.open-ils.org/downloads/Evergreen-ILS-2.0.10.tar.gz\r
+tar xzf Evergreen-ILS-2.0.10.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.9</userinput></screen> \r
+ <screen><userinput>cd /home/opensrf/Evergreen-ILS-2.0.10</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
<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.9</userinput></screen>\r
+ <screen><userinput>cd /home/opensrf/Evergreen-ILS-2.0.10</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_9 install</userinput></screen>\r
+ <screen><userinput>make STAFF_CLIENT_BUILD_ID=rel_2_0_10 install</userinput></screen>\r
</step>\r
<step>\r
<para>As the <emphasis>root</emphasis> user, change all files to be owned by the \r
<screen><userinput>\r
cd /openils/var/web/xul/\r
rm server\r
-ln -s rel_2_0_9/server\r
+ln -s rel_2_0_10/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.9</userinput></screen>\r
+ <screen><userinput>cd /home/opensrf/Evergreen-ILS-2.0.10</userinput></screen>\r
</step>\r
\r
<step>\r
psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.6-2.0.7-upgrade-db.sql evergreen\r
psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.7-2.0.8-upgrade-db.sql evergreen\r
psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.8-2.0.9-upgrade-db.sql evergreen\r
+psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.9-2.0.10-upgrade-db.sql evergreen\r
\r
</userinput>\r
</screen> \r
</userinput></screen>\r
</step>\r
<step>\r
- <para>as the <systemitem class="username">postgres</systemitem> user, load data from backup into PostgreSQL 9.0.</para>\r
+ <para>as the <systemitem class="username">postgres</systemitem> user, load data from backup into PostgreSQL 2.0.10.0.</para>\r
<screen><userinput><![CDATA[ \r
psql < data\r
]]></userinput></screen>\r
<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.9.tar.gz"></ulink> .
+ <ulink url="http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.10.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.9</filename>
+ <filename class="directory">/home/opensrf/Evergreen-ILS-2.0.10</filename>
will be created:</para>
<screen>
<userinput>
# as the opensrf user:
cd /home/opensrf
- wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.9.tar.gz
- tar zxf Evergreen-ILS-2.0.9.tar.gz</userinput>
+ wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.10.tar.gz
+ tar zxf Evergreen-ILS-2.0.10.tar.gz</userinput>
</screen>
</step>
<step xml:id="serversideinstallation-installprereq">
<screen>
<userinput>
# as the root user:
- cd /home/opensrf/Evergreen-ILS-2.0.9
+ cd /home/opensrf/Evergreen-ILS-2.0.10
make -f Open-ILS/src/extras/Makefile.install [DISTRIBUTION]</userinput>
</screen>
<screen>
<userinput>
# as the opensrf user:
- cd /home/opensrf/Evergreen-ILS-2.0.9
+ cd /home/opensrf/Evergreen-ILS-2.0.10
./configure --prefix=/openils --sysconfdir=/openils/conf
make</userinput>
</screen>
<screen>
<userinput>
# as the root user:
- cd /home/opensrf/Evergreen-ILS-2.0.9
- make STAFF_CLIENT_BUILD_ID=rel_2_0_9 install</userinput>
+ cd /home/opensrf/Evergreen-ILS-2.0.10
+ make STAFF_CLIENT_BUILD_ID=rel_2_0_10 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_9</filename>
+ <filename class="directory">/openils/var/web/xul/rel_2_0_10</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_9/server server</userinput>
+ ln -sf rel_2_0_10/server server</userinput>
</screen>
</step>
<step>
<screen>
<userinput>
# as the root user:
- cd /home/opensrf/Evergreen-ILS-2.0.9
+ cd /home/opensrf/Evergreen-ILS-2.0.10
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.9
+ cd /home/opensrf/Evergreen-ILS-2.0.10
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>
<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.9.tar.gz"></ulink> .
+ <ulink url="http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.10.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.9</filename>
+ <filename class="directory">/home/opensrf/Evergreen-ILS-2.0.10</filename>
will be created:</para>
<screen>
<userinput>
# as the opensrf user:
cd /home/opensrf
- wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.9.tar.gz
- tar zxf Evergreen-ILS-2.0.9.tar.gz</userinput>
+ wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.10.tar.gz
+ tar zxf Evergreen-ILS-2.0.10.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.9
+ cd /home/opensrf/Evergreen-ILS-2.0.10
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.9
+ cd /home/opensrf/Evergreen-ILS-2.0.10
./configure --prefix=/openils --sysconfdir=/openils/conf
make</userinput>
</screen>
<screen>
<userinput>
# as the root user:
- cd /home/opensrf/Evergreen-ILS-2.0.9
- make STAFF_CLIENT_BUILD_ID=rel_2_0_9 install</userinput>
+ cd /home/opensrf/Evergreen-ILS-2.0.10
+ make STAFF_CLIENT_BUILD_ID=rel_2_0_10 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_9</filename>
+ <filename class="directory">/openils/var/web/xul/rel_2_0_10</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_9/server server</userinput>
+ ln -sf rel_2_0_10/server server</userinput>
</screen>
</step>
<step>
<screen>
<userinput>
# as the root user:
- cd /home/opensrf/Evergreen-ILS-2.0.9
+ cd /home/opensrf/Evergreen-ILS-2.0.10
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.9
+ cd /home/opensrf/Evergreen-ILS-2.0.10
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.9/Open-ILS/src/support-scripts/settings-tester.pl</userinput>
+ ./Evergreen-ILS-2.0.10/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.9/Open-ILS/xul/staff_client/build/application.ini</userinput>
+ xulrunner /home/opensrf/Evergreen-ILS-2.0.10/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>