===== [V9] FAQ: How to install the latest v9 release for AhsayCBS? ===== Article ID: 9010
Reviewed: 2022-11-09

Product Version:
AhsayCBS: 9.1.0.0 to 9.x
OS: Windows, Linux ===== Description ===== How to install the latest public release for AhsayCBS v9?

As of 2023-March-20, the current Version 9 public release is v9.5.4.0 ===== Steps ===== This document contains simple instructions of how to upgrade your AhsayCBS server to the latest public release. If you require full details, you should reference the AhsayCBS Upgrade Guide instead.

Table of Contents:

Preparing to install the latest stable AhsayCBS release:

Important:
==== Instructions for AhsayCBS installation on Windows ==== For AhsayCBS installation on Windows:

  1. From AhsayCBS web console, Disable Auto Update Agent (AUA) for all users. This prevents any unintentional client upgrades until you have had chance to do a post-upgrade checkup.

  2. Download the upgrade executable file:

    • Stable patch release [Executable file for version 9.x.x.x upgrade to latest public release]:
      cbs-win.exe (refer to the Release Notes for more details on the release)

  3. Shutdown the AhsayCBS service:
    [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite ] > [ Stop ]
    [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ NFS Service ] > [ Stop ]

  4. Remove the [ Installers ] folder at %CBSHOMEPATH%\system\cbs\Installers
    (Example: C:\Program Files\AhsayCBS\system\cbs\Installers\)

    Note: This is where Branded Installers are stored. If you are not branded, you can skip this step.

  5. Double-click the cbs-win.exe file to start the AhsayCBS Setup Wizard.

  6. Click [Yes] when prompted to migrate the previous configuration to the new server:



  7. Continue to the next steps with the information provided in the AhsayCBS Setup Wizard.

  8. Installation is now complete.

  9. Prepare the Client Agent: How to auto update all AhsayOBM / ACB client agents




==== Instructions for AhsayCBS installation on Linux ==== For AhsayCBS installation on Linux:

  1. From AhsayCBS web console, Disable Auto Update Agent (AUA) for all users. This prevents any unintentional client upgrades until you have had chance to do a post-upgrade checkup.

  2. Download the upgrade tarball file:

    • Stable patch release [Tarball file for version 9.x.x.x upgrade to latest public release]:
      cbs-nix.tar.gz (refer to the Release Notes for more details on the release)

    Make note which directory you saved it to (Example used in this article, /var/tmp)

  3. Shutdown the AhsayCBS service:

    # cd /usr/local/cbs/bin
    # sh shutdown.sh
  4. Remove the [ Installers ] folder at $CBSHOMEPATH/system/cbs/Installers :

    Note: This is where Branded Installers are stored. If you are not branded, you can skip this step.

    # cd /usr/local/cbs/system/cbs
    # rm -rf Installers
  5. Rename the existing installation folder: (where "versionnumber" corresponds to your current AhsayCBS version prior to upgrading. For example, if you are currently on AhsayCBS v9.1.0.50, then rename the folder to "/usr/local/cbs.91050")

    # mv /usr/local/cbs /usr/local/cbs.versionnumber
  6. Extract the cbs-nix.tar.gz file to the installation directory:

    # mkdir /usr/local/cbs
    # cp /var/tmp/cbs-nix.tar.gz /usr/local/cbs
    # cd /usr/local/cbs
    # gunzip cbs-nix.tar.gz
    # tar -xf cbs-nix.tar
  7. Copy the configuration , logs , and system home directories , and the user directory (if kept in CBS Home path) over from the original CBS home:
    NOTE: A 'copy' will consume extra space but is recommended in case you need to revert your CBS upgrade back to the previous version. As the newer version may have converted configuration settings, it is not recommended to revert an already upgraded conf.

    # cd /usr/local/cbs
    # cp -R /usr/local/cbs.version#/conf .
    # cp -R /usr/local/cbs.version#/logs .
    # cp -R /usr/local/cbs.version#/system .
    # cp -R /usr/local/cbs.version#/user .
    Before performing the 'copy', check that you have enough free space for the copy to successfully complete. If you are low on space, you may want to 'move' instead. Consult with your Linux Administrator if you are unsure.

  8. Startup the AhsayCBS service by:

    # cd /usr/local/cbs/bin
    # sh startup.sh
  9. Installation is now complete.

  10. Prepare the Client Agent: How to auto update all AhsayOBM / ACB client agents




==== Last Step: Prepare Branded Client Agents ==== How to auto update all AhsayOBM / ACB client agents:

To auto update all AhsayOBM / AhsayACB client agents, perform the following steps:

  1. Prepare the live update files:

    • [ For default installation (non-branded) ]
      • The live update files are already bundled and included after the AhsayCBS upgrade. Continue to next step and check that Auto Update is enabled per Backup User account.

    • [ For branded installation ]
        1. Login to the AhsayCBS console
        2. Under [System Settings], select [Basic] > [Administrative Access] > choose a [{system_account}]
          NOTE: You'll need to return and repeat these steps if you have additional branded Sub Admin accounts.
        3. Under [Rebrand Clients], review your customization properties and graphics , ensure no changes are necessary. Repeat for the other branded Sub Admin users.
        4. If you made any changes, you'll need to Save through to the CBS main menu: Click [OK], then [Save]
        5. Once you have confirmed each branding is correct, return to the [Administrative Access] page, within the Manage System User section is "View" (right-side). Click "View" and select [Build].
        6. Click on the checkboxes for each of the System User(s) you want to Rebuild Client.
        7. Once marked, click on the hammer-icon ("Build Branded Client"). The process will soon begin to upload the branding properties to Ahsay Customization Portal and begin the build. You should be patient as each client build may take 15-minutes, plus additional time necessary to download from Ahsay to your CBS server (estimate 30-60 minutes to fully complete). It is expected that the build queue can be in excess of 90-minutes if a new release was just made available.

  2. Enable the Auto Update feature on the AhsayCBS server. Please refer to the How to enable AUA chapter within the AhsayCBS Administrator's Guide for more information.



===== Keywords ===== cbs, obs, rdr, rps, Upgrade, Patch, Hot-fix, Hotfix, Fix, Bug, Update, upgrade