Tenants and management

A tenant is an allotment of users and resources within an organization. Organizations can leverage tenants for distinct purposes, such as development or production, and then share common resources across tenants. Each tenant has its own resources, users, and workloads. SambaStudio allows organizations to allocate resources across multiple tenants.

This document describes:

The SambaStudio tenant structure and nomenclature.
The switching tenant feature available to all users.
The tenant management features available to an organization administrator (OrgAdmin).

See Users and management for more information on SambaStudio user roles and management.

Structure and nomenclature

SambaStudio uses the following structure and terminology in describing tenants and users.

Organization: Organization describes an entity or customer using SambaStudio.
User: A user is part of an organization and can be assigned a predefined role. A user can be part of and assigned to multiple tenants. All users within the same tenant can view or manage projects and workloads present in the tenant.
Tenant: A tenant is an allotment of users and resources within an organization. Each tenant has its own resources, users, and workloads.
Default tenant: The default tenant is where all resources are allocated initially. During the SambaStudio installation, the default tenant (Default Tenant) is created and an organization administrator (OrgAdmin) is assigned to it.

When updating tenant RDUs and reallocation of resources is performed, resources will get removed from the selected tenant and assigned to the default tenant. The resources then can be added from the default tenant to another tenant.
Project: A project is a logical grouping of workloads and artifacts within a tenant.

Switching tenants

SambaStudio allows users to switch the active tenant they are using from any window in the platform. By switching tenants, users can view or manage projects and workloads that are present in multiple tenants.

A user must be assigned to more than one tenant by an organization administrator or tenant administrator in order to switch tenants.

Click the tenant selection drop-down in the top menu bar. A list of your assigned tenants will display with the current tenant highlighted in blue and a checkmark. Only tenants assigned to you by your organization administrator or tenant administrator will be displayed.

Figure 1. Tenant selection drop-down
Select and click the destination tenant to switch. That will now be the active tenant.

Organizational resources drop-down

The organizational resources drop-down provides a summary of the resources for the selected active tenant (displayed immediately to the left). It can be viewed from any window in the platform. Hover over the organizational resources in the top menu bar to view the drop-down summary.

Figure 2. Organizational resources drop-down summary for the default tenant

Tenant management using the GUI

An organization administrator (OrgAdmin) can click Tenant management from the left menu. The Tenant management window displays resource and allocation information available to an organization administrator (OrgAdmin).

Figure 3. Tenant management window

Organizational resources

The Organizational resources section displays platform specific information.

Total RDUs displays the total number of RDUs configured for the SambaStudio platform.
Busy RDUs displays the number of RDUs that are currently busy performing tasks.
Available RDUs displays the number of RDUs that are available to perform new tasks.

Figure 4. Organizational resources

Current allocations

The Current allocations section displays the current tenant configurations of the platform in a table and allows organization administrators (OrgAdmin) to manage tenant resources.

Click Create tenant to create a tenant using the GUI.

Click Update allocations to update the allocated RDUs for a tenant using the GUI.

The Tenant name column displays the tenant name of each tenant.
The Allocated RDUs column displays the number of RDUs allocated to each tenant.
The Busy RDUs column displays the number of RDUs that are currently busy performing tasks of each tenant.
The Available RDUs column displays the number of RDUs of each tenant that are available to perform new tasks.
The Status column displays the current status of each tenant.
- Creating displays when a new tenant is being created.
- Updating displays when a tenant allocation is being updated.
- Ready displays when a tenant has been setup, but has no RDUs allocated to it.
- Available displays when a tenant has been setup and has at least one RDU allocated to it.
- Failed displays when creating, deleting, or updating a tenant fails.
The three dots open a drop-down menu that allows you to Update allocations of the tenant in that row.

Figure 5. Current allocations

Tenant management using the CLI

Run snapi tenant --help in the snapi command line to display the options and commands available for tenants.

Example snapi tenant help

$ snapi tenant --help
Usage: snapi tenant [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  create  Create a new tenant
  info    Gets the tenant info
  list    Lists the tenants in the user's directory

Tenant information using the CLI

You can use the snapi command line to display tenant information by running the following command.

snapi tenant info --tenant <tenant name or ID>

The command below displays information for the tenant named default.

Example snapi tenant info

$ snapi tenant info --tenant default

         Tenant Info
         ============
ID                      : 39bcd490-575d-44bd-9f77-08bdd2ac3164
Name                    : default
Display Name            : default
Allocated RDUs          : 16
Busy RDUs               : 0
Available RDUs          : 16
Created at              : 05/09/2023 10:38:13 CDT
Last Updated            : 05/09/2023 10:38:15 CDT
Status                  : Available

Run snapi tenant info --help for command options information.

Create a tenant using the GUI

Organization administrators (OrgAdmin) can create a new tenant using the GUI by following the steps below.

Once a tenant has been created it cannot be deleted.

Click the Create tenant button. The Create new tenant box will open.
Enter a name for the tenant in the Add tenant name field. Note that spaces are not accepted in this field.
Click Create to complete the process. Click Cancel to stop the process and return to the Tenant management window.

Figure 6. Create new tenant

Create a tenant using the CLI

The example below demonstrates how to create a tenant using the snapi command line. The command specifies test01 as the tenant name.

Example snapi tenant create

$ snapi tenant create \
	--name test01

Run snapi tenant create --help for command options information.

Update tenant RDUs using the GUI

Organization administrators (OrgAdmin) can change the number of RDUs assigned to a tenant using the GUI by following the steps below.

Resource allocations cannot be changed for a Default tenant.

Click the Update allocations button. The Update resource allocation box will open.
Select the tenant you wish to manage from the Select a tenant drop-down.
Change the number of RDUs assigned to the tenant by clicking - or +.
Click Update to complete the process. Click Cancel to stop the process and return to the Tenant management window.

Figure 7. Update resource allocation

Update tenant RDUs using the CLI

The example commands below demonstrate how organization administrators (OrgAdmin) can update the existing tenant RDU allocation using the snapi command line. The command specifies the following:

test01 is the tenant that will be updated.
8 as the new number of RDUs assigned to the tenant.

Example snapi tenant update

$ snapi tenant update \
	--tenant test01 \
	--rdus 8

Run snapi tenant update --help for command options information.