CounterPath Bria 4 Provisioning Guide - Enterprise Deployments User Manual
Page 22
CounterPath Corporation
18
Server Response
The upgrade executable server must respond with the following:
or
where:
•
Success
: 1=true (there is an upgrade) or 0=false (there is no upgrade).
•
Mandatory
: 1=true. This response is optional; the default is “0”. Bria handles the upgrade
differently depending on this response; see below.
•
version
: identifies a build stamp set by
Bria
during build time. Bria uses this version to
determine whether to prompt the user to install the upgrade; see “Handling of the Upgrade”,
below.
•
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 will recheck periodically for available upgrades.
Handling of the Upgrade
If an upgrade is available, Bria 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 does not prompt the user to download
•
If the response has the lower number, Bria does not prompt the user to download: downgrades are not
supported.
•
If the response has a higher number, Bria prompts the user to download the upgrade.
•
If the user initiates the download, Bria will download the installer and save it to the local Bria program
folder. Bria 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 will enter its timing cycle and display
the download prompt again at the appropriate time.
•
If the user declines a mandatory upgrade, Bria shuts down.
“Install Later” Handling
If the user declines to install the downloaded version, then the next time Bria 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 will install the new (local) version.
[DATA]
Success=0
<CRLF>
[DATA]
Success=1
Mandatory=1
version=60000
url=https://executableupgradeserver.com/newversion.exe
<CRLF>