AhsayACB / AhsayOBM Hotfix Installation Guide

Article ID

5003

Last Reviewed Date

Product Version

AhsayACB / AhsayOBM: 7.5 or above

Operating System

All Platforms

Description

This Know-How article contains information on how to apply a hotfix to your AhsayOBM or AhsayACB client.

Solution

  • AhsayACB
  • AhsayOBM
  • SynologyNAS - AhsayOBM
  • QNAPNAS - AhsayOBM

Hotfix installation instructions for AhsayACB

  1. Download the required Hotfix from the Hotfix Release Page.

    Alternatively, if you were provided with a specific Hotfix to correct an issue, use that download instead.

  2. Make sure no backup or restore job is in progress. Close the AhsayACB GUI Windows if it is open.

  3. Shutdown the backup client service by:

    • Windows

      Control Panel > Administrative Tools > Services > Ahsay A-Click Backup Services > Stop

    • macOS

      Run the script file at /Applications/AhsayACB/bin/StopScheduler.sh

  4. (For Windows Only) Close the AhsayACB system tray icon.

  5. Install the Hotfix Files:

    • Windows

      Expand the contents of the downloaded hotfix zip into AhsayACB Installation Home path (e.g. C:\Program Files\AhsayACB)

    • macOS

      Expand the contents of the downloaded hotfix zip into AhsayACB Installation Home path (e.g. /Applications/AhsayACB)

    Extract contents of zip download, keeping the same directory structure, overwrite the contents (existing files) in your AhsayACB installation path. For example, extract the file “bin\obc.jar” (inside the zip download) to “C:\Program Files\AhsayACB\bin\obc.jar”

    In case you need to rollback, to undo the hotfix patch, make a full copy of the AhsayACB Installation directory prior to overwriting files.

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

  6. Restart the backup client service by:

    • Windows

      Control Panel > Administrative Tools > Services > Ahsay A-Click Backup Services > Start

    • macOS

      Run the script file at /Applications/AhsayACB/bin/Scheduler.sh

  7. Installation is now complete.

Hotfix installation instructions for AhsayOBM

  1. Download the required Hotfix from the Hotfix Release Page.

    Alternatively, if you were provided with a specific Hotfix to correct an issue, use that download instead.

  2. Make sure no backup or restore job is in progress. Close the AhsayOBM GUI window if it is open.

  3. Shutdown the backup client service by:

    • Windows

      1. Control Panel > Administrative Tools > Services > Ahsay Online Backup Manager Services > Stop

      2. Control Panel > Administrative Tools > Services > NFS Service (Ahsay Systems Corporation) > Stop

      3. (If applicable) Control Panel > Administrative Tools > Services > CBT Cluster Services (Ahsay Online Backup Manager) > Stop

    • macOS

      Run the script file at /Applications/AhsayOBM/bin/StopScheduler.sh

    • Linux/FreeBSD

      Run the script file at /usr/local/obm/bin/StopScheduler.sh

  4. (For Windows only) Close the AhsayOBM system tray icon.

  5. Install the Hotfix Files:

    • Windows

      Expand the contents of the downloaded hotfix zip into AhsayOBM Installation Home path (e.g. C:\Program Files\AhsayOBM)

    • macOS

      Expand the contents of the downloaded hotfix zip into AhsayOBM Installation Home path (e.g. /Applications/AhsayOBM)

    • Linux/FreeBSD

      Expand the contents of the downloaded hotfix zip into AhsayOBM Installation Home path (e.g. /usr/local/obm)

    Extract contents of zip download, keeping the same directory structure, overwrite the contents (existing files) in your AhsayOBM installation path. For example, extract the file “bin\obc.jar” (inside the zip download) to “C:\Program Files\AhsayOBM\bin\obc.jar”

    In case you need to rollback, to undo the hotfix patch, make a full copy of the AhsayOBM Installation directory prior to overwriting files.

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

  6. Restart the backup client service by:

    • Windows

      1. Control Panel > Administrative Tools > Services > Ahsay Online Backup Manager Services > Start

      2. Control Panel > Administrative Tools > Services > NFS Service (Ahsay Systems Corporation) > Start

      3. (If applicable) Control Panel > Administrative Tools > Services > CBT Cluster Services (Ahsay Online Backup Manager) > Start

    • macOS

      Run the script file at /Applications/AhsayOBM/bin/Scheduler.sh

    • Linux/FreeBSD

      Run the script file at /usr/local/obm/bin/Scheduler.sh

  7. Installation is now complete.

