User Tools

Site Tools


Upgrading from Evergreen 1.2.2 to 1.2.3

Installing the new version

  1. Download and unpack in a temporary directory.
  2. Make a backup copy of all your files, but especially the /openils/conf directory.
  3. Stop Apache. On some systems this can be accomplished by doing 'sudo service apache2 stop'.
  4. Stop Evergreen:
    su - opensrf
    /openils/bin/ -c /openils/conf/opensrf_core.xml -a stop_all

    (You may have to change the paths to match your installation.)

  5. Perform the 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:
    openils_core openils_web openils_reporter openils_client_xul openils_server_xul evergreen_core
  6. Start Evergreen:
    sudo -u opensrf /openils/bin/ -c /openils/conf/opensrf_core.xml -a start_router
    sudo -u opensrf /openils/bin/ -c /openils/conf/opensrf_core.xml -a start_perl
    sudo -u opensrf /openils/bin/ -c /openils/conf/opensrf_core.xml -a start_c
    sudo -u opensrf /openils/bin/ -c /openils/conf/opensrf_core.xml -u
  7. Apply new Apache configuration (selfcheck login proxy) to /etc/apache2/eg_vhost.conf (or similar)
    <LocationMatch .*/selfcheck.xml>
        SetHandler perl-script
        PerlSetVar OILSProxyTitle "Selfcheck Login"
        PerlSetVar OILSProxyDescription "Please log in to activate the selfcheck interface"
        PerlSetVar OILSProxyPermissions "STAFF_LOGIN"
        PerlHandler OpenILS::WWW::Proxy
        Options +ExecCGI
        PerlSendHeader On
        allow from all
  8. 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.3 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 must be in place before running this script. Instructions for upgrading from 1.2.0 or to through can be found 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.

  1. To upgrade the database schema, issue the following commands against the Evergreen database:
     $ cd Evergreen-ILS-
     $ PGUSER=postgres PGHOST= psql evergreen -W -f
       Password: [password]

If you encounter any errors with this upgrade script please contact the developers on the open-ils-dev mailing list.

zzz_archive/upgrading/1.2.2_to_1.2.3.txt · Last modified: 2022/02/10 13:34 by

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki

© 2008-2022 GPLS and others. Evergreen is open source software, freely licensed under GNU GPLv2 or later.
The Evergreen Project is a U.S. 501(c)3 non-profit organization.