AhsayCBS Hotfix Installation Guide

AhsayCBS Hotfix Installation Guide

Article ID
5009
Last Reviewed Date
Product Version
AhsayCBS: 7.5 or above
Operating System
All Platforms
Description

This Know-How article discusses how to apply hotfix to AhsayCBS.

Requirements

You can only apply the hotfix to machines running AhsayCBS version that the hotfix is based on.

Inappropriately installing hotfix not for your base AhsayCBS version may have unexpected results.

The information can be found on the Hotfix Release History page:

The instructions provided are for default Ahsay branding and default paths. If your software is branded or uses custom paths, substitute with your customized name or path.

For branded CBS, installing CBS hotfix does not require Rebuild Client as branding is not affected unless you upgraded to new Base version just before applying CBS hotfix and had not yet performed Rebuild Client for the Base release.
Solution
  • Windows / Linux
  • AhsayUBS
Hotfix installation instructions for AhsayCBS on Windows/Linux OS

  1. Download the required hotfix directly provided to you or from the Hotfix Release History page: (v7 | v8 | v9)

    Examples:

    • cbs-win-hotfix-task12345.zip
    • cbs-win-v830999.zip
    • cbs-nix-v9720.zip

  2. Unzip the downloaded ZIP package to a temporary directory. The contents will only include relevant files necessary for the hotfix, it will not contain files that are expected to already be on your server.

    Example: Unzipped contains directories build, download, java, lib, webapps

    The contents of hotfix ZIP are subject to change and directories may differ than listed in this article.

  3. Create a rollback copy of those directories before applying the hotfix.

    Based on the directories you unzipped in step 2, create a duplicate of those current directories found in your AhsayCBS installation home (i.e. "C:\Program Files\AhsayCBS" or "/usr/local/cbs"). For identification, we recommend you append suffix of ".{version#}" for your current AhsayCBS version, to the copied directory name.

    Example, your AhsayCBS is currently v8.3.0.30, you will create a copy of those directories the hotfix will overwrite:

    • Copy "C:\Program Files\AhsayCBS\build" to "C:\Program Files\AhsayCBS\build.83030"

    • Copy "C:\Program Files\AhsayCBS\download" to "C:\Program Files\AhsayCBS\download.83030"

    • Copy "C:\Program Files\AhsayCBS\java" to "C:\Program Files\AhsayCBS\java.83030"

    • Copy "C:\Program Files\AhsayCBS\lib" to "C:\Program Files\AhsayCBS\lib.83030"

    • Copy "C:\Program Files\AhsayCBS\webapps" to "C:\Program Files\AhsayCBS\webapps.83030"

    For custom installations, substitute the above with your correct drive, path or directory name.

  4. Before shutting down AhsayCBS and installing the hotfix, verify that there are no active jobs.

    Login to AhsayCBS Web Console then click Live Activities.
  5. (Optional)) It is good practice to disable AUA (via AhsayCBS UI) for each user before updating AhsayCBS.

  6. Shutdown the AhsayCBS service by:

    • Windows

      1. Control Panel > Administrative Tools > Services > Ahsay Cloud Backup Suite > Stop
      2. Control Panel > Administrative Tools > Services > Ahsay Cloud Backup Suite NFS Service > Stop

    • Linux/FreeBSD

      1. Run the script file at %CBS_Install_Home%/bin/shutdown.sh to shutdown the AhsayCBS service (e.g. /usr/local/cbs/bin/shutdown.sh)

      2. Run the script file at %CBS_Install_Home%/nfs/bin/shutdown.sh to shutdown the AhsayCBS NFS service (e.g. /usr/local/cbs/nfs/bin/shutdown.sh)

    • For Branded products, substitute with your customized name for AhsayCBS.

  7. Install the hotfix files:

    • Windows

      Copy those unzipped directories from step 2 to your AhsayCBS Installation Home path (e.g. C:\Program Files\AhsayCBS)

    • Linux/FreeBSD

      Copy those unzipped directories from step 2 to your AhsayCBS Installation Home path (e.g. /usr/local/cbs)
    • Extract all files within the zip archive to their path locations as in the zip archive (DO NOT remove any file from the AhsayCBS installation directory, only overwrite existing files when necessary) For example, copy the file "lib\cbs.jar" (extracted from the ZIP download) to "C:\Program Files\AhsayCBS\lib\cbs.jar".
    • You should not install a hotfix version that is lower than your current AhsayCBS version.

  8. Startup the AhsayCBS service by:

    • Windows

      1. Control Panel > Administrative Tools > Services > Ahsay Cloud Backup Suite > Start
      2. Control Panel > Administrative Tools > Services > Ahsay Cloud Backup Suite NFS Service > Start

    • Linux/FreeBSD

      1. Run the script file at %CBS_Install_Home%/bin/startup.sh to startup the AhsayCBS service (e.g. /usr/local/cbs/bin/startup.sh)

      2. Run the script file at %CBS_Install_Home%/nfs/bin/startup.sh to startup the AhsayCBS NFS service (e.g. /usr/local/cbs/nfs/bin/startup.sh)

    • For Branded products, substitute with your customized name for AhsayCBS.
  9. Installation is now complete.
  10. Login to your AhsayCBS web management console and go to System Settings > License > Update License to verify the Product Version.
