Running the Nexus IQ Server as a Service on Windows

This knowledge base article provides instructions for running the Nexus IQ Server as a service under Windows using a free edition of Java Service Wrapper.  If you want to run the Nexus IQ Server as a service on Linux please see our installation guide.

New Nexus IQ Server Install as a Windows Service

  1. Ensure you have already installed the latest JDK from Oracle on the target system and the system meets our other system requirements.
  2. Download and extract the clm-jsw.zip file attached to this article into a directory path that does not contain spaces.
  3. Replace the extracted conf/config.yml with the config.yml file from current Nexus IQ server installation (be sure to check the "sonatypeWork" property in the copied version to make sure it is correct).
  4. Copy the nexus-iq-server-<version>.jar file from your installation into the "lib" directory.
  5. Note: Do not copy the nexus-iq-cli-<version>.jar file into that directory. That is the command line scanner, and it cannot be on the class path of IQ Server.
  6. The service will run as the SYSTEM user. IQ server requires use of a temporary directory to perform some work.

    The SYSTEM user will use "%systemroot%\System32\config\systemprofile\Temp" as it's temporary directory.

    On some versions of Windows this directory does not exist by default. Make sure that this directory exists. Create it manually if it does not.
  7. Using an administrative user, run ".\bin\clm install".
  8. Using an administrative user, run ".\bin\clm start" to start the windows service, or start it through the services UI.
  9. Verify that on restarting the host, that the application will successfully restart itself.

Editing Java Program Arguments Used to Lauch IQ Server

You may want to edit the Java.exe arguments used when IQ Server is launched. These are not parameters to IQ Server, but rather parameters for the Java Virtual Machine. 

To change arguments passed to the java.exe program launching IQ Server:

  1. Edit ./bin/jsw/conf/wrapper.conf
  2. Find the references to wrapper.java.additional.<n> properties - add or remove lines with new properties according to the java service wrapper documentation.

Example: Configure a custom outbound truststore

In order to override the default Java truststore IQ Server uses:

  1. Edit ./bin/jsw/conf/wrapper.conf
  2. Specify wrapper.java.additional.<n> properties defining the trustStore and its password. Make sure all paths specified use forward slashes, even on windows and if the value requires a space, then the entire value must be in quotes.
# MaxPermmSize not needed on JDK 8+, so comment it out
# wrapper.java.additional.1=-XX:MaxPermSize=256m
wrapper.java.additional.1=-Djavax.net.ssl.trustStore=/<replace_with_absolute_full_path>/nexus-iq-server-outbound.jks
wrapper.java.additional.2=-Djavax.net.ssl.trustStorePassword=changeit

 

Have more questions? Submit a request

0 Comments

Article is closed for comments.