Hotfix installation instructions for SynologyNAS - AhsayOBM

  1. Download the required Hotfix from the Hotfix Release Page.

    Alternatively, if you were provided with a specific Hotfix to correct an issue, use that download instead.

  2. Turn off scheduler daemon, if it is enabled, in AhsayOBM > Settings.

  3. Make sure no backup or restore job is in progress. Close the AhsayOBM application if it is open.

  4. Enable the SSH service in Control Panel > Terminal & SNMP.

  5. Connect to the Synology NAS via SFTP using your favorite SFTP client. (For DSM5, use “root” as login user. For DSM6 or above, use “admin” as login user)

  6. Create a temp directory “/tmp/obmhotfix” (or other name), then copy the <hotfix>.zip file to /tmp/obmhotfix.

  7. Connect to the Synology NAS console via SSH using your favorite SSH client. (e.g. Putty) (For DSM5, use “root” as login user. For DSM6 or above, use “admin” as login user)

  8. For DSM6, change to root user by calling “sudo su”, enter your administrator password.

  9. Change directory to /tmp/obmhotfix, then unpack the hofix by calling “7z x <hotfix>.zip”.

  10. Copy the files to the application home. (e.g. /volume1/@appstore/AhsayOBM/obm/bin by calling cp -R bin/* /volume1/@appstore/AhsayOBM/obm/bin)

    Extract contents of zip download, keeping the same directory structure, overwrite the contents (existing files) in application home. Repeat for all files contained in the hotfix, copying it to the application home.

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

  11. Remove the temp directory.

  12. Set the permissions for all the copied hotfix files, e.g. chmod 755 -R /volume1/@appstore/AhsayOBM/obm/wui

  13. Reopen the AhsayOBM. Enable scheduler daemon in AhsayOBM > Settings if necessary.

Hotfix installation instructions for QNAPNAS - AhsayOBM

  1. Download the required Hotfix from the Hotfix Release Page.

    Alternatively, if you were provided with a specific Hotfix to correct an issue, use that download instead.
  2. Go to QNAP Web Console Control Panel > Telnet / SSH to enable “Allow SSH Connection” and “Enable SFTP” option. By default, the port number is “22”.
  3. Stop the AhsayOBM service in App Center by going to App Center > MyApps > AhsayOBM > Stop.
  4. Connect to the QNAP NAS via SFTP using your favorite SFTP client.
  5. Create a temp directory “/share/obmhotfix” (or other name), then copy the <hotfix>.zip to /share/obmhotfix.
  6. Change directory to /share/obmhotfix, then unpack the hotfix by calling “unzip <hotfix>.zip”.

  7. Copy the patches to the application home.

    Example:

    Legacy or Home class NAS, where home is: /share/MD0_DATA/.qpkg/AhsayOBM/obm/

    cp -R bin/* /share/MD0_DATA/.qpkg/AhsayOBM/obm/bin

    SMB class NAS, where home is: /share/CACHEDEV1_DATA/.qpkg/AhsayOBM/obm/

    cp -R bin/* /share/CACHEDEV1_DATA/.qpkg/AhsayOBM/obm/bin

    Extract contents of zip download, keeping the same directory structure, overwrite the contents (existing files) in application home. Repeat for all files contained in the hotfix, copying it to the application home.

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

  8. Set the permissions for the Hotfix files. (e.g. chmod 755 -R /share/CACHEDEV1_DATA/.qpkg/AhsayOBM/obm/wui or chmod 755 -R /share/MD0_DATA/.qpkg/AhsayOBM/obm/wui)

    Repeat for all files copied.

  9. Start the AhsayOBM service in App Center by going to App Center > MyApps > AhsayOBM > Start

  10. Remove the temp directory.