======Upgrading Evergreen 1.6.0.0 to 1.6.0.1======

  - Stop Apache.
  - Stop all Evergreen and OpenSRF services.  As the **opensrf** user:<code bash>
osrf_ctl.sh -l -a stop_all</code>
  - [[zzz_archive:opensrf:1.2:install|Install OpenSRF 1.2.2]].
  - 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.1.tar.gz):<code bash>
wget http://evergreen-ils.org/downloads/Evergreen-ILS-1.6.0.1.tar.gz
tar xzf Evergreen-ILS-1.6.0.1.tar.gz
</code>
    - As the **root** user, install the prerequisites.  Replace <distribution> 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-intrepid'' for Ubuntu Intrepid Ibex (8.10)<code bash>
cd /home/opensrf/Evergreen-ILS-1.6.0.1
make -f Open-ILS/src/extras/Makefile.install <distribution></code>
    - As the **opensrf** user, configure and compile Evergreen:<code bash>
cd /home/opensrf/Evergreen-ILS-1.6.0.1
./configure --prefix=/openils --sysconfdir=/openils/conf
make</code>
    - As the **root** user, install Evergreen:<code bash>
make STAFF_CLIENT_BUILD_ID=rel_1_6_0_1 install</code>
    - As the **opensrf** user, update configuration files:<code bash>
cd /home/opensrf/Evergreen-ILS-1.6.0.1
# 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</code>
  - 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**<code bash>
psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.6.0.0-1.6.0.1-upgrade-db.sql evergreen
</code>
  - 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:<code bash>
osrf_ctl.sh -l -a start_all</code>
  - Start Apache.
  - As the **opensrf** user, run autogen to refresh the static organizational data files:<code bash>
cd /openils/bin
./autogen.sh -c /openils/conf/opensrf_core.xml -u
</code>
  - 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.