AdminGuide:GettingStarted:Multitenant/en

Return to AdminGuide:GettingStarted

To activate a Kalliope Multitenant license, follow these steps:

1. If you wish to activate the license on a new machine, begin by following the instructions for activating a KalliopePBX VM license with the license key you were provided. If you wish to activate a Kalliope Multitenant license on a KalliopePBX VM that was previously set up, skip to step 2.

2. Log into the KalliopePBX administration GUI with "admin" credentials and open the license management page from the main menu.

3. Click on "Activate new license" and insert the "KalliopePBX Multitenant" license key.
Click on "Activate".

4. After activating the license, you will need to log in again to unlock multitenant functionality.
Before restarting you will be asked which limitations, if any, to set for the "default" tenant, i.e. the preexisting one set up during firmware installation (see step 1).

To manage tenants, log in with the following credentials:

Username: pbxadmin
Password: admin

You are advised to change the password for the user "pbxadmin" immediately after login.

6. Once you have logged in as pbxadmin, you can view the new license from the Licenses menu.

During the activation of a multitenant license, KalliopePBX executes a series of internal procedures; some are automatic, while others require the admin to input the necessary parameters.

When operating in its default single tenant mode, KalliopePBX is already a multitenant system with a single predefined tenant enabled (associated to the "default" domain); the pbxadmin and the tenant admin (see "Users and roles") are simply combined into a single user, "admin".

When a multitenant license is activated, the two users are made distinct, separating the admin's configuration privileges (the operation of the single tenant) from those of the new user "pbxadmin". The users of a single tenant are now identified by the domain of the tenant they belong to (in this case, "default", so the admin becomes admin@default, and so on) so they can have the freedom to pick any username within the tenant.

Allo stesso tempo, viene effettuato un disaccoppiamento tra le linee SIP esterne (gateway, domini, trunk e terminazioni) ed i tenant, in quanto le prime sono entità sotto il controllo del pbxadmin e pertanto ne deve essere mediata la visibilità ai singoli tenant admin. Viene introdotto il concetto di "assigned line", che in pratica corrisponde ad una numerazione (o arco di numerazione) presente su una delle linee di uscita, e che viene assegnata (in termini di utilizzo esclusivo) ad un tenant.

Al momento dell'attivazione della licenza multi-tenant, in caso di presenza di linee di ingresso/uscita già configurate sul PBX, vengono implicitamente create delle linee assegnate (una per ciascun linea di uscita) che vengono attribuite (con selezione "qualsiasi") al tenant "default". In questa fase è possibile anche specificare solo alcune numerazioni da presentare al tenant, in modo da riservare poi altre nuemrazioni eventualmente presenti sulla linea ad altri tenant.

L'assegnazione delle linee ai tenant avviene in modo analogo alla configurazione delle selezioni passanti (DID) nel caso delle linee di ingresso di un sistema single-tenant, con la differenza che adesso la destinazione d'inoltro non sarà più una entità quali interni, code, gruppi o altro, ma sarà un intero tenant. Nella configurazione del tenant sarà poi effettuato l'instradamento alle destinazioni terminali, secondo il concetto di DID associati alle singole "assigned line".

ATTENZIONE! In questa procedura di conversione delle linee da single a multi-tenant è importante considerare il fatto che le eventuali regole di manipolazioni in ingresso (ad un gateway o ad un dominio) che nello scenario single-tenant venivano effettuate prima dell'applicazione delle regole di instradamento dei DID, vengono mantenute associate alle effettive linee di ingresso e non sono invece trasferite al tenant. Ne consegue che le regole di assegnazione delle numerazioni ai tenant (assigned lines) DEVE essere effettuata configurando le selezioni risultanti DOPO le manipolazioni di ingresso.

Parimenti, le regole di uscita vengono applicate a livello di PBX dopo che la chiamata sia uscita dal tenant e attribuita ad una specifica linea di uscita.

All'interno di ogni singolo tenant sono poi presenti nuove tabelle di manipolazione (sia in ingresso che in uscita) associate alle singole assigned line attribuite a ciascuno di essi, permettendo quindi sia al pbxadmin che al singolo admin di tenant di effettuare le necessarie modifiche ai numeri chiamante e chiamato nelle varie fasi di gestione della chiamata.