Multitenancy management tool is built to use a single instance of BI 4.x runs on a server, serving multiple client organizations (tenants). BI 4.x can be designed to virtually partition its data and configuration and each client can have access to their own data only.
The SAP BusinessObjects Business Intelligence platform Multitenancy Management Tool is a Java-based program that SAP OEM partners can use to standardize and automate the creation of objects and settings for new customers in a multitenant BI platform deployment.
The traditional way of configuring a multitenant environment is to create separate user groups, folders for each tenant and apply security manually, but the multitenancy management tool automates these steps and makes it easier to create new tenants.
Let’s begin to configure a simple multitenant environment:
Step – 1: Create Tenant Template:
- Create a user group name “$TemplateToken$”.
- Create a public folder named $TemplateToken$ atthe root level.
- Assign required rights to “$TemplateToken$” user group on $TemplateToken$ folder.
Step – 2: Create Tenant Configuration file:
The tenant_template_def.properties file is located in the multitenancyManager folder at:
Windows: <InstallDir>\SAP BusinessObjects EnterpriseXI4.x\java\apps\multitenancyManager\jars\
- Take a backup of the properties file and open the original one in a text editor.
- Under (Mandatory) Name of the tenant being added, change the value for the tenant Name option to the name of the new tenant you are defining.
- Under (Mandatory) Template token identifier used for tenant name replacing, change the value for the templateToken option to thestring used to identify your template folders and user group. Use the string “$TemplateToken$,” as we did in step – 1.
- Under (Mandatory) Logon information provide CMS Server name, Authentication type, User name (an admin user who has permissions to perform the task), its password.
- Under (Optional) Document folder template, change the value for the templateContentFolder option to specify the top-level template folder paths. Separate multiple values with a semicolon, and include the full path of the public root folder.
- Save and close the tenant_template_def.properties file.
Step – 3: Run the Multitenancy Management Tool:
- Open Command prompt and navigate to the location, <InstallDir>\SAP BusinessObjects Enterprise XI 4.0\java\apps\
- Type following command.
java -jar multitenancymanager.jar -configFile tenant_template_def.properties
- Likewise you can simple change the value “Name of the tenant being added” as we did in Step – 2.2, save the file and run the tool.
- After the tool successfully finish creating the tenant logon to CMC, go to Multitenancy and you should see the tenant name populated here.
- Right click on the tenant name and go to properties. From here you can manage the number of concurrent logon sessions.
- You can also manage concurrent user sessions from tenant_template_def.properties
- You can add groups to tenant.
- You can delete a tenant and all its associate infoobjects with the option to exclude certain infoobjects.
- You can track system usage by tenant using auditing by enabling and configuring audit events as per the requirements.
- To determine which auditing event is generated by which tenant use 2 new lookup tables in the auditing database: ADS_TENANT and ADS_USER.
For detailed overview please visit following blog: