Difference between revisions of "PolycomSLAProvisioning"

From FusionPBX
Jump to: navigation, search
(Rewrite Rules)
Line 1: Line 1:
 
=Provisioning Polycom VVX with SLA=
 
=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
 
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
 +
 +
==Prerequisites==
 +
* a fusionpbx installation
 +
* nginx as web server
 +
* basic abilities on linux cli to edit files
 +
* some basic familiarity with fusionpbx
  
 
==Provisioning tool==
 
==Provisioning tool==

Revision as of 00:59, 30 January 2015

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

Prerequisites

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

Provisioning tool

Access the provisioning editor at

Advanced/Provisioning Editor

navigate to

Files/polycom/vvx

{$mac}.cfg

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.

<APPLICATION APP_FILE_PATH="sip.ld" CONFIG_FILES="[PHONE_MAC_ADDRESS]-features.cfg,[PHONE_MAC_ADDRESS]-site.cfg,[PHONE_MAC_ADDRESS]-registration.cfg" MISC_FILES="" LOG_FILE_DIRECTORY="" OVERRIDES_DIRECTORY="" CONTACTS_DIRECTORY="" LICENSE_DIRECTORY="" USER_PROFILES_DIRECTORY="" CALL_LISTS_DIRECTORY="">

{$mac}-registration.cfg

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.

reg.{$row.line_number}.label="{$row.display_name}" 
reg.{$row.line_number}.type="shared" 
reg.{$row.line_number}.thirdPartyName=""

features.cfg

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="">
  </bg.color.bm>
 </bg.color>

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>
 </bg.color>

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

#polycom
rewrite "^.*/provision/000000000000.cfg$" "/app/provison/?mac=$1&file=%7b%24mac%7d.cfg";
rewrite "^.*/provision/(.*).(png|jpg|gif)" "/app/provision/$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;

note that this includes a rewrite for features.cfg and for images that will be referenced for the variable {$bg1} from above. The background image will be stored in app/provision/imagename.jpg for example.

you should upload your 320x240 jpg file to app/provision -or- the directory of your choosing. If you do not, the phone will simply show the default background gradient.

Default Settings

navigate to Advanced/Default Settings.

Provisioning

add/update the entries to match

Provision
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 filename.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
DHCP Menu
Boot Server Static
Boot Server Option 160
Boot Server Type String
Option 60 Format ASCII String