Article ID: 8009
Reviewed: 2022-05-24

Product Version:
AhsayCBS: 8.1 to 8.x
OS: All platforms

How to install the latest patch set for AhsayCBS?

As of 2022-May-24, the current Version 8 public release is v8.7.0.0

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

How to install the latest stable patch release for AhsayCBS:

Important:

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

---

For AhsayCBS installation on Windows:

1. Download the upgrade executable file:
   
   
   • Stable patch release [Executable file for version 8.x.x.x upgrade to latest public release]:
     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. Installation is now complete.

Important:
Note that the indexing and file structure of backup data was redesigned since AhsayCBS version 7 (Click Here for more details). Backup data that were backup in the version 6 structure can be migrated to version 8. Please refer to the Data Migration chapter within the AhsayCBS Administrator's Guide for more details on the requirement, suggestion and limitation on data migration.

---

For AhsayCBS installation on Linux:

1. Download the upgrade tarball file:
   
   
   • Stable patch release [Tarball file for version 8.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, /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.

Important:
Note that the indexing and file structure of backup data was redesigned since AhsayCBS version 7 (Click Here for more details). Backup data that were backup in the version 6 structure can be migrated to version 8. Please refer to the Data Migration chapter within the AhsayCBS Administrator's Guide for more details on the requirement, suggestion and limitation on data migration.


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