This documentation relates to an old version of DSpace, version 3.x. Looking for another version? See all documentation.
This section describes how to upgrade a DSpace installation from one version to the next. Details of the differences between the functionality of each version are given in the Version History section.
Test Your Upgrade Process
In order to minimize downtime, it is always recommended to first perform a DSpace upgrade using a Development or Test server. You should note any problems you may have encountered (and also how to resolve them) before attempting to upgrade your Production server. It also gives you a chance to "practice" at the upgrade. Practice makes perfect, and minimizes problems and downtime. Additionally, if you are using a version control system, such as subversion or git, to manage your locally developed features or modifications, then you can do all of your upgrades in your local version control system on your Development server and commit the changes. That way your Production server can just checkout your well tested and upgraded code.
If you are upgrading across multiple versions
You should perform all of the steps of each upgrade between the version from which you are starting and the version to which you are upgrading. You do not need to install each intervening version, but you do need to carry out all of the configuration changes and additions, and all of the database updates, for each one. For example, when upgrading from 1.6.x to 1.8.x, you need to perform the configuration & database upgrade steps detailed in Upgrading From 1.6.x to 1.7.x followed by those detailed in Upgrading From 1.7.x to 1.8.x.
- Upgrading From 3.0 to 3.x
- Upgrading From 1.8.x to 3.x
- Upgrading From 1.8 to 1.8.x
- Upgrading From 1.7.x to 1.8.x
- Upgrading From 1.7 to 1.7.x
- Upgrading From 1.6.x to 1.7.x
- Upgrading From 1.6 to 1.6.x
- Upgrading From 1.5.x to 1.6.x
- Upgrading From 1.5 or 1.5.1 to 1.5.2
- Upgrading From 1.4.2 to 1.5
- Upgrading From 1.4.1 to 1.4.2
- Upgrading From 1.4 to 1.4.x
- Upgrading From 1.3.2 to 1.4.x
- Upgrading From 1.3.1 to 1.3.2
- Upgrading From 1.2.x to 1.3.x
- Upgrading From 1.2.1 to 1.2.2
- Upgrading From 1.2 to 1.2.1
- Upgrading From 1.1.x to 1.2
- Upgrading From 1.1 to 1.1.1
- Upgrading From 1.0.1 to 1.1