If you are using the current version of Cumulus NetQ, the content on this page may not be up to date. The current version of the documentation is available here. If you are redirected to the main page of the user guide, then this page may have been renamed; please search for it there.

Install NetQ Using the Admin UI

You can now install the NetQ software using the Admin UI.

This is the final set of steps for installing NetQ. If you have not already performed the installation preparation steps, go to Install NetQ System Platform before continuing here.

To install NetQ:

  1. Log in to your NetQ On-premises Appliance, NetQ Cloud Appliance, the master node of your cluster, or VM.

    In your browser address field, enter https://<hostname-or-ipaddr>:8443.

    This opens the Admin UI.

  2. Step through the UI.

    Having made your installation choices during the preparation steps, you can quickly select the correct path through the UI.

    1. Select your deployment type.

      Choose which type of deployment model you want to use. Both options provide secure access to data and features useful for monitoring and troubleshooting your network.

    2. Select your install method.

      Choose between restoring data from a previous version of NetQ or performing a fresh installation.

      Fresh Install: Continue with Step c.

      Maintain Existing Data (on-premises only): If you have created a backup of your NetQ data, choose this option.

      If you are moving from a standalone to a server cluster arrangement, you can only restore your data one time. After the data has been converted to the cluster schema, it cannot be returned to the single server format.

    3. Select your server arrangement.

      Select whether you want to deploy your infrastructure as a single stand-alone server or as a cluster of servers. One master and two worker nodes are supported for the cluster deployment.

      Select arrangement

      Select arrangement

      If you select a server cluster, use the private IP addresses that you used when setting up the worker nodes to add those nodes.

      Add worker nodes to a server cluster

      Add worker nodes to a server cluster

    4. Install NetQ software.

      You install the NetQ software using the installation files (NetQ-3.0.0.tgz for on-premises deployments or NetQ-3.0.0-opta.tgz for cloud deployments) that you downloaded and stored previously.

      Enter the appropriate filename in the field provided.

    5. Activate NetQ.

      This final step activates the software and enables you to view the health of your NetQ system. For cloud deployments, you must enter your configuration key.

      On-premises activation

      On-premises activation

      Cloud activation

      Cloud activation

    6. View the system health.

      When the installation and activation is complete, the NetQ System Health dashboard is visible for tracking the status of key components in the system. Single server deployments display two cards, one for the server, and one for Kubernetes pods. Server cluster deployments display additional cards, including one each for the Cassandra database, Kafka, and Zookeeper services.

      On-premises deployment

      On-premises deployment