https://wiki.eprints.org/w/index.php?title=Upgrading_from_3.2&feed=atom&action=historyUpgrading from 3.2 - Revision history2024-03-28T12:59:35ZRevision history for this page on the wikiMediaWiki 1.31.8https://wiki.eprints.org/w/index.php?title=Upgrading_from_3.2&diff=14349&oldid=prevDrn@ecs.soton.ac.uk: Fixed typo for link2022-01-28T11:36:09Z<p>Fixed typo for link</p>
<table class="diff diff-contentalign-left" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en-GB">
<td colspan="2" style="background-color: #fff; color: #222; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #222; text-align: center;">Revision as of 11:36, 28 January 2022</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l28" >Line 28:</td>
<td colspan="2" class="diff-lineno">Line 28:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>== Upgrade Steps ==</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>== Upgrade Steps ==</div></td></tr>
<tr><td class='diff-marker'>−</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>As you are initially just installing EPrints from scratch on a new server you can follow either the [[Installing EPrints on RHEL/Fedora/CentOS|Red Hat based Linux]] or [[Installing EPrints on Debian/<del class="diffchange diffchange-inline">ubuntu</del>|Debian based Linux]] instructions.  Installation on other operating systems is discouraged.</div></td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>As you are initially just installing EPrints from scratch on a new server you can follow either the [[Installing EPrints on RHEL/Fedora/CentOS|Red Hat based Linux]] or [[Installing EPrints on Debian/<ins class="diffchange diffchange-inline">Ubuntu</ins>|Debian based Linux]] instructions.  Installation on other operating systems is discouraged.</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>Once you have an EPrints 3.3 repository running on your new server you can start reconfiguring it to meet your bespoke requirements.  It is recommended that if you have more than one archive you work on one at a time.  First you need to tar up you current archive and copy it to your new server:</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>Once you have an EPrints 3.3 repository running on your new server you can start reconfiguring it to meet your bespoke requirements.  It is recommended that if you have more than one archive you work on one at a time.  First you need to tar up you current archive and copy it to your new server:</div></td></tr>
</table>Drn@ecs.soton.ac.ukhttps://wiki.eprints.org/w/index.php?title=Upgrading_from_3.2&diff=12527&oldid=prevDrn@ecs.soton.ac.uk at 13:40, 15 September 20172017-09-15T13:40:27Z<p></p>
<table class="diff diff-contentalign-left" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en-GB">
<td colspan="2" style="background-color: #fff; color: #222; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #222; text-align: center;">Revision as of 13:40, 15 September 2017</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l1" >Line 1:</td>
<td colspan="2" class="diff-lineno">Line 1:</td></tr>
<tr><td class='diff-marker'>−</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>{{Work_in_Progress|This is a work in progress.  Please do not follow these instructions until <del class="diffchange diffchange-inline">these instructions </del>are complete and this warning has been removed.}}</div></td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>{{Work_in_Progress|This is a work in progress.  Please do not follow these instructions until <ins class="diffchange diffchange-inline">they </ins>are complete and this warning has been removed.}}</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>'''It is generally advised that you do not upgrade from EPrints 3.2 to EPrints 3.3 on the same server rather you install and configure the latest EPrints 3.3 on a new server and test the best you can that all the functionality works as you expect and then migrate your archive's database and documents folder across to the new server.'''</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>'''It is generally advised that you do not upgrade from EPrints 3.2 to EPrints 3.3 on the same server rather you install and configure the latest EPrints 3.3 on a new server and test the best you can that all the functionality works as you expect and then migrate your archive's database and documents folder across to the new server.'''</div></td></tr>
</table>Drn@ecs.soton.ac.ukhttps://wiki.eprints.org/w/index.php?title=Upgrading_from_3.2&diff=12472&oldid=prevDrn@ecs.soton.ac.uk at 13:47, 6 September 20172017-09-06T13:47:23Z<p></p>
<table class="diff diff-contentalign-left" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en-GB">
<td colspan="2" style="background-color: #fff; color: #222; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #222; text-align: center;">Revision as of 13:47, 6 September 2017</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l1" >Line 1:</td>
<td colspan="2" class="diff-lineno">Line 1:</td></tr>
<tr><td class='diff-marker'>−</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div><del class="diffchange diffchange-inline">'''*** THIS PAGE IS A WORK IN PROGRESS</del>.  <del class="diffchange diffchange-inline">PLEASE DO NOT FOLLOW THESE INSTRUCTIONS UNTIL THEY ARE COMPLETE AND THIS WARNING HAS BEEN REMOVED ***'''</del></div></td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins class="diffchange diffchange-inline">{{Work_in_Progress|This is a work in progress</ins>.  <ins class="diffchange diffchange-inline">Please do not follow these instructions until these instructions are complete and this warning has been removed.}}</ins></div></td></tr>
<tr><td class='diff-marker'>−</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div> </div></td><td colspan="2"> </td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>'''It is generally advised that you do not upgrade from EPrints 3.2 to EPrints 3.3 on the same server rather you install and configure the latest EPrints 3.3 on a new server and test the best you can that all the functionality works as you expect and then migrate your archive's database and documents folder across to the new server.'''</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>'''It is generally advised that you do not upgrade from EPrints 3.2 to EPrints 3.3 on the same server rather you install and configure the latest EPrints 3.3 on a new server and test the best you can that all the functionality works as you expect and then migrate your archive's database and documents folder across to the new server.'''</div></td></tr>
<tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l14" >Line 14:</td>
<td colspan="2" class="diff-lineno">Line 13:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>== Things to check ==</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>== Things to check ==</div></td></tr>
<tr><td class='diff-marker'>−</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>Before you start installing the lateste EPrints 3.3 on a new server, it is worth asking the following questions about your existing EPrints 3.2 repository.  As they will determine whether there are additional dependencies or configuration changes you need to made to get these to work.  In some cases you may need to contact your institution's/organisation's IT support department to make changes at an institutional level (e.g. firewall changes, access to authentications systems such as Active <del class="diffchange diffchange-inline">Diretcoy </del>/ LDAP, etc.).</div></td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>Before you start installing the lateste EPrints 3.3 on a new server, it is worth asking the following questions about your existing EPrints 3.2 repository.  As they will determine whether there are additional dependencies or configuration changes you need to made to get these to work.  In some cases you may need to contact your institution's/organisation's IT support department to make changes at an institutional level (e.g. firewall changes, access to authentications systems such as Active <ins class="diffchange diffchange-inline">Directory </ins>/ LDAP, etc.).</div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div> </div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div># Does it use ROMEO completion?</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div># Does it use ROMEO completion?</div></td></tr>
</table>Drn@ecs.soton.ac.ukhttps://wiki.eprints.org/w/index.php?title=Upgrading_from_3.2&diff=12449&oldid=prevDrn@ecs.soton.ac.uk at 14:26, 5 September 20172017-09-05T14:26:40Z<p></p>
<table class="diff diff-contentalign-left" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en-GB">
<td colspan="2" style="background-color: #fff; color: #222; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #222; text-align: center;">Revision as of 14:26, 5 September 2017</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l32" >Line 32:</td>
<td colspan="2" class="diff-lineno">Line 32:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>Once you have an EPrints 3.3 repository running on your new server you can start reconfiguring it to meet your bespoke requirements.  It is recommended that if you have more than one archive you work on one at a time.  First you need to tar up you current archive and copy it to your new server:</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>Once you have an EPrints 3.3 repository running on your new server you can start reconfiguring it to meet your bespoke requirements.  It is recommended that if you have more than one archive you work on one at a time.  First you need to tar up you current archive and copy it to your new server:</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'>−</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>cd EPRINTS_PATH/archives/</div></td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins class="diffchange diffchange-inline"> </ins>cd EPRINTS_PATH/archives/</div></td></tr>
<tr><td class='diff-marker'>−</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>tar -czvf --exclude=ARCHIVE_DIR_NAME/documents/ ARCHIVE_DIR_NAME.tgz ARCHIVE_DIR_NAME</div></td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins class="diffchange diffchange-inline"> </ins>tar -czvf --exclude=ARCHIVE_DIR_NAME/documents/ ARCHIVE_DIR_NAME.tgz ARCHIVE_DIR_NAME</div></td></tr>
<tr><td class='diff-marker'>−</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>scp ARCHIVE_DIR_NAME.tgz NEW_SERVER:</div></td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins class="diffchange diffchange-inline"> </ins>scp ARCHIVE_DIR_NAME.tgz NEW_SERVER:</div></td></tr>
</table>Drn@ecs.soton.ac.ukhttps://wiki.eprints.org/w/index.php?title=Upgrading_from_3.2&diff=12448&oldid=prevDrn@ecs.soton.ac.uk at 14:26, 5 September 20172017-09-05T14:26:21Z<p></p>
<table class="diff diff-contentalign-left" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en-GB">
<td colspan="2" style="background-color: #fff; color: #222; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #222; text-align: center;">Revision as of 14:26, 5 September 2017</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l8" >Line 8:</td>
<td colspan="2" class="diff-lineno">Line 8:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* '''EPRINTS_PATH''': The directory in which EPrints is installed, e.g. ''/opt/eprints3/'',  /usr/local/share/eprints/'', etc.</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* '''EPRINTS_PATH''': The directory in which EPrints is installed, e.g. ''/opt/eprints3/'',  /usr/local/share/eprints/'', etc.</div></td></tr>
<tr><td class='diff-marker'>−</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>* '''ARCHIVE_DIR_NAME''': The name of the top level directory your archive. e.g. ''test'' if the full path is ''/opt/eprints3/<del class="diffchange diffchange-inline">archves</del>/test/''.</div></td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>* '''ARCHIVE_DIR_NAME''': The name of the top level directory your archive. e.g. ''test'' if the full path is ''/opt/eprints3/<ins class="diffchange diffchange-inline">archives</ins>/test/''.</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* '''OLD_SERVER''': The hostname of the old server running EPrints 3.2 (e.g. old-eprints.example.org).</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* '''OLD_SERVER''': The hostname of the old server running EPrints 3.2 (e.g. old-eprints.example.org).</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* '''NEW_SERVER''': The hostname of the new server running EPrints 3.3 (e.g. new-eprints.example.org).</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* '''NEW_SERVER''': The hostname of the new server running EPrints 3.3 (e.g. new-eprints.example.org).</div></td></tr>
</table>Drn@ecs.soton.ac.ukhttps://wiki.eprints.org/w/index.php?title=Upgrading_from_3.2&diff=12447&oldid=prevDrn@ecs.soton.ac.uk at 14:26, 5 September 20172017-09-05T14:26:10Z<p></p>
<table class="diff diff-contentalign-left" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en-GB">
<td colspan="2" style="background-color: #fff; color: #222; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #222; text-align: center;">Revision as of 14:26, 5 September 2017</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l7" >Line 7:</td>
<td colspan="2" class="diff-lineno">Line 7:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>As the way that EPrints may be installed on your existing system the following keys will be used throughout this guide:</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>As the way that EPrints may be installed on your existing system the following keys will be used throughout this guide:</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'>−</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>* '''EPRINTS_PATH''': The directory in which EPrints is installed, e.g. ''/opt/eprints3/'',  /usr/local/share/eprints/<del class="diffchange diffchange-inline">'</del>'', etc.</div></td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>* '''EPRINTS_PATH''': The directory in which EPrints is installed, e.g. ''/opt/eprints3/'',  /usr/local/share/eprints/'', etc.</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* '''ARCHIVE_DIR_NAME''': The name of the top level directory your archive. e.g. ''test'' if the full path is ''/opt/eprints3/archves/test/''.</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* '''ARCHIVE_DIR_NAME''': The name of the top level directory your archive. e.g. ''test'' if the full path is ''/opt/eprints3/archves/test/''.</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* '''OLD_SERVER''': The hostname of the old server running EPrints 3.2 (e.g. old-eprints.example.org).</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>* '''OLD_SERVER''': The hostname of the old server running EPrints 3.2 (e.g. old-eprints.example.org).</div></td></tr>
</table>Drn@ecs.soton.ac.ukhttps://wiki.eprints.org/w/index.php?title=Upgrading_from_3.2&diff=12446&oldid=prevDrn@ecs.soton.ac.uk at 14:25, 5 September 20172017-09-05T14:25:55Z<p></p>
<table class="diff diff-contentalign-left" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en-GB">
<td colspan="2" style="background-color: #fff; color: #222; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #222; text-align: center;">Revision as of 14:25, 5 September 2017</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l1" >Line 1:</td>
<td colspan="2" class="diff-lineno">Line 1:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>'''*** THIS PAGE IS A WORK IN PROGRESS.  PLEASE DO NOT FOLLOW THESE INSTRUCTIONS UNTIL THEY ARE COMPLETE AND THIS WARNING HAS BEEN REMOVED ***'''</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>'''*** THIS PAGE IS A WORK IN PROGRESS.  PLEASE DO NOT FOLLOW THESE INSTRUCTIONS UNTIL THEY ARE COMPLETE AND THIS WARNING HAS BEEN REMOVED ***'''</div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;"></ins></div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>'''It is generally advised that you do not upgrade from EPrints 3.2 to EPrints 3.3 on the same server rather you install and configure the latest EPrints 3.3 on a new server and test the best you can that all the functionality works as you expect and then migrate your archive's database and documents folder across to the new server.'''</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>'''It is generally advised that you do not upgrade from EPrints 3.2 to EPrints 3.3 on the same server rather you install and configure the latest EPrints 3.3 on a new server and test the best you can that all the functionality works as you expect and then migrate your archive's database and documents folder across to the new server.'''</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'>−</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div><del class="diffchange diffchange-inline">=</del>== Nomenclature <del class="diffchange diffchange-inline">=</del>==</div></td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>== Nomenclature ==</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>As the way that EPrints may be installed on your existing system the following keys will be used throughout this guide:</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>As the way that EPrints may be installed on your existing system the following keys will be used throughout this guide:</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
</table>Drn@ecs.soton.ac.ukhttps://wiki.eprints.org/w/index.php?title=Upgrading_from_3.2&diff=12445&oldid=prevDrn@ecs.soton.ac.uk: Added start of page.2017-09-05T14:25:41Z<p>Added start of page.</p>
<p><b>New page</b></p><div>'''*** THIS PAGE IS A WORK IN PROGRESS. PLEASE DO NOT FOLLOW THESE INSTRUCTIONS UNTIL THEY ARE COMPLETE AND THIS WARNING HAS BEEN REMOVED ***'''<br />
<br />
'''It is generally advised that you do not upgrade from EPrints 3.2 to EPrints 3.3 on the same server rather you install and configure the latest EPrints 3.3 on a new server and test the best you can that all the functionality works as you expect and then migrate your archive's database and documents folder across to the new server.'''<br />
<br />
=== Nomenclature ===<br />
As the way that EPrints may be installed on your existing system the following keys will be used throughout this guide:<br />
<br />
* '''EPRINTS_PATH''': The directory in which EPrints is installed, e.g. ''/opt/eprints3/'', /usr/local/share/eprints/''', etc.<br />
* '''ARCHIVE_DIR_NAME''': The name of the top level directory your archive. e.g. ''test'' if the full path is ''/opt/eprints3/archves/test/''.<br />
* '''OLD_SERVER''': The hostname of the old server running EPrints 3.2 (e.g. old-eprints.example.org).<br />
* '''NEW_SERVER''': The hostname of the new server running EPrints 3.3 (e.g. new-eprints.example.org).<br />
<br />
<br />
== Things to check ==<br />
Before you start installing the lateste EPrints 3.3 on a new server, it is worth asking the following questions about your existing EPrints 3.2 repository. As they will determine whether there are additional dependencies or configuration changes you need to made to get these to work. In some cases you may need to contact your institution's/organisation's IT support department to make changes at an institutional level (e.g. firewall changes, access to authentications systems such as Active Diretcoy / LDAP, etc.).<br />
<br />
# Does it use ROMEO completion?<br />
# Is the kultur module used?<br />
# Is it using irstats1?<br />
# Graphs shown on abstract pages?<br />
# How is user authentication handled?<br />
# Is SSL used?<br />
# Is Google Analytics used?<br />
# Is the REF module used?<br />
# Coversheets in use?<br />
<br />
<br />
== Upgrade Steps ==<br />
As you are initially just installing EPrints from scratch on a new server you can follow either the [[Installing EPrints on RHEL/Fedora/CentOS|Red Hat based Linux]] or [[Installing EPrints on Debian/ubuntu|Debian based Linux]] instructions. Installation on other operating systems is discouraged.<br />
<br />
Once you have an EPrints 3.3 repository running on your new server you can start reconfiguring it to meet your bespoke requirements. It is recommended that if you have more than one archive you work on one at a time. First you need to tar up you current archive and copy it to your new server:<br />
<br />
cd EPRINTS_PATH/archives/<br />
tar -czvf --exclude=ARCHIVE_DIR_NAME/documents/ ARCHIVE_DIR_NAME.tgz ARCHIVE_DIR_NAME<br />
scp ARCHIVE_DIR_NAME.tgz NEW_SERVER:</div>Drn@ecs.soton.ac.uk