Setting up virtual tenants to enable content sharing among tenants

When you set up virtual tenants, objects in the content store can be accessed by users who belong to different tenants.

Virtual tenants include real tenants that are already configured in Cognos® Analytics.

Before you begin

Multitenancy is enabled for IBM® Cognos Analytics and the tenants are created in Manage > Multitenancy. For more information, see Creating tenants.

About this task

When viewed on the Multitenancy tab, the entries for virtual tenants and real tenants look identical. To make it easier to identify virtual tenants, use meaningful names when creating them and specify descriptions.

For example, you want to configure content sharing for tenants named North America, Central America, and South America. You create a virtual tenant named Americas and add the three tenants to this tenant. Users who belong to any of the three tenants can access content of their own tenant, content of the other two tenants, and public content.

If you delete a virtual tenant, all content that is associated with that tenant is also deleted.

For more information, see Advanced multitenancy features (www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_cra.doc/c_config_mt_advanced.html).

Procedure

Perform the following steps to create a virtual tenant and a folder for the virtual tenant content.

  1. Log on to IBM Cognos Analytics as a member of the System Administrators role.
  2. In Manage, select the Multitenancy tab.
  3. Select the Add New tenant icon icon.
  4. Specify the Name and Tenant ID parameters.

    The virtual tenant ID does not need to be preconfigured. It can be any value.

    For a description, type a string, such as Virtual tenant, that will help you to identify the tenant among other tenants in Cognos Analytics.

  5. Select Add.
    The virtual tenant name is displayed in the list of tenants, and the tenant is disabled by default. You can enable the tenant after you finish configuring it.
  6. For the virtual tenant that you created, from its context menu Context menu icon, select View members.
  7. On the Members tab, select the Add icon Add object icon.
  8. Select the tenants that you want to add to the virtual tenant, and click Add.
    Tip: You can add disabled tenants. However, users cannot access content of the disabled tenants until the tenants are enabled.
  9. Create a new folder. The folder name should be similar to the virtual tenant name for easier identification.
  10. In the folder properties page, on the General tab, Advanced section, change the Tenant ID value to the tenant ID of the virtual tenant by selecting the ID from the list of available IDs. For example, if your virtual tenant ID is Americas, select this ID from the list and assign it to the folder.