Manually Trigger Auto Updates for AhsayOBM/AhsayACB

Article ID

5039

Last Reviewed Date

Product Version

AhsayACB / AhsayOBM: 8.1 or above

Operating System

All Platforms

Description

This Know-How article contains instructions 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

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 AhsayCBS version.

This article will discuss the steps how to push a higher client AUA version, so the user's device will Auto Upgrade with the changes.

Requirements:

  • The Auto Update function has already been enabled on AhsayCBS.
  • The AhsayOBM / AhsayACB user account is selected for Auto Update on AhsayCBS.
  • The AhsayOBM / AhsayACB client machine must be powered on.
  • The AhsayOBM / AhsayACB client machine must be connected to the Internet.
  • The AhsayOBM / AhsayACB scheduler services on the client machine must be running.
  • The AhsayOBM / AhsayACB application GUI on the client machine must be closed.
  • The home.txt file on AhsayOBM / AhsayACB client machine contains the correct path of the .obm or .acb folder.
  • The RunConfigurator.sh script must be closed for AhsayOBM on Linux/FreeBSD.
  • Antivirus or firewall must allow the updated application binary files to complete the download onto the AhsayOBM / AhsayACB machine.

Limitations:

  • 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 article is not for you. You should contact Ahsay Support for further troubleshooting, to determine why the device's Auto Update is not working.

Solution

To force another update to the AhsayOBM / AhsayACB clients:

  1. For backup purposes, create a duplicate copy of %AhsayCBS_Home%\download\liveUpdate\index.xml.

  2. Edit the "index.xml" file with a text editor.

  3. Search for AutoUpdate product="%productname%" and modify the version="version_no" by incrementing 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.

    Example:

    Assuming AhsayCBS is on 9.1.0.50, search for:

    AhsayACB users

    AutoUpdate product="acb" version="9.1.0.50" compatible="9.x.x.x" host="" edition name="AhsayACB_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="AhsayACB_FULL_NAME_SYSTEM"

    AhsayOBM users

    AutoUpdate product="obm" version="9.1.0.50" compatible="9.x.x.x" host="" edition name="AhsayOBM_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="AhsayOBM_FULL_NAME_SYSTEM"

    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.

  4. Save the changes to the index.xml file.
  5. Enable AUA for all backup users, or the individual user(s) that should receive the updated client version for. Refer to the Auto Update section in the AhsayCBS Administrator - Backup / Restore Guide.
  6. Inform backup users to close their client user interface. The AUA cannot upgrade the client if the application user interface is open.

  7. Within the next 15 minutes, the 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.

    The client version reported from the software, after an upgrade 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 article.