Install or Upgrade App Delivery Manager

Follow the steps in this guide to install or upgrade NGINX Management Suite App Delivery Manager.


Before You Begin

Security Considerations

To ensure that your NGINX Management Suite deployment remains secure, follow the recommendations in this section:

  • Install NGINX Management Suite and its modules on a dedicated machine (bare metal, container, cloud, or VM).
  • Make sure that no other services are running on the same machine.
  • Make sure that the machine is not accessible from the Internet.
  • Make sure that the machine is behind a firewall.

Installation Prerequisites

Important:
Before you can install this module, you need to have NGINX and ClickHouse installed on your system. Additionally, you will need to add the NGINX Management Suite repository. The Prerequisites topic has detailed instructions on how to fulfill these requirements.

Dependencies with Instance Manager

App Delivery Manager relies on the platform features provided by NGINX Management Suite, specifically those included with Instance Manager.

When installing App Delivery Manager, you may need a newer version of NGINX Management Suite. The installation process will notify you of any version requirements before installing App Delivery Manager and any dependent packages, including NGINX Management Suite. You may cancel the installation process if a backup of the NGINX Management Suite is needed before upgrading.

The following table lists the minimum versions of Instance Manager required by App Delivery Manager:

App Delivery Manager Instance Manager Dependency
4.0.0-EA3 2.12.0 and later
4.0.0-EA2 2.11.0 and later
4.0.0-EA1 2.10.1 and later

Install App Delivery Manager

  1. To install the latest version of App Delivery Manager, run the following command:

    sudo yum install -y nms-app-delivery-manager
    

  1. To install the latest version of App Delivery Manager, run the following commands:

    sudo apt-get update
    sudo apt-get install nms-app-delivery-manager
    
  1. Enable and start the NGINX Management Suite services:

    sudo systemctl enable nms nms-core nms-dpm nms-ingestion nms-integrations nms-adm --now
    

    NGINX Management Suite components started this way run by default as the non-root nms user inside the nms group, both of which are created during installation.

  2. Restart the NGINX web server:

    sudo systemctl restart nginx
    

Post-Installation Steps

The following steps may be optional, depending on your installation configuration.

  1. (Optional) If you used a custom address, username, or password or enabled TLS when installing ClickHouse, follow the steps in the Configure ClickHouse guide to update the /etc/nms/nms.conf file. If you don’t do so, NGINX Management Suite won’t be able to connect to ClickHouse.

  2. (Optional) If you use Vault, follow the steps in the Configure Vault guide to update the /etc/nms/nms.conf file. If you don’t do so, NGINX Management Suite won’t be able to connect to Vault.

  3. (Optional) If you use SELinux, follow the steps in the Configure SELinux guide to restore SELinux contexts (restorecon) for the files and directories related to NGINX Management suite.

Accessing the Web Interface

To access the NGINX Management Suite web interface, open a web browser and go to https://<NMS_FQDN>, replacing <NMS_FQDN> with the Fully Qualified Domain Name of your NGINX Management Suite host.

The default administrator username is admin, and the generated password was displayed in the terminal during installation. If you’d like to change this password, refer to the “Set or Change User Passwords section in the Basic Authentication topic.

Add License

A valid license is required to make full use of all the features in App Delivery Manager.

Download License

Licensing App Delivery Manager

To license App Delivery Manager, use the trial license provided by your sales team. Do not use a trial license downloaded from MyF5, as this may lead to errors.

Please note that trials cannot be combined. For example, you cannot use a trial for Instance Manager and add a trial for App Delivery Manager. After a trial expires, it cannot be reused on the same instance.

Apply License

Refer to the Add a License topic for instructions on how to apply a trial license, subscription license, or Flexible Consumption Program license.


Upgrade App Delivery Manager

Note:
When you confirm the upgrade, the upgrade process will automatically upgrade dependent packages as needed, including Instance Manager. If you prefer to back up NGINX Management Suite before upgrading, you can cancel the upgrade when prompted.

  1. To upgrade to the latest version of App Delivery Manager, run the following command:

    sudo yum update -y nms-app-delivery-manager
    

  1. To upgrade to the latest version of App Delivery Manager, run the following command:

    sudo apt-get update
    sudo apt-get install -y --only-upgrade nms-app-delivery-manager
    
  1. Restart the NGINX Management Suite platform services:

    sudo systemctl restart nms
    

    NGINX Management Suite components started this way run by default as the non-root nms user inside the nms group, both of which are created during installation.

  2. Restart the NGINX web server:

    sudo systemctl restart nginx
    
  3. Restart the App Delivery Manager service:

    sudo systemctl restart nms-adm
    
  4. (Optional) If you use SELinux, follow the steps in the Configure SELinux guide to restore the default SELinux labels (restorecon) for the files and directories related to NGINX Management suite.


What’s Next

Set Up the Data Plane

Complete the following steps for each data plane instance you want to use with App Delivery Manager:

  1. Install NGINX Plus R24 or later
  2. Install the NGINX Agent on your data plane instances to register them with NGINX Management Suite as part of an Instance Group.
  3. Install NGINX Plus Metrics Module

Install Other NGINX Management Suite Modules