Cisco Systems OL-27172-01 Mobility Aid User Manual


 
6-7
Cisco Broadband Access Center 3.8 Administrator Guide
OL-27172-01
Chapter 6 Firmware Management
Authoring Firmware Rules Templates
Expression—Zero or more expression for evaluating this rule; has the same syntax and
definition as the Expression defined for the FirmwareRule element. For detailed information,
see Expression and Regular Expression, page 6-7.
FirmwareRule—Each FirmwareRule element provides:
Expression—Zero or more expressions for evaluating this rule. The rules triggers a firmware
update if all expressions in a given rule match. For detailed information, see Expression and
Regular Expression, page 6-7.
InternalFirmwareFile or ExternalFirmwareFile—One of the two must be specified.
InternalFirmwareFile is used if the Cisco BAC file service is utilized, and the firmware image
file has been added to the system using the API or the administrator user interface.
ExternalFirmwareFile provides information for firmware image files located on external file
servers.
For detailed information, see Internal Firmware File vs. External Firmware File, page 6-10.
Expression and Regular Expression
Expressions provide a conditional way to apply the firmware rules based on value match. If the value is
a range, Regular Expression (Regex) is used for defining the firware rule in firmware rule template.
Regular expression provides a conditional way to apply the firmware rules based on Regex pattern
match. Each expression or Regex must provide a ParameterName, InformParameterName or
RpcArgumentName tag, one or more Value tags and an Operator tag.
The value of the event returned from the CPE, and the condition specified for the event determines
whether the firmware rule is applied to the CPE. The firmware rules are defined in the firmware template
with the appropriate event, Regex pattern associated with the event, and the condition for applying the
firmware rule.
Regex support is also available in the configuration templates prerequisites. For more information on
configuring prerequisites, see Configuring Prerequisites, page 5-13.
Cisco BAC processes these tags in sequence to match and assign a firmware image file to the CPE.
ParameterName
Specifies the name of a TR-069 parameter. The ParameterName is validated by using the relevant
parameter dictionary.
The DPE may have this parameter available from Inform or from prior GetParameterValues RPCs calls
within the same session. If the parameter value is not available in the session when processing the rule,
the DPE queries the device for the missing parameter values before proceeding with evaluation of the
rules.
For additional information, see Parameters, page 5-6.
InformParameterName
Specifies the name of an Inform parameter that is not described in the parameter dictionary. This entry
is not validated.
For example, the expression in the following example evaluates to true if the device
Inform.EventCode
includes either of the specified values:
<Expression>
<InformParameter>Inform.EventCode</InformParameter>
<Value>1 BOOT</Value>