Space banner


This documentation supports the 20.02 version of BMC Digital Workplace Advanced.

To view the latest version, select the version from the Product Version menu.

Configuring multitenancy

To restrict access for BMC Digital Workplace users to the configuration of a specific company in Remedy ITSM, you can configure multitenancy in BMC Digital Workplace. As a system administrator, you prepare the tenant configuration utility, activate the master tenant, and then activate subtenants as needed. 

The master tenant should be associated with a company in Remedy IT Service Management (BMC Remedy ITSM). Administrators who are members of the master tenant company can set and modify provider settings from the BMC Digital Workplace Admin console. Each subtenant is associated with a company in BMC Remedy ITSM. Subtenants use the provider settings from the master tenant. 


You cannot use the multitenancy feature and the External Users feature at the same time. If you configure multitenancy, the External Users menu is not available in the Admin console. If you have already configured an external company, you cannot use multitenancy as a managed service provider (MSP).

For more information about MSP, see Managing customers.

For more information about the External Users feature, see Portal for external users and Administering an external BMC Digital Workplace portal.

Before you begin

  • Configure multitenancy in BMC Remedy ITSM. 
    For information about multitenancy, see Multi-tenancy Open link  in the BMC Remedy ITSM documentation.
  • Locate the tenant configuration utility in DWP_HOME\DWP\tenant-config\scripts.

To prepare the tenant configuration utility

  1. On the BMC Digital Workplace server, move the tenant-config.jar from DWP_HOME/tenant-config to a folder with scripts:
    • (LinuxDWP_HOME/tenant-config/scripts/linux
    • (WindowsDWP_HOME\tenant-config\scripts\win
  2. (Optional) To run the tenant configuration utility on a server other than the BMC Digital Workplace server, copy the scripts/linux or scripts/win folders from the BMC Digital Workplace server to the server that will run the utility.
  3. In a text editor, edit the set_env.bat (Windows) or (Linux) to set the following parameters:

    ParameterValueAdditional information
    java_homePath to your Java directoryDo not include the bin directory at the end of the path. Enclose the path in double quotes, as in the example provided in the file.
    myit_server_urlA URL that has the following format: http://DigitalWorkplaceServer/dwp

    DigitalWorkplaceServer must be the host name of the BMC Digital Workplace server. If you want to run the tenant configuration utility from the BMC Digital Workplace server, you can enter localhost, as in http://localhost:port/dwp, where port is the BMC Digital Workplace server Tomcat port.

    API_TOKENAPI token value

    Copy the API_token value from the file in the TomcatHome/external_conf directory.

    Note: On fresh installation or upgrade, this value is automatically generated and populated in the file.

    API_SECRETAPI secret value

    Copy the API_secret from the file in the TomcatHome/external_conf directory.

    Note: This value is automatically generated and populated in the file after a fresh installation or upgrade.

    tenant_nameTenant identifier required for tenant operationsDefault value: 000000000000001
    master_tenant_nameMaster tenant configuration details are copied during creation of a subtenantDefault value: 000000000000001
    companyCompany identifier of a subtenantNot applicable
    SAML_authenticationTrue or FalseMust be set (to True or False) before a tenant or subtenant is added.
  4. To test the utility, run the following command:

    (Windows) list_tenants.bat

    You should see a default tenant with the name 000000000000001.

To activate the master tenant

  1. As a database administrator, run the following SQL statement:

    UPDATE DWP_SYSTEM.Tenant SET HOSTNAME = 'localhost;@Company:<Master Tenant Company>' WHERE HOSTNAME='localhost';

    Replace <Master Tenant Company> with the company name for the master tenant company, such as Calbro Services, for example:

    UPDATE DWP_SYSTEM.Tenant SET HOSTNAME = 'localhost;@Company:Calbro Services' WHERE HOSTNAME='localhost';


Do not activate the master tenant company as a subtenant.

To activate subtenants

  1. In the tenant configuration utility directory, edit (Linux) or set_env.bat (Windows) with a text editor, and set the company to the name of the BMC Remedy ITSM operating or customer company that you are activating.

    • (Linux) Find the line that says  COMPANY="" and put the company name inside the quotes, for example, COMPANY="Acme".

    • (Windows) Find the line set company= and add the company name to the end after the equals sign (=), for example, set company=Acme.

  2. Run (Linux) or add_subtenant.bat (Windows).

  3. Repeat step 1 and 2 for each company you want to activate.


    Ensure that you activate subtenants for all required companies. Users from companies for which subtenants are not activated, will not be able to log in to BMC Digital Workplace.

Where to go from here

If you are rebranding BMC Digital Workplace, you must rebrand it for each subtenant, as described in Rebranding BMC Digital Workplace.

Was this page helpful? Yes No Submitting... Thank you