Difference between revisions of "Upgrading"
(Added Manual) |
(epindexer and site-wide configuration integrated, formatting adjusted) |
||
| Line 7: | Line 7: | ||
=== From GitHub === | === From GitHub === | ||
| − | If you have installed with GitHub you can update to the latest version using the following commands, substituting y | + | If you have installed with GitHub you can update to the latest version using the following commands, substituting ''y'' for the version you want: |
git fetch origin | git fetch origin | ||
git merge tags/v3.3.y | git merge tags/v3.3.y | ||
| − | This should warn you if you have made any locally uncommitted changes. You may need to use ''git stash'' to move these temporarily and reintegrate after updating from | + | This should warn you if you have made any locally uncommitted changes. You may need to use ''git stash'' to move these temporarily and reintegrate after updating from GitHub. |
=== From a Tarball === | === From a Tarball === | ||
Although not impossible it is strongly discouraged to upgrade from a tarball. One major reason not to do this is that if you have made any local changes other than to your original archive's configuration, it will be difficult to ensure all these modifications are retained. However, if you wish to do this, you can follow the instructions below, (as the eprints user unless otherwise stated): | Although not impossible it is strongly discouraged to upgrade from a tarball. One major reason not to do this is that if you have made any local changes other than to your original archive's configuration, it will be difficult to ensure all these modifications are retained. However, if you wish to do this, you can follow the instructions below, (as the eprints user unless otherwise stated): | ||
| + | <ol> | ||
| + | <li> Download the tarball from files.eprints.org, (e.g. https://files.eprints.org/2306/5/eprints-3.3.16.tar.gz)</li> | ||
| − | + | <li> As the root user, unpack the tarball under the same parent path as your existing EPrints and change the ownership of this whole directory structure</li> | |
| − | + | cd /opt | |
| + | tar -xzvf eprints-3.3.16.tar.gz | ||
| + | mv eprints-3.3.16 eprints3_new | ||
| + | chown -R eprints:eprints /opt/eprints3_new | ||
| − | + | <li> As the root user, stop Apache and EPrints' indexer.</li> | |
| − | + | ||
| + | apachectl graceful-stop | ||
| + | /opt/eprints3/bin/epindexer stop | ||
| − | + | <li> Move the archive(s) from your old EPrints to your new one, e.g.</li> | |
mv /opt/eprints3/archives/* /opt/eprints3_new/archives/ | mv /opt/eprints3/archives/* /opt/eprints3_new/archives/ | ||
| − | + | <li> Copy SystemSettings.pm to your new EPrints as well as site-wide settings</li> | |
| − | cp /opt/eprints3/perl_lib/EPrints/SystemSettings.pm /opt/eprints3_new/perl_lib/EPrints/ | + | cp -p /opt/eprints3/perl_lib/EPrints/SystemSettings.pm /opt/eprints3_new/perl_lib/EPrints/ |
| + | cp -pR /opt/eprints3/cfg /opt/eprints3_new/cfg | ||
| + | cp -pR /opt/eprints3/site_lib /opt/eprints3_new/site_lib | ||
| − | + | <li> If you are aware of any local modifications to files under your EPrints path (e.g. /opt/eprints3) but outside the archives directory then compare these files using diff to work out how your local changes can be integrated. E.g.</li> | |
diff /opt/eprints3/perl_lib/EPrints/MetaField/Date.pm /opt/eprints3_new/perl_lib/EPrints/MetaField/Date.pm | diff /opt/eprints3/perl_lib/EPrints/MetaField/Date.pm /opt/eprints3_new/perl_lib/EPrints/MetaField/Date.pm | ||
| − | + | <li> As the root user, switch round the old and new versions of EPrints, e.g.</li> | |
mv /opt/eprints3 /opt/eprints3_old | mv /opt/eprints3 /opt/eprints3_old | ||
mv /opt/eprints3_new /opt/eprints3 | mv /opt/eprints3_new /opt/eprints3 | ||
| − | + | <li> Run epadmin test to check there are no configuration issues, e.g.</li> | |
/opt/eprints3/bin/epadmin test | /opt/eprints3/bin/epadmin test | ||
| − | + | <li> Restart EPrints' indexer.</li> | |
| + | |||
| + | /opt/eprints3/bin/epindexer start | ||
| + | |||
| + | <li> As the root user, restart Apache.</li> | ||
apachectl restart | apachectl restart | ||
| + | <li>Don't forget to reinstall your Bazaar packages.</li> | ||
| + | </ol> | ||
== Upgrading to EPrints to 3.3 == | == Upgrading to EPrints to 3.3 == | ||
Revision as of 13:07, 22 October 2020
| Manual Sections | ||
| ||
Contents
Upgrade from 3.3.x to 3.3.y
From a Linux Package Manager
If you have installed from the Deb or RPM package, then you can just upgrade this. However, it is recommended that you have done a backup before doing this. Also if this is on a production server, that you do this during an extended period of scheduled downtime and have previously tested the upgrade on a pre-production server.
From GitHub
If you have installed with GitHub you can update to the latest version using the following commands, substituting y for the version you want:
git fetch origin git merge tags/v3.3.y
This should warn you if you have made any locally uncommitted changes. You may need to use git stash to move these temporarily and reintegrate after updating from GitHub.
From a Tarball
Although not impossible it is strongly discouraged to upgrade from a tarball. One major reason not to do this is that if you have made any local changes other than to your original archive's configuration, it will be difficult to ensure all these modifications are retained. However, if you wish to do this, you can follow the instructions below, (as the eprints user unless otherwise stated):
- Download the tarball from files.eprints.org, (e.g. https://files.eprints.org/2306/5/eprints-3.3.16.tar.gz)
- As the root user, unpack the tarball under the same parent path as your existing EPrints and change the ownership of this whole directory structure
- As the root user, stop Apache and EPrints' indexer.
- Move the archive(s) from your old EPrints to your new one, e.g.
- Copy SystemSettings.pm to your new EPrints as well as site-wide settings
- If you are aware of any local modifications to files under your EPrints path (e.g. /opt/eprints3) but outside the archives directory then compare these files using diff to work out how your local changes can be integrated. E.g.
- As the root user, switch round the old and new versions of EPrints, e.g.
- Run epadmin test to check there are no configuration issues, e.g.
- Restart EPrints' indexer.
- As the root user, restart Apache.
- Don't forget to reinstall your Bazaar packages.
cd /opt tar -xzvf eprints-3.3.16.tar.gz mv eprints-3.3.16 eprints3_new chown -R eprints:eprints /opt/eprints3_new
apachectl graceful-stop /opt/eprints3/bin/epindexer stop
mv /opt/eprints3/archives/* /opt/eprints3_new/archives/
cp -p /opt/eprints3/perl_lib/EPrints/SystemSettings.pm /opt/eprints3_new/perl_lib/EPrints/ cp -pR /opt/eprints3/cfg /opt/eprints3_new/cfg cp -pR /opt/eprints3/site_lib /opt/eprints3_new/site_lib
diff /opt/eprints3/perl_lib/EPrints/MetaField/Date.pm /opt/eprints3_new/perl_lib/EPrints/MetaField/Date.pm
mv /opt/eprints3 /opt/eprints3_old mv /opt/eprints3_new /opt/eprints3
/opt/eprints3/bin/epadmin test
/opt/eprints3/bin/epindexer start
apachectl restart
Upgrading to EPrints to 3.3
Upgrading from older 3.1 and 3.2 versions of EPrints to 3.3 is somewhat more involved. Please see the following guides:
