======Upgrading Evergreen 2.0.1 to 2.0.2======

  * If you are currently on a version before 2.0.1, make sure you follow the [[upgrading:evergreen|upgrade instructions]] for all previous releases up to 2.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.6:install|Install OpenSRF 1.6.x]].
    - **NOTE:** You may skip this step if the latest version of OpenSRF 1.6.x 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-2.0.2.tar.gz):<code bash>
wget http://evergreen-ils.org/downloads/Evergreen-ILS-2.0.2.tar.gz
tar xzf Evergreen-ILS-2.0.2.tar.gz
</code>
    - As the **root** user, install the prerequisites.  Replace <distribution> below with one of these values for your actual distribution:
      * ''debian-sqeeze'' for Debian Squeeze
      * ''ubuntu-lucid'' for Ubuntu Lucid Lynx (10.04)<code bash>
cd /home/opensrf/Evergreen-ILS-2.0.2
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-2.0.2
./configure --prefix=/openils --sysconfdir=/openils/conf
make</code>
    - As the **root** user, install Evergreen:<code bash>
make STAFF_CLIENT_BUILD_ID=rel_2_0_2 install</code>
    - As the **root** user, change all files to be owned by the opensrf user/group:<code bash>
sudo chown -R opensrf:opensrf /openils</code>
    - As the **opensrf** user, update configuration files:<code bash>
cd /home/opensrf/Evergreen-ILS-2.0.2
# and offline-config.pl for the offline staff client data uploader
perl Open-ILS/src/support-scripts/eg_db_config.pl \
  --create-offline --user evergreen --password evergreen \
  --hostname localhost --port 5432 --database evergreen</code>
    - As the **opensrf** user, update server symlink in /openils/var/web/xul/:<code bash>
cd /openils/var/web/xul/
rm server
ln -s rel_2_0_2/server server</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>cd /home/opensrf/Evergreen-ILS-2.0.2
psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/2.0.1-2.0.2-upgrade-db.sql evergreen
</code>
  - Start all Evergreen and OpenSRF services.  As the **opensrf** user:<code bash>
osrf_ctl.sh -l -a start_all</code>
  - Start Apache as **root**.
  - 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.