MyIT Tenant Configuration.

Version 2
    Share This:

    This document contains official content from the BMC Software Knowledge Base. It is automatically updated when the knowledge article is modified.


    MyIT Digital Workplace






    Customer wanted to configure Multi-Tenancy on their environment but after running the steps given in the below document, customer was not able to configure it correctly.

    Configuring multitenancy

    Problem : it was not setting the Master Company as given by customer instead it was setting localhost as Master and all other companies as Sub tenant.

    This is identified as Defect and raised with R&D team.

    Defect Details :


    To prepare the tenant configuration utility

    1. Create a MyIT Super Admin group:
    1. On the BMC Remedy ITSM server, open the Group form.
    3. Create a group named MyIT Super Admin and give it a Group ID of 45002.
    1. Choose or create a user in Remedy that will have a user name and password entered in the configuration file that the command-line tool will use to access BMC MyIT. This user must also be in the People form and have a company assigned in that form in the Company+ field (in the General tab).
    1. Note the company assigned to this user.  You must activate that company in To activate tenants.
    3. In the User form, add the MyIT Super Admin group to this user.
    1. On the BMC MyIT server, set up the tenant configuration utility:
    1. Under Smart_IT_MyIT/Smart_IT_MyIT, find the .jar file in the tenant-config directory.
    3. Copy the .jar file and rename the copy to have a .zip extension.
    5. Unzip the .zip file.
    7. Copy the original .jar file to the applicable scripts location:
      Windows: scripts/win
      Linux: scripts/linux
    9. If you plan to run the tenant configuration utility from a machine other than the BMC MyIT server, copy either the scripts/win folder or the scripts/linux folder to the machine that will run the utility.
    11. Edit set_env.bat (Windows) or (Linux) with a text editor and set the following parameters:
    ParameterValueAdditional information
    java7_homePath to your java directoryDo not  include the “bin” directory at the end of the path. Surround the path with double quotes, as in the example provided in the file.
    The parameter indicates java7, but the value must be a java 8 installation. Do not change the name of the “set” variable because this variable is used in other places.
    myit_server_urlhttp://myitServer/uxmyitServer must be the host name of the BMC MyIT server. If you will run the tenant configuration utility from the BMC MyIT server, you can enter localhost, as in http://localhost/ux.
    user_nameUser name of the user that you set up in step 2.None
    passwordPassword of the user that you set up in step 2.None
    1. Test the utility by running the following command:
      Windows: list_tenants.bat

      You should see a default tenant with the name 000000000000001.
    1. Now run the update query to set the Master Company
                             UPDATE TENANT SET HOSTNAME = 'localhost @Company:<Master Tenant Company> where HOSTNAME='localhost'
    To activate tenants
    1. In the tenant configuration utility directory, edit set_env.bat (Windows) or (Linux) with a text editor, and set the company to the name of the BMC Remedy ITSM operating or customer company that you are activating.(Sub Tenants).
    3. Run add_subtenant.bat (Windows) or (Linux).
    5. Repeat steps 1 and 2 for each company that you are activating.


    Article Number:


    Article Type:

    Solutions to a Product Problem

      Looking for additional information?    Search BMC Support  or  Browse Knowledge Articles