The XL Release upgrade process you use depends on the version from which you are upgrading, and the version to which you want to go. If you are upgrading from an older, unsupported version such as 6.2.0 to the most recent version such as 9.0.x, you will need to make a minimum of 3 “hops”, performing multiple upgrades in succession. For example, if you are starting from version 6.2.x, you’d perform the following upgrades:
- Upgrade from version 6.2.x to version 7.0.x
- Upgrade from version 7.0.x to version 7.5.x
- Upgrade from version 7.5.x to version 9.0.x
The following table describes typical upgrade scenarios based on your starting version.
|If you are on…||Hop 1||Hop 2||Hop 3|
|6.2.x||7.0.x through 7.2.0||7.5.x||8.5.x or 9.0.x|
|7.0.x through 7.2.0||7.5.x||8.5.x or 9.0.x|
|7.5.x||8.5.x or 9.0.x|
|9.0.x (e.g. 9.0.2)||9.0.x (e.g., 9.0.3)|
This section provides links to the appropriate upgrade instructions you must use for each hop based on your starting version and your destination version.
XL Release version 7.0.2 through 7.2.x are the minimum versions from which you can perform the next hop to later versions that will require you to perform a database migration. Therefore, if you are upgrading from an older, unsupported version such as 6.2.x, you must first get to one of these versions before you can proceed with upgrading to 7.5.x.
Beginning with XL Release version 7.5.0, the JackRabbit (JCR) archive database was replaced with an SQL relational database. The purpose of this important update to the repository technology was to improve the overall performance and the scalability of XL Release.
To get to version 7.5.x (specifically you should choose to upgrade to the last version in the 7.5.x stream which is 7.5.7), you must run a migration tool to migrate from JCR to a supported SQL database as part of your upgrade process. In order to run the migration tool, you must be on a version between 7.0.x and 7.2.x.
Later versions of XL Release (8.x and higher) will not allow you migrate an embedded database to an external database. Therefore, When migrating from a previous JCR-based version of XL Release (version 7.2 and earlier) to a SQL-based version, make sure that you choose to migrate to an external database.
Procedure: Upgrade XL Release to version 7.5.x.
If your base XL Release version is 7.5.x or higher, you’re already using a SQL relational database, so your upgrade process should be simplified.