CounterPath Bria Professional 2.5 Provisioning Guide - Manual (Page 23)

Provisioning Bria Professional OEM Edition
19
where:
•
Success : 1=true (there is an upgrade) or 0=false (there is no upgrade).
• Mandatory : 1=true. This response is optional; the deafult is “0”. Bria Professional handles the
upgrade differently depending on this response; see below.
• version : identifies a build stamp set by Bria Professional during build time. Bria Professional
uses this version to determine whether to prompt the user to install the upgrade; see step .
• url : the absolute path to the installer software for the new version.
• The response must end with a CRLF.
The response cannot include a [SETTINGS] secti on. In other words, none of the user’s current settings can
be changed via this response.
If no upgrades are found, Bria Professional will recheck periodically for available upgrades. See “Timer
Settings” on page 16 for details.
Handling of the Upgrade
If an upgrade is available, Bria Professional compares the build number of the application on the user’s
computer to the build number specified in the response (60000 in the above example).
• If the response has the same number, Bria Professional does not prompt the user to download
• If the response has a different number, Bria Professional prompts the user to download the upgrade.
•
If the user initiates the download, Bria Professional will download the installer and save it to the local
Bria Professional program folder. Bria Professional will also prompt the user to exit in order to install
the new version. The user can install immediately or postpone installation.
• If the user declines the upgrade and the upgrade is optional, Bria Professional will enter its timing cycle
and display the download prompt again at the appropriate time. See “Timer Settings” on page 16.
• If the user declines a mandatory upgrade, Bria Professional shuts down
• If the user declines with “do not ask me again” (possible only with an optional upgrade), Bria
Professional will not check again for upgrades during the session.
“Install Later” Handling
If the user declines to install the downloaded version, then the next time Bria Professional is started the user will
be prompted to install the newer version.One of the following will occur:
• If the user initiates the installation, Bria Professional will install the new (local) version.
• If the user declines, Bria Professional will start the original version and will enter its timing cycle,
displaying the download prompt again at the appropriate time. See “Timer Settings” on page 16.
• If the user declines with “do not ask me again”, Bria Professional will start the original version and will not
prompt to install again during the session.
Bria Professional starts the version installed most recently. The automatic check scenario will be initiated as
described in the previous section. The downloaded installer will not be deleted, to enable manual rollback, if
required.
[DATA]
Success=1
Mandatory=1
version=60000
url=https://executableupgradeserver.com/newversion.exe
<CRLF>