======Upgrading from Evergreen 1.2.1 to 1.2.2======

=====Installing the new version=====

  - Download and unpack http://www.open-ils.org/downloads/Evergreen-ILS-1.2.2.tar.gz in a temporary directory.
  - Make a backup copy of all your files, but especially the ''/openils/conf'' directory.
  - Stop Apache.  On some systems this can be accomplished by doing 'sudo service apache2 stop'.
  - Stop Evergreen:<code bash>
su - opensrf
/openils/bin/osrf_ctl.sh -c /openils/conf/opensrf_core.xml -a stop_all</code>  (You may have to change the paths to match your installation.)
  - Perform the [[zzz_archive:server_installation]] steps relevant to your platform; typically you can skip the prerequisites and go directly to the section that includes ''make config'' and ends with ''make install''.  **__WARNING__:**  You will **DESTROY your Evergreen database** if you supply 'openils_all evergreen_core' for the Build_targets part of 'make config'.  Instead, use the following Build_targets: <code>openils_core openils_web openils_reporter openils_client_xul openils_server_xul evergreen_core</code>
  - Start Evergreen: <code>sudo -u opensrf /openils/bin/osrf_ctl.sh -c /openils/conf/opensrf_core.xml -a start_router
sudo -u opensrf /openils/bin/osrf_ctl.sh -c /openils/conf/opensrf_core.xml -a start_perl
sudo -u opensrf /openils/bin/osrf_ctl.sh -c /openils/conf/opensrf_core.xml -a start_c</code>
  - Start Apache.  On some systems this can be accomplished by doing 'sudo service apache2 start'.

=====Database Schema Upgrade=====

To support the new search infrastructure available in 1.2.2 some new database components must be added.  An SQL script is provided to alleviate any need to work with the database by hand.  Database upgrade procedures for at least version 1.2.1.1 must be in place before running this script.  Instructions for upgrading from 1.2.0 or 1.2.1.0 to 1.2.1.1 through 1.2.1.4 can be found [[zzz_archive:upgrading:1.2.0_to_1.2.1|here]].

These instructions assume that PostgreSQL is running on the local machine, there is a database called 'evergreen', a database user called 'evergreen' and a database password of 'password'.  Modify these settings as required.

  - The JSON::XS Perl module must be installed on the database server to support a new plperl database function. To install JSON::XS on your database system, run the following command as root:<code bash>
# cpan JSON::XS
</code>
  - To upgrade the database schema, issue the following commands against the Evergreen database:<code>
 $ cd Evergreen-ILS-1.2.2.1/Open-ILS/src/sql/Pg/
 $ PGUSER=postgres PGHOST=127.0.0.1 psql evergreen -W -f 1.2.1-1.2.2-upgrade-db.sql
   Password: [password]
</code>

If you encounter any errors with this upgrade script please contact the developers on the [[http://open-ils.org/listserv.php|open-ils-dev]] mailing list.

In addition to this script, the main ''opensrf.xml'' configuration file must be updated.  Place the following XML under the <appsettings> node of <open-ils.search> section this file:

<code xml>
  <use_staged_search>true</use_staged_search>
</code>

The section will look something like this:

<code xml>
            <open-ils.search>
                <keepalive>5</keepalive>
                <stateless>1</stateless>
                <migratable>1</migratable>
                <language>perl</language>
                <implementation>OpenILS::Application::Search</implementation>
                <max_requests>100</max_requests>

                <unix_config>
                  ...
                </unix_config>

                <app_settings>
                    <use_staged_search>true</use_staged_search>
                    <marc_html_xsl>oilsMARC21slim2HTML.xsl</marc_html_xsl>

                    ... added content, spell checking, and cache settings and zip-file settings ...

                </app_settings>

</code>


=====Added Content Plugin and Caching layer=====

The added content plugin layer has been given a number of enhancements: 

  * The plugin now has the ability to serve images.  Therefore, the following is no longer needed in your apache config (default: ''eg_vhost.conf''):  <code>
RewriteEngine on
ProxyTimeout 2
RewriteRule /opac/extras/ac/jacket/small/(.*) \
    http://images.amazon.com/images/P/$1.01._SCMZZZZZZZ_.jpg [P,L]
RewriteRule /opac/extras/ac/jacket/large/(.*) \
    http://images.amazon.com/images/P/$1.01._SCLZZZZZZZ_.jpg [P,L]</code>
  * If you use Amazon for image lookups, add the following to your ''opensrf.xml'' file in the ''<added_content>'' section: <code xml>
<module>OpenILS::WWW::AddedContent::Amazon</module>
<base_url>http://images.amazon.com/images/P/</base_url></code>
  * The plugin architecture now supports automatically shutting down for a configured amount of time after a configured number of lookup errors.  The purpose of this is to reduce unnecessary waiting for Apache processes if your added content servers are not responding in a timely fashion.  For example, if you have 10 errors configured, after 10 successive added content lookup errors (usually status 500 from the AC server), the added content plugin layer will stop trying for the configured amount of time.  Add the following to your ''opensrf.xml'' file in the ''<added_content>'' section: <code xml>
<retry_timeout>300</retry_timeout>
<max_errors>10</max_errors></code>
    * Note that cached content will still be served regardless of the error handling.

=====More 1.2.2 information=====
  * [[history:feature_list_1_2_2|1.2.2 feature summary]]
  * [[http://open-ils.org/downloads.php|Download an Evergreen 1.2.2 release]]
  * [[http://open-ils.org/downloads/ChangeLog-1.2.2.0-1.2.2.1|Subversion change log for 1.2.2.1]]