Polycom SLA Provisioning

From FusionPBX
Jump to: navigation, search

Provisioning Polycom VVX with SLA

This document is meant as a guide to configure provisioning, make alterations per the authors preferences, and enable SLA w/ presence to emulate a 'key system'. All testing and development of this guide was on Polycom VVX 400/410 phones. This guide by syadnom_* in freenode/#fusionpbx


  • a fusionpbx installation
  • nginx as web server
  • basic abilities on linux cli to edit files
  • some basic familiarity with fusionpbx


  • This guide is using the Broadsoft SCA/SLA method preferred by freeswitch
  • There are only 2 fully function phone brand/series that do SLA with freeswitch, Polycom (SoundPoint and VVX) and Cisco/Linksys SPA
  • This guide also works for the SPA line but needs additional rewrites and changes to provisioning files
  • Aastra phones have partial support for SLA, I have a number of 53i/55i running from this config with changes to rewrites and provisioning, but the partial support kills the usefulness
  • I choose the Polycom VVX series as a long time SoundPoint and FreePBX user and it's ability to do SLA
  • This guide was built with huge help from a number of regulars in freenode/#fusionpbx, as well as data pulled from this wiki.

Provisioning tool

Access the provisioning editor at

Advanced/Provisioning Editor

navigate to



alter the line to add the [PHONE_MAC_ADDRESS]-features.cfg file to initial provisioning. This tells the phone to make use of the features.cfg file where a few settings like parking lots and background images can be configured.



for SLA to work, thirdPartyName needs to be blanked. Also, this needs cleared if you plan to alter the Label as this guide directs. Change the following fields.



we will add some variables so that background images can be configured from 'Default settings'. find the following section

<bg.color bg.color.selection="1,1">
 <bg.color.bm bg.color.bm.1.em.name="" bg.color.bm.1.name="" bg.color.bm.2.em.name="" bg.color.bm.2.name="">

change it to

<bg.color bg.color.selection="2,1">
 <bg.color.bm bg.color.bm.1.em.name="" bg.color.bm.1.name="{$bg1}" bg.color.bm.2.em.name="" bg.color.bm.2.name="{$bg2}" >

the setting "2,1" is essentially 'enable' '2', 'image' 1, so defaulting to use bg.color.bm.1.name.

Rewrite Rules

the apply only to nginx, and by default are in /etc/nginx/sites-enabled/fusionpbx

rewrite "^.*/provision/000000000000.cfg$" "/app/provison/?mac=$1&file=%7b%24mac%7d.cfg";
rewrite "^.*/provision/(.*).(png|jpg|gif)" "/app/provision/backgrounds/$host/$1.$2";
rewrite "^.*/provision/([A-Fa-f0-9]{12})-features.cfg$" /app/provision/?mac=$1&file=features.cfg;
rewrite "^.*/provision/([A-Fa-f0-9]{12})-sip.cfg$" /app/provision/?mac=$1&file=sip.cfg;
rewrite "^.*/provision/([A-Fa-f0-9]{12})-phone.cfg$" /app/provision/?mac=$1;
rewrite "^.*/provision/([A-Fa-f0-9]{12})-registration.cfg$" "/app/provision/?mac=$1&file=%7b%24mac%7d-registration.cfg";
rewrite "^.*/provision/([A-Fa-f0-9]{12})-site.cfg$"  /app/provision/?mac=$1&file=site.cfg;
rewrite "^.*/provision/([A-Fa-f0-9]{12})-web.cfg$"  /app/provision/?mac=$1&file=web.cfg;

Background Images

Create your background images, in this case 320x240 jpg,png, or gif. you will need to create directories and set permissions to match each of your domains, and then add the files to individual folders. The rewrite rule above takes the domain used in the URL and directs the request to the per-domain directories below. The FQDN entires MUST match the domain exactly. Image filenames must match the bg1 and bg2 variables set below exactly. The PUBLIC and PRIVATE ip options are there in case you connect directly to the IP for provisioning (single domain for instance) and can be if this is only multi-tenant.

mkdir -p /var/www/fusionpbx/app/provision/backgrounds/<PUBLIC_IP>
mkdir -p /var/www/fusionpbx/app/provision/backgrounds/<PRIVATE_IP>
mkdir -p /var/www/fusionpbx/app/provision/backgrounds/<FQDN1>
mkdir -p /var/www/fusionpbx/app/provision/backgrounds/<FQDN2>
chown -R www-data.www-data /var/www/fusionpbx/app/provision/backgrounds/

Default Settings

navigate to Advanced/Default Settings.


add/update the entries to match

Subcategory Type Value Enabled Description
enabled text true True
ntp_server_primary text pool.ntp.org True
polycom_gmt_offset text -25200 True in seconds, multiple hours *3600
bg1 text background1.jpg True your image file for background. 320x240 for VVX400/410
bg2 text background2.jpg True your image file for background. 320x240 for VVX400/410
  • ideally the bg1 variable could be set by domain for multi-tenancy, haven't figured that one out yet

Phone Configuration

for 'manual' phone configuration, browse to the phone's IP address and alter the following

Settings>Provisioning Server
Provisioning Server
Provisioning Server
Name Value
Server Type HTTP
Server Address your IP or FQDN if MultiTenant
Server User
Server Password
File Transmit Tries 3
Retry Wait(s) 1
Tag SN to UA Disable
Boot Server Static
Boot Server Option 160
Boot Server Type String
Option 60 Format ASCII String