Adding tenants and setting the AR System server for authentication

To configure the Mid Tier for multitenancy, first add tenants to the Mid Tier and then configure the tenant-specific properties. 

To add a tenant

1. In a browser, open the Mid Tier Configuration Tool at http://hostname:portnumber/arsys/shared/config/config.jsp.
2. Click the Tenant Settings link.
3. On the Tenant Settings page, click Add Tenant.
   
4. On the Add New Tenant page, enter the following information.
   1. In the Tenant Name field, enter the name of the tenant (for example, Tenant1).

   2. 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-load-balancer-sample-configuration-in-AR-System.

   3. In the Web Reports Base URL field, enter the base URL (for example, https://Tenant1.onbmc.com:8080/).
   4. (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 server that are added to the Mid Tier. For more information, see Configuring-AR-System-servers-that-the-Mid-Tier-uses.
   5. (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.
   6. (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.
5. 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, the config.Tenant1.properties file is added to the midTierInstallationDirectory\WEB-INF\classes\tenants\ folder.

If you add a tenant with the name of a tenant that was previously deleted or offboarded from any Mid Tier, 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 Configuring-the-AR-System-server-as-a-Centralized-Configuration-server.

To edit tenant-specific properties

1. On the Tenant Settings page, select a tenant that you want to edit, and click Edit.

   

2. On the Edit Tenant page, edit the tenant-specific properties that you want to change for this tenant.
3. Click Save Tenant.

To delete a tenant

1. In a browser, open the Mid Tier Configuration Tool at http://hostname:portnumber/arsys/shared/config/config.jsp.
2. Click the Tenant Settings link.
3. From the Tenant Settings page, select the check boxes in the Delete/Edit column for one or more tenants.
4. Click Delete.
   Use caution when deleting a tenant. Ensure that the users who are logged through the tenant's virtual URL stop accessing the Mid Tier. Otherwise, the users 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 Configuring-AR-System-servers-that-the-Mid-Tier-uses. 

You cannot map a single AR System server 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 the Mid Tier using the virtual host name, the Mid Tier is in 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 AR System administrator can access the Mid Tier Configuration Tool only by using the actual Mid Tier host name, not the virtual host name.