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 BMC Discovery

1. Configure the following settings for each BMC Discovery :

   Setting	Description or reference
   Name resolution settings	For more information, see Configuring name resolution settings.
   Time synchronization	For more information, see Performing time synchronization.
   DNS alias of BMC Discovery	Format: <company>-disc-<type>-<environment>.<domain>
   DNS entries for the new tenant	Format: <company>-<type>-<environment>.<domain>
   Only for custom signed or self-signed certificates	Import the CA bundle into the single sign-on settings of the appliance. This action ensures that an error does not occur when the appliance makes the SSL connection to BMC Helix Single Sign-on.

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 address.
   
   
    

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

   Warning

   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 Downloading and configuring the tctl utility.

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.

   Warning

   Important

   In this file, the property "name" refers to the "TENANT_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:
      
      
       

Where to go from here

Performing the post deployment procedures