Cisco Systems OL-27172-01 Mobility Aid User Manual


 
5-11
Cisco Broadband Access Center 3.8 Administrator Guide
OL-27172-01
Chapter 5 Configuration Templates Management
Features of Cisco BAC Templates
Expressions
Expressions are conditionals that use information from device properties. They may use Parameters,
InformParameters or rpcArguments. Expressions are used within prerequisites and firmware rules and
are processed when a device contacts Cisco BAC to retrieve its configuration.
If the expressions that you specify evaluates to true, the condition(s) is met, and the corresponding
configuration or firmware rule is applied to the device. For detailed information, see Using Conditionals,
page 5-19.
The Prerequisites tag may contain zero or more expressions.
SendHttpErrorOnFail
When the prerequisites specified in the configuration template are not met, and the sendHttpErrorOnFail
attribute is set, an HTTP error with the specified code is sent to the device, and the corresponding
configuration is not applied to the device.
Example 5-2 Configuring Prerequisite - sendHttpErrorOnFail
In this example, when the software version of the device is not 1.1, an HTTP error code is sent to the
device.
<Prerequisites sendHttpErrorOnFail=”503”>
<Expression>
<ParameterName>InternetGatewayDevice.DeviceInfo.SoftwareVersion</ParameterName>
<Value>1.1</Value>
<Operator>match</Operator>
</Expression>
</Prerequisites>
MaintenanceWindow
Use the MaintenanceWindow setting to specify the time window within which you want to apply a
particular configuration to a specific CPE. This evaluation is performed at the DPE on device contact;
as such, the DPE local time is used.
Note You should configure the server on which the DPE runs with automatic time server synchronization, such
as NTP.
MaintenanceWindow comprises:
StartTime—Specifies a time value indicating the beginning of a maintenance window. This value is
defined as hh:mm:ss.
Duration—Specifies a time value indicating the duration from StartTime when the configuration can
be applied. This value is defined as hh:mm.
DayOfWeek—Specifies the days of the week when you can apply the configuration. Absence of this
tag indicates that the rule is valid for all days of the week. This tag is optional.
You can use these elements to specify the time window when this rule can run, thus providing the ability
to limit configuration upgrades to late in the night when subscribers are most likely sleeping.
The Prerequisites tag may contain zero or one MaintenanceWindow.