This documentation is for WSO2 Enterprise Service Bus version 4.9.0 . View documentation for the latest release.

All docs This doc
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

The goal of multitenancy is to maximize resource sharing by allowing multiple users (tenants) to log in and use a single sever/cluster at the same time, in a tenant-isolated manner. That is, each user is given the experience of using his/her own server, rather than a shared environment. Multitenancy ensures optimal performance of the system's resources such as memory and hardware and also secures each tenant's personal data.

You can register tenant domains using the Management Console of WSO2 products.

When multitenancy is enabled and a tenant becomes inactive for a long period of time, the tenant is unloaded from the server's memory. By default, the time period is 30 minutes. After that, the tenant has to log in again before sending requests to the server.

You change the default time period allowed for tenant inactiveness by adding -Dtenant.idle.time=<time_in_minutes> java property to the product's startup script ( ./ file for Linux and wso2server.bat  for Windows) as shown below:


    -Dtenant.idle.time=30 \

Adding and viewing a tenant

To add and view a tenant, take the following steps:

  1. On the Configure tab of the Management Console and click Add New Tenant.
  2. Enter the tenant information in Register A New Organization screen as follows, and click Save.
    • Domain -  The domain name for the organization, which should be unique (For example: This is used as a unique identifier for your domain. You can use it to log into the admin console to be redirected to your specific tenant. The domain is also used in URLs to distinguish one tenant from another. 
    • Usage plan for the tenant - The usage plan defines limitations (such as number of users, bandwidth etc.) for the tenant
    • First Name/Last Name - Name of the tenant admin
    • Admin Username - The login username of the tenant admin. Username always ends with the domain name (For example:
    • Admin Password - The password used to log in using the admin username specified.
    • Admin Password (Repeat)- Repeat the password to confirm.
    • Email - The email address of the admin
  3. After saving, the newly added tenant appears in the Tenants List
    Click View Tenants in the left menu, to see information of all tenants currently existing in the system.
  • No labels