This page applies to an earlier version of the AppDynamics App IQ Platform.
For documentation on the latest version, see the 4.4 Documentation.


Skip to end of metadata
Go to start of metadata

On this page:

The tenancy mode of an on-premise AppDynamics Controller (whether it is single-tenancy or multi-tenancy) is set at installation time. However, you can switch the tenancy mode from single-tenant to multi-tenant mode later as described here.

Note that switching from multi-tenancy to single-tenancy is not supported

Differences Between Multi- and Single-Tenant Mode

In multi-tenant mode:

  • You can create multiple accounts (tenants) in the Controller. 
  • Each account will have its own set of users and Applications. 
  • The Controller login page includes an additional field where users need to choose an account to log in to. 
  • Essentially, multi-tenant mode allows you to partition users and access to application data in a logical, secure way. 

In single-tenant mode:

  • There is only one account (tenant) in the Controller system. 
  • All users and applications are part of this single built-in account, so all users have access to all monitored Applications in this mode.
  • The account is not exposed to users in the Controller UI. The account field in the log in page is omitted for single tenant mode.
  • AppDynamics recommends single-tenant mode for most installations.

Switch from Single-Tenant to Multi-Tenant Mode

  1. Log in to the AppDynamics Administration Console, as described in Access the Administration Console

  2. Click Controller Settings.

  3. Set the value for the multitenant.controller property to true.

Create Accounts in Multi-Tenant Mode

In multi-tenant mode you create accounts from the Admin Console interface. A Controller license does not enforce or distinguish a particular tenancy mode for the Controller, but the total number of licensed agents for all accounts cannot exceed the number of agents for which you are licensed.  

To add accounts to a multi-tenant Controller
  1. In the Administration Console and click Accounts
    If you are switching from single- to multi-tenant mode, you will see the default accounts used for single-tenant mode. This window also provides information on the number of licenses provisioned for the agents in your environment.

  2. Click Add (the + icon).
  3. Provide the details about the Account. 
    Users will log into the AppDynamics UI using this Account Name.
  4. Create credentials for the Controller administrator.
    The user with administrator privileges can then create users for that Account. For details see Configure Users and Groups.
  5. Click Create account.

After enabling multi-tenant mode, users need to specify the account they want to log into in the Account field in the Controller UI login screen. For details see Java Agent Configuration Properties.NET Agent Configuration Properties, and Standalone Machine Agent Configuration Properties.

  • No labels