Multi-Tenant

Mutli-tenant is done using Fully Qualified domain names (FQDN). Often sub-domains are used. The domains help separate the information between tenants. The domains need to be pointed to the FusionPBX server.

Advanced -> System Settings

To setup multi-tenant all domains under advanced -> system settings need to use the following convention.

The paths below assumes that the FreeSWITCH conf directory is installed to /usr/local/freeswitch/conf/

Set the paths

Extensions Directory:

/usr/local/freeswitch/conf/directory/example1.domain.com

Dialplan Public Directory:

/usr/local/freeswitch/conf/dialplan/example1.domain.com

Recordings Directory:

/usr/local/freeswitch/recordings/example1.domain.com

Advanced -> SIP Profiles -> Internal

Edit the internal.xml file and comment out <!-- and --> for the following 3 entries.

Original looks like this.

<!--all inbound reg will look in this domain for the users -->
<param name="force-register-domain" value="$${domain}"/>
<!--force the domain in subscriptions to this value -->
<param name="force-subscription-domain" value="$${domain}"/>
<!--all inbound reg will stored in the db using this domain -->
<param name="force-register-db-domain" value="$${domain}"/>

Changed to look like this:

<!--all inbound reg will look in this domain for the users -->
<!--<param name="force-register-domain" value="$${domain}"/>-->
<!--force the domain in subscriptions to this value -->
<!--<param name="force-subscription-domain" value="$${domain}"/>-->
<!--all inbound reg will stored in the db using this domain -->
<!--<param name="force-register-db-domain" value="$${domain}"/>-->

System -> Variables

Disable the domain variable so that it is not applied system wide.

Convert Old Systems

The easiest way to get started with multi-tenant is to begin using it before configuring the system. However if you find that you need to switch an existing system to multi-tenant you will need to do the following.

• The context for each extension needs to be changed to the domain name
• On old system you have to either add some additional variables or recreate your inbound and outbound routes
• Need to re-save gateways so that they use the new domain. You may need to manually remove the gateway xml files.