• ×
    Information
    Windows update impacting certain printer icons and names. Microsoft is working on a solution.
    Click here to learn more
    Information
    Need Windows 11 help?
    Check documents on compatibility, FAQs, upgrade information and available fixes.
    Windows 11 Support Center.
  • post a message
  • ×
    Information
    Windows update impacting certain printer icons and names. Microsoft is working on a solution.
    Click here to learn more
    Information
    Need Windows 11 help?
    Check documents on compatibility, FAQs, upgrade information and available fixes.
    Windows 11 Support Center.
  • post a message
Guidelines
The HP Community is where owners of HP products, like you, volunteer to help each other find solutions.
HP Recommended

Simple answer:

 

Use the Poly Lens cloud Service to maintain your phones. Poly Lens >here< offers free provisioning for phones via the Cloud. No need to manually create XML files.

 

Simply set up the DHCP Provisioning Option and everything will be fully automated.

 

UC Software 4.0.0 or later:

 

Since UCS 4.0.0 the phone can import configuration files via the Web Interface. For more information please check => here <=

 

This is useful in order to add configuration changes to an individual phone with Parameters that are not available to change via the Web Interface or the Phone GUI.

 

The expected format would be an XML file with the .cfg as a file extension.

 

  • Utilities > Import & Export Configuration > Import Configuration

EDIT: Importing single or multiple configuration values via the Web Interface has a higher priority than a configuration file provisioned value and will overwrite the original set parameter.

 

image

 

Some community replies or the Admin Guide contain individual parameters.

 

Simply open a compatible editor like Notepadd++ and paste the parameter into it:

 

image

Any configuration file needs to start with a < chevron and end with a /> forward-slash chevron

 

Simply save this with any name ending with .cfg and import using the above menu

 

Older than UC Software 4.0.0 or Provisioning Server:

 

Each released version of SIP or UCS software contains the relevant supported configuration files that, depending on the software Version, are needed to provision the phone.

 

The compatible Software and prior versions can be downloaded from => here <=, need to be decompressed/unzipped and then to be placed on a provision server.

 

NOTE: Do not ever mix configuration files from previous versions with newer versions!

 

The SIP Software releases traditionally included the 000000000000.cfg, the sip.cfg and the phone1.cfg

 

Since the appearance of newer phone models, older phones have been classed as legacy phones, and the newer phones software now may contain a sip_(Version of Sip).cfg and a phone1_(Version of Sip).cfg

 

This allows a mix of phones and guarantees backwards capability.

 

NOTE: Please consult the SIP / UCS Admin Guide matching your software version!

 

Every Software Version prior to UCS 3.3.0 always needed the phone to be able to download its sip.cfg / phone1.cfg files.

 

UCS 3.3.0 removed the need for this and the phone does only need to download either the templates files listed in the \Config subdirectory or any self-created files that had been listed within the CONFIG_FILES=" " section of a 000000000000.cfg or manually created <mac>.cfg.

 

EDIT: The configuration values provided via this method reads the files left to right. Meaning if a value is placed in a single or different configuration file and value 1 enables a feature and value 2 disable this feature only value 1 is prioritized and value 2 is ignored. The same is applicable the other way around.

 

Example template file's from within the \Config subdirectory within UCS 3.3.0 or later:

 

applications.cfg
features.cfg
H323.cfg
polycomConfig.xsd
reg-advanced.cfg
reg-basic.cfg
region.cfg
sip-basic.cfg
sip-interop.cfg
site.cfg
text.txt
video-integration.cfg
video.cfg

 

The user must specify the files that should be loaded via the CONFIG_FILES="" section as these are not automatically loaded.

 

For more details please check => here <=

 

NOTE: The files within the \Config are only templates and individual parameters can be copied & pasted into a manually created file(s) instead! 

 

Example applications.cfg

imageapplications,.cfg

In the above example the parameter

<apps.restapi apps.restapi.enabled="0">

is disabled aka ="0".

 

This matches the factory configuration so specifying the file within the config_files="" section would not actually make any changes unless this applications.cfg file would be modified.

 

Manually creating a configuration file:

 

NOTE: Please note that the configuration file must be XML conform or the phone will ignore it!

 

In order to change the standard value of a single parameter, it is easier to create an individual file.

 

The example parameter used in below is se.rt.enabled="1"

 

If 0, the ringtone feature is not enabled on the phone. If 1 (default), the ringtone feature is enabled.

 

Using UCS 3.3.0 or newer (check the matching admin guide) the parameter is contained in the template file features.cfg.

 

Opening the file with an XML compatible editor like Notepadd++ shows all the template parameters. 

 

image

 

Copying and pasting the relevant section into a new window will allow the user to simply change one individual setting and load this file via the 000000000000.cfg or manually created <mac>.cfg.

 

