Skip to main content

Please use the following steps on How to force another Auto Update on AhsayOBM / AhsayACB clients.

This contains instructions on how to force another Auto Update on backup client agents when AhsayCBS remains the same version. This allows you to push the updated client package without end-user interaction using Auto Update feation in AhsayCBS.

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 to 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), you should contact Ahsay Support for the 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 the index.xml file.
    %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 version revision. 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)
    For AhsayACB users:
    • Search for AutoUpdate product="acb"
    • Increment the version variable 9.1.0.50 by one revision version to 9.1.0.51
    For AhsayOBM users:
    • Search for AutoUpdate product="obm"
    • Increment the version variable 9.1.0.50 by one revision version to 9.1.0.51

    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.

  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.

Note:

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.