Configure tenants and tenant users

In BMC Cloud Lifecycle Management, a tenant is a group of users who need access to the BMC Cloud Lifecycle Management – My Cloud Services Console to request services from the cloud. A tenant can be any group of users that needs to isolate its data and services from other groups. The use of tenants in the cloud allows a company or service provider to segregate groups in the cloud and to control the visibility and permissions for offerings in the Service Catalog that are available to tenant users.

Earlier, you could only create tenants in the Application Administration Console. In this release, you can now create tenant companies from the BMC Cloud Lifecycle Management – Administration Console.

This topic contains the following sections:

To create tenants

The use of tenants in the cloud allows a company or service provider to both segregate groups in the cloud and to control the visibility and permissions for offerings in the Service Catalog that are available to tenant users. Tenants have two types of users:

• Cloud end users can use the BMC Cloud Lifecycle Management My Cloud Services Console to request services hosted in the portion of the cloud assigned to the tenant company. Cloud end users can see only their own services in the BMC My Cloud Services Console.
• Cloud organization administrators can use the BMC Cloud Lifecycle Management My Cloud Services Console to see and manipulate any and all services created by cloud end users of their own company.

To create tenants: 

1. From the Administration Console, click the vertical Workspaces menu and select Tenants.
2. In the Tenant Management pane, click Create or import tenant . 
3. In the Add Tenant dialog box, enter the requested information.
   Fields marked with an asterisk (*) are mandatory. 
   
   1. Select the Create new tenant button.
   2. In the Company Name text box, enter a unique name for the tenant.

   3. In the Location tex box, enter a location for the tenant. 
      or
      Click to select an existing location.

      Note

      The locations displayed in the list are the locations created for other tenants in BMC Remedy IT Service Management Foundation. When you enter a new location in BMC Cloud Lifecycle Management while adding a tenant, the new location is added to the Location list.  

       

      You can add the rest of the details as required.

      Note

      By default, the contract start date is the current date. You can specify the contract end date, if required.

   4. From the list of Available Entitlement Packages, select the packages you want to apply to this tenant.
   5. Click Add > to move them to the Selected Entitlement Packages area. 
      You can use the Search field to search for the preferred entitlement package. For details about the entitlement packages, see Creating entitlement packages.
   6. Click the Quotas tab to define the quota for the tenant. 
      By default, the Unlimited check box is selected for a tenant. For more information about managing quota, see Setting and managing quota. 

   7. Click the ITSM Mapping tab to display change template mappings and override the mappings as needed.
      For more information, see Managing change policy mappings for particular tenants.

   8. If you want to specify limited quota for the tenant, perform the following steps in the Allocation area:
      1. Clear the Unlimited check box for the Server, CPU Count, Memory (GB), and the Local Storage (GB) fields.
      2. In the Tenant Quota text box for the Server field, enter the number of servers that you want to assign to the tenant. 
      3. In the Tenant Quota text box for the CPU Count field, enter the number of CPUs that you want to assign to the tenant.
      4. In the Tenant Quota text box for the Memory (GB) field, enter the memory in GB that you want to assign to the tenant.
      5. In the Tenant Quota text box for the Local Storage (GB) field, enter the local hard disk in GB that you want to assign to the tenant. 
4. Click Add.

To verify whether the tenant is created successfully, click the Activities tab. The Update Tenant Quota activity along with its status is displayed. 

If the tenant is created but the quota details are not updated, the activity fails. When the activity fails, you can edit the tenant and update the tenant quota manually again.  

_{Back to top}

To import existing tenants

If you create a tenant by using BMC Remedy ITSM Foundation, you must import the tenant in BMC Cloud Lifecycle Management before its users can access the BMC Cloud Lifecycle Management – My Cloud Services Console.

Before you begin, consider the following:

• The tenant companies that you want to import must be configured in the Application Administration Console, as described in Creating tenant companies and users by using BMC Remedy ITSM.
• You can only import companies whose type is specified as Operating Company or Customer in the Application Administration Console.