image

 

Above shows, an individual file stored as rt.cfg and the value changed from the factory default 1 into 0.

 

image

 

Above shows the individually created <mac>.cfg file loading the rt.cfg via the  CONFIG_FILES="" section from the provisioning server root directory.

 

Only the individual Phone with this MAC address will load this parameter.

 

NOTE: Substitution placeholders can be used as shown => here <=

 

Troubleshooting Configuration Files

 

The most common mistake when copy and pasting configuration files are the wrong "font" on quotes:

 

image

 

Not closing or opening XML conforms aka no < or > at beginning or end

 

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<polycomConfig>
  <lineKey
    lineKey.reassignment.enabled="1" [missing '>' to close]
  </lineKey>
</polycomConfig>

 

 

------------------------------------------------
Notice: I am an HP Poly employee but all replies within the community are done as a volunteer outside of my day role. This community forum is not an official HP Poly support resource, thus responses from HP Poly employees, partners, and customers alike are best-effort in attempts to share learned knowledge.
If you need immediate and/or official assistance for former Poly\Plantronics\Polycom please open a service ticket through your support channels
For HP products please check HP Support.

Please also ensure you always check the General VoIP , Video Endpoint , UC Platform (Microsoft) , PSTN
2 REPLIES 2
HP Recommended

When a user wants to provision and automate the configuration of a large number of phones they could utilize the attached excel spreadsheet to do so. 

 

For the steps below please familiarize yourself with the Poly Admin Guide for the phone model in question. Poly support suggest using an editor like Notepad++

 

  1. Download a supported software for the Phone in question from our support page >here<

  2. Unzip the software into a directory on the PC and open the 00000000000.cfg and amend the various config_file and other locations to match what you are trying to setup.

    An explanation of this can be found => here <=

    For example, the logs should go into a newly-created subdirectory called logs aka LOG_FILE_DIRECTORY="/logs/"

  3. Setup a DHCP Option for either a Skype for Business Sku 161, an openSIP Sku 160 or a general option 66 to cover both as shown >here<

  4. Setup Filezilla FTP as shown => here <= and set up a new user.

    The user could be called PlcmSpIp as this is the default user a Poly phone would use as user and password.

    Point to the directory where the downloaded firmware from step 2. was unzipped into.

  5. Unzip the attached Copy of GenerateMac.zip and open the Copy of GenerateMac.xlsm

    image

    Please enable the content so the macro's in the script work

    image
    Row 2 Field A represents the Mac address of the device. The rest of the fields B etc. can be any configuration parameter.

    In the example, we used the User, the address and the password required for a SIP registration. You can add more fields to create individually required configuration for phones.

    Clicking on "Generate Files" will start to create the individual files named <MAC>-individual.cfg in the directory the xlsm file was opened.
    image
    Now copy all these files to the location of the unzipped firmware in step 2. from above.

  6. Download the attached general.zip and unzip the file general.cfg and place it into the location of the unzipped firmware downloaded in step 2. above.

    Example file:
    image
    The above contains the general settings for every phone to register to a SIP server as shown >here< and changes the time to a 24h clock preferred in Europe as an example.

    The above can be edited to suit the local requirements.

    For example you could also include the below:
    		prov.polling.enabled="1"
    		prov.polling.mode="random"
    		prov.polling.period="86400"
    		prov.polling.time="03:00"
    		prov.polling.timeRandomEnd="05:00"

    Adding the above would cause the Poly phone every day to automatically connect to the provisioning server and check for any configuration changes. The approached polling period is during the night hours at the phones local time. This is staggered based on the phones Mac address so no all phones are doing this at the same time.

    The above could also be modified to include configuration for phone >logs<

  7. Edit the config_file section of the 000000000000.cfg again to include:
    CONFIG_FILES="general.cfg,[PHONE_MAC_ADDRESS]-individual.cfg"


    image

  8. Each phone will now boot out of the box from the DHCP Server and find it's DHCP Option and search first for its own Mac address.cfg file and then skip this step and download the 000000000000.cfg instead.
    Whilst parsing the 000000000000.cfg it will check the config_files section and load the general.cfg and then next automatically substitute the [PHONE_MAC_ADDRESS] part and replace this with its own Mac address-individual.cfg and load this.

 

NOTE: The above information is supplied to help users but Poly cannot be held responsible for any of the attached files. If you require support please work with your Poly reseller as outlined => here <=

------------------------------------------------
Notice: I am an HP Poly employee but all replies within the community are done as a volunteer outside of my day role. This community forum is not an official HP Poly support resource, thus responses from HP Poly employees, partners, and customers alike are best-effort in attempts to share learned knowledge.
If you need immediate and/or official assistance for former Poly\Plantronics\Polycom please open a service ticket through your support channels
For HP products please check HP Support.

