Skip to main content

Upgrade Procedure for Windows using Executable File

The following steps refer to AhsayCBS with Standard installation. Substitute our default path with your custom installation path.

If you are using OEM version (branded installation), your Service name and/or path name may be unique than shown in our guide, substitute for your environment.

For branded environments, you may use the Ahsay public release download to upgrade your branded AhsayCBS. The cbs-win.exe installer will preserve your branding upon upgrade, however the Windows Service name may revert. As a precaution, you should export a copy of each of your Branding JSON for “admin” and any primary “sub-admin” account. After you have upgraded the server, you are required to Rebuild Client for “admin” and each primary “sub-admin” account, before the new client is available for download or AUA.

  1. Download the AhsayCBS executable (cbs-win.exe) from the Ahsay website.
  2. Logon with Windows administrator privileges (i.e. administrator).
  3. Stop the AhsayCBS service from the Services management console, this can be reached from Control Panel > Administrative Tools > Services > Ahsay Cloud Backup Suite. Click the Stop button on the left as highlighted.

    AhsayCBS Services

  4. Remove the folder C:\Program Files\AhsayCBS\system\cbs\Installers.

    • This contains Branded installers, which will be out of date upon AhsayCBS upgrade.
    • You can skip this step if you are unbranded.
  5. Double-click the downloaded cbs-win.exe to start the AhsayCBS setup wizard.
  6. Select the language to use during the installation from the dropdown box and click on OK.
  7. The installer will detect there is already an AhsayCBS installed, click on Yes to migrate the settings from your existing installation to the new installation.

    Existing AhsayCBS Installation Detected

  8. A welcome screen will be shown, please click the Next button to go to the next step.
  9. On the next screen, it will prompt the license agreement window. After you have read the terms and conditions, choose I accept the agreement and click the Next button to proceed.
  10. The system will check the validity of your maintenance license before proceeding with the installation. Click Next to continue.

    Before upgrading to the latest version of AhsayCBS make sure that your license key has a valid support maintenance otherwise installation will fail. You will receive the following messages if you have an expired maintenance license.

    Expired Maintenance License

    License Information

    Exit Setup

  11. Select/deselect the options according to your preferences and click the Next button.
  12. The next screen will provide a summary detail of the options selected. Please verify the installation options. If they are correct, click the Install button to begin the installation.
  13. Wait until the upgrade process is completed. The installer will expand the installation files to the AhsayCBS installation folder and it should take a few moments. The installation will reuse the same installation folder path.
  14. Start up the service from the Services management console, Control Panel > Administrative Tools > Services > Ahsay Cloud Backup Suite. Click the Start button to start the service.
  15. The AhsayCBS service is now starting up. Check that it indeed shows Started.
  16. You can open the following log files to check if there are any errors during the startup located in the %AhsayCBS_HOME%\logs folder:

    yyyy-mm-dd refers to the upgrade date.
    • catalina_yyyy-mm-dd.log
    • console_yyyy-mm-dd.log
    • obs_context_yyyy-mm-dd.log
  17. Logon to the AhsayCBS web management console and do a post-upgrade check.
  18. Here is a list of suggested items to check after you started up your AhsayCBS.
    • Check "Host Name" is valid and represents the Fully Qualified Domain Name (FQDN) of your AhsayCBS server for which this installation was installed onto. You may find it in AhsayCBS web console System Settings > Basic > General > Host.
    • Check SMTP settings in AhsayCBS web console System Settings > Basic > Email.
    • Check all users’ profile, backup and policy group settings in AhsayCBS web console Backup/Restore > Users, Groups & Policies.
    • Recommended for branded servers; check each user’s Auto Update setting is disabled. This will allow you time to verify branding and Rebuild Client, as required.
    • Check AhsayCBS License page, there are no negative usages.
    • Check HTTPS connection to the AhsayCBS on different browsers (Safari, Firefox and Chrome). Verify webpage loads.
    • Check each client Download link is not outdated. Please refer to this article on how to resolve this.
    • Connect from any AhsayOBM/AhsayACB to AhsayCBS to verify clients can connect.

For OEM (branded) version, please refer to the Branding section to generate new installers.

When you confirmed the settings are fine, then enable Auto Update via the AhsayCBS interface.

If you had globally disabled AUA (pre-upgrade step 4), you can reenable the client auto update by renaming the index.xml.disable file in %CBS_HOME%/download/liveUpdate/ to index.xml.

If your previous AhsayCBS version was v8.5.0.126 or earlier, and you just upgraded to a newer version for the first time, then you should review %CBS_INSTALL_PATH%/logs/retention-policy-reset.log.

This is in response to Critical Issue with AhsayCBS v8 web console update of retention policy settings.

The advisory and the fix, applies to the first AhsayCBS upgrade when you upgrade from pre-v8.5.0.127. If you have upgraded AhsayCBS several times since pre-v8.5.0.127, then the retention-policy-reset.log might have been archived and no longer found in the logs path.