Tenants

A tenant is a group of users that have the same view of the system. This section describes how to manage tenants in the Streamlio Cloud.

Streamlio Cloud based on Apache Pulsar was built from the ground up to support multi-tenancy. It supports two multi-tenancy-specific resources to enable multi-tenancy: tenants and namespaces. To give an example, imagine a Streamlio Cloud instance deployed to support a wide variety of applications. Within the instance, each tenant can represent a team in the enterprise, a core feature, or a product line, to give just a few examples. Each tenant, in turn, can contain several namespaces, for example one namespace for each application or use case. A namespace can then contain any number of topics.

Create a tenant

An administrator can create a tenant using the following command

pulsar-admin tenants create TENANT --admin-roles ADMIN-ROLES

where TENANT is the name of the tenant and ADMIN-ROLES is a comma separated list of roles allowed to administrate the tenant. For example, the command to create the tenant in my-tenant with the role jon as being the administrator is as follows:

pulsar-admin tenants create my-tenant --admin-roles jon

Delete a tenant

One can delete a tenant when it is not required using the command

pulsar-admin tenants delete TENANT

where TENANT is the name of the tenant. For example, if you want to delete the tenant called my-tenant issue the following command

pulsar-admin tenants delete my-tenant

Update a tenant

One can update the tenant such as changing the administrator

pulsar-admin tenants update TENANT --admin-roles NEW-ADMIN-ROLE

where TENANT is the name of the tenant and NEW-ADMIN-ROLES is a comma separated list of new roles allowed to administrate the tenant. For example, if you want to update the tenant called my-tenant with the role jeff as being the administrator, issue the following command

pulsar-admin tenants update my-tenant --admin-roles jeff

List all tenants

A Streamlio Cloud instance can have multiple tenants. You can list all the tenants using the following command

pulsar-admin tenants list TENANT

The output will list all the tenants in the Streamlio Cloud instance.

_____ Copyright 2019 Streamlio, Inc. Apache, Apache BookKeeper, Apache Pulsar and associated open source project names are trademarks of the Apache Software Foundation.