Please also ensure you always check the General VoIP , Video Endpoint , UC Platform (Microsoft) , PSTN
HP Recommended

The Config File needs to be in XML structure.

 

AKA:

<device         device.set="1"
                device.baseProfile.set="1"
                device.baseProfile="Lync"
                device.auth.localAdminPassword.set="1" 
                device.auth.localAdminPassword="789"
                device.eulaAccepted.set="1" 
                device.eulaAccepted="1"
                prov.eula.accepted="1"
				prov.polling.enabled="1"
                prov.polling.mode="random"
                prov.polling.period="86400"
                prov.polling.time="01:00"
                prov.polling.timeRandomEnd="05:00"
                prov.userControl.enabled="1"
                prov.userControl.postponeTime="00:15" 
                prov.startupCheck.enabled="1"
				tcpIpApp.sntp.olsonTimezoneID="Europe/London"
				apps.restapi.enabled="1"
				httpd.cfg.enabled="1"
                httpd.cfg.secureTunnelRequired="1"
                httpd.enabled="1"
				lcl.ml.lang="English_United_Kingdom"/>

 

The above is an without any extra fields or comments

 

More complex with better readability:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<!-- Change to Microsoft Skype for Business -->
<!-- Change Admin Password to 789 -->
<!-- Accept the End User License Agreement -->
<device                device.set="1"
                device.baseProfile.set="1"
                device.baseProfile="Lync"
                device.auth.localAdminPassword.set="1" 
                device.auth.localAdminPassword="789"
                device.eulaAccepted.set="1" 
                device.eulaAccepted="1"
                prov.eula.accepted="1"/>
<!-- Polling for new configuration daily between 01:00 and 05:00 with a postpone option -->
<!-- Enable device on a reboot to check provisioning server -->
<polling prov.polling.enabled="1"
                prov.polling.mode="random"
                prov.polling.period="86400"
                prov.polling.time="01:00"
                prov.polling.timeRandomEnd="05:00"
                prov.userControl.enabled="1"
                prov.userControl.postponeTime="00:15" 
                prov.startupCheck.enabled="1"/>
<!-- Set UK timezone -->
<!-- See https://documents.polycom.com/bundle/trio-ag-5-9-0-AA/page/r2732735.html for more countries -->
<tcpIpApp           tcpIpApp.sntp.olsonTimezoneID="Europe/London" />
<!-- Enable REST API -->
<!-- https://community.polycom.com/t5/VoIP-SIP-Phones/FAQ-REST-API/td-p/98914 -->
<apps    apps.restapi.enabled="1" />
<!-- Enable Web Interface for HTTPS -->
<httpd  httpd.cfg.enabled="1"
                httpd.cfg.secureTunnelRequired="1"
                httpd.enabled="1" />
<!-- Enable English United Kindom for PhoneUI -->
<!-- Arabic_AE-->
<!-- Chinese_China-->
<!-- Chinese_Taiwan-->
<!-- Czech_Czechia-->
<!-- Danish_Denmark-->
<!-- DTGerman_Germany-->
<!-- Dutch_Netherlands-->
<!-- English_Canada-->
<!-- English_United_Kingdom-->
<!-- English_United_States-->
<!-- French_Canada-->
<!-- French_France-->
<!-- German_Germany-->
<!-- Hungarian_Hungary-->
<!-- Italian_Italy-->
<!-- Japanese_Japan-->
<!-- Korean_Korea-->
<!-- Norwegian_Norway-->
<!-- Polish_Poland-->
<!-- Portuguese_Portugal-->
<!-- Romanian_Romania-->
<!-- Russian_Russia-->
<!-- Slovenian_Slovenia-->
<!-- Spanish_Spain-->
<!-- Swedish_Sweden-->
<lcl lcl.ml.lang="English_United_Kingdom"          />

 

------------------------------------------------
Notice: I am an HP Poly employee but all replies within the community are done as a volunteer outside of my day role. This community forum is not an official HP Poly support resource, thus responses from HP Poly employees, partners, and customers alike are best-effort in attempts to share learned knowledge.
If you need immediate and/or official assistance for former Poly\Plantronics\Polycom please open a service ticket through your support channels
For HP products please check HP Support.

Please also ensure you always check the General VoIP , Video Endpoint , UC Platform (Microsoft) , PSTN
† The opinions expressed above are the personal opinions of the authors, not of HP. By using this site, you accept the <a href="https://www8.hp.com/us/en/terms-of-use.html" class="udrlinesmall">Terms of Use</a> and <a href="/t5/custom/page/page-id/hp.rulespage" class="udrlinesmall"> Rules of Participation</a>.