Modifying Plug and Play Files

From Vodia PBX Wiki
(Redirected from PnP Customization)
Jump to: navigation, search

Contents

General

For the most part, the snom ONE PBX takes care of provisioning of the snom phones with the its default configuration. But in some cases customers want to tweak some of the phone settings for various reasons. This chapter explains different mechanism the system administrator can adopt to achieve that goal.

If none of the listed mechanisms work for you, please contact snom support.

snom Phones

Customizing snom phone settings

There are 2 ways you can customize the phone settings during PnP.

First Method
  • Login to the PBX as system administrator
  • Navigate to Admin->Web Page Control->Templates page
  • Select snom_3xx_phone.xml file
  • Add the custom setting at the bottom of the file (just before </phone_setting> tag)
  • Save the file.

Lets take an example to understand this.

Consider you want to change Dialtone during Hold (cw_dialtone) setting on all of the snom 3xx phones. You can add the following line to snom_3xx_phone.xml file as explained above.

<cw_dialtone perm="">on</cw_dialtone>

If you reboot the phone now, you will see that Dialtone during Hold setting is turned on after the reboot. You can verify this by logging into phone's web interface and navigating to Advanced->Audio page.

Second Method

This method makes use of a custom file per phone type, i.e., you will have to create a custom file for each of the snom phone models, 300, 320, 360 etc.

  • Create a snom_360_custom.xml file. The content of the file will be explained in the example below.
  • Copy this file to <pbx working dir>/tftp folder
  • Now Login to the PBX as system administrator
  • Navigate to Admin->Web Page Control->Templates page.
  • Select snom_360.xml template from the drop-down list
  • Add the snom_360_custom.xml line before the end of <setting-files> tag. Example below will show the content of this file.
  • Save the file.

Lets take an example to understand this.

Consider you want to change the same Dialtone during Hold (cw_dialtone) setting on all of the snom 360 phones.

The snom_360_custom.xml file will look like this

<?xml version="1.0" encoding="utf-8" ?> 
<phone-settings>
  <cw_dialtone perm="">on</cw_dialtone>
</phone-settings>

The modified version of snom_360.xml will look like this

<?xml version="1.0" encoding="utf-8"?>
<setting-files>
  <file url="{http-url}/snom_3xx_fw.xml?model=snom360" />
  <file url="{https-url}/snom_3xx_phone.xml?model=snom360" />
  <file url="{https-url}/snom_3xx_fkeys.xml?model=snom360" />
  <file url="{https-url}/snom_web_lang.xml?model=snom360" />
  <file url="{https-url}/snom_gui_lang.xml?model=snom360" />
  <file url="{https-url tftp}/snom_360_custom.xml" />
</setting-files>


IIf you reboot the phone now, you will see that Dialtone during Hold setting is turned on after the reboot. You can verify this by logging into phone's web interface and navigating to Advanced->Audio page.

Note: You can follow the same procedure to customize other models of snom phone. Example: For snom 370 phones, you will have to use snom_370_custom.xml and snom_370.xml files.

Reverting back to the phone menu button to default

After the default plug and play with the snomONE PBX, the snom phone's Menu button will be programmed to handle some extension specific functions, like changing the DND status, setting up the call forwarding, changing the name, email, cell phone etc. If you do not like this behavior, then you will have to modify the snom_xxx_phone.xml file. You can modify this templates from Admin->Web Page Control tab

From <dkey_menu perm="RW">url {http-url snom}/menu.xml?auth=basic</dkey_menu>

To <dkey_menu perm="RW">keyevent F_SETTINGS</dkey_menu>

After the template has been modified, you will have to reboot the phone to see the change.

Insecure provisioning

Generally, PBX provisions the phone in a secure way using HTTPS mechanism. But in some cases, customers want to use the less secure(HTTP) method of provisioning. You may do this for debugging purposes or some network restrictions. Whatever is the reason, PBX lets the administrator to provision the phones using HTTP method.

In order to achieve this goal, you will have to modify 2 template files on the PBX.

Steps to follow

  • Login to PBX as as System administrator
  • Navigate to Admin->Web Page Control->Templates page
  • Select snom_360.xml (for snom 360 phones) from the drop-down list
  • Change the all https-url to http-url.
  • Save the file. This will be automatically saved under "<pbx working dir>/webpages" folder.

The final(modified) version of snom_360.xml will look like this -

  <?xml version="1.0" encoding="utf-8"?>
  <setting-files>
    <file url="{http-url}/snom_3xx_fw.xml?model=snom360" />
    <file url="{http-url}/snom_3xx_phone.xml?model=snom360" />
    <file url="{http-url}/snom_3xx_fkeys.xml?model=snom360" />
    <file url="{http-url}/snom_web_lang.xml?model=snom360" />
    <file url="{http-url}/snom_gui_lang.xml?model=snom360" />
   </setting-files>


  • Now select pnp.xml file from the drop-down.
  • Search for snom_3xx_phone.xml within this file.
  • In this section, change the https under <protocol> tag to http
  • Then search for snom_3xx_fkeys.xml within this file
  • In this section, change the https under <protocol> tag to http
  • Save the file

After these two changes, if you reboot any phone, they will be provisioned using the HTTP method, instead of the default HTTPS method.

Non snom phones

Currently, plug and play is supported for some non-snom phones under snomONE from v5x on.