Upgrade Rule - Cisco 6800 Series Provisioning Manual

Provisioning Scripts

Upgrade Rule

A resync is typically considered unsuccessful if a requested profile is not received from the server. The
Resync_Fails_On_FNF parameter can override this default behavior. If Resync_Fails_On_FNF is set to No,
the device accepts a file-not-found response from the server as a successful resync. The default value for
Resync_Fails_On_FNF is Yes.
Upgrade Rule
Upgrade rule is to tell the device to activate to a new load and from where to get the load, if necessary. If the
load is already on the device, it will not try to get the load. So, validity of the load location does not matter
when the desired load is in the inactive partition.
The Upgrade_Rule specifies a firmware load which, if different from the current load, will be downloaded
and applied unless limited by a conditional expression or Upgrade_Enable is set to No.
The phone provides one configurable remote upgrade parameter, Upgrade_Rule. This parameter accepts
syntax similar to the profile rule parameters. URL options are not supported for upgrades, but conditional
expressions and assignment expressions can be used. If conditional expressions are used, the parameter can
be populated with multiple alternatives, separated by the | character. The syntax for each alternative is as
follows:
[ conditional-expr ] [ assignment-expr ] URL
As in the case of Profile_Rule* parameters, the Upgrade_Rule parameter evaluates each alternative until a
conditional expression is satisfied or an alternative has no conditional expression. The accompanying assignment
expression is evaluated, if specified. Then, an upgrade to the specified URL is attempted.
If the Upgrade_Rule contains a URL without a conditional expression, the device upgrades to the firmware
image that the URL specifies. After macro expansion and evaluation of the rule, the device does not reattempt
to upgrade until the rule is modified or the effective combination of scheme + server + port + filepath is
changed.
To attempt a firmware upgrade, the device disables audio at the start of the procedure and reboots at the end
of the procedure. The device automatically begins an upgrade that is driven by the contents of Upgrade_Rule
only if all voice lines are currently inactive.
For example,
• For the Cisco IP 6800 Series:
http://p.tel.com/firmware/sip68xx.11-1-0MPP-BN (BN==Build Number).loads
In this example, the Upgrade_Rule upgrades the firmware to the image that is stored at the indicated URL.
Here is another example for the Cisco IP Phone 6800 Series:
("$F" ne "beta-customer")? http://p.tel.com/firmware/sip68xx.11-0-1MPP-BN (BN==Build
Number).loads
| http://p.tel.com/firmware/sip68xx.11-0-1MPP-BN (BN==Build Number).loads
This example directs the unit to load one of two images, based on the contents of a general-purpose parameter,
GPP_F.
The device can enforce a downgrade limit regarding firmware revision number, which can be a useful
customization option. If a valid firmware revision number is configured in the Downgrade_Rev_Limit
parameter, the device rejects upgrade attempts for firmware versions earlier than the specified limit.
Cisco IP Phone 6800 Series Multiplatform Phones Provisioning Guide
27