Cisco SPA2102-AU Provisioning Guide - Page 45
Upgrade Rule, Data Types - audio configuration
View all Cisco SPA2102-AU manuals
Add to My Manuals
Save this manual to your list of manuals |
Page 45 highlights
Chapter 2 Creating Provisioning Scripts Data Types 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 2-19