Provisioning polling

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>

Description	Valid Values	Default
If set to on, the phone will periodically fetch the provisioning files (configuration and/or software updates).	on \| off	off

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:

Option 1: set Polling Mode to Relative. You can set the value of X in parameter Polling Period
Option 2: alternatively, this can also be achieved by using a single setting called Settings refresh timer. If this is preferred, disable Prov Polling and set Settings refresh timer to the value of X

Example: fetch provisioning files every 24 hours

Required settings:

Option 1: using provisioning polling, configure the following settings:
- Prov Polling: on
- Polling Mode: Relative
- Polling Period: 86400 seconds (24 hours)

Option 1 example: fetch provisioning files every 24 hours

<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

Option 2: using the Settings refresh timer
- Prov Polling: off
- Settings refresh timer: 86400 seconds (24 hours)

Option 2 example: fetch provisioning files every 24 hours

<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: on
Polling Mode: Absolute
Polling Time: 01:00

Example: check for updates in the provisioning files every day at 01:00

<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.

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

<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.

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

<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

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

<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.