This page describes how to create and manage accounts in a multi-tenant Controller. The tenant mode determines whether the Controller UI offers single or multiple environments. See Controller Deployment

Switch from Single-Tenant to Multi-Tenant Mode

Switching from single-tenancy to multi-tenancy mode is supported. However, switching from multi-tenancy to single-tenancy is not. Take precautions to ensure multi-tenancy is the correct mode for your environment.

If multi-tenancy is enabled for an on-premises Controller (or for a SaaS Controller), users must enter the account name in the Account field when logging in to the Controller UI.

  1. Navigate to the Administration Console.
  2. Locate the multitenant.controller setting. 
  3. Set the value to true

Create Accounts in Multi-Tenant Mode

In multi-tenant mode, you can add accounts as follows:

  1. Log in to the AppDynamics Administration Console as the AppDynamics root user.
  2. Click Account Settings and then Add
  3. Define the licensing entitlements that apply to the account.
    Account-level license unit limits let you prevent a particular account from using more licensing units than it should. 

    The overall license limits applicable at the Controller level are independent of any specific limits you apply at the account level.  

    For example, if an account is set up with a Controller Java Agent limit of 100, you can ensure that the new account never interferes with the license availability of another account by setting the Java Units Provisioned value for the account to a smaller limit. However, if you set it to 100 and other accounts are also set to that amount, the first 100 agents that connect to the Controller would occupy those units, regardless of the accounts they report to. Similarly, you can limit the life span of the account by setting an expiration date for the license.

    You can see how many total license units are available to your Controller on the License Management page. 

  4. When finished defining entitlements, click Save.

After enabling multi-tenant mode, users must specify the account they want to log into in the Account field in the Controller UI login screen. See Java Agent Configuration Properties.NET Agent Configuration Properties, and Database Agent Configuration PropertiesMachine Agent Configuration Properties.