Report Rule; Upgrade Rule; Data Types - Linksys SPA2102-AU Provisioning Manual

Chapter 2 Creating Provisioning Scripts
The following is an example of the corresponding Report_Rule configuration:
[ --key secretphrase ] http://prov.serv.net/spa/$MA/rep.xml.enc
Once the report rule is configured, an actual report can be generated and transmitted by sending the SPA
a SIP NOTIFY message, with the Event: report type. The SIP NOTIFY request is handled like other SIP
notifies, with the SPA requiring authentication from the requesting server before honoring the request to
issue a report. Each SIP NOTIFY report request generates one attempt to transmit the report. Retries are
not supported.

Upgrade Rule

The SPA provides one configurable remote upgrade parameter, Upgrade_Rule. This parameter accepts
a syntax similar to the profile rule parameters. URL options 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 SPA upgrades to the firmware
image specified by the URL. Subsequently, it does not attempt to upgrade again until either the rule itself
is modified or the effective combination of scheme + server + port + filepath is changed, following
macro expansion and evaluation of the rule.
In order to attempt a firmware upgrade, the SPA disables audio at the start of the procedure, and reboots
at the end of the procedure. For this reason, an upgrade driven by the contents of Upgrade_Rule is only
automatically initiated by the SPA if any voice line is currently inactive.
For example,
http://p.tel.com/firmware/spa021025.bin
In this example, the Upgrade_Rule upgrades the firmware to the image stored at the indicated URL. The
following is another example:
("$F" ne "beta-customer")? http://p.tel.com/firmware/spa021025.bin
| http://p.tel.com/firmware/spa-test-0527s.bin
This example directs the unit to load one of two images, based on the contents of a general purpose
parameter, GPP_F.
The SPA can enforce a downgrade limit with respect to firmware revision number. This can be useful as
a customization option. If a valid firmware revision number is configured in the parameter
Downgrade_Rev_Limit, the SPA rejects upgrade attempts for firmware versions earlier than the
specified limit.

Data Types

The data types used with configuration profile parameters are as follows:
Version 3.0
Linksys SPA Provisioning Guide
Data Types
2-19