Difference between revisions of "Upgrading from 3.2"
m |
(Fixed typo for link) |
||
| (One intermediate revision by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | {{Work_in_Progress|This is a work in progress. Please do not follow these instructions until | + | {{Work_in_Progress|This is a work in progress. Please do not follow these instructions until they are complete and this warning has been removed.}} |
'''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.''' | '''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.''' | ||
| Line 28: | Line 28: | ||
== Upgrade Steps == | == Upgrade Steps == | ||
| − | 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/ | + | 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. |
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: | 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: | ||
Latest revision as of 11:36, 28 January 2022
Work in Progress
The page is a work in progress.
This is a work in progress. Please do not follow these instructions until they are complete and this warning has been removed.
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.
Nomenclature
As the way that EPrints may be installed on your existing system the following keys will be used throughout this guide:
- EPRINTS_PATH: The directory in which EPrints is installed, e.g. /opt/eprints3/, /usr/local/share/eprints/, etc.
- ARCHIVE_DIR_NAME: The name of the top level directory your archive. e.g. test if the full path is /opt/eprints3/archives/test/.
- OLD_SERVER: The hostname of the old server running EPrints 3.2 (e.g. old-eprints.example.org).
- NEW_SERVER: The hostname of the new server running EPrints 3.3 (e.g. new-eprints.example.org).
Things to check
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 Directory / LDAP, etc.).
- Does it use ROMEO completion?
- Is the kultur module used?
- Is it using irstats1?
- Graphs shown on abstract pages?
- How is user authentication handled?
- Is SSL used?
- Is Google Analytics used?
- Is the REF module used?
- Coversheets in use?
Upgrade Steps
As you are initially just installing EPrints from scratch on a new server you can follow either the Red Hat based Linux or Debian based Linux instructions. Installation on other operating systems is discouraged.
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:
cd EPRINTS_PATH/archives/ tar -czvf --exclude=ARCHIVE_DIR_NAME/documents/ ARCHIVE_DIR_NAME.tgz ARCHIVE_DIR_NAME scp ARCHIVE_DIR_NAME.tgz NEW_SERVER:
