Switching from the IQ Server Standalone JAR to the Bundled JDK Assembly

Download the latest Sonatype IQ Server distribution with the bundled JDK from our Download and Compatibility page.

Extract the package to a directory where you intend to run the new version.

You might encounter messages like "Ignoring unknown extender header keyword 'LIBARCHIVE.creationtime'" during extraction. You can typically ignore these messages.

Navigate to the extracted directory (e.g., /opt/sonatype-iq-server/nexus-iq-server-<version>-linux-aarch_64/bin).

Verify that the nexus-iq-server script is present; this is the script you will use to run the application.

Open the systemd service file (named sonatype-iq-server) for editing.

Comment out or remove the existing java command line that launches the standalone JAR.

Replace that line with a command that uses the provided executable/script.

1. Ensure that any necessary environment variables or working directories are correctly set.

2. Pay close attention to how the configuration file (config.yml) is referenced, and consider using an absolute path to avoid ambiguity.

3. See below for an illustrative example - you would need to adapt this to your particular system:

   1. If you have a script that currently contains the following:

      Bash
      java -jar /path/to/nexus-iq-server.jar server /path/to/config.yml

   2. You would change it to something like this:

      Bash
      /path/to/extracted/bin/nexus-iq-server server /path/to/config.yml

Stop your IQ Server instance.

(Optional) Update any stop command in your service/startup configuration.

1. If your service/startup configuration includes a specific command or script to stop IQ Server, you might need to update it to align with how the bundled JDK version is stopped.

2. For example, if your script uses a grep to find the process based on the JAR name, you might need to adjust the grep pattern to find the process based on the new executable name.