Install NGINX Controller Agent

Overview

This page shows how to install, update, and uninstall the NGINX Controller Agent.

You can use the NGINX Controller Agent to monitor your systems with the NGINX Controller.

Objectives

  • Install the NGINX Controller Agent
  • Upgrade the NGINX Controller Agent to a newer version
  • Uninstall the NGINX Controller Agent

Install the NGINX Controller Agent

Install the NGINX Controller Agent on each NGINX Plus Instance that you want to manage and monitor.

Take the following steps to add an existing Instance to NGINX Controller:

  1. Open the NGINX Controller user interface and log in.

  2. Select the NGINX Controller menu icon, then select Infrastructure.

  3. On Infrastructure menu, select Instances.

  4. On the Instances Overview page, select Create to add an Instance.

  5. On the Create Instance page, select Add an existing instance.

  6. Add a name for the Instance. If you don’t provide a name, the hostname of the Instance is used by default.

  7. To add the Instance to an existing Location, select a Location from the list. Or select Create New to create a Location.

    Note:
    Once set, the Location for an Instance cannot be changed. If you need to change or remove the Location for an Instance, you must remove the Instance from NGINX Controller, and then add it back.
  8. (Optional) By default, registration of NGINX Plus Instances is performed over a secure connection. To use self-signed certificates with the Controller Agent, select Allow insecure server connections to NGINX Controller using TLS. For security purposes, we recommend that you secure the Controller Agent with signed certificates when possible.

  9. Use SSH to connect and log in to the NGINX Instance that you want to connect to NGINX Controller.

  10. Run the curl or wget command that’s shown in the Installation Instructions section on the NGINX Instance to download and install the Controller Agent package. The -i and -l options for the install.sh script specify the Instance name and Location, respectively.

    Note:

    Make sure you enter the commands to download and run the install.sh script on the NGINX Plus system, and not on the NGINX Controller.

    NGINX Controller 3.6 and earlier require Python 2.6 or 2.7. You’ll be prompted to install Python if it’s not installed already. Python is not required for NGINX Controller 3.7 and later.

After a few minutes, the NGINX Instance will appear on the Instances Overview page.

Upgrade the NGINX Controller Agent

The steps to upgrade the NGINX Controller Agent are similar to the installation steps.

Note:
When you upgrade NGINX Controller, you also need to upgrade the NGINX Controller Agent software on each monitored NGINX Plus Instance.

To upgrade the NGINX Controller Agent:

  1. Open the NGINX Controller user interface and log in.

  2. Select the NGINX Controller menu icon, then select Infrastructure.

  3. On the Instances Overview page, select Create.

  4. Follow the instructions in the Install Instructions pane to connect to the NGINX instance and install the updated Controller Agent package.

    Note:
    NGINX Controller 3.6 and earlier require Python 2.6 or 2.7. You’ll be prompted to install Python if it’s not installed already. Python is not required for NGINX Controller 3.7 and later.

Uninstall the Analytics, Visibility, and Reporting Daemon (AVRD)

NGINX Controller uses an Analytics, Visibility, and Reporting daemon (AVRD) to aggregate and report app-centric metrics. These metrics can be used to track your apps and monitor their health.

If you want to remove AVRD from your dataplane instances, take the following steps to uninstall AVRD and its supporting modules. You must perform these steps on each of your dataplane instances.

  • Debian/Ubuntu

    sudo apt-get purge avrd avrd-metrics nginx-plus-module-metrics
    
  • RedHat/CentOS

    sudo yum remove avrd avrd-metrics nginx-plus-module-metrics
    

Uninstall the NGINX Controller Agent and Delete an Instance

Note:
Be sure to uninstall the Controller Agent first, before you delete an Instance. If you don’t uninstall the Controller Agent first, the Instance may reappear in NGINX Controller after it has been deleted.
  1. Run the remove nginx-controller-agent command on your NGINX Plus instance to uninstall the Controller Agent.

    On Ubuntu/Debian:

    apt-get purge nginx-controller-agent
    

    On CentOS/Red Hat Enterprise Linux:

    yum purge nginx-controller-agent
    
  2. (Optional) If you use SELinux on CentOS or Red Hat Enterprise Linux, take the following steps to remove the SELinux policy that was created when the Controller Agent was installed:

    1. Revert the installed permissions:

      sudo semodule -r nginx
      
    2. Remove the following files:

      • nginx.te
      • nginx.mod
      • nginx.pp
  3. Delete the NGINX Plus instance from the NGINX Controller user interface:

    1. Open the NGINX Controller user interface and log in.
    2. Select the NGINX Controller menu icon, then select Infrastructure. The Instances Overview page is displayed.
    3. On the Instances Overview page, select the NGINX Plus instance that you want to delete.
    4. Select the Delete icon (trash can).
  4. Delete alerts:

    1. Open the NGINX Controller user interface and log in.
    2. Select the NGINX Controller menu icon, then select Analytics.
    3. On the Analytics menu, select Alerts.
    4. Hover the mouse over an alert that you want to update, then select the volume icon to mute the alert or the trash icon to delete it.

What’s Next


This documentation applies to the following versions of NGINX Controller Documentation:
3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 3.6, 3.7, 3.8, 3.9, 3.10, 3.11 and 3.12.