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
Log in to the AppDynamics Administration Console, as described in Access the Administration Console.
Click Controller Settings.
Set the value for the
multitenant.controllerproperty 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
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.
- Click Add (the + icon).
- Provide the details about the Account.
Users will log into the AppDynamics UI using this Account Name.
- 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.
- 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.