Adding a Tenant

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 add a tenant using the CLI tool, REST API or the PPaaS Console, allowing tenants to maintain separate domains for their institutions as shown below:

Sample tenant JSON

{
  "admin": "admin",
  "firstName": "Frank",
  "lastName": "Myers",
  "adminPassword": "admin123",
  "tenantDomain": "frank.com",
  "email": "foo@bar.com",
  "active": "true"
}

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 ( ./wso2server.sh file for Linux and wso2server.bat for Windows) as shown below:

JAVA_OPTS \
    -Dtenant.idle.time=30 \