======Upgrading Evergreen 1.6.0.3 to 1.6.0.4======
* If you are currently on a version before 1.6.0.3, make sure you follow the [[upgrading:evergreen|upgrade instructions]] for all previous releases up to 1.6.0.3.
- Stop Apache.
- Stop all Evergreen and OpenSRF services. As the **opensrf** user:
osrf_ctl.sh -l -a stop_all
- [[zzz_archive:opensrf:1.2:install|Install OpenSRF 1.2.2]].
- **NOTE:** You may skip this step if OpenSRF 1.2.2 was previously installed.
- Download and build Evergreen:
- As the **opensrf** user, download and extract the latest version of Evergreen (http://open-ils.org/downloads/Evergreen-ILS-1.6.0.4.tar.gz):
wget http://evergreen-ils.org/downloads/Evergreen-ILS-1.6.0.4.tar.gz
tar xzf Evergreen-ILS-1.6.0.4.tar.gz
- As the **root** user, install the prerequisites. Replace below with one of these values for your actual distribution:
* ''debian-etch'' for Debian Etch (4.0)
* ''debian-lenny'' for Debian Lenny
* ''ubuntu-hardy'' for Ubuntu Hardy Heron (8.04)
* ''ubuntu-karmic'' for Ubuntu Karmic Koala (9.10)
cd /home/opensrf/Evergreen-ILS-1.6.0.4
make -f Open-ILS/src/extras/Makefile.install
- As the **opensrf** user, configure and compile Evergreen:
cd /home/opensrf/Evergreen-ILS-1.6.0.4
./configure --prefix=/openils --sysconfdir=/openils/conf
make
- As the **root** user, install Evergreen:
make STAFF_CLIENT_BUILD_ID=rel_1_6_0_4 install
- As the **opensrf** user, update configuration files:
cd /home/opensrf/Evergreen-ILS-1.6.0.4
# Build live-db-setup.pl for the cgi-bin bootstrapping scripts
# and offline-config.pl for the offline staff client data uploader
sudo perl Open-ILS/src/support-scripts/eg_db_config.pl \
--create-bootstrap --create-offline --user evergreen --password evergreen \
--hostname localhost --port 5432 --database evergreen
# Change all files to be owned by the opensrf user/group
sudo chown -R opensrf:opensrf /openils
- Upgrade the database:
- **NOTE: it is recommended that you [[http://www.open-ils.org/dokuwiki/doku.php?id=evergreen-admin:maintenance:backups&s[]=database&s[]=backup|back up your Evergreen database]] in order to restore your data if anything goes wrong**
- Download the [[http://www.open-ils.org/downloads/1.6.0-mmbxs-cleanup.sql|billing view hot-fix script]].
psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.0.3-1.6.0.4-upgrade-db.sql evergreen
psql -U evergreen -h localhost -f 1.6.0-mmbxs-cleanup.sql evergreen
- As the **opensrf** user, copy /openils/conf/oils_web.xml.example to /openils/conf/oils_web.xml (needed for acquisitions templates)
- Start all Evergreen and OpenSRF services. As the **opensrf** user:
osrf_ctl.sh -l -a start_all
- Start Apache.
- As the **opensrf** user, run autogen to refresh the static organizational data files:
cd /openils/bin
./autogen.sh -c /openils/conf/opensrf_core.xml -u
- Troubleshooting:
If you run into errors, see: [[http://www.open-ils.org/dokuwiki/doku.php?id=troubleshooting:checking_for_errors&s[]=troubleshooting|Troubleshooting: Checking for Errors]] for help finding errors in the log files. You may also ask the evergreen community using the [[http://www.open-ils.org/listserv.php|mailing lists]]. Including error information from the logs will be extremely helpful when seeking assistance.
----
**In some cases, you may upgrade OpenSRF to version 1.2 instead of installing from scratch. To upgrade:**
- Go to the [[zzz_archive:opensrf:1.2:install|instructions for installing OpenSRF 1.2]] and complete steps 2, 3, (4 I, II, III b) and 5
- Restart OpenSRF and test connections using srfsh.