The multitenancy feature provides the ability to segregate all data by operating company and customer company. In BMC Remedy IT Service Management (BMC Remedy ITSM), configure multi-tenancy for data that comes from BMC Remedy ITSM, such as users and service request definitions (SRDs). When users are set up, they are granted access to data for one or more companies. For data that is maintained in BMC Remedy ITSM, such as SRDs, this same access is provided in BMC MyIT without any additional configuration. For example, if you create separate SRDs for the Calbro and Acme companies, and grant Bob Unser access only to the Calbro company, he can see and request only SRDs from the Calbro company.
However, BMC MyIT also provides configuration data that is not available in BMC Remedy ITSM, such as:
- Quick-pick lists of SRD catalog items showing up on the Support tab
- Catalog configuration
- How-to links
- Location features (floor maps, points of interest)
- Service health
- Appointment and reservation features
- Social posts not tied to any BMC Remedy ITSM tickets or BMC Service Request Management service requests
This topic describes how to configure BMC MyIT so that configuration data provided by BMC MyIT is restricted to a specific tenant company. A system administrator first prepares the tenant configuration utility, and then activates tenants as needed. Subtenants use the provider settings from the master tenant. This means that only an administrator for the master tenant can modify the provider settings.
Users get access only to the BMC MyIT configuration data for the company to which they are assigned on the People form in the Company field in the General tab, even if they have access to multiple companies through the access restrictions. For example, if Joe Unser, a self-service user, is assigned Calbro company in the Company field of the People form, he has access to how-to links and locations that are configured for Calbro, but not the how-to links and locations that are configured for Acme. This also applies to the MyIT Admin Console: if Allen Allbrook, a BMC MyIT administrator, is a member of the Calbro company, he can configure how-to links and locations for Calbro only. If Allen Allbrook also needs to configure how-to links and locations for Acme, he requires a second user ID that is a member of the Acme company.
For the Admin Console, an exception to the per-company configuration is the Providers Settings area of Configuration. The Provider Settings are shared for all companies (tenants). After you activate multitenancy, the providers settings are no longer available from the BMC MyIT Administration console. Instead, you must use the tenant admin utility to configure the provider settings.
Before you begin
Configure multitenancy in BMC Remedy ITSM, as described in Multi-tenancy in the BMC Remedy ITSM documentation.
To prepare the tenant configuration utility
- Create a MyIT Super Admin group:
- On the BMC Remedy ITSM server, open the Group form.
- Create a group named MyIT Super Admin and give it a Group ID of 45002.
- 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).
- Note the company assigned to this user. You must activate that company in .
- In the User form, add the MyIT Super Admin group to this user.
- On the BMC MyIT server, set up the tenant configuration utility:
- 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.
Edit set_env.bat (Windows) or set_env.sh (Linux) with a text editor and set the following parameters:
Parameter Value Additional information java_home Path to your java directory Do 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_url http://myitServer/ux myitServer 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 . user_name User name of the user that you set up in step 2. None password Password of the user that you set up in step 2. None
- Test the utility by running the following command:
You should see a default tenant with the name
To activate tenants
In the tenant configuration utility directory, edit set_env.bat (Windows) or set_env.sh (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.
The very first tenant you activate must be the company assigned to the user configured in step 2 of To prepare the tenant configuration utility.
In Linux, the find the line that says
COMPANY=""and put the company name inside the quotes. For Windows, find the line
set company=and add the company name to the end after the =.
- Edit add_subtenant.bat (Windows) or add_subtenant.bat (Linux) in a text editor, and change
Run add_subtenant.bat (Windows) or add_subtenant.sh (Linux).
- Repeat steps 1 through 3 for each company that you are activating.
Where to go from here
If you are rebranding the universal client, you must rebrand it for each tenant, as described in Rebranding the BMC MyIT Universal Client.