[V9] FAQ: How to force another Auto Update on AhsayOBM / ACB clients
Article ID:
9309
Reviewed: 2022-01-17
Product Version:
AhsayACB / AhsayOBM: 9.1 to 9.x
OS: All platforms
Description
This document contains instruction on how to force another Auto Update on backup client agents when AhsayCBS remains the same version. This allows you to push updated client package without end-user interaction using Auto Update feature in AhsayCBS.
Example:
For example, your AhsayCBS currently runs on version 9.1.0.50, you have made some modification (e.g. branding changes) to the client application (version 9.1.0.50), and you need to ensure that the new updates are dispatched to the client software via Auto Update (AUA) without user interaction. Because the user's device already run v9.1.0.50 client, Auto Update will not further upgrade it as its version matches the CBS version, this FAQ will demonstrate how you can push a higher client AUA version, so the user's device will Auto Upgrade with your changes.
Requirements:
-
The Auto Update function has already been enabled on AhsayCBS.
-
The AhsayOBM / ACB user account is selected for Auto Update on AhsayCBS.
-
The AhsayOBM / ACB client machine must be powered on.
-
The AhsayOBM / ACB client machine must be connected to the internet.
-
The AhsayOBM / ACB scheduler services on the client machine must be running.
-
The AhsayOBM / ACB application GUI on the client machine must be closed.
-
The home.txt file on AhsayOBM / ACB client machine contains the correct path of the .obm or .acb folder.
- AhsayOBM on Linux/FreeBSD the RunConfigurator.sh script must closed.
- Antivirus or firewall must allow the updated application binary files to complete the download onto the AhsayOBM/ACB machine.
Limitations:
-
Auto Update is not supported for AhsayOBM installed on either Synology or QNAP NAS devices.
-
Auto Update is not supported for first-time client installation.
-
If a client device's Auto Update is not working (e.g. stuck on old client version), this FAQ is not for you. You should contact Ahsay Support for further troubleshooting, to determine why the device's Auto Update is not working.
Steps
To force another update to the AhsayOBM / ACB clients:
-
For backup purposes, create a duplicate copy of %CBS_HOME%\download\liveUpdate\index.xml
Example, C:\Program Files\AhsayCBS\download\liveUpdate\index.xml
-
Edit the "index.xml" file with a text editor.
-
For AhsayACB users, search for: <AutoUpdate product="acb" and modify "version=" then increment the "version" variable by one revision version. You may need to repeat the search and replace if the version you are modifying occurs more than once.
For example:
Assuming AhsayCBS is on 9.1.0.50, search for:
<AutoUpdate product="acb" version="9.1.0.50" compatible="9.x.x.x" host="" edition name="%ACB_FULL_NAME_SYSTEM%">
Increment the "version" variable "9.1.0.50" by one revision version to "9.1.0.51":
<AutoUpdate product="acb" version="9.1.0.51" compatible="9.x.x.x" host="" edition name="%ACB_FULL_NAME_SYSTEM%">
Important:
It is not recommend to repeatedly rebuild client and increment the version variable (e.g. continuously creating your own version), as the new "version number" that you have created may then be larger than the next official AhsayCBS release, which can cause future AUA upgrade problem.
Also, a sub-revision version (appending extra ".x"), such as "9.1.0.50.1" is invalid.
-
For AhsayOBM users, search for: <AutoUpdate product="obm" and modify "version=" then increment the "version" variable by one revision version. You may need to repeat the search and replace if the version you are modifying occurs more than once.
For example:
Assuming AhsayCBS is on 9.1.0.50, search for:
<AutoUpdate product="obm" version="9.1.0.50" compatible="9.x.x.x" host="" edition name="%OBM_FULL_NAME_SYSTEM%">
Increment the "version" variable "9.1.0.50" by one revision version to "9.1.0.51":
<AutoUpdate product="obm" version="9.1.0.51" compatible="9.x.x.x" host="" edition name="%OBM_FULL_NAME_SYSTEM%">
Important:
It is not recommended to repeatedly rebuild the client and increment the version variable (e.g. continuously creating your own version), as the new "version number" that you have created may then be larger than the next official AhsayCBS release, which can cause future AUA upgrade problem.
Also, a sub-revision version (appending extra ".x"), such as "9.1.0.50.1" is invalid.
-
Save the changes to the index.xml file.
-
Enable AUA for all backup users, or the individual user(s) that should receive this updated client version for (refer to the Auto Update section in the AhsayCBS Administrator's Guide for details).
-
Inform backup users to close their client user interface. The AUA cannot upgrade the client if the application user interface is opened.
-
Within the next 15-minutes, the v9 client's AUA service will automatically check if the "index.xml" version number is greater than the installed version. If yes, the client will perform an auto update. The client upgrade will download the changed binaries, depending on network speeds, the installation process may take another 30-minutes.
Note:
The client version reported from the software, after an update will remain as the true client version (e.g. the official Ahsay release version), and not of the new "version" value created by following this FAQ.
Keywords
force, aua, autoupdate, update, upgrade, autoupgrade, autoupdateagent, autoupgradeagent