Managing tenants

A tenant is a unique and separate division or department within an organization. Each tenant has its own resources, separated from other tenants. In the standalone model, an organization is restricted to having a single tenant. As a result, a one-to-one relationship ensues between an organization and tenant.

Creating a Tenant

When creating a tenant, you also define the credentials for the administrator of the tenant.

1. Log in to the Orchestrator host portal as a system administrator.

   The Tenants page is displayed.

   
   

   

   
   
2. In the top right, click Add Tenant.

   The Provision Tenant dialog opens:

   
   

   

   
   
3. Fill in the required fields Tenant Name,Password, and Confirm Password.
   Note: The username (admin) for the tenant administrator cannot be changed.

   Important: If you recently changed the settings, the password you define here may not be validated against the new settings because it takes around one hour for the changes to apply.
4. (Optional) Fill in the First Name, Last Name, and Email Address fields.
5. Click Provision.

   The tenant and tenant admin are created and the new tenant is displayed on the Tenants page.

   Note: The tenant administrator is a local user called admin. It is automatically created with the Administrator role when you add a new tenant, with the password and email address you provided in the Provision Tenant dialog.

Renaming a Tenant

Important:

Impact of changing the tenant name

Changing the name of any of your tenants greatly impacts your previous configurations:

• Robots configured at the tenant level are disconnected. Users must reconnect their robots, entering the new URL.
• The tenant URL previously bookmarked doesn't work anymore. Send your users the new URL.
• Mobile Orchestrator users are disconnected. Send them the new tenant URL to connect again.

1. Log in to the Orchestrator host portal as a system administrator.

   The Tenants page is displayed.

2. Click More Actions at the right end of the row and select Rename tenant.

   The Edit Tenant dialog opens.

3. Edit the name in the Tenant Name field.
4. Click Update to apply the change.

   The tenant name is changed and the new name appears in the Tenants page.

Disabling or Enabling Tenants

Important: Remove licenses before disabling a tenant: If you intend to disable a tenant, remove the license allocation for the tenant prior to disabling it. Otherwise, the licenses are not returned to the license pool and you cannot use them for other tenants.

To disable or enable a tenant: In the Tenants page, click More Actions and select Disable or Enable:

To disable or enable multiple tenants: Select the checkboxes at the left of the tenants and then click Disable/Enable the selected tenants:

Enabling or Disabling Features

Until configured differently, all features are enabled by default for all tenants.

1. Log in to the Orchestrator host portal as a system administrator.

   The Tenants page is displayed.

2. Click More Actions at the right end of the row and select Enable/Disable features.

   The Feature Flags window is displayed.

3. Select the checkboxes for the features you want to enable on the tenant, or clear the ones you want to disable.
4. Click Proceed to apply your changes.

Alternatively, select multiple tenants and click the Enable/Disable Features for Selected Tenants button to change the enabled features for multiple tenants at once.