Configuring the mid tier for multitenancy
To configure the mid tier for multitenancy, first add tenants to the mid tier and then configure the tenant-specific properties. The following topics are provided:
To add a tenant
Open the BMC Remedy Mid Tier Configuration Tool from the URL http://hostname:portnumber/arsys/shared/config/config.jsp
- Click the Tenant Settings link.
- On the Tenant Settings page, click Add Tenant.
- In the Add New Tenant page, enter the following information.
- In the Tenant Name field, enter the name of the tenant (for example, Tenant1).
In the Virtual Host Name field, enter the virtual name of the host (for example, Tenant1.bmc.com).
You must map this virtual host name with the pool name in the f5 load balancer. For more information, see f5 rules.
- In the Web Reports Base URL field, enter the base URL (for example, https://Tenant1.onbmc.com:8080/).
- (Optional) From the Tenant Configuration Server list, select an AR System server as your configuration server.
This list is populated based on the AR System servers that are added to the mid tier. For more information, see Adding or deleting a server.
- (Optional) Click Browse to specify the location of the config.properties file.
By default, the existing config.properties file is located in the midTierInstallationDirectory\WEB-INF\classes folder.
- (Optional) Clear the Also add to tenant's server list check box.
The configuration server is not added as a server to the tenant. By default, this check box is selected.
- Click Save.
Ensure that the virtual host is accessible to the users by making appropriate changes in DNS or load balancer settings.
The tenant is added to the mid tier. Each tenant that is added to the mid tier has a corresponding tenant-specific property file. For example, if you add a tenant named Tenant1, a properties file called config.Tenant1.properties is added to the midTierInstallationDirectory\WEB-INF\classes\tenants\ folder.
If you add a tenant with the name of a tenant that was deleted or offboarded from any mid tier previously, a warning message is displayed. When you delete a tenant, the tenant is deleted but the tenant configuration is not deleted from the Centralized Configuration forms. For more information, see Centralized configuration for the mid tier.
To edit tenant-specific properties
On the Tenant Settings page, select a tenant that you want to edit and click Edit.
- On the Edit Tenant page, edit the tenant-specific properties that you want to change for this tenant.
- Click Save Tenant.
To delete a tenant
Open the BMC Remedy Mid Tier Configuration Tool from theURL.
- Click the Tenant Settings link.
- From the Tenant Settings page, select the check boxes in the Delete/Edit column for one or more tenants.
- Click Delete.
Use caution when deleting a tenant. Ensure that the users who are logged on using the tenant's virtual URL stop accessing the mid tier; otherwise they might see unexpected behavior.
Mapping a tenant to multiple AR System servers
You can add multiple AR System servers to a tenant; however, only one AR System server will be the primary server used for authenticating, setting preferences, the home page, and the data visualization module. For more information, see Adding or deleting a server.
A single AR System server cannot be mapped to more than one tenant.
Configuring global settings for all tenants
You can configure global configuration settings for tenants such as the cache settings, report settings, and log settings. For more information, see Configuring Mid Tier.
Identifying whether the mid tier is in multitenant mode
When you access mid tier using the virtual host name, the mid tier is in the multitenant mode. For example, if your URL starts with http://Tenant1.onbmc.com/arsys/forms/, you are using a mid tier that is in multitenant mode. If your URL starts with http://hostName/arsys/forms/, you are accessing a mid tier that is not in the multitenant mode.
For a mid tier to be accessed in multitenant mode, ensure that at least one tenant with a virtual host name is added to the mid tier.
The Mid Tier Configuration Tool is accessed only by the BMC Remedy AR System administrator using the actual mid tier host name rather than the virtual host name.