Creating subtenants from a record instance

As an administrator, you configure multitenancy to restrict end user access to a specific company. Multitenancy also provides the ability to restrict the configuration data to a specific company.

Customers who are subscribed to BMC Helix Digital Workplace create subtenants from the BMC Helix Innovation Studio UI.

Required license

AR Fixed license

How multitenancy works in BMC Helix Digital Workplace

The following table describes how the default subtenant and subtenants work:

Tenancy	Description
Default subtenant	The first tenant that you create is the default subtenant. The default subtenant is associated with a company in BMC Helix ITSM. Administrators who are members of the default subtenant company can set and modify provider settings from the BMC Helix Digital Workplace Admin console.
Subtenant	After you create the default subtenant, all the subsequent tenants are subtenants. If you want to create multiple subtenants, you create a record instance each time you want to create a subtenant. A subtenant is also associated with a company in BMC Helix ITSM. Subtenants use the provider settings from the default subtenant.

Before you begin

Make sure you complete the following tasks before creating subtenants:

Area or Product	Description
Action Request System	Make sure that you have the following permissions: AR System administrator (to create a record definition instance) MyIT Admin (to verify tenant creation) MyIT Super Admin (to verify tenant creation) For more information, see User goals and features and Creating and modifying users. Create companies in BMC Helix ITSM by the same name that you want to create the default subtenant and subtenants in BMC Helix Digital Workplace. To learn more, see Creating companies.
BMC Helix ITSM	Configure multitenancy. For detailed instructions, see Setting up the Tenancy mode.

Area or Product

Description

Action Request System

Make sure that you have the following permissions:
- AR System administrator (to create a record definition instance)
- MyIT Admin (to verify tenant creation)
- MyIT Super Admin (to verify tenant creation)

For more information, see User goals and features and Creating and modifying users.

Create companies in BMC Helix ITSM by the same name that you want to create the default subtenant and subtenants in BMC Helix Digital Workplace. To learn more, see Creating companies.

BMC Helix ITSM

Configure multitenancy. For detailed instructions, see Setting up the Tenancy mode.

To create subtenants

As an AR System administrator, log in to BMC Helix Innovation Studio.
From the Workspace tab, click Digital Workplace.
On the Record Definitions tab, select the check box for SubtenantCreate and click Edit data, as shown in the following image:
In the New Record panel, in the Name Field, type the name of the subtenant that you want to create.
Make sure that the name is the same as the one you created in Action Request System earlier. The other fields are populated automatically.

The following image shows an example of creating the Apex Service subtenant:
Click Save.

To verify tenant creation

As a MyIT super administrator, log in to BMC Helix Digital Workplace Administration console.
Select user icon > Company access.
In the Company picker, verify that the tenant is created, as shown in the following image:

To verify tenant creation from the BMC Helix Innovation Studio UI

As an AR System administrator, log in to BMC Helix Innovation Studio.
On the Workspace tab, click Digital Workplace.
On the Record Definitions tab, select the check box for Subtenant and click Edit data.
Verify that a record definition instance is created as shown in the following image: