zzz_archive:upgrading:1.2_to_1.4.0.0
Upgrading Evergreen from a 1.2.x release to 1.4.0.0
- Install new and upgraded prerequisites. The easiest way to do this is to use the Makefile.install prerequisite installer; it will skip any prerequisites that are already installed on your system. Run the following command as root, where _distribution_ is one of
debian
orubuntu
:make -f Open-ILS/src/extras/Makefile.install _distribution_
- Install OpenSRF 1.0.2. See upgrading OpenSRF 0.9 to 1.0 for some gotchas. Otherwise, it's basically:
./configure --prefix=/openils --sysconfdir=/openils/conf make make install
- Remove the symbolic link
/openils/var/web/reports/fm_IDL.xml
- this will be replaced by an entityized version for internationalization support, but/openils/conf/fm_IDL.xml
will break horribly if it gets replaced by an entityized version, so we have to disentangle the two. - Install Evergreen 1.4.0.0.
./autogen.sh ./configure --prefix=/openils --sysconfdir=/openils/conf make sudo make install # 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 chown -R opensrf:opensrf /openils
- Upgrade the database
- From version 1.2 NOTE: it is recommended that you shut down Postgres and make a copy of the data directory in order to restore to Evergreen 1.2 if anything goes wrong
# Upgrading from Evergreen 1.2.3.x: psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.2.3-1.4-upgrade-db.sql # Or from Evergreen 1.2.4.x: psql -U evergreen -h localhost -f Open-ILS/src/sql/Pg/1.2.4-1.4-upgrade-db.sql
- Update
opensrf_core.xml
andopensrf.xml
. A naive way would be to copy the new example files (/openils/conf/opensrf_core.xml.example
and/openils/conf/opensrf.xml
) and then update the username / password / hostname info and other customizations you might have made. The following step will automatically propagate database usernames and passwords intoopensrf.xml
:# Update opensrf.xml with the database connection info sudo perl Open-ILS/src/support-scripts/eg_db_config.pl --update-config \ --service all--user evergreen --password evergreen --hostname localhost \ --port 5432 --database evergreen
- Update Apache configuration:
- Update
/etc/apache2/startup.pl
with the example fromOpen-ILS/examples/apache/startup.pl
(primarily to add the Vandelay Perl module). - Update
/etc/apache2/eg_vhost.conf
with the example fromOpen-ILS/examples/apache/eg_vhost.conf
for internationalization and JSON gateway format support. - Update
/etc/apache2/sites-available/eg.conf
with the example fromOpen-ILS/examples/apache/eg.conf
for internationalization support in the SlimPAC.
ERRATA
- Translation seed data for en-CA, fr-CA, hy-A and cs-CZ are available but not installed by default. See this page for instructions on installing these translations.
- In
/openils/conf/opensrf_core.xml
, one additional public service,open-ils.fielder
, is required. See changeset 11919 for details. This will be added by default in the next release. - An issue with hold freezing was discovered after the official release was cut. A thaw date is required in 1.4.0.0. This will also be fixed in the next release.
- The current default logging level for the Apache modules it
debug
, which is extremely verbose. You can adjust this in/etc/apache2/sites-available/eg.conf
, andinfo
is a reasonable value.info
will be the default in the next release.
zzz_archive/upgrading/1.2_to_1.4.0.0.txt · Last modified: 2022/02/10 13:34 by 127.0.0.1