IQ Server Installation
Check the IQ Server requirements before installation.
IQ Server Installation
To Install the IQ Server:
- Download the latest version of IQ Server
- Create a directory where you want to install the IQ Server
Move the IQ Server archive into the folder
cd /opt mkdir nexus-iq-server mv ~/Downloads/nexus-iq-server.* nexus-iq-server/ cd nexus-iq-server
Enter the directory
Extract the archive with one of the following commands:
unzip nexus-iq-server*.zip tar xfvz nexus-iq-server*.tar.gz
This unpacks the following files into your directory:
README.txt config.yml demo.bat demo.sh eula.html nexus-iq-cli-1.125.0-01.jar nexus-iq-server-1.125.0-01.jar
If you plan to use an external database, we highly recommend configuring it before starting the IQ Server.
See External Database Configuration for more information.
Start the IQ Server
Start the IQ Server with the following commands:
cd /opt/nexus-iq-server java -jar nexus-iq-server-*.jar server config.yml 2> stderr.log
Linux requires a User to start IQ Server. See Running IQ Server as a Service for details and examples.
This starts the IQ Server using the configuration from the config.yml file. Output will be logged to the console and errors will be recorded in the stderr.log file. 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
IQ Server now requires Java 8 starting with the 1.42 release. If you are running on an older version of Java you may encounter an error message on startup. Check out the System Requirements for more information.
The IQ Server start command can be modified by adding java configurations parameters such as
-Xmx4g -XX:+UseG1GC to improve performance and adapt to the server hardware.
The web application can be accessed at port 8070 of your server via any web browser.
The initial startup will prompt you to install a License.
We recommend always using SSL to ensure confidentiality of report and credential data during transit. This can be done by setting up a proxy server. You can find more information in the HTTPS Configuration section of Configuring.
Log in to IQ Server
Your first time logging in you will need to use the default Admin account. This default Admin account has all Administrative roles and permissions. Be sure to change the default admin password after logging in.
To log into the IQ Server:
- Navigate to your IQ Server installation (e.g. localhost:8070).
- Enter your username and password.
Click on the Log Out link in the upper right corner to log out.
IQ server will time out after 30 minutes of inactivity.
In product notifications provide up-to-date information about IQ Server. Click the notifications iconin the IQ Server toolbar to view the Notifications panel. Unread notifications are indicated by a blue counter over the notification icon.
Install the License
IQ Server requires a valid license. Your IQ Server license will be provided by the Sonatype support team as
To install the product license:
- Navigate to the IQ Server web application (e.g. http://localhost:8070).
- Sign in to the IQ Server with the default administrator login credentials (user ID "admin", password "admin123").
- Click the Install License button and upload your
- Accept the end user license agreement.
After installing the license, you will be redirected to the Getting Started page.
IQ Server Directories
IQ Server creates a directory to store its data and configuration during the initial startup. The default directory is
./sonatype-work/clm-server and can be configured in
config.yml. This path is relative to the location of the invoking java command.
Running the default startup command from the installation directory causes
/sonatype-work/clm-server to be created within it.
to a different location to separate the installation and data directories.
A log directory is also created in the installation directory. Set the
to change the location.