Article ID: 8009
Reviewed: 16/08/2021

Product Version:
AhsayCBS: 8.1 or above
OS: All platforms

How to install the latest patch set for AhsayCBS?

This document contains the information of how to upgrade your AhsayCBS server to the latest stable patch release.

Table of Contents:

• How to install the latest stable patch release for AhsayCBS
  • Installation on Windows
  • Installation on Linux
• How to auto update all AhsayOBM / ACB client agents

• Please read the Release Notes before applying the patch.
  
• For branded / customized AhsayCBS installation, it is recommended to first create an export JSON of your branding properties before upgrading.
  
• Although the branding, SSL cert, and other configuration settings of your existing AhsayCBS server will be carried over after the upgrade. In branded environments, the AhsayOBM / AhsayACB client installers will need to be rebuilt before they are updated to the latest release version. Therefore, it is recommended that the auto upgrade (AUA) feature is disabled for all backup users before starting the AhsayCBS upgrade process. Please refer to Chapter 10 of our AhsayCBS Administrator's Guide for more details on branding.
  
• For environment with AhsayPRD (multiple AhsayCBS instances on a single backup server), contact Technical Support to request for the cbs-win.zip package.
  
• When upgrading an older release, for example 6.27.0.0, before proceeding with the upgrade, please refer to the upgrade instruction provided in Chapter 4 of our Ahsay Backup Software Upgrade Guide instead of the instructions below.

1. Download the upgrade executable file:
   
   
   • Stable patch release [Executable file for version 8.x.x.x upgrade to 8.5.2.106]:
     cbs-win.exe (refer to the Release Notes for more details on the release)
   
   
2. Shutdown the AhsayCBS service:
   [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite ] > [ Stop ]
   [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ NFS Service ] > [ Stop ]
   
   
3. Remove the [ Installers ] folder at - ${CBS_Install-Home}\system\cbs\Installers
   
   
4. Double-click the cbs-win.exe file to start the AhsayCBS Setup Wizard.
   
   
5. Click [Yes] when prompted to migrate the previous configuration to the new server:
   
   
   
   
6. Continue to the next steps with the information provided in the AhsayCBS Setup Wizard.
   
   
7. Ensure that [Migrate Previous Configuration] is enabled before proceeding:
   
   
   
   
8. Installation is now complete.

1. Download the upgrade tarball file:
   
   
   • Stable patch release [Tarball file for version 8.x.x.x upgrade to 8.5.2.106]:
     cbs-nix.tar.gz (refer to the Release Notes for more details on the release)
   
   Make note which directory you saved it to (Example, /var/tmp)
   
   
2. Shutdown the AhsayCBS service:
   
   

   # cd /usr/local/cbs/bin # sh shutdown.sh

3. Remove the [ Installers ] folder at - ${CBS_Install-Home}/system/cbs/Installers:
   
   

   # cd /usr/local/cbs/system/cbs # rm -rf Installers

4. Rename the existing installation folder: (where "version#" corresponds to your current AhsayCBS version prior to upgrading. For example, if you are currently on AhsayCBS v8.1.1.50, then rename the folder to "/usr/local/cbs.81150")
   
   

   # mv /usr/local/cbs /usr/local/cbs.version#

5. 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

6. Copy the configuration folder, log folder, system home and user home from the backup copy:
   
   

   # 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 .

7. Startup the AhsayCBS service by:
   
   

   # cd /usr/local/cbs/bin # sh startup.sh

8. Installation is now complete.

1. Prepare the live update files:
   
   
   • [ For branded installation ]
     
     • Login to the AhsayCBS console
     • Under [System Settings], select [Basic] > [Administrative Access] > [${system_account}]
     • Customize the branding information under [Rebrand Clients]
     • Click [OK], then [Save]
     • Press the [Build Branded Client] button to rebuild the client installation file and live update files
   • [ For default installation ]
     
     • The live update files are ready after the AhsayCBS upgrade
   
   
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.

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