This documentation is for WSO2 Storage Server 1.0.3. View documentation for the latest release.
Page Comparison - Configuring Multiple Tenants (v.2 vs v.3) - Storage Server 1.0.3 - WSO2 Documentation

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

The goal of multitenancy is to maximize resource sharing across multiple users (while hiding the fact that these users are on the same server) and to ensure optimal performance. You can register tenants in the SS Management Console, allowing tenants to maintain separate domains for their institutions.


When multitenancy is used, certain tenants can sometimes become inactive for a long period of time. By default, if the inactive period is 30 minutes, the tenant is unloaded from the server memory. This requires the tenant to log in again before sending requests to the server.

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

Code Block
    -Dtenant.idle.time=30 \

Table of Contents

Adding a tenant

To add a new tenant, take the following steps:

  1. On the Configure tab of the Management Console, click Add New Tenant.
  2. Enter the information about this tenant as follows: 
    • Domain -  The domain name for the organization, which should be a unique name (e.g.,
    • Usage plan for the tenant - The usage plan defines limitations (such as number of users) for the tenant.  
    • First Name - First name of the tenant admin.
    • Last Name - Last name of the tenant admin. 
    • Admin Username - The username the tenant admin will use to log in. The username must always end with the domain name (e.g., [email protected]).
    • Email - The email address of the admin.

Viewing tenants

To view existing tenants, on the Configure tab in the Management Console, click View Tenants.   

Include Page
Shared:Configuring Multitenancy
Shared:Configuring Multitenancy