Plantronics + Polycom. Now together as Poly Logo

[FAQ] Automatically check for configuration changes or new software versions

Polycom Employee & Community Manager

[FAQ] Automatically check for configuration changes or new software versions

Scheduling Automated Software Upgrades with Distributed Polling

 

You can set the polling behavior to one of three modes – relative, absolute, or random – depending on how frequently you would like to upgrade your phone deployment.

 

The Polling will only look for configuration files specified within the Config_Files Section of the 000000000000.cfg or <mac>.cfg as explained => here <=

 

Please Note:

 

  • Standard polling does not download a <mac>-directory.xml if dir.local.readonly is not set to ="1"


Random mode is a new mode available only in UC Software 4.0.0 or later.

 

  • Relative
    Specifying the mode as rel enables phones to poll after every X seconds. You can specify the value of X in the prov.polling.period parameter.

  • Absolute
    Specifying the mode as abs enables phones to poll at an exact time, based on the 24-hour clock. You can set the exact time in the prov.polling.time parameter.

  • Random
    Specifying the mode as random enables phones to randomly poll for upgrades. The randomness depends on the period specified in prov.polling.period.
    If the period is less than one day, phones will randomly poll at any time of the day.
    If the period is greater than one day, phones will poll at a random time between the values in prov.polling.time and prov.polling.timeRandomEnd if specified, or a random time if these values are not specified.
    The polling day is determined by the MAC address of the phone.

 

Attribute

Permitted Values

Default Value

Interpretation

prov.polling.enabled

0 or 1

0

If set to 1, automatic periodic provisioning server polling for upgrades is enabled.

prov.polling.mode

rel, abs, random

rel

Polling mode:

·         relative (rel)

·         absolute (abs)

·         random (random).

prov.polling.period

integer >= 3600

86400

Polling period in seconds.

Measured relative to boot time in relative mode.

86400s = 24h

prov.polling.time

hh:mm

03:00

Time of day to poll.

prov.polling.timeRandomEnd

hh:mm

 

Time of day to stop polling.

 

EXAMPLES

 

Frequent Polling, Fixed

 

  • This will cause the phone to provision every 2 hours.

 

Attribute

Value

prov.polling.enabled

1

prov.polling.mode

rel

prov.polling.period

7200

 

Frequent Polling, Random

 

  • This will cause the phone to provision every 2 hours.

 

Attribute

Value

prov.polling.enabled

1

prov.polling.mode

random

prov.polling.period

7200

 

 

Night Checks, Fixed Every Day

 

  • All phones will poll at 4 am.

 

Attribute

Value

prov.polling.enabled

1

prov.polling.mode

abs

prov.polling.time

04:00

 

Night Checks, Random Every Day

 

  • Phones will poll the server at a random time between 1am and 5am every day.

 

Attribute

Value

prov.polling.enabled

1

prov.polling.mode

random

prov.polling.period

86400

prov.polling.time

01:00

prov.polling.timeRandomEnd

05:00

 

Night Checks, Spread Out

 

  • The phone will poll the server over a 30 day period, at a random time anywhere between 11pm and 3am during the day of the poll.
     
  • The polling period will repeat every 30 days, regardless of when the phone was rebooted.

  • The starting day (day of the poll) within the polling period is based on a calculation using a fixed reference starting point and the first octet of the phone’s MAC address.

 

Attribute

Value

prov.polling.enabled

1

prov.polling.mode

random

prov.polling.period

2592000

prov.polling.time

23:00

prov.polling.timeRandomEnd

03:00

 

More details can be found in the Feature Profile 68720 Scheduling Automated Software Upgrades with Distributed Polling => here <=

 

Postpone an Update:

 

The above can be combined with a new Parameter to let the customer delay an upgrade process utilizing UC Software 5.3.1 or later.

 

Example configuration:

 

<config prov.polling.enabled="1"
		prov.polling.mode="rel"
		prov.polling.period="3610"
		prov.userControl.enabled="1"
		prov.userControl.postponeTime="00:15" />

 

NOTE: Please be aware that if ZTP is being used this parameter is ignored! 

 

The phone "pulls" after around 1h the new firmware that was placed into the directory after booting and then displays as follows:

 

VVX_SoftwareUpdate_01.PNG

 

Pressing Details will show:

 

VVX_SoftwareUpdate_02.PNG

 

There even appears a new SoftKey:

 

VVX_SoftwareUpdate_03.PNG

 

The parameter prov.usercontrol.postponeTime allows:

 

  • Configure a time interval for software update notifications. Permitted values for this configuration parameter are 15 min, 1 hour, 2hours, 4 hours and 6 hours using the format HH:MM. If a user configures an invalid value the default value is used.

After the period has elapsed this is shown:

 

VVX_SoftwareUpdate_04.PNG




<======== Signature / Disclaimer ========>
Please be aware:For questions about the type of support to expect please check here

Please also ensure you always check the VoIP , Video Endpoint , Skype for Business , PSTN or RPM FAQ's

Please remember, if you see a post that helped you , and it answers your question, please mark it as an "Accept as Solution".

The title Polycom Employee & Community Manager is an automatic setting within the community and any forum reply or post is based upon my personal experience and does not reflect the opinion or view of my employer.
Poly employee participation within this community is not mandatory and any post or FAQ article provided by myself is done either during my working hours or outside working hours, in my private time, and maybe answered on weekends, bank holidays or personal holidays.
Message 1 of 1