Zero Touch Provisioning

Overview

This applies to Sangoma's P-Series model telephones.

Sangoma phones discover DPMA, Switchvox, FreePBX, or PBXact systems using multicast DNS (Bonjour), and provision directly from those systems using SIP MESSAGE - which eliminates the need for extra provisioning servers, and greatly simplifies system deployments for most users.

    Note:  DPMA product is included for install with products as mentioned above  

Tested Environment

PBX Version:15.0.17.48
PBX Distro:12.7.8-2107-3.sng7
Asterisk Version:18.6.0

Configuration

Endpoint Manager Configuration

    Note: For new, un-registered phones, the phone MAC address must first be entered  (or Claimed) in the Partner Portal system.

DPMA is disabled by default in Endpoint Manager. We need to manually enable this option.

 

"Endpoint Manager → Global → Use DPMA"  option needs to set to YES.   Leaving this option to NO means that Endpoint Manager will only use the legacy provisioning method (i.e. http) to provision Sangoma P series phones.

 

After toggled to Yes you'll receive

The process of enabling DPMA will automatically start 

Sometimes a write permission error avoids this process to be successful.

From the CLI launch:

fwconsole chown

 

Confirm with "Save Global" and "Apply Config" if needed 

DPMA Configuration

The next step is to perform the common settings config related to DPMA.

To access the DPMA Management page, you can use the "Endpoint Manager → Global Settings→ DPMA Management" button, or "Endpoint Manager → Right Nav → DPMA Management"

 

In both cases you'll reach a page showing these options

  • DPMA Version - The version number of Asterisk DPMA module.

  • Global Pin - A numeric identifier that, depending on the setting of Phone Authentication Method, can be used to assign the configuration of any phone.

  • Phone Authentication Method - This is the authentication type required for a user to take ownership of a phone. By default, no authentication is required and any user can claim any phone configuration. Other available options are:

  • Global PIN - The user must enter the Global PIN in order to claim the phone.(Recommended)

  • mDNS Service Name - Defines the registration server name for this server, provided to the phone during its mDNS server discovery.

  • mDNS Discovery Address - Defines the Ip address or hostname of this server, provided to the phone during its mDNS server discovery.

  • mDNS Discovery Port - Defines the SIP UDP signaling port for this server, provided to the phone during its mDNS server discovery. Defaults to 5060.

  • mDNS Discovery Transport - Defines the SIP UDP signaling transport for this server, provided to the phone during its mDNS server discovery. Defaults to UDP.

  • Default User List Template - Selected template will be used to generate the phone config when user picks the extension from available user list from the phone. this is applicable for only those extensions who are not associated with any template in extension mapping page.

  • PJSIP Max Contact Display Limit - Set the user list display limit for PJSIP maxcontact. this is applicable for only those extensions who are not configured in extension mapping page.

  • Available options are:

    • One:- Display only first extension in user list(i.e. ext-1)

    • All:- Display all extension in user list (i.e. ext-1 to ext-n where n is max contact )

  • DPMA Logging - Enable or Disable DPMA logging. If enable will generate logs in "/var/log/asterisk/dpma" file.

 

Confirm with "Save" and "Apply Config" if needed

Adding Digium Templates

Choose D & P Series phones template and set it up as per your needs

 

Work on a dedicated template to these phones as per EPM page instructions.

 

 

http://portal.sangoma.com configuration

Go to the Sangoma Portal at https://portal.sangoma.com and on the left menu select Sangoma Phones / Change redirection settings

Look in the Search input form for your Sangoma P-Series phone 

and click on the View/Edit button.

Here you need to put all the informations in sync with DPMA configuration we just made!

Reboot your phone and you are done!

Return to Documentation Home I Return to Sangoma Support