Hotfix installation instructions for AhsayCBS on AhsayUBS

Before proceeding, you should be comfortable with Command-Line Interface and have familiarity with *nix shell. Otherwise, you may want to consult with your IT before proceeding.

  1. Enable SSH (if not already enabled).

    1. Login to AhsayUBS admin web console.
    2. Enable SSH by clicking the Start button on System > Settings > SSHD page.

  2. Connect to your AhsayUBS via SSH terminal, using your AhsayUBS admin credentials.

    The credentials is not your AhsayCBS web console login.

  3. Create a temporary directory on your AhsayUBS volume for the hotfix download.

    Example, create a directory on the /ubs/mnt/eslsfw volume.

    mkdir /ubs/mnt/eslsfw/obsr/HOTFIX

  4. For the hotfix version you will download, create a sub-directory within the temporary directory.

    Example, if you are downloading hotfix v9.8.5.1.

    mkdir "/ubs/mnt/eslsfw/obsr/HOTFIX/HF9851"

  5. Change directory to the temporary directory.

    cd "/ubs/mnt/eslsfw/obsr/HOTFIX"

  6. Download the hotfix using the Unix command, "fetch".

    Recall the URL of the required hotfix directly provided to you from the Hotfix Release History page: (v7 | v8 | v9)

    Replace below syntax with the URL of the hotfix download.

    fetch http://host.domain.com/path/path2/file.zip

  7. After successful download, unzip the downloaded ZIP file using the Unix command, "unzip". Destination will be the hotfix sub-directory. You should list the contents afterwards.

    Example, unzipped contains directories: build, lib, webapps

    unzip -n *.zip -d /ubs/mnt/eslsfw/obsr/HOTFIX/HF9851
    The contents of hotfix ZIP are subject to change and directories may differ than listed in this article.

  8. Before shutting down AhsayCBS and installing the hotfix, verify that there are no active jobs.

    Login to AhsayCBS Web Console, click Live Activities.
  9. (Optional)) It is good practice to disable AUA (via AhsayCBS UI) for each user before updating AhsayCBS.
  10. Login to AhsayUBS admin web console.

  11. Shutdown the AhsayCBS service by:

    1. Click the Stop button on Backup Server > Server Status page.
    2. Click the Stop button on Backup Server > Server Status page in the "NFS Service" section.

  12. Grant write permission for the related AhsayCBS server files:

    mount -uw /ubs/mnt/esfmfw

  13. For each unzipped hotfix directory, create a rollback copy of your current AhsayCBS directories before applying the hotfix.

    Based on the directories unzipped from step 7, create a duplicate of those current directories found in your AhsayCBS installation home (i.e. "/ubs/mnt/esfmfw/obsr/system/obsr/"). For identification, we recommend you append suffix of ".{version#}" for your current AhsayCBS version, to the copied directory name.

    Example, your AhsayCBS is currently v8.3.0.30, you will create a complete copy of those directories the hotfix will overwrite. In the below example, we are writing to /ubs/mnt/eslsfw.

    cp -R /ubs/mnt/esfmfw/obsr/system/obsr/build "/ubs/mnt/eslsfw/obsr/HOTFIX/build.83030"
cp -R /ubs/mnt/esfmfw/obsr/system/obsr/lib "/ubs/mnt/eslsfw/obsr/HOTFIX/lib.83030"
cp -R /ubs/mnt/esfmfw/obsr/system/obsr/webapps "/ubs/mnt/eslsfw/obsr/HOTFIX/webapps.83030"
    The contents of hotfix ZIP are subject to change and directories may differ than listed in this article.

  14. To install the hotfix, copy the hotfix files to the correct location.

    Example:

    cp -Rfvp /ubs/mnt/eslsfw/obsr/HOTFIX/HF9851/ /ubs/mnt/esfmfw/obsr/system/obsr
    You should not install a hotfix version lower than your current AhsayCBS version.
  15. Reboot the AhsayUBS machine afterwards via the AhsayUBS admin web console.
  16. Once AhsayUBS has booted, return to the AhsayUBS admin web console and Disable SSH.

  17. Check if AhsayCBS Service has started. If not running, click on Start.

    Check the Status on Backup Server > Server Status page.
  18. Login to your AhsayCBS web management console and go to System Settings > License > Update License to verify the Product Version.

  19. If you need to reclaim space and have no further need for the rollback copies, you can remove the temporary directory afterward:

    rm -fr /ubs/mnt/eslsfw/obsr/HOTFIX/
    Before you deploy newer AhsayUBS image, you should remove this temporary directory.