This page covers how to manually apply and update a license file for on-premise Controllers. You must manually apply the license file after installing the Controller. Whenever you purchase additional units, you must update the license file. 

For EUM and BiQ licenses:

  • If you have custom values set in Account Settings, such as data retention, and you update the license file, those settings no longer apply. You must first manually update those settings on admin.jsp and then update the license file.
  • After updating a license file, remember to re-provision the new license to the EUM Collector.

Apply a License File to a Single On-Premises Controller

After installing the Controller, you must manually apply the license file to the Controller installation directory:

  1. Copy the license file to the Controller installation directory (typically found within {controller_home}/platform/product/controller/). After copying the file, allow up to five minutes for the license change to take effect.

    If the license has not been detected after five minutes, try the following:

    • Linux: Execute the following command:
    touch license.lic
    CODE
    • Windows: Remove and copy the file again.
  2. To verify that the license file is applied, check that the license appears on the License page under Peak Usage.

Apply a License File to a Multi-Tenant Controller

If you are updating the license file for a multi-tenant Controller, you must manually edit the accounts to apply the change. For example, if you purchase an additional 200 licenses to distribute across two accounts, you must manually specify how many units go to each account.

To apply a license file to a multi-tenant Controller:

  1. Copy the license file to the Controller installation directory. After copying the license file, allow up to five minutes for the license change to take effect.
  2. Log in with root user at http://<controller_host>:<port>/controller/admin.jsp. 
  3. Click Accounts and select the account you want to apply the license to.
  4. Update the license expiration date and license units based on license.lic.
  5. Save the changes.

Update a License File with Additional Purchased Units

If you purchase additional license units, you must update the license file in the Controller installation directory: 

  1. Rename your old license file to something other than license.lic (so that the Controller ignores it). After copying the license file, allow up to five minutes for the license change to take effect.

    If the license has not been detected after five minutes, try the following:

    • Linux: Execute the following command:
    touch license.lic
    CODE
    • Windows: Replace the license file again.

  2. To verify that your license file is applied, check that the license you purchased appears on the License page under Account Usage.

Update License Rules in the Controller

If you have license rules, you must update rules to account for the additional units purchased after updating your license. For example, if you buy another 200 licenses to distribute across two license rules, you must manually update the rules with those additional units.

Update MAC Address 

AppDynamics licenses for on-premises Controllers are tied to your machine's MAC address on which you installed the Controller. The original MAC address set up must be done by AppDynamics Operations when a new on-premises license is first provisioned. Afterward, you can update your MAC address manually.

You can change the MAC address up to twelve times within a 12-month period using these steps. If you need to change it again, contact the AppDynamics Licensing Team by emailing licensing-help@appdynamics.com.

To update the MAC address on a permanent license:

All License Admins that have access privileges for a permanent on-premises license can update MAC addresses. To view a list of these users, go to Account Overview > Subscriptions.

  1. Navigate to www.appdynamics.com.
  2. Log in with your AppDynamics user credentials.

  3. Ensure that your account is set up with License Admin permissions. 

  4. On the main navigation bar, click Account Overview > Subscriptions.

  5. Click the [Controller] Name or ActionsView Details.

  6. Click Edit next to the MAC address. 

  7. Enter the new hexadecimal MAC address.
  8. Click Save.