Installing prerequisites
------------------------
- * **PostgreSQL**: Version 9.4 is recommended.
- The minimum supported version is 9.3.
- * **Linux**: Evergreen 3.0 has been tested on Debian Jessie (8.0),
- Debian Wheezy (7.0), Ubuntu Xenial Xerus (16.04),
+ * **PostgreSQL**: The minimum supported version is 9.4.
+ * **Linux**: Evergreen has been tested on Debian Stretch (9),
+ Debian Jessie (8), Debian Wheezy (7), Ubuntu Xenial Xerus (16.04),
and Ubuntu Trusty Tahr (14.04).
If you are running an older version of these distributions, you may want
to upgrade before upgrading Evergreen. For instructions on upgrading these
distributions, visit the Debian or Ubuntu websites.
- * **OpenSRF**: The minimum supported version of OpenSRF is 2.5.1.
+ * **OpenSRF**: The minimum supported version of OpenSRF is 3.0.0.
Evergreen has a number of prerequisite packages that must be installed
before you can successfully configure, compile, and install Evergreen.
-1. Begin by installing the most recent version of OpenSRF (2.5.1 or later).
+1. Begin by installing the most recent version of OpenSRF (3.0.0 or later).
You can download OpenSRF releases from http://evergreen-ils.org/opensrf-downloads/
2. On some distributions, it is necessary to install PostgreSQL 9.4+ from external
repositories.
PostgreSQL, so steps are taken to automatically utilize the
PostgreSQL community's apt sources.
(For complete details, see: https://wiki.postgresql.org/wiki/Apt)
- * Debian (Jessie) and Ubuntu (Xenial) comes with PostgreSQL 9.4+,
+ * Debian (Jessie/Stretch) and Ubuntu (Xenial) comes with PostgreSQL 9.4+,
so no additional steps are required.
+
3. Issue the following commands as the *root* Linux account to install
prerequisites using the `Makefile.install` prerequisite installer,
- substituting `debian-jessie`, `debian-wheezy`,
+ substituting `debian-stretch`, `debian-jessie`, `debian-wheezy`,
`ubuntu-xenial`, or `ubuntu-trusty` for <osname> below:
+
[source, bash]
issuing the following commands as the *root* Linux account:
+
[NOTE]
-You should skip this step if installing on Ubuntu Trusty, Ubuntu Xenial or Debian Jessie. The Ubuntu
-and Debian Jessie targets use libdbd-pgsql from packages.
+You should skip this step if installing on Ubuntu Trusty/Xenial or Debian Jessie/Stretch. The Ubuntu
+and Debian Jessie/Stretch targets use libdbd-pgsql from packages.
+
.Debian Wheezy
[source, bash]
make -f Open-ILS/src/extras/Makefile.install <osname>-packager
------------------------------------------------------------------------------
-Optional: Extra steps for web staff client
-------------------------------------------
+Extra steps for web staff client
+--------------------------------
[NOTE]
Skip this entire section if you are using an official release tarball downloaded
+
[source, bash]
------------------------------------------------------------------------------
-make STAFF_CLIENT_STAMP_ID=rel_3_0_beta1 install
+make STAFF_CLIENT_STAMP_ID=rel_3_0_beta2 install
------------------------------------------------------------------------------
+
2. The server portion of the staff client expects `http://hostname/xul/server`
chown -R opensrf:opensrf /openils
------------------------------------------------------------------------------
+Run ldconfig
+------------
+
+On Debian Stretch, run the following command as the root user:
+
+[source, bash]
+------------------------------------------------------------------------------
+ldconfig
+------------------------------------------------------------------------------
+
Additional Instructions for Developers
--------------------------------------
cd /etc/apache2/ssl
------------------------------------------------------------------------------
+
-.Ubuntu Trusty, Ubuntu Xenial, and Debian Jessie
+.Ubuntu Trusty/Xenial and Debian Jessie/Stretch
[source,bash]
------------------------------------------------------------------------------------
cp Open-ILS/examples/apache_24/eg_24.conf /etc/apache2/sites-available/eg.conf
</IfModule>
------------------------------------------------------------------------------
+
-.Ubuntu Trusty, Ubuntu Xenial, Debian Jessie (`/etc/apache2/mods-available/mpm_prefork.conf`)
+.Ubuntu Trusty/Xenial, Debian Jessie/Stretch (`/etc/apache2/mods-available/mpm_prefork.conf`)
[source,bash]
------------------------------------------------------------------------------
<IfModule mpm_prefork_module>
</IfModule>
------------------------------------------------------------------------------
+
-. (Ubuntu Trusty, Ubuntu Xenial, Debian Jessie) As the *root* user,
+. (Ubuntu Trusty/Xenial, Debian Jessie/Stretch) As the *root* user,
enable the mpm_prefork module:
+
[source,bash]
a2ensite eg.conf
------------------------------------------------------------------------------
+
-(Ubuntu Trusty, Ubuntu Xenial, Debian Jessie):
+(Ubuntu Trusty/Xenial, Debian Jessie/Stretch):
+
[source,bash]
------------------------------------------------------------------------------
cp -b /openils/conf/action_trigger_filters.json.example /openils/conf/action_trigger_filters.json
------------------------------------------------------------------------------
-For more information about configuring and using action triggers, see
-<<_notifications_action_triggers,Notifications / Action Triggers>>.
+For more information about configuring and running action triggers, see
+<<_processing_action_triggers,Notifications / Action Triggers>>.
Creating the Evergreen database
-------------------------------
[source, bash]
------------------------------------------------------------------------------
+make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-stretch
make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-jessie
make -f Open-ILS/src/extras/Makefile.install postgres-server-debian-wheezy
make -f Open-ILS/src/extras/Makefile.install postgres-server-ubuntu-trusty
For a standalone PostgreSQL server, install the following Perl modules for your
distribution as the *root* Linux account:
-.(Debian Wheezy, Ubuntu Trusty, and Ubuntu Xenial)
+.(Debian and Ubuntu)
No extra modules required for these distributions.
You need to create a PostgreSQL superuser to create and access the database.
~~~~~~~~~~~~~~~~~~~~~~
* **PostgreSQL**: The minimum supported version is 9.4.
- * **Linux**: Evergreen 2.12.0 has been tested on Debian Stretch (9.0),
+ * **Linux**: Evergreen 3.0.beta2 has been tested on Debian Stretch (9.0),
Debian Jessie (8.0), Debian Wheezy (7.0), Ubuntu Xenial Xerus (16.04),
and Ubuntu Trusty Tahr (14.04).
If you are running an older version of these distributions, you may want
.. Back up the /openils directory.
. Upgrade OpenSRF. Download and install the latest version of OpenSRF from
the https://evergreen-ils.org/opensrf-downloads/[OpenSRF download page].
-. As the *opensrf* user, download and extract Evergreen 3.0.beta1:
+. As the *opensrf* user, download and extract Evergreen 3.0.beta2:
+
[source, bash]
-----------------------------------------------
-wget https://evergreen-ils.org/downloads/Evergreen-ILS-3.0.beta1.tar.gz
-tar xzf Evergreen-ILS-3.0.beta1.tar.gz
+wget https://evergreen-ils.org/downloads/Evergreen-ILS-3.0.beta2.tar.gz
+tar xzf Evergreen-ILS-3.0.beta2.tar.gz
-----------------------------------------------
+
[NOTE]
+
[source, bash]
---------------------------------------------
-cd /home/opensrf/Evergreen-ILS-3.0.beta1
+cd /home/opensrf/Evergreen-ILS-3.0.beta2
---------------------------------------------
+
On the next command, replace `[distribution]` with one of these values for your
+
[source, bash]
------------------------------------------------------------
-cd /home/opensrf/Evergreen-ILS-3.0.beta1
+cd /home/opensrf/Evergreen-ILS-3.0.beta2
PATH=/openils/bin:$PATH ./configure --prefix=/openils --sysconfdir=/openils/conf
make
------------------------------------------------------------
+
[source, bash]
------------------------------------------------------------
-cd /home/opensrf/Evergreen-ILS-3.0.beta1
-make STAFF_CLIENT_STAMP_ID=rel_3_0_beta1 install
+cd /home/opensrf/Evergreen-ILS-3.0.beta2
+make STAFF_CLIENT_STAMP_ID=rel_3_0_beta2 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_3_0_beta1/server server
+ln -sf rel_3_0_beta2/server server
----------------------------------------------------------
+
. As the *opensrf* user, update opensrf_core.xml and opensrf.xml by copying the
+
[source, bash]
-------------------------------------------------------------------------
-cd /home/opensrf/Evergreen-ILS-3.0.beta1
+cd /home/opensrf/Evergreen-ILS-3.0.beta2
perl Open-ILS/src/support-scripts/eg_db_config --update-config --service all \
--create-offline --database evergreen --host localhost --user evergreen --password evergreen
-------------------------------------------------------------------------
+
[source, bash]
----------------------------------------------------------
-cp /home/opensrf/Evergreen-ILS-3.0.beta1/Open-ILS/examples/apache/eg_startup /etc/apache2/eg_startup
+cp /home/opensrf/Evergreen-ILS-3.0.beta2/Open-ILS/examples/apache/eg_startup /etc/apache2/eg_startup
----------------------------------------------------------
+
.. 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-3.0.beta1/Open-ILS/examples/apache/eg_vhost.conf /etc/apache2/eg_vhost.conf
+cp /home/opensrf/Evergreen-ILS-3.0.beta2/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-3.0.beta1/Open-ILS/examples/apache/eg.conf /etc/apache2/sites-available/eg.conf
+cp /home/opensrf/Evergreen-ILS-3.0.beta2/Open-ILS/examples/apache/eg.conf /etc/apache2/sites-available/eg.conf
----------------------------------------------------------
Upgrade the Evergreen database schema
[source, bash]
----------------------------------------------------------
-cd /home/opensrf/Evergreen-ILS-3.0.beta1/Open-ILS/src/sql/Pg
-psql -U evergreen -h localhost -f version-upgrade/2.12.5-3.0.beta1-upgrade-db.sql evergreen
+cd /home/opensrf/Evergreen-ILS-3.0.beta2/Open-ILS/src/sql/Pg
+psql -U evergreen -h localhost -f version-upgrade/2.12.5-3.0.beta2-upgrade-db.sql evergreen
----------------------------------------------------------
[TIP]