jswank/iq-server repository overview

⁠jswank/iq-server

This is an unofficial Dockerfile for Sonatype Nexus IQ, based on CentOS. The official docker image is sonatype/nexus-iq-server⁠.

To run, binding the exposed port 8070 and 8071 to the host:

$ docker run -d -p 8070:8070 -p 8071:8071 --name iq-server jswank/iq-server

To test:

$ curl http://localhost:8071/ping

To (re)build the image:

Copy the Dockerfile and do the build-

$ docker build --rm=true --tag=jswank/iq-server .

⁠Notes

• Default credentials are: admin / admin123

• All logs are directed to stdout:

$ docker logs -f iq-server

• Installation of IQ Server is to /opt/sonatype/iq-server.

• A persistent directory, /sonatype-work, is used for report and DB storage. This directory needs to be writable by the IQ server process, which runs as UID 201.

• An environment variable, JVM_OPTIONS, used to control the JVM arguments

  $ docker run -d -p 8070:8070 --name iq-server -e JVM_OPTIONS="-server -Xmx2g" jswank/iq-server
  

  Copy

⁠Persistent Data

There are two general approaches to handling persistent storage requirements with Docker. See Managing Data in Containers⁠ for additional information.

1. Use a data volume container. Since data volumes are persistent until no containers use them, a container can created specifically for this purpose. This is the recommended approach.

$ docker run -d --name iq-data jswank/iq-server echo "data-only container for IQ server"
$ docker run -d -p 8070:8070 --name iq-server --volumes-from iq-data jswank/iq-server

1. Mount a host directory as the volume. This is not portable, as it relies on the directory existing with correct permissions on the host. However it can be useful in certain situations where this volume needs to be assigned to certain specific underlying storage.

$ mkdir /some/dir/iq-data && chown -R 201 /some/dir/iq-data
$ docker run -d -p 8070:8070 --name iq-server -v /some/dir/iq-data:/sonatype-work jswank/iq-server

⁠Changing IQ Server Configuration

There are two primary ways to update the configuration for iq-server.

Pass parameters to the JVM via IQ_OPTIONS. For instance, to change the baseUrl:

  $ docker run -d -e IQ_OPTIONS="-Ddw.baseUrl=http://someaddress:8000" jswank/iq-server

Create an image w/ updated config.yml:

• Create a new config.yml
• Create a Dockerfile:

  FROM jswank/iq-server
  ADD config.yml /opt/sonatype/iq-server/

• Create a local image:

  $ docker build -t my-iq-server .

• Use this docker image as you normally would: docker run -d my-iq-server