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 :
   

   The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
   This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.
   

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:
   
   
   
   

   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.

   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