Article ID: 9010
Reviewed: 2022-11-09

Product Version:
AhsayCBS: 9.1.0.0 to 9.x
OS: Windows, Linux

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

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
  • Installation on Windows
  • Installation on Linux
• How to auto update all AhsayOBM / ACB client agents

• Read the Release Notes before applying the latest AhsayCBS version.
  
• Review the AhsayCBS v9 New Features and DataSheet, or if You are New to AhsayCBS 9.
  
• 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 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.
  
• Upgrading from AhsayOBS v6.x? Stop. Before proceeding with the upgrade, please refer to the upgrade instruction provided in Best Practice for AhsayOBS to AhsayCBS Upgrade and Data Migration instead of the instructions below.

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

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

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.

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