Skip to main content

Upgrade the IQ Server

Upgrading the IQ Server is replacing the server jar with the latest version and restarting the service. On startup, the server detects that it has been upgraded from the files in the sonatype-work directory and performs any changes. This often includes updates to the database and files on disk.


Some upgrades will take longer before the server is available due to modifications made to the database. Allow for enough time for the process to complete before interrupting the service. Disable any process that may interrupt the server while the upgrade is happening to avoid corruption. In a Kubernetes environment, a liveness probe may attempt to restart the server container during the upgrade.

We strongly recommend taking a backup of your server installation and sonatype-work directories before attempting to upgrade. Rarely does an issue happen during sequential updates, however, updates spanning multiple versions may run into unforeseen issues.

Follow the instructions to Backup the IQ Server

Review the release-specific upgrade instructions for your current version and any versions that follow.

Upgrade Instructions

Download the latest version from Download and Compatibility

  1. Update differences from your current config.yml file and use the new config.yml. Note any new default configuration settings in the new config.xml

  2. Stop the server

  3. Replace the old config.yml with the new config.yml file

  4. Copy the new server jar and change the startup scripts to reflect the new jar name

  5. Start the server