Documentation Nexus IQ Server 1.17

Our documentation site has moved. For the most current version, please see http://help.sonatype.com

4.4. Upgrading the Nexus IQ Server

The latest version of the Nexus IQ Server can be downloaded from the Sonatype support site.

Before starting any upgrade, always start by checking our compatibility matrix, Knowledge Base article, and making a backup.

[Tip]

Before attempting an upgrade, it’s best to review all upgrade instructions provided for your current version, as well as any versions that followed.

Upgrade Instructions
  1. Stop the Nexus IQ Server
  2. Perform a backup
  3. Make a copy of nexus-iq-server/config.yml
  4. Copy the new installation bundle into installation folder
  5. Extract the bundle
  6. Apply all modifications from the backup config.yml to the new config.yml file including e.g. server ports
  7. Update any startup scripts as needed
  8. Start the Nexus IQ Server
[Note]

Before upgrading we highly recommend reviewing the Nexus IQ Server Backup Instructions section above. Also, if there is any concern, please feel free to contact our support team: support@sonatype.com.

4.4.1. Upgrading from Version 1.16 or Earlier

In version 1.17 a rebranding of the Sonatype CLM product took place, and is now known as Nexus IQ. As part of this rebranding two of the binaries also changed during this release:

Server

From: sonatype-clm-server

To: nexus-iq-server

CLI

From: sonatype-clm-scanner

To: nexus-iq-cli

If you have any scripts utilizing the previous names, you will want to update these given the change above.

[Note]

In the example above, only the server name is given. The full binary name would look like nexus-iq-server-1.17.jar

4.4.2. Upgrading from Versions Earlier than 1.9.x

While Sonatype only supports the previous two releases, we are happy to help direct any upgrade needs you may have. If you are upgrading from a version prior to 1.9.x, please contact our support team directly: support@sonatype.com.