Upgrade Compatibility - Repository Manager 2 to 3
Requirement: Always Use Latest Versions
Sonatype always recommends having the latest version 2 upgrading to the latest version 3 (as well as IQ Server for applicable users). Latest versions have the latest bug fixes, especially important for the upgrade process and compatibility with new features of Nexus Repository Manager 3.
Upgrading to an older NXRM3 then subsequently updating to the latest NXRM3 is not equivalent, as it will hit old upgrade bugs.
Requirement: Always Use Same License
When upgrading from repository manager 2 to 3, both versions must have the same licensing setup.
The same license file can be used in NXRM2 and NXRM3 or a license can always be applied at a later time.
| Licensing: Valid Upgrade Path | Licensing: Unsupported Upgrade Path |
|---|---|
Nexus Repository Manager OSS 2 → Nexus Repository Manager OSS 3 Nexus Repository Manager Pro 2 → Nexus Repository Manager Pro 3 | Nexus Repository Manager OSS 2 → Nexus Repository Manager Pro 3 Nexus Repository Manager Pro 2 → Nexus Repository Manager OSS 3 |
Supported Nexus Repository Manager Upgrade Paths
Find the repository manager version you have in the left column. Follow the upgrade procedure in the right column.
| Source Nexus Repository Manager | Required Upgrade Procedure |
|---|---|
| 3.1.0 and newer | 1. Upgrade to latest available 3.x version |
| 3.0.0 to 3.0.2 |
|
| 3 milestone 7 |
|
| 3 milestone 1 to milestone 6 | Upgrading these versions is not supported. |
| Latest 2.x version |
|
| 2.0 or any later 2.x version |
|
| 1.x |
|
1 Versions after 2.7.2 do not include support for upgrading 1.x versions
The latest Nexus Repository Manager version 2 can be downloaded here.
The latest Nexus Repository Manager version 3 can be downloaded here.
Minimally Compatible Server Versions for Lifecycle Features
Below is a matrix of Sonatype server product versions minimally verified for lifecycle features. This does not mean all features are supported by these versions.
The table is suggesting that major issues should not be encountered running these minimal versions congruently.
If you encounter problems with any of the versions listed, we advise upgrading to the most recent version first to attempt resolution of the issue.
| Version 2 | Version 3 | Minimum Lifecycle Firewall compatible IQ Server |
|---|---|---|
| 2.14.8 | 3.12.1 | 1.46.0 |
| 2.14.6 | 3.8.0 | 1.42.0 |
| 2.14.5 | 3.7.1 | 1.33.0 |
| 2.14.4 | 3.4.0 | Not Supported |
| 2.14.3 | 3.2.1 | Not Supported |
| 2.14.2 | 3.2 | Not Supported |
| 2.14.1 | 3.1 | Not Supported |