Documentation Nexus IQ Server 1.20

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

4.4. Upgrading the IQ Server

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

Before starting any upgrade, make sure you have reviewed all upgrade instructions provided for your current version (see additional sections below), as well as any versions that followed.

Additionally, you should check the Compatibility Matrix located in our Download and Install Knowledge Base article.

  1. Stop the 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. Copy your backed-up config.yml over the default
  7. Update any startup scripts as needed
  8. Start the IQ Server
[Note]

Optionally you can manually merge the changes from the existing config.yml into the new, but this is not required.

If there is any concern, please feel free to contact our support team: support@sonatype.com.

4.4.1. Upgrading from Version 1.17 or Earlier to Version 1.18 or Later

IQ Server version 1.18 introduces the Root Organization—a new entity at the top of the system hierarchy that allows you to set policy globally across all organizations and applications. After you update the IQ Server to version 1.18, you should configure and create the Root Organization. It’s a one time process, and occurs when the server is restarted. The process makes a permanent change to the system hierarchy that cannot be undone. It is strongly recommended that you backup the IQ Server and read "Introducing the Root Organization" before proceeding.

4.4.2. 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.20.0-02.jar

4.4.3. 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.