Deploying BMC Helix IT Operations Management in a multitenant environment

Perform the following steps to deploy BMC Helix IT Operations Management in a multitenant environment.

To deploy the BMC Discovery appliance

1. Configure the following settings for each BMC Discovery appliance:
   

2. In the deployment namespace, open the smart-graph-tenant-config configmap for editing by running the following command:

   kubectl -n <namespace> edit cm smart-graph-tenant-config

3. In the data section, add the new BMC Discovery appliance address.
   
   
   
   

4. (Optional) Add additional tenants to the configmap as follows:
   
   
   
   
   

   Important

   While adding additional tenants to the configmap make sure that each tenant name is distinct.

To deploy BMC Helix IT Operations Management in a multitenant environment

1. Log in to tctl.
   For more information, see Onboarding and managing tenants and services.

2. Create the tenant.json file by using the following details as an example. This file is used to create the tenant. 

   {
   "name": "york",
   "email": "jsmith@bmc.com",
   "first_name": "John",
   "last_name": "Smith",
   "phone": "1234678",
   "environment": "small",
   "domain": "york-private-small.bmc.com",
   "description": "York",
   "country": "United Kingdom",
   "login_id": "hannah_admin",
   "type": "LICENSE"
   }
   

   For information about the parameters in this file, see Configuration file settings.

   Important

   In this file, the property "name" refers to the "COMPANY_NAME".

3. Run the following command to create a new tenant:

   tctl create tenant -f tenant.json

   The email address specified in the JSON file receives the following emails:

   • An email for license activation
   • An email for setting the password for the initial user
4. Activate the tenant by using link in the email that was just received.
5. Verify the active services.
   

   1. To see the list of services that are activated on the new tenant, run the following command:

      tctl get tenant-service <tenant_id>    

      Expected output:
      
      

   2. To activate a service on the new tenant, run the following command:

      tctl activate service <tenant_id> -i <service-id>

      For example, the following image shows the Discovery service activated for the new tenant:
      
      
      
      

      Important

      While registering a multi-tenant:

      • The value of Tenant type and Domain name cannot be changed. These values are assigned when the URL is created. If the user wants to assign a new value for Tenant type and Domain name, a new URL must be created.
      • The user can change the values of Company name and Environment.

Where to go from here

See the BMC Helix Operations Management documentation to know more about the product.