Editing Upgrading between EPrints 3.3 Versions (section)

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

==== Downloading and Unpacking 3.3 ====
<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

</ol>
==== Downloading and Unpacking 3.4 ====
<ol>
<li> Download the main tarball from files.eprints.org, (e.g. https://files.eprints.org/3097/5/eprints-3.4.6.tar.gz)</li>
<li> Download the publications tarball from files.eprints.org, (e.g. https://files.eprints.org/3097/6/eprints-3.4.6-flavours.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 /home/eprints/eprints-3.4.6.tar.gz
 tar -xzvf /home/eprints/eprints-3.4.6-flavours.tar.gz
 mv eprints-3.4.6 eprints3_new
 chown -R eprints:eprints /opt/eprints3_new

</ol>

==== Installing and Configuring ====


<ol>
<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/

<li> Copy SystemSettings.pm to your new EPrints as well as site-wide settings</li>

 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 

<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_new /opt/eprints3

<li> Run epadmin test to check there are no configuration issues, e.g.</li>

 /opt/eprints3/bin/epadmin test

<li> Run ''epadmin upgrade'' and ''epadmin update'' to deploy any structural changes or addition of fields to the database, e.g.</li>

 /opt/eprints3/bin/epadmin upgrade ARCHIVEID
 /opt/eprints3/bin/epadmin update ARCHIVEID

<li> Restart EPrints' indexer.</li>

 /opt/eprints3/bin/epindexer start

<li> As the root user, restart Apache.</li>

 apachectl restart

<li>Don't forget to reinstall your Bazaar packages.</li>
</ol>