© 2003 - 2005 Sipura Technology, Inc
Proprietary (See Copyright Notice on Page 2)
32
ParName: Upgrade_Rule
Default: Empty
The Upgrade_Rule parameter is a script that identifies the upgrade server to contact during a
firmware upgrade. The string supports one level of macro expansion, using a small set of variables.
Following macro substitution, the rule is evaluated to obtain a URL of the firmware file to request from
an upgrade server.
The URL can be partially specified, in which case default values are assumed for the unspecified
terms. The filepath portion of the URL must be specified.
The Upgrade_Rule supports additional syntax that allows the URL to be a function of the firmware
release currently running in the SPA. This mechanism can aid service providers sequence through a
firmware upgrade, by allowing them to automatically stage the upgrade sequence, if so required by
the firmware.
The conditional syntax consists of a sequence of condition-url pairs, separated by the ‘|’ character.
The condition component tests the current firmware version number against a specified value.
The sequence of conditions is evaluated until one is satisfied. The URL associated with that
condition is then used to upgrade the SPA. No additional URLs in the rule are considered.
The upgrade will fail if the new firmware load does not satisfy the upgrade rule condition that
suggested the URL. This alleviates the possibility of infinite upgrade loops, in case the device has
been misconfigured.
The rule syntax is the same as for the Profile_Rule described in a previous section, except that there
are no supported optional qualifiers for upgrades at this time. (That is, the bracketed options
preceding the URL are not supported in the Upgrade_Rule). Also, all upgrade entries require a
condition term to be specified.
Upgrade Rule Syntax Examples (each line is a separate example):
(! 1.0.2)? /spa2000/1-00-02/spa.bin
(<1.0)? tftp://pserv.myvoice.com:42001/upg/spa2000/1.0.2/spa.bin
(<0.99.52)?/spa09952.bin | (<1.0.2)?/spa10002.bin
Log Upgrade Request Message:
ParName: Log_Upgrade_Request_Msg
Default:
$PN $MAC –- Requesting upgrade
$SCHEME://$SERVIP:$PORT$PATH
The Log_Upgrade_Request_Msg is a script that defines the message sent to the configured Syslog
server whenever the SPA attempts an upgrade from the upgrade server. The string supports one
level of macro substitution, with the same variables as for the Upgrade_Rule above. An empty string
does not generate a syslog message.
