Editing The Built-In Phone Provisioning Templates
3CX PhoneSystem is supplied with pre-configured templates for the most popular SIP Phone vendors on the market.
These pre-configured templates include the settings which the majority of users need. Occasionally, however, it may be necessary to adjust the settings inside these templates to suit the needs of a particular installation.
The 3CX Management Console provides a built-in editor to adjust these templates without the need to locate them inside the 3CX Phone System machine’s file system.
Note: Please also read the following document, which contains additional relevant information: http://www.3cx.com/blog/voip-howto/phone-provisioning-complete-guide/
Using the 3CX Management Console Built-In Editor
- Go to “Settings -> Provisioning Templates”
- In the “Template Type” Combo box, select “Phones”
- In the “Template Name” Combo box, select the Phone Model Number for which you would like to adjust the template. Please keep in mind that all of a vendor’s phones are inside one template file – so, for example, if you select “Linksys SPA-921″ from the “Template Name” Combo box, the changes will affect all Linksys models.
- This will display the contents of the template file in the edit box. Note: The phone’s configuration settings are specified inside a <deviceconfig> tag. Some of the template files need to have multiple <deviceconfig> tags, but the one which will need to be edited is the LAST <deviceconfig> section in the file.
- Locate the LAST <deviceconfig> XML tag in the file (for example by doing a “Find” for the string “<deviceconfig file”) The 3CX-pre-configured settings are preceded with comments to explain the use of that particular setting.
- You can, at your option:
- remove options, by deleting the option line completely
- adjust options, by customizing the option line. For example, in the Linksys template file, the line:
<Resync_Periodic group=”Provisioning/Configuration_Profile”>86400</Resync_Periodic> …instructs the phone to re-obtain its configuration file every 86400 minutes (24 hours).
- If you want the phone to re-obtain its configuration file every 12 hours, you would adjust this line to read:
<Resync_Periodic group=”Provisioning/Configuration_Profile”>43200</Resync_Periodic>
- add options, by adding an option line. For example, if you wanted to set your Linksys phones to send Syslog messages to a Syslog server on IP Address 10.0.0.99, you could add the following line:
<Syslog_Server group=”System/Optional_Network_Configuration”>10.0.0.99</Syslog_Server>
Note: The examples quoted above are valid for Linksys phones. Different phone vendors will require options to be declared in different formats. Refer to the vendor’s administration guides or documentation for further information about configuration options.