How to Install Latest AhsayCBS Release

Preparing to install the latest stable AhsayCBS release

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 the chance to do a post-upgrade checkup.

2. Download the upgrade executable file from the Ahsay download page. Go to Ahsay Backup Software (DIY) > AhsayCBS, then click Download under Windows.

   

   Stable patch 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 %AhsayCBS_Home_Path%\system\cbs\Installers.

   Example: C:\Program Files\AhsayCBS\system\cbs\Installer

   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, refer to How to auto update all AhsayOBM / AhsayACB client agents.

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 the chance to do a post-upgrade checkup.

2. Download the upgrade tarball file from the Ahsay download page. Go to Ahsay Backup Software (DIY) > AhsayCBS, then click Download under Linux / FreeBSD.

   

   Stable patch release: cbs-nix.tar.gz (refer to the Release Notes for more details on the release)

3. Shutdown the AhsayCBS service:

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

4. Remove the Installers folder at $AhsayCBS_Home_Path/system/cbs/Installers:

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

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

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 /vartmp/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, system home directories and the user directory (if kept in the AhsayCBS Home path) over from the original AhsayCBS Home:

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

   A 'copy' will consume extra space but is recommended in case you need to revert your AhsayCBS 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.

8. Startup the AhsayCBS service by:

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

9. Installation is now complete.
10. Prepare the Client Agent, refer to How to auto update all AhsayOBM / AhsayACB client agents.

How to auto update all AhsayOBM / AhsayACB 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 the next step and check that Auto Update is enabled per backup user account.

   • For branded installation

     1. Login to the AhsayCBS web console.

     2. Under System Settings, select Basic > Administrative Access > %system_user_account%

        You will 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 needed. Repeat for other branded Sub Admin users.
     4. If you made any changes, you will need to Save through the AhsayCBS 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". Click on the drop-down arrow and select Build.
     6. Click on the checkbox(es) beside the system user you want to Rebuild Client.
     7. Once done with the selection, click 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 is needed to download from Ahsay to your AhsayCBS server (estimate 30-60 minutes to fully complete). It is expected that the build queue can be in excess of 90 minutes if new release was just made available.
2. Enable the Auto Update feature on the AhsayCBS server. Please refer to the Auto Update discussion in the AhsayCBS Administrator - Backup/Restore Guide for more information.