+
.. Back up the /openils directory.
. Upgrade OpenSRF. Download and install the latest version of OpenSRF from
-the http://evergreen-ils.org/opensrf.php[OpenSRF download page].
+the http://evergreen-ils.org/opensrf-downloads/[OpenSRF download page].
. As the opensrf user, download and extract Evergreen 2.3:
+
[source, bash]
-----------------------------------------------
-wget http://www.open-ils.org/downloads/Evergreen-ILS-2.3.3.tar.gz
-tar xzf Evergreen-ILS-2.3.3.tar.gz
+wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.3.10.tar.gz
+tar xzf Evergreen-ILS-2.3.10.tar.gz
-----------------------------------------------
+
[NOTE]
-For the latest edition of Evergreen, check the http://evergreen-ils.org/downloads.php[Evergreen download page] and adjust upgrading instructions accordingly.
+For the latest edition of Evergreen, check the http://evergreen-ils.org/egdownloads/[Evergreen download page] and adjust upgrading instructions accordingly.
+
. As the root user, install the prerequisites:
+
[source, bash]
----------------------------------------------
-cd /home/opensrf/Evergreen-ILS-2.3.3
+cd /home/opensrf/Evergreen-ILS-2.3.10
---------------------------------------------
+
On the next command, replace `[distribution]` with one of these values for your
+
[source, bash]
------------------------------------------------------------
-cd /home/opensrf/Evergreen-ILS-2.3.3
+cd /home/opensrf/Evergreen-ILS-2.3.10
./configure --prefix=/openils --sysconfdir=/openils/conf
make
------------------------------------------------------------
+
[source, bash]
------------------------------------------------------------
-cd /home/opensrf/Evergreen-ILS-2.3.3
-make STAFF_CLIENT_STAMP_ID=rel_2_3_3 install
+cd /home/opensrf/Evergreen-ILS-2.3.10
+make STAFF_CLIENT_STAMP_ID=rel_2_3_10 install
------------------------------------------------------------
+
. As the root user, change all files to be owned by the opensrf user and group:
-----------------------------------------------------------
cd /openils/var/web/xul/
rm server
-ln -sf rel_2_3_3/server server
+ln -sf rel_2_3_10/server server
----------------------------------------------------------
+
. As the opensrf user, update opensrf_core.xml and opensrf.xml by copying the
+
[source, bash]
-------------------------------------------------------------------------
-cd /home/opensrf/Evergreen-ILS-2.3.3
+cd /home/opensrf/Evergreen-ILS-2.3.10
perl Open-ILS/src/support-scripts/eg_db_config.pl --update-config --service all \
--create-offline --database evergreen --host localhost --user evergreen --password evergreen
-------------------------------------------------------------------------
+
[source, bash]
----------------------------------------------------------
-cp /home/opensrf/Evergreen-ILS-2.3.3/Open-ILS/examples/apache/startup.pl /etc/apache2/startup.pl
+cp /home/opensrf/Evergreen-ILS-2.3.10/Open-ILS/examples/apache/startup.pl /etc/apache2/startup.pl
----------------------------------------------------------
+
.. Update /etc/apache2/eg_vhost.conf by copying the example from Open-ILS/examples/apache/eg_vhost.conf.
+
[source, bash]
----------------------------------------------------------
-cp /home/opensrf/Evergreen-ILS-2.3.3/Open-ILS/examples/apache/eg_vhost.conf /etc/apache2/eg_vhost.conf
+cp /home/opensrf/Evergreen-ILS-2.3.10/Open-ILS/examples/apache/eg_vhost.conf /etc/apache2/eg_vhost.conf
----------------------------------------------------------
+
.. Update /etc/apache2/sites-available/eg.conf by copying the example from Open-ILS/ examples/apache/eg.conf.
+
[source, bash]
----------------------------------------------------------
-cp /home/opensrf/Evergreen-ILS-2.3.3/Open-ILS/examples/apache/eg.conf /etc/apache2/sites-available/eg.conf
+cp /home/opensrf/Evergreen-ILS-2.3.10/Open-ILS/examples/apache/eg.conf /etc/apache2/sites-available/eg.conf
----------------------------------------------------------
Upgrade the Evergreen database schema
[CAUTION]
Pay attention to error output as you run the upgrade scripts. If you encounter errors
that you cannot resolve yourself through additional troubleshooting, please
-report the errors to the http://evergreen-ils.org/listserv.php[Evergreen
+report the errors to the http://evergreen-ils.org/communicate/mailing-lists/[Evergreen
Technical Discussion List].
Run the following script as a user with the ability to connect to the
[source, bash]
----------------------------------------------------------
-cd /home/opensrf/Evergreen-ILS-2.3.3/Open-ILS/src/sql/Pg
+cd /home/opensrf/Evergreen-ILS-2.3.10/Open-ILS/src/sql/Pg
psql -U evergreen -h localhost -f version-upgrade/2.2-2.3.0-upgrade-db.sql evergreen
psql -U evergreen -h localhost -f version-upgrade/2.3.0-2.3.1-upgrade-db.sql evergreen
psql -U evergreen -h localhost -f version-upgrade/2.3.1-2.3.2-upgrade-db.sql evergreen
psql -U evergreen -h localhost -f version-upgrade/2.3.2-2.3.3-upgrade-db.sql evergreen
+psql -U evergreen -h localhost -f version-upgrade/2.3.3-2.3.4-upgrade-db.sql evergreen
+psql -U evergreen -h localhost -f version-upgrade/2.3.4-2.3.5-upgrade-db.sql evergreen
+psql -U evergreen -h localhost -f version-upgrade/2.3.5-2.3.6-upgrade-db.sql evergreen
+psql -U evergreen -h localhost -f version-upgrade/2.3.6-2.3.7-upgrade-db.sql evergreen
+psql -U evergreen -h localhost -f version-upgrade/2.3.7-2.3.8-upgrade-db.sql evergreen
+psql -U evergreen -h localhost -f version-upgrade/2.3.8-2.3.9-upgrade-db.sql evergreen
+psql -U evergreen -h localhost -f version-upgrade/2.3.9-2.3.10-upgrade-db.sql evergreen
----------------------------------------------------------
Restart Evergreen and Test