User Tools

Site Tools


Sidebar

Announcement

Ahsay Backup Software

Backup Set Types

Supported Storage

Features in OBM / ACB

Features in CBS

Brand and Customize

License

Documentation

Performance Testing

FAQs and Known Issues

Can't Find What You Need?

public:version_9:start_here:9010_how_to_install_the_latest_patch_set_for_ahsaycbs

[V9] FAQ: How to install the latest v9 release for AhsayCBS?

Article ID: 9010
Reviewed: 2022-05-06

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

Description

How to install the latest public release for AhsayCBS v9?

As of 2022-May-06, the current Version 9 public release is v9.1.4.0

Steps

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:

Important:

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


Instructions for AhsayCBS installation on Windows

For AhsayCBS installation on Windows:

  1. 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)

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

  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.





Instructions for AhsayCBS installation on Linux

For AhsayCBS installation on Linux:

  1. 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, /var/tmp)

  2. Shutdown the AhsayCBS service:

    # cd /usr/local/cbs/bin
    # sh shutdown.sh
  3. 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
  4. 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
  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.





Last Step: Prepare Branded 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 branded installation ]
      • Login to the AhsayCBS console
      • Under [System Settings], select [Basic] > [Administrative Access] > [${system_account}]
        NOTE: You'll need to return and repeat these steps if you have additional branded Sub Admin accounts.
      • Under [Rebrand Clients], review your customization properties and graphics. If you made any changes, you'll need to Save through to the CBS main menu, then return back here before continuing with these steps.
      • 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. Continue to check that Auto Update is enabled per Backup User account.

  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.



Keywords

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

public/version_9/start_here/9010_how_to_install_the_latest_patch_set_for_ahsaycbs.txt · Last modified: 2022/05/06 10:05 by kirk.lim