Difference between revisions of "Upgrading"

From EPrints Documentation
Jump to: navigation, search
(Upgrade from 3.3.13 to 3.3.14)
(Added Manual)
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==Upgrade from 3.3.13 to 3.3.14==
+
{{manual}}
  
You can upgrade to 3.3.14 from 3.3.13 without re-install EPrints.
+
== Upgrade from 3.3.x to 3.3.y ==
  
Download the upgrade patch file: http://files.eprints.org/1027/10/upgrade-3.3.13-3.3.14.patch
+
=== 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.
  
Become eprints user and go to eprints installation directory:
+
=== From GitHub ===
sudo su eprints
+
If you have installed with GitHub you can update to the latest version using the following commands, substituting y form the version you want:
cd /opt/eprints3
 
  
Check if you are on version 3.3.13:
+
git fetch origin
cat VERSION
+
git merge tags/v3.3.y
  
Apply the patch only if you are on 3.3.13
+
This should warn you if you have made any locally uncommitted changesYou may need to use ''git stash'' to move these temporarily and reintegrate after updating from GitHUb.
  patch -p1 < ./upgrade-3.3.13-3.3.14.patch
 
  
You can safely ignore the missing debian related files during patch by press "Enter". This is due to the patch generated by git.
+
=== 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):
  
 +
1. Download the tarball from files.eprints.org, (e.g. http://files.eprints.org/1073/2/eprints-3.3.15.tar.gz)
  
Restart apache to take effect.
+
2. 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:
 +
 
 +
tar -xzvf eprints-3.3.15.tar.gz /opt/eprints3_new
 +
chown -R eprints:eprints /opt/eprints3_new
 +
 
 +
3. Move the archive(s) from your old EPrints to your new one, e.g.:
 +
 
 +
mv /opt/eprints3/archives/* /opt/eprints3_new/archives/
 +
 
 +
4. Copy SystemSettings.pm to you new EPrints
 +
 
 +
cp /opt/eprints3/perl_lib/EPrints/SystemSettings.pm /opt/eprints3_new/perl_lib/EPrints/
 +
 
 +
5. If you are aware of any local modifications to files under your EPrints path (e.g. /opt/eprints3) but outside in the archives directory then compare these files using diff to work out how your local changes can be integrated.  E.g.
 +
 
 +
diff /opt/eprints3/perl_lib/EPrints/MetaField/Date.pm /opt/eprints3_new/perl_lib/EPrints/MetaField/Date.pm
 +
 
 +
6. As the root user, switch round the old and new versions of EPrints, e.g.
 +
 
 +
mv /opt/eprints3 /opt/eprints3_old
 +
mv /opt/eprints3_new /opt/eprints3
 +
 
 +
7. Run epadmin test to check there are no configuration issues, e.g.:
 +
 
 +
/opt/eprints3/bin/epadmin test
 +
 
 +
8. As the root user, restart Apache.
 +
 
 +
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:
 +
* [[Upgrading from 3.1]]
 +
* [[Upgrading from 3.2]]

Revision as of 12:49, 8 September 2017

Manual Sections

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 form 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):

1. Download the tarball from files.eprints.org, (e.g. http://files.eprints.org/1073/2/eprints-3.3.15.tar.gz)

2. 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:

tar -xzvf eprints-3.3.15.tar.gz /opt/eprints3_new
chown -R eprints:eprints /opt/eprints3_new

3. Move the archive(s) from your old EPrints to your new one, e.g.:

mv /opt/eprints3/archives/* /opt/eprints3_new/archives/

4. Copy SystemSettings.pm to you new EPrints

cp /opt/eprints3/perl_lib/EPrints/SystemSettings.pm /opt/eprints3_new/perl_lib/EPrints/

5. If you are aware of any local modifications to files under your EPrints path (e.g. /opt/eprints3) but outside in the archives directory then compare these files using diff to work out how your local changes can be integrated. E.g.

diff /opt/eprints3/perl_lib/EPrints/MetaField/Date.pm /opt/eprints3_new/perl_lib/EPrints/MetaField/Date.pm 

6. As the root user, switch round the old and new versions of EPrints, e.g.

mv /opt/eprints3 /opt/eprints3_old
mv /opt/eprints3_new /opt/eprints3

7. Run epadmin test to check there are no configuration issues, e.g.:

/opt/eprints3/bin/epadmin test

8. As the root user, restart Apache.

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: