Skip to main content
Version: 5.21.0

How to Enable Nexus IQ

This guide walks you through how to enable Nexus IQ.

note

These tasks are intended to be completed as a system integrator.

Prerequisites​

  • Nexus Repository Manager enabled
  • Nexus Repository Manager configured with a Pro license
  • Structsure Package
  • Structsure IaC Bundle
  • kubectl configured to interact with your cluster

Step 1: Enable Nexus IaC​

note

Additional details on configuring IaC can be found here.

Enabling the Nexus IaC will provision and configure Nexus IQ with an RDS.

In the infra env.hcl, enable the nexus module:

locals {
  modules = {
    nexus = true
  }

  nexus_repository_manager_inputs = {
    nexus_pro_version_enabled = false # If you have a license, you can enable this to turn on RDS
  }
}

Step 2: Configure Structsure Package​

note

More details about installation options can be found here.

Nexus IQ is disabled by default in Structsure. To enable it, add the following to the Zarf config file:

package:
  deploy:
    set:
      NEXUS_IQ_ENABLED: true

Step 3: Configure License​

Upon first visiting Nexus IQ, you will be able to upload a license file to activate Nexus IQ.

Step 4: Update Default Password​

The URL to Nexus IQ can be found in the Virtual Services in the nexusiq namespace.

Running the command kubectl get virtualservice -n nexusiq should return something similar to:

NAME                       GATEWAYS                  HOSTS                                    AGE
nexus-iq                   ["istio-system/public"]   ["nexus-iq-server.10-32-1-126.nip.io"]   174m

Log in with the default admin and admin123 username/password; then:

  1. In the top right of the UI, click the user profile icon.
  2. Click Change Password.
  3. Provide a current and new password.

Step 5: Log in to Nexus Repository Manager​

The initial admin password is available in a Kuberenetes secret in the nexus-repository-manager namespace. Kubernetes secrets are base64 encoded, so the password can be retrieved with the following command:

kubectl get secret nexus-repository-manager-secret -n nexus-repository-manager --template='{{index .data "admin.password" | base64decode }}'

The URL to Nexus Repository Manager can be found in the virtual services in the nexus-repository-manager namespace.

Running the command kubectl get virtualservice -n nexus-repository-manager should return something similar to:

NAME                       GATEWAYS                  HOSTS                           AGE
nexus-repository-manager   ["istio-system/public"]   ["nexus.10-32-19-210.nip.io"]   174m

Be sure to prepend the host with https://.

Upon visiting the URL, you can log in with the admin user and the password retrieved above.

Step 6: Configure Nexus IQ​

While logged in as an admin:

  1. Go to the admin panel by clicking the gear icon at the top of the page.
  2. In the left-hand panel, click IQ Server.
  3. Apply the following settings:
    1. Enable IQ Server: Check box.
    2. IQ Server URL: Enter http://nexus-iq.nexusiq.svc.cluster.local:8070.
    3. Authentication Method: Select User Authentication.
    4. Username: Enter admin.
    5. Password: Enter updated password from previous step.