Multi-Tenant

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

Advanced -> System Settings

To setup multi-tenant in FusionPBX 3.x or higher add more than one domain under advanced -> domains. After adding the second domain restart the internal sip profile this can be done at Status -> SIP Status then restart the Internal SIP Profile.

Alias

When adding a new tenant the domain alias will not show up until an extension has been added to the tenant and the internal sip profile has been rescanned or restarted. The alias can be viewed in Status -> SIP Status.

This should be done automatically for new domains.

XML Editor -> directory -> default.xml (a.k.a. /usr/local/freeswitch/conf/directory/default.xml) Change the following from...

<include>
	<!--the domain or ip (the right hand side of the @ in the addr-->
	<domain name="$${domain}">

to...

<include>
	<!--the domain or ip (the right hand side of the @ in the addr-->
	<domain name="<IP>">

Where <IP> is the public, private IP or domain of your FreeSWITCH/FusionPBX install.

System -> Variables

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

User Manager

Accounts -> User Manager when adding a user you have the domain select option that assigns the user to the domain. Tenant admin's highest level of access should not exceed the 'admin' group. Users in the 'superadmin' group are able to view and manage all tenants.

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.

Other

If transfering calls (blind) aren't working for you...

to top of: conf/dialplan/domain.example.com.xml

<include>
  <context name="domain.example.com.xml">
    <extension name="setdomain" continue="true">
    
    <!-- The channel variable isn't passing on calls
             Not sure why, but this is a workaround -->

      <condition field="destination_number" expression="^.*$">
        <action application="info"/>
        <action application="set" data="domain=domain.example.com.xml"/>
        <action application="set" data="domain_name=${domain}"/>
        <action application="log" data="INFO NOW WE HAVE SET domain_name"/>
        <action application="info"/>
      </condition>
    </extension>

ABOVE fixes for all calls generated internally, for inbound calls we need to fix the public profile:

Change in conf/dialplan/public.xml:

    <extension name="public_extensions">
      <condition field="destination_number" expression="^(10[01][0-9])$">
        <action application="info"/>
<!--    <action application="transfer" data="$1 XML default"/> changed to get inbound calls to transfer properly-->
        <action application="transfer" data="$1 XML ${domain_name}"/>
      </condition>
    </extension>

You still cannot transfer to internal conferences (*3000). Probably need to set something up under conf/diaplan/public/domain.example.com/internal_conferences.xml or some such.

Otherwise, just use a conference that you did set up through apps->Conferences, and add it to the inbound routes page... could also add a *3000 whatever route there too.

If you changed your extensions from the default 1000-1019, you will need to edit these as well.