Profile Rules - Linksys SPA2102-AU Provisioning Manual

Chapter 2 Creating Provisioning Scripts
In this example, the SPA periodically resyncs every hour (plus an additional random delay of up to 10
minutes). In case of resync failure, the SPA retries in 30 minutes (plus up to five minutes more).
If it fails again, it waits an additional hour (plus up to 10 minutes). If again unsuccessful, it waits two
more hours (plus up to 15 minutes), and so also thereafter, until it successfully resyncs.
The following is another example:
Upgrade_Error_Retry_Delay
In this example, if a remote upgrade attempt fails, the SPA retries the upgrade in 30 minutes, then again
after one more hour, then in two hours. If it still fails, it subsequently retries every four to five hours,
until it succeeds.

Profile Rules

The SPA provides multiple remote configuration profile parameters (Profile_Rule*). This means that
each resync operation can retrieve multiple files, potentially managed by different servers.
In the simplest scenario, the SPA resyncs periodically to a single profile on a central server, which
updates all pertinent internal parameters. Alternatively, the profile can be split between different files.
One file is common for all the SPAs in a deployment, while a separate file is provided that is unique for
each account. Encryption keys and certificate information could be supplied by still another profile,
stored on a separate server.
Whenever a resync operation is due, the SPA evaluates the four Profile_Rule* parameters in sequence:
1.
2.
3.
4.
Each evaluation may result in a profile being retrieved from a remote provisioning server, possibly
updating some number of internal parameters. If any of these evaluations fails, the resync sequence is
interrupted, and is retried again from the beginning specified by the Resync_Error_Retry_Delay
parameter (seconds). If all evaluations succeed, the SPA waits for the second specified by the
Resync_Periodic parameter, and then resync once more.
The contents of each Profile_Rule* parameter consist of a set of alternatives. The alternatives are
separated by the | character. Each alternative consists of a conditional expression, an assignment
expression, a profile URL, and any associated URL options. All these components are optional within
each alternative. The following are the valid combinations, and the order in which they must appear, if
present:
[ conditional-expr ] [ assignment-expr ] [[ options ] URL ]
Within each Profile_Rule* parameter, all of the alternatives except the last one must provide a
conditional expression. This expression is evaluated and processed as follows:
1.
2.
3.
Version 3.0
Profile_Rule
Profile_Rule_B
Profile_Rule_C
Profile_Rule_D
Conditions are evaluated from left to right, until one is found that evaluates as true (or until one
alternative is found with no conditional expression)
Any accompanying assignment expression is evaluated, if present
If a URL is specified as part of that alternative, an attempt is made to download the profile located
at the specified URL, and update the internal parameters accordingly.
= 1800,3600,7200,14400+3600
Using Provisioning Parameters
Linksys SPA Provisioning Guide
2-17