Skip to main content

Self-hosted server installation

The following instructions are for installing the self-hosted deployments for Lifecycle and Firewall.

For SaaS deployments see Sonatype Cloud

Default credentials

The default server credentials are the user admin with the password admin123

The Change Administrator Password notice will remain in the UI until the default password has been modified.

Installation

The steps throughout the documentation refer to storing the server installation files in the server's /opt directory. You may use a different directory, however, we recommend documenting any changes in your internal notes.

To Install the server:

  1. Download the latest version of the server. See Download and Compatibility

  2. Create a directory for the installation and move the archive into the folder

    cd /opt
mkdir nexus-iq-server
mv ~/Downloads/nexus-iq-server.* nexus-iq-server/
cd nexus-iq-server

  3. From the directory, extract the archive

    unzip nexus-iq-server*.zip
tar xfvz nexus-iq-server*.tar.gz

See IQ Server Directory and Files for details on the installation folder contents

Initialization

Use the following command to start the server. This starts the server using the configuration from the Config YAML. The output is logged to the console and errors will be recorded in the stderr.log file.

cd /opt/nexus-iq-server
java -jar nexus-iq-server-*.jar server config.yml 2> stderr.log

Linux requires a User to start the server. See Run IQ Server as a Service for details and examples.

A successful start will result in a console message similar to the following:

... [main] org.eclipse.jetty.server.AbstractConnector - Started InstrumentedBlockingChannelConnector@0.0.0.0:8070
... [main] org.eclipse.jetty.server.AbstractConnector - Started SocketConnector@0.0.0.0:8071

The start command may be modified by adding Java configuration parameters.

JAVA_OPTIONS="-Djava.util.prefs.userRoot=./sonatype-work/javaprefs -Djava.io.tmpdir=/path/to/tmpdir"
java $JAVA_OPTIONS -jar nexus-iq-server-*.jar server ./iq-server/config.yml 2> stderr.log

Automatic Shutdown on Errors

In rare circumstances, errors may occur that are severe enough to be effectively unrecoverable under normal conditions.

When this occurs, the system will shut down to preserve a valid system state and avoid errant behavior or data corruption that could occur as a result of continuing in a potentially abnormal or undefined state.

We recommend that you configure to Run IQ Server as a Service and ensure that it restarts automatically to avoid a prolonged outage in the event of an unrecoverable error.