Running IQ Server as a Service

The user needs full access rights to the IQ Server installation directory and the sonatypeWork directory listed in your config.yml. By default the sonatype work directory is inside the nexus-iq-server folder. The following command can grant a service user permission:

chown -Rv {username} /opt/nexus-iq-server

The command for starting IQ Server can be used in a startup script. Adjust the javaopts variable to suit the hardware used.

Startup Script

#! /bin/sh
cd /opt/nexus-iq-server
javaopts="-Xmx4096m -XX:MaxPermSize=128m"
java $javaopts -jar nexus-iq-server-*.jar server config.yml 2> stderr.log

A running server can be stopped with a shutdown script.

Shutdown Script

#!/bin/sh
     pid=`ps aux | grep nexus-iq-server | grep -vE '(stop|grep)' | awk '{print $2}'`
     kill $pid

Typically these approaches are combined to a service script similar to the script listed in Simplistic Service Script for Unix Systems. Saving this script as e.g. nexus-iq-server lets you to start the server with its log running to the current shell with:

./nexus-iq-server console

To start IQ Server as a background process:

./nexus-iq-server start

To stop running IQ Server as a background process:

./nexus-iq-server stop

This example script can be improved to be more robust against repeat invocations, long running stops, and potentially work better across different Unix flavors, but shows the principal functionality. A similar script can be used for Windows:

Simplistic Service Script for Unix Systems

#!/bin/sh

# The following comment lines are used by the init setup script like the
# chkconfig command for RedHat based distributions. Change as
# appropriate for your installation.

### BEGIN INIT INFO
# Provides:          nexus-iq-server
# Required-Start:    $local_fs $remote_fs $network $time $named
# Required-Stop:     $local_fs $remote_fs $network $time $named
# Default-Start:     3 5
# Default-Stop:      0 1 2 6
# Short-Description: nexus-iq-server service
# Description:       Start the nexus-iq-server service
### END INIT INFO

NEXUS_IQ_SERVER_HOME="/opt/tools/nexus-iq-server"
VERSION="[0-9.]*-??"
JAVA_OPTIONS="-Xmx4096m -XX:+UseG1GC"
# The user ID which should be used to run the IQ Server
# IMPORTANT - Make sure that the user has the required privileges to write into the IQ Server work directory.
RUN_AS_USER="iqserver"

do_start()
{
    _cmd &
    echo "Started nexus-iq-server"
}

do_console()
{
    _cmd
}

do_stop()
{
    pid=`ps aux | grep nexus-iq-server | grep '.jar server' | grep -vE '(stop|grep)' | awk '{print $2}'`
    kill $pid
    echo "Stopping nexus-iq-server - PID $pid ($?)"
}

do_usage()
{
    echo "Usage: nexus-iq-server [console|start|stop]"
}

_cmd()
{
    cd $NEXUS_IQ_SERVER_HOME || return $?
    chown $RUN_AS_USER ./stderr.log
    if [ "$RUN_AS_USER" == "$USER" ]; then
        java $JAVA_OPTIONS -jar nexus-iq-server-$VERSION.jar server config.yml 2> stderr.log
    else
        sudo -u $RUN_AS_USER java $JAVA_OPTIONS -jar nexus-iq-server-$VERSION.jar server config.yml 2> stderr.log
    fi 
}

case $1 in
    console)
        do_console
        ;;
    start)
        do_start
        ;;
    stop)
        do_stop
        ;;
    *)
        do_usage
        ;;
esac

Setting the above as a startup script will vary between operating systems and distributions depending on the init system used. Generally the script would be copied to a dedicated startup directory and assigned with run-levels and other characteristics for the start up. The following commands show an example on a Debian-based system:

sudo su
cp nexus-iq-server /etc/init.d/
cd /etc/init.d
update-rc.d nexus-iq-server defaults
service nexus-iq-server start

Depending on the requirements from your system administrator, modify the scripts to fit into your environment and exact deployment scenario.

[Unit]
Description=Nexus IQ Service
After=network-online.target

[Service]
Type=forking
ExecStart=/etc/init.d/nexus-iq-server start
ExecStop=/etc/init.d/nexus-iq-server stop
User=iqserver
Restart=on-abort
TimeoutSec=600

[Install]
WantedBy=multi-user.target

chmod a+x /etc/init.d/nexus-iq-server
sudo systemctl daemon-reload
sudo systemctl enable nexusiq.service
sudo systemctl start nexusiq.service