Article ID:
5145
Reviewed:
2019-04-15
Reviewed:
2022-01-26
Product Version:
AhsayCBS: 7.3.2.0 to 7.x
OS: All platforms
ATTENTION
1st January, 2022: v7 officially End-of-Life [details]
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:
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 our AhsayCBS Administrator's Guide for more details on branding.
-
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 / Migration Guide instead of the instructions below.
For AhsayCBS installation on Windows:
-
Download the upgrade executable file:
-
Stable patch release (7.x.x.0) [Executable file for version 7.x.x.x upgrade to 7.17.2.2]:
cbs-win.exe
(refer to the
Release Notes for more details on the release)
-
Shutdown the AhsayCBS service:
[ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite ] > [ Stop ]
[ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite NFS Service ] > [ Stop ] (AhsayCBS version 7.9.0.0 or above)
-
Remove the [ Installers ] folder at -
${CBS_Install-Home}\system\cbs\Installers
-
Double-click the cbs-win.exe file to start the AhsayCBS Setup Wizard.
-
Click [Yes] when prompted to migrate the previous configuration to the new server:
-
Continue to the next steps with the information provided in the AhsayCBS Setup Wizard.
-
Ensure that [Migrate Previous Configuration] is enabled before proceeding:
-
Installation is now complete.
Important:
Note that the indexing and file structure of backup data was redesigned for AhsayCBS version 7 (
Click Here
for more details).
Backup data that were backup in version 6 structure can be migrated to version 7 structure with AhsayCBS version 7.7.0.0 or above.
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:
-
Download the upgrade tarball file:
-
Stable patch release (7.x.x.0) [Tarball file for version 7.x.x.x upgrade to 7.17.2.2]:
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)
-
Shutdown the AhsayCBS service:
# cd /usr/local/cbs/bin
# sh shutdown.sh
|
-
Remove the [ Installers ] folder at - ${CBS_Install-Home}/system/cbs/Installers:
# cd /usr/local/cbs/system/cbs
# rm -rf Installers
|
-
Rename the existing installation folder:
# mv /usr/local/cbs /usr/local/cbs_bak
|
-
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
|
-
Copy the configuration folder, log folder, system home and user home from the backup copy:
# cd /usr/local/cbs
# cp -R /usr/local/cbs_bak/conf .
# cp -R /usr/local/cbs_bak/logs .
# cp -R /usr/local/cbs_bak/system .
# cp -R /usr/local/cbs_bak/user .
|
-
Startup the AhsayCBS service by:
# cd /usr/local/cbs/bin
# sh startup.sh
|
-
Installation is now complete.
Important:
Note that the indexing and file structure of backup data was redesigned for AhsayCBS version 7 (
Click Here
for more details).
Backup data that were backup in version 6 structure can be migrated to version 7 structure with AhsayCBS version 7.7.0.0 or above.
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:
-
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
-
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