1. From the Administration Console, click the vertical Workspaces menu and select Tenants.
2. In the Tenant Management pane, click Create or import tenant .
3. In the Add Tenant dialog box, enter the required details.
   Fields marked with an asterisk (*) are mandatory. 
   1. Select the Import Existing Tenant button.

   2. From the Company Name list, select the tenant that you want to import.
      The Company Name list comprises the tenants created in BMC Remedy IT Service Management Foundation, which are not yet imported. After you select the tenant, the details are displayed. You cannot edit the tenant details from BMC Cloud Lifecycle Management.

      Note

      You cannot import a tenant if the location for the tenant is not specified in BMC Remedy ITSM Foundation.

   3. Click the Contract End Date calendar icon and select the date when the tenant's users will no longer to be able to request cloud services in the BMC My Cloud Services Console.
      

      Note

      The Contract Start Date is set to the date that you onboard the tenant and you cannot change it. The Contract Start Date defaults to the start of the day, at 12:00 A.M. To increase the the length of the contract to the end of the day, add an additional day. 

       

   4. From the list of Available Entitlement Packages, select the packages you want to apply to this tenant.
   5. Click Add > to move them to the Selected Entitlement Packages area. 
      You can use the search field to search for the preferred entitlement package. For details about the entitlement packages, see Creating entitlement packages.
   6. Click the Quotas tab to define the quota for the tenant. 
      By default, the Unlimited check box is selected for a tenant. For details about quota, see Setting and managing quota. 

   7. Click the ITSM Mapping tab to display change template mappings and override the mappings as needed.
      For more information, see Managing change policy mappings for particular tenants.

   8. If you want to specify a limited quota for the tenant, perform the following steps in the Allocation area:
      1. Clear the Unlimited check box for the Server, CPU Count, Memory (GB), and the Local Storage (GB) fields.
      2. In the Tenant Quota text box for the Server field, enter the number of servers that you want to assign to the tenant. 
      3. In the Tenant Quota text box for the CPU Count field, enter the number of CPUs that you want to assign to the tenant.
      4. In the Tenant Quota text box for the Memory (GB) field, enter the memory in GB that you want to assign to the tenant.
      5. In the Tenant Quota text box for the Local Storage (GB) field, enter the local hard disk in GB that you want to assign to the tenant.  
4. Click Add.
   The tenant is imported successfully.

To verify whether the tenant is onboarded successfully, click the Activities tab. The Update Tenant Quota activity and its status are displayed. 

_{Back to top}

To create entitlement packages

Entitlement packages are groups of requestable offerings that you want to make available to one or more tenant companies.

1. From the BMC Cloud Lifecycle Management Administration Console, click the vertical Workspaces menu on the left side of the window and select Service Catalog.
2. Click the Entitlement Packages tab.
   The Packages workarea is displayed.
3. Click the Create Entitlement Package icon .
   The Package Details dialog box is displayed.
   
4. Enter a name for the package.
5. Enter a description.
6. In Company, select the tenant company for the package or select Global to make the package available to all companies.
7. You can enter or select a package group.
   Package Group marks a package as being part of a group. The Package Group value is not used anywhere else.
8. In the Available Requestable Offerings (SRDs) table, select the offerings that you want to make available to the selected company.
9. Click Add to move the offering to the Selected Requestable Offerings (SRDs) table.
   You can also drag and drop entitlement packages from one table to the other.
10. Click Save.
11. Click Close.

You can now associate the new entitlement package with a particular tenant company, as described in Managing entitlement packages.

_{Back to top}

To map tenants to network containers

Before tenant users can request services, you must associate each tenant with a network container. To create a network container, see Creating network containers.

1. From the BMC Cloud Lifecycle Management – Administration Console, click the vertical Workspaces menu and select Resources.
2. Under the Quick Links > Network section, click Network Containers.
3. Select the network container to which you want to map one or more tenants.
4. Click Manage Tenant Mappings .
   The Map Tenants dialog box is displayed for the selected network container. In the Name field, the name of the network container is displayed. In the Available Tenants table, the list of onboarded tenants is displayed.
   

5. Select one or more tenants from the tenants table and click Add >.
   The selected tenant or tenants are moved to the Mapped Tenants table. You can search for a tenant by using the Search field.

   Note

   The Search field is case-sensitive.

6. Click Save. 
   The selected tenant or tenants are mapped to the network container.  

   Note

   After you map a tenant to a network container, refresh the page. Sometimes, when you modify the container later, the tenant is not saved against the network container.

_{Back to top}

To select tenant entitlement packages

An entitlement package is created from the Entitlement Packages tab in the Service Catalog workspace, as described in Creating entitlement packages. You can select which entitlement packages are made available to a tenant's users and set the tenant's contract end date. You select the entitlement packages while creating or importing the tenant. To edit the selected entitlement packages, see To create a tenant.

_{Back to top}

Where to go next

If you plan additional product integrations with BMC Cloud Lifecycle Management, go to Integrating.

You can also configure additional third-party providers. 

Otherwise, proceed to Verify the configuration.