Provisioning polling allows phone administrators to schedule fetching the provisioning files (configuration and/or software updates) at a well defined interval or date/time. Be aware that by default the provisioning polling is off.

XML Configuration

<prov_polling_enabled perm="PERMISSIONFLAGS">VALIDVALUE</prov_polling_enabled>


DescriptionValid ValuesDefault
If set to on, the phone will periodically fetch the provisioning files (configuration and/or software updates).on | offoff


Example parameter

<prov_polling_enabled perm="R">on</prov_polling_enabled>

The phone offers 3 types of provisioning polling, choose the type you want to use and find below how to configure the needed parameters in your auto-provisioning file:

  • Relative: This mode enables phones to check for updates in the provisioning files every X seconds.
  • Absolute: This mode enables phones to check for updates in the provisioning files at an exact time, based on the 24-hour clock. You can set the time in the parameter Polling Time.
  • Random: This mode enables phones to check for updates in the provisioning files randomly. The randomness depends on the period set in the Polling Period (in seconds)


Relative

This mode enables phones to check for updates in the provisioning files every X seconds. 


There are two ways to enable this functionality:


Example: fetch provisioning files every 24 hours

Required settings:

<prov_polling_enabled perm="R">on</prov_polling_enabled>
<prov_polling_mode perm="R">rel</prov_polling_mode>
<prov_polling_period perm="R">86400</prov_polling_period

<prov_polling_enabled perm="R">off</prov_polling_enabled>
<settings_refresh_timer perm="R">86400</settings_refresh_timer>

Absolute

This mode enables phones to check for updates in the provisioning files at an exact time, based on the 24-hour clock.


You can set the time in the parameter Polling Time.

Required settings:


<prov_polling_enabled perm="R">on</prov_polling_enabled>
<prov_polling_mode perm="R">abs</prov_polling_mode>
<prov_polling_time perm="R">01:00</prov_polling_time>

Random

This mode enables phones to check for updates in the provisioning files randomly.


The randomness depends on the period set in the Polling Period (in seconds):

  • If the Polling Period is less than one day (<86400 seconds), the phone will check for upgrades at any interval within the Polling Period randomly (see Example 3)
  • If the Polling Period is greater than one day (>=86400 seconds): for example if it is set to 3 days (259200 seconds), the phone will check for upgrades every 3 days, starting the next day after the setting was changed, at a random time between Polling Time and Polling Time Random End



Example 1: check for updates in the provisioning files once a day at a random time between 01:00 and 02:30

Required settings:

This case will have provisioning every day between 01:00-02:30, starting the next day after the setting was changed.

<prov_polling_enabled perm="R">on</prov_polling_enabled>
<prov_polling_mode perm="R">random</prov_polling_mode>
<prov_polling_period perm="R">86400</prov_polling_period>
<prov_polling_time perm="R">01:00</prov_polling_time>
<prov_polling_time_rand_end perm="R">02:30</prov_polling_time_rand_end>


Example 2: check for updates in the provisioning files every 3 days at a random time between 01:00 and 02:30

Required settings:

This case will have provisioning every 3 days between 01:00-02:30, starting the next day after the setting was changed.

<prov_polling_enabled perm="R">on</prov_polling_enabled>
<prov_polling_mode perm="R">random</prov_polling_mode>
<prov_polling_period perm="R">259200</prov_polling_period>
<prov_polling_time perm="R">01:00</prov_polling_time>
<prov_polling_time_rand_end perm="R">02:30</prov_polling_time_rand_end>


Example 3: check for updates in the provisioning files at random intervals between 0 and 3600 seconds

Required settings:

For this case, settings Polling Time and Polling Time Random End are ignored

<prov_polling_enabled perm="R">on</prov_polling_enabled>
<prov_polling_mode perm="R">random</prov_polling_mode>
<prov_polling_period perm="R">3600</prov_polling_period>

To enable provisioning polling, open the Web Interface of your phone, click on Advanced -> Update and set Prov Polling to on.