How to use Multi-Tenancy

The Wiki of Unify contains information on clients and devices, communications systems and unified communications. - Unify GmbH & Co. KG is a Trademark Licensee of Siemens AG.

Jump to: navigation, search

In the following, the administration of data from multiple clients (=tenants) with one single DLS installation is described.

This function is available only when DLS multi-tenancy has been installed. This will be asked by the installation assistant.

With multi-tenancy masks, the selection menu Tenants is available. Otherwise, it is greyed out.

When a a new object is created without selecting a tenant, an error message appears.

With multi-tenancy masks, it will make a difference whether the object is assigned to a tenant or not, that is, in the tool bar under Tenant, either the tenant’s name or <not assigned> will be displayed.

When objects are added which require a license, the tenant specific limits are checked. If a tenant is created or changed, the license dependent data are checked. The respective alarm thresholds are set tenant specific (see Section 6.3.1, "Tenants").

Basically, there is a difference between tenant dependent and tenant independent alarms.

The tenancy feature is stored in the database - but this feature is activated during setup and so it is system dependent and NOT database dependent.Hence it is possible to restore a DLS database that previously contained tenancy relations to a DLS installation where the tenancy feature is not installed.

In this rare scenario, if you have installed a system without tenant and restore a tenant database you will not see any tenants and no-tenant dependent objects afterwards since this feature was never installed before.

How to install/de-install Multi-Tenancy

First Installation

Follow the instructions of the installation assistant and, at Components, click Multi-Tenancy.

Update Installation

Follow the instructions of the installation assistant and, at Components, click Multi-Tenancy.
For all data that can be tenant specific, <not assigned> is entered as a tenant. Later, the data can be assigned to defined tenants.


Execute an update installation and, at Components, deactivate Multi-Tenancy.

Import Tenants from OpenScape Voice Assistant

1) When you use a version > V3.0 of OpenScape Voice Assistant, open:

Element Manager > Element Manager Configuration > "OpenScape Voice Assistant" Tab

2) Enable Tenants synchronization and click Update Business Groups.
For each business group, a tenant and a location is created.
The names used hereby are constructed from :

<BusinessGroups Switchname (OpenScape Voice Assistant Version > V3.0) ><BusinessGroups Name>

Tenants and locations already existing are updated.

Set Up configuration

How to Set Up Tenants

1)Navigate to Administration > Server Configuration > Tenants.
2)Enter the required number of licenses. You can check the total number via Administration > Server Licenses.
3)If an appropriate location exists already, assign it to the tenant now via Administration > Server Configuration > Tenants > "Locations" Tab. The possible values are displayed in a selection list. It is possible to assign multiple locations. After this, continue with step 6.
4)If no appropriate location should be set up yet, click Save firstly to create the tenant, as this will be required for setting up the location. After this, navigate to Administration > Server Configuration > Location and create a location.
5)Change to Administration > Server Configuration > Location > "Tenants" Tab and assign the location to a tenant. A location can be assigned to only one tenant.
6)Change to Administration > Account Management > Account Configuration and assign the tenant to that account which shall access the data belonging to this tenant.

NOTE: The newly created tenant will be assigned to the "admin" account. This assignment cannot be effected via the GUI.

Delete Tenants

To delete a tenant, all references to this tenant must be removed first.
1)Navigate to Administration > Server Configuration > Tenants.
2)Mark the desired tenant and delete the locations listed in the "Locations" Tab.
3)Click Delete and, in the dialog window, confirm that the tenant is to be deleted.

A tenant that has been deleted will be removed automatically from the "admin" account.This cannot be effected via the GUI.

Setup a Multi-Tenancy account

1.Navigate to Administration > Account Management > Account Configuration. 2.Create an account. As Access Type, choose DLS-GUI. 3.Assign the desired roles. The role EDIT_GENERAL_ONE ensures that the account may only edit multi-tenancy masks. With the role EDIT_SYSTEM, also system relevant masks which affect all tenants can be edited. 4.Change to the "Tenants" Tab. In Tenant, enter the tenants that can be edited by this account.

Multi-tenancy accounts can edit data belonging to the assigned tenants as well as data marked with <not assigned>. To the "admin" account, the selection <all> is available in addition. With <all>, all data present in the database can be displayed and edited.

Multi-Tenancy Alarm configuration

When a tenant is set up, a tenant specific alarm configuration is created automatically. At this, the data of the generic (<not assigned>) alarm configuration are copied. If a tenant is chosen in the tool bar, the corresponding tenant dependent alarm configuration will be selected. Thus, Email addresses, batch files, and SNMP traps can be entered for license, mobility, and certificate expiration in a tenant-specific manner.