10-07-2011 04:46 AM - edited 03-16-2017 03:44 PM
Downloading the compatible SIP / UC Software from the Polycom Support Page => here <= always contains a 000000000000.cfg.
This File is protected and set as read only and is thought to be a template for Phone Provisioning.
The properties of this file can be changed via right clicking on the file and then selecting the properties and un-ticking the read-only attribute.
The file or a local copy renamed into the MAC address <mac>.cfg of a phone is utilized to actually load individual configuration files via the config_files="" section.
You do not add any kind of actual phone configuration to this file !
The individual sections can be used to define separate directories in order to keep a root directory "clean".
Above example was taken from a UCS 4.0.3 Software
NOTE: Using SIP 3.2.x or older the Phones always need to ensure to load the sip.cfg / phone1.cfg!
The APP_FILE_PATH="sip.ld" determines the name and location of the SIP / UCS application
The DECT_FILE_PATH="3111-17823-001.dect.ld" determines the name and location of the Dect D60 application (UC Software 5.4.3 or later)
The CONFIG_FILES="" section is used to load additional files that are separated via a "," (comma) .
The order of the files (left to right) determines how the parameters are set.
Having the same parameter in multiple different files will set the value found in the first file and ignore any other values for the same subsequent parameter.
NOTE: The 000000000000.cfg is not being used to set configuration parameters!
The Phone on booting from the Provisioning Server will always look for it's own <mac>.cfg file and load this if it can be found.
A <mac>.cfg can be created by opening the original 000000000000.cfg and storing it with the MAC Address of a Phone.
NOTE: The <mac>.cfg is just a place holder in this explanation for the Phones real unique MAC Address.
In the absence of a individual <mac>.cfg the Phone will always load the 000000000000.cfg.
The CONFIG_FILES="" section in the <mac>.cfg or 000000000000.cfg is used to load Phone specific configuration files affecting the single phone only via substitution and general site related configurations.
These could be individual SIP Authentication Username and Password or site specific configuration files like the IP Address / Hostname of the SIP Server or other Site Specific settings.
An example could be:
The [PHONE_MAC_ADDRESS]-extension.cfg would use the substitution and individual files with the MAC Address Part of the Phone in Question with a similar content like => here <= would need to be manually created.
NOTE: A sample script that utilizes Perl can be found => here <=
The site.cfg would contain site specific settings like NTP Server, SIP server IP address, default language and for example local ringtones.
Utilizing this example in a 000000000000.cfg would cause all phones to load the their individual single files [PHONE_MAC_ADDRESS]-extension.cfg and then load the sites.cfg.
For more details on creating configuration files or using existing configuration files please check => here <=
NOTE: Legacy phones will in addition always need their sip.cfg / phone1.cfg as explained => here <=
The CONFIG_FILES="" and all other section can load files in several different formats. One could simply be site.cfg or even http://xxx.xxx.xxx.xxx/site.cfg and can combine local and / or remote files.
The LOG_FILE_DIRECTORY="" can be used to store logs in a different directory. If nothing is specified the files are stored in the root directory. See => here <= for more details.
The OVERRIDES_DIRECTORY="" can be used for the <mac>-phone.cfg and/or <mac>-web.cfg. If nothing is specified the files are stored / loaded in/from the root directory.
The CONTACTS_DIRECTORY="" can be used for the <mac>-phone.cfg and/or <mac>-web.cfg. If nothing is specified the files are stored / loaded in/from the root directory. See => here <= for more details.
The LICENSE_DIRECTORY="" can be used for the <mac>-license.cfg . If nothing is specified the files are loaded from the root directory. See => here <= for more details.
The USER_PROFILES_DIRECTORY="" can be used for the individual user cfg files . If nothing is specified the files are loaded from the root directory. See => here <= for more details.
The CALL_LISTS_DIRECTORY="" can be used to store/load the <mac>-calls.xml or <username>-calls.xml files. If nothing is specified the files are stored / loaded in/from the root directory.
Note:The call lists (or call log) is supported on VVX 300, 310, 400, 410, 500, 600 and 1500 phones!
The COREFILE_DIRECTORY="" is being used by the phone in case the software encounters an issue and is used by Support to determine the root cause.
The Service_Files="" is being used by ALY / Alcatel Lucent implementations. This was added in 5.4.0
Details on how to combine new SIP / UC Software when using legacy Phones can be found => here <=.
NOTE: Please ensure to consult the Admin Guide as the details may very depending on the SIP / UC Software Version