This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
public:how_to_apply_hotfix_to_ahsayobm_ahsayacb [2020/01/13 16:53] yuk.cheng [Hotfix installation instructions for AhsayOBM for QNAP NAS] |
public:how_to_apply_hotfix_to_ahsayobm_ahsayacb [2022/07/25 11:34] kirk.lim Repeat for all files contained in the hotfix, copying it to the application home. |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== How to apply hotfix to AhsayOBM/AhsayACB ====== | ====== How to apply hotfix to AhsayOBM/AhsayACB ====== | ||
===== Requirements ===== | ===== Requirements ===== | ||
- | You can only apply to this hotfix to machines running AhsayOBM/AhsayACB version that the hotfix is based on.\\ | + | You can only apply this hotfix to machines running AhsayOBM/AhsayACB version that the hotfix is based on. Inappropriately installing hotfix not for your base client version may have unexpected results. \\ |
This information can be found on the Hotfix Release History page: \\ | This information can be found on the Hotfix Release History page: \\ | ||
- | * [[http://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v7|Hotfix for v7]] | + | * [[https://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v7|Hotfix for v7]] |
- | * [[http://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v8|Hotfix for v8]] | + | * [[https://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_previous8_hotfix|Hotfix for v8]] |
+ | * [[https://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_latest_hotfix|Hotfix for v9]] | ||
+ | |||
+ | |||
+ | ---- | ||
===== Hotfix installation instructions for AhsayOBM ===== | ===== Hotfix installation instructions for AhsayOBM ===== | ||
- | 1. Download the required hotfix from the Hotfix Release History page: ([[http://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v7|v7]] | [[ http://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v8|v8]])\\ | + | 1. Download the required hotfix from the Hotfix Release History page: ([[https://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v7|v7]] | [[ https://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_previous8_hotfix|v8]] | [[ https://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_latest_hotfix|v9]])\\ |
- | 2. Make sure no backup/restore job is in progress. Close OBM if it is opened. \\ | + | 2. Make sure no backup or restore job is in progress. Close OBM if it is opened. \\ |
3. Shutdown the backup client service by: \\ | 3. Shutdown the backup client service by: \\ | ||
- | \\ | + | <WRAP INDENT> |
- | __Windows__ | + | __Windows__<WRAP INDENT> |
- | * [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Online Backup Manager Services ] > [ Stop ] | + | [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Online Backup Manager Services ] > [ Stop ] |
- | * [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ CBT Cluster Services (Ahsay Online Backup Manager) ] > [ Stop ] (Windows 2008/2008R2/2012/2012R2 only) | + | [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ NFS Service (Ahsay Systems Corporation) ] > [ Stop ] |
- | * [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ NFS Service (Ahsay Systems Corporation) ] > [ Stop ] | + | [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ CBT Cluster Services (Ahsay Online Backup Manager) ] > [ Stop ] (if applicable) |
- | __macOS__ | + | </WRAP> |
- | * Run the script file at [ / Applications / AhsayOBM / bin / StopScheduler.sh ] | + | |
- | __Linux/FreeBSD__ | + | __macOS__<WRAP INDENT> |
- | * Run the script file at [ / usr / local / obm / bin / StopScheduler.sh ] | + | Run the script file at [ / Applications / AhsayOBM / bin / StopScheduler.sh ] |
+ | </WRAP> | ||
+ | |||
+ | __Linux/FreeBSD__<WRAP INDENT> | ||
+ | Run the script file at [ /usr/local/obm/bin/StopScheduler.sh ] | ||
+ | </WRAP> | ||
+ | </WRAP> | ||
4. (For Windows only) Close the AhsayOBM system tray icon. \\ | 4. (For Windows only) Close the AhsayOBM system tray icon. \\ | ||
5. Install the hotfix files: \\ | 5. Install the hotfix files: \\ | ||
+ | <WRAP INDENT> | ||
+ | **Overview** | ||
+ | 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”.\\ | ||
\\ | \\ | ||
- | __Windows__ | + | <color #ed1c24>In case you need to rollback, to undo the hotfix patch, make a full copy of the OBM Installation directory prior to overwriting files. |
- | * Expand the hotfix downloaded to [ OBM_Install_Home ] (e.g. C:\Program Files\AhsayOBM) | + | </color> |
- | __macOS__ | + | \\ |
- | * Expand the hotfix downloaded to [ OBM_Install_Home ] (e.g. /Applications/AhsayOBM) | + | \\ |
- | __Linux/FreeBSD__ | + | Note: The contents of hotfix ZIP are subject to change and directories may differ than listed in this article. |
- | * Expand the hotfix downloaded to [ OBM_Install_Home ] (e.g. /usr/local/obm) | + | </WRAP> |
- | <color #ed1c24>Expand all files within the zip archive to their path locations as in the zip archive (DO NOT remove any file from the AhsayOBM installation directory, only overwrite existing files when necessary). For example, expand the file, "bin\obc.jar", inside the zip archive to "C:\Program Files\AhsayOBM\bin\obc.jar".</color> | + | <WRAP INDENT> |
+ | __Windows__<WRAP INDENT> | ||
+ | Expand the contents of the downloaded hotfix zip into [ OBM_Install_Home_Path ] (e.g. C:\Program Files\AhsayOBM) | ||
+ | </WRAP> | ||
+ | |||
+ | __macOS__<WRAP INDENT> | ||
+ | Expand the contents of the downloaded hotfix zip into [ OBM_Install_Home_Path ] (e.g. /Applications/AhsayOBM) | ||
+ | </WRAP> | ||
+ | |||
+ | __Linux/FreeBSD__<WRAP INDENT> | ||
+ | Expand the contents of the downloaded hotfix zip into [ OBM_Install_Home_Path ] (e.g. /usr/local/obm) | ||
+ | </WRAP> | ||
+ | </WRAP> | ||
6. Restart the backup client service by:\\ | 6. Restart the backup client service by:\\ | ||
- | \\ | + | <WRAP INDENT> |
- | __Windows__ | + | __Windows__<WRAP INDENT> |
- | * [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Online Backup Manager Services ] > [ Start ] | + | [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Online Backup Manager Services ] > [ Start ] |
- | * [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ CBT Cluster Services (Ahsay Online Backup Manager) ] > [ Start ] (Windows 2008/2008R2/2012/2012R2 only) | + | [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ NFS Service (Ahsay Systems Corporation) ] > [ Start ] |
- | * [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ NFS Service (Ahsay Systems Corporation) ] > [ Start ] | + | [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ CBT Cluster Services (Ahsay Online Backup Manager) ] > [ Start ] (if applicable) |
- | __macOS__ | + | </WRAP> |
- | * Run the script file at [ / Applications / AhsayOBM / bin / Scheduler.sh ] | + | |
- | __Linux/FreeBSD__ | + | |
- | * Run the script file at [ / usr / local / obm / bin / Scheduler.sh ] | + | |
- | 7. (For Windows only) Open the AhsayOBM system tray icon from [Start Menu] > [All Programs] > [AhsayOBM] > [AhsayOBM] | + | __macOS__<WRAP INDENT> |
+ | Run the script file at [ / Applications / AhsayOBM / bin / Scheduler.sh ] | ||
+ | </WRAP> | ||
+ | |||
+ | __Linux/FreeBSD__<WRAP INDENT> | ||
+ | Run the script file at [ /usr/local/obm/bin/Scheduler.sh ] | ||
+ | </WRAP> | ||
+ | </WRAP> | ||
+ | |||
+ | 7. (For Windows only) Open the AhsayOBM system tray icon from ''[Start Menu] > [All Programs] > [AhsayOBM] > [AhsayOBM]'' , login , and confirm version | ||
8. Installation is now complete. | 8. Installation is now complete. | ||
Line 50: | Line 84: | ||
===== Hotfix installation instructions for AhsayACB ===== | ===== Hotfix installation instructions for AhsayACB ===== | ||
- | 1. Download the required hotfix from the Hotfix Release History page: ([[http://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v7|v7]] | [[ http://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v8|v8]])\\ | + | 1. Download the required hotfix from the Hotfix Release History page: ([[https://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v7|v7]] | [[ https://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_previous8_hotfix|v8]] | [[ https://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_latest_hotfix|v9]])\\ |
- | 2. Shutdown the backup client service by: \\ | + | 2. Make sure no backup or restore job is in progress. Close ACB if it is opened. \\ |
- | \\ | + | 3. Shutdown the backup client service by: \\ |
- | __Windows__ | + | <WRAP INDENT> |
- | * [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay A-Click Backup Services ] > [ Stop ] | + | __Windows__<WRAP INDENT> |
- | __macOS__ | + | [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay A-Click Backup Services ] > [ Stop ] |
- | * Run the script file at [ / Applications / AhsayACB / bin / StopScheduler.sh ] | + | </WRAP> |
- | 3. (For Windows only) Close the AhsayACB system tray icon. \\ | + | __macOS__<WRAP INDENT> |
+ | Run the script file at [ / Applications / AhsayACB / bin / StopScheduler.sh ] | ||
+ | </WRAP> | ||
+ | </WRAP> | ||
- | Install the hotfix files: \\ | + | 4. (For Windows only) Close the AhsayACB system tray icon. \\ |
+ | |||
+ | 5. Install the hotfix files: \\ | ||
+ | <WRAP INDENT> | ||
+ | **Overview** | ||
+ | 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”.\\ | ||
\\ | \\ | ||
- | __Windows__ | + | <color #ed1c24>In case you need to rollback, to undo the hotfix patch, make a full copy of the ACB Installation directory prior to overwriting files. |
- | * Expand the hotfix downloaded to [ ACB_Install_Home ] (e.g. C:\Program Files\AhsayACB) | + | </color> |
- | __macOS__ | + | \\ |
- | * Expand the hotfix downloaded to [ ACB_Install_Home ] (e.g. /Applications/AhsayACB) | + | \\ |
+ | Note: The contents of hotfix ZIP are subject to change and directories may differ than listed in this article. | ||
+ | </WRAP> | ||
- | <color #ed1c24>Expand all files within the zip archive to their path locations as in the zip archive (DO NOT remove any file from the AhsayACB installation directory, only overwrite existing files when necessary). For example, expand the file, "bin\obc.jar", inside the zip archive to "C:\Program Files\AhsayACB\bin\obc.jar".</color> | + | <WRAP INDENT> |
+ | __Windows__<WRAP INDENT> | ||
+ | Expand the contents of the downloaded hotfix zip into [ ACB_Install_Home_Path ] (e.g. C:\Program Files\AhsayACB) | ||
+ | </WRAP> | ||
- | 4. Restart the backup client service by: \\ | + | __macOS__<WRAP INDENT> |
- | \\ | + | Expand the contents of the downloaded hotfix zip into [ ACB_Install_Home_Path ] (e.g. /Applications/AhsayACB) |
- | __Windows__ | + | </WRAP> |
- | * [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay A-Click Backup Services ] > [ Start ] | + | </WRAP> |
- | __macOS__ | + | |
- | * Run the script file at [ / Applications / AhsayACB / bin / Scheduler.sh ] | + | |
- | 5. (For Windows only) Open the AhsayACB system tray icon from [ Start Menu ] > [ All Programs ] > [ AhsayACB ] > [ AhsayACB ] | + | 6. Restart the backup client service by: \\ |
+ | <WRAP INDENT> | ||
+ | __Windows__<WRAP INDENT> | ||
+ | [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay A-Click Backup Services ] > [ Start ] | ||
+ | </WRAP> | ||
- | 6. Installation is now complete. | + | __macOS__<WRAP INDENT> |
+ | Run the script file at [ / Applications / AhsayACB / bin / Scheduler.sh ] | ||
+ | </WRAP> | ||
+ | </WRAP> | ||
+ | |||
+ | 7. (For Windows only) Open the AhsayACB system tray icon from ''[ Start Menu ] > [ All Programs ] > [ AhsayACB ] > [ AhsayACB ]'' , login , and confirm version | ||
+ | |||
+ | 8. Installation is now complete. | ||
---- | ---- | ||
Line 84: | Line 141: | ||
===== Hotfix installation instructions for AhsayOBM for Synology NAS ===== | ===== Hotfix installation instructions for AhsayOBM for Synology NAS ===== | ||
- | 1. Download the required hotfix from the Hotfix Release History page: ([[http://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v7|v7]] | [[ http://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v8|v8]])\\ | + | 1. Download the required hotfix from the Hotfix Release History page: ([[https://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v7|v7]] | [[ https://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_previous8_hotfix|v8]] | [[ https://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_latest_hotfix|v9]])\\ |
- | 2. Turn off scheduler daemon in AhsayOBM->Settings if it is enabled. | + | |
- | 3. Make sure no backup/restore job is in progress. Close OBM if it is opened. | + | 2. Turn off scheduler daemon, if it is enabled, in //AhsayOBM->Settings// . |
+ | |||
+ | 3. Make sure no backup or restore job is in progress. Close OBM if it is opened. | ||
4. Enable the SSH service in "Control Panel"->"Terminal & SNMP". | 4. Enable the SSH service in "Control Panel"->"Terminal & SNMP". | ||
Line 93: | Line 151: | ||
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) | 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 | + | 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) | 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) | ||
Line 99: | Line 157: | ||
8. For DSM6, change to root user by calling "sudo su", enter your administrator password. | 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". | + | 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" | + | 10. Copy the files to the application home, i.e. **/volume1/@appstore/AhsayOBM/obm/bin** by calling //"**cp -R bin/* /volume1/@appstore/AhsayOBM/obm/bin**"// |
+ | <WRAP INDENT> | ||
+ | **Overview** | ||
+ | Extract contents of zip download, keeping the same directory structure, overwrite the contents (existing files).\\ | ||
+ | Repeat for all files contained in the hotfix, copying it to the application home.\\ | ||
+ | Note: The contents of hotfix ZIP are subject to change and directories may differ than listed in this article. | ||
+ | </WRAP> | ||
11. Remove the temp directory. | 11. Remove the temp directory. | ||
- | 12. Please reboot the NAS for proper restart of the application. | + | 12. Set the permissions for the hotfix files, i.e. ''chmod 755 -R /volume1/@appstore/AhsayOBM/obm/wui'' |
+ | |||
+ | 13. Please reboot the NAS for proper restart of the application. | ||
+ | |||
+ | 14. Reopen the AhsayOBM. Enable scheduler daemon in //AhsayOBM->Settings// if necessary. | ||
+ | |||
+ | ---- | ||
- | 13. Reopen the AhsayOBM. Enable scheduler daemon in AhsayOBM->Settings if necessary. | ||
===== Hotfix installation instructions for AhsayOBM for QNAP NAS ===== | ===== Hotfix installation instructions for AhsayOBM for QNAP NAS ===== | ||
- | 1. Download the required hotfix from the Hotfix Release History page: ([[http://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v7|v7]] | [[ http://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v8|v8]])\\ | + | 1. Download the required hotfix from the Hotfix Release History page: ([[https://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v7|v7]] | [[ https://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_previous8_hotfix|v8]] | [[ https://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_latest_hotfix|v9]])\\ |
- | 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" | + | 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 AhsayOBM service in App Center by go to [App Center] > [MyApps] > [AhsayOBM] > [Stop] | + | 3. Stop 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. | 4. Connect to the QNAP NAS via SFTP using your favorite SFTP client. | ||
- | 5. Create a temp directory "mkdir /share/CACHEDEV1_DATA/.qpkg/obmhotfix" (or other name), then copy the <hotfix>.zip to /share/CACHEDEV1_DATA/.qpkg/obmhotfix | + | 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**: /share/MD0_DATA/.qpkg/AhsayOBM/obm/bin (by calling **//“cp -R bin/* /share/MD0_DATA/.qpkg/AhsayOBM/obm/bin)//** | ||
+ | * **SMB class NAS**: /share/CACHEDEV1_DATA/.qpkg/AhsayOBM/obm/bin (by calling **//“cp -R bin/* /share/CACHEDEV1_DATA/.qpkg/AhsayOBM/obm/bin)//** | ||
+ | <WRAP INDENT> | ||
+ | **Overview** | ||
+ | Extract contents of zip download, keeping the same directory structure, overwrite the contents (existing files).\\ | ||
+ | Repeat for all files contained in the hotfix, copying it to the application home.\\ | ||
+ | Note: The contents of hotfix ZIP are subject to change and directories may differ than listed in this article. | ||
+ | </WRAP> | ||
+ | |||
+ | 8. Set the permissions for the hotfix files, i.e. ''chmod 755 -R /share/CACHEDEV1_DATA/.qpkg/AhsayOBM/obm/wui'' , or ''chmod 755 -R /share/MD0_DATA/.qpkg/AhsayOBM/obm/wui'' | ||
+ | |||
+ | 9. Start AhsayOBM service in App Center by go to ''[App Center] > [MyApps] > [AhsayOBM] > [Start]'' | ||
- | 6. Change directory to /share/CACHEDEV1_DATA/.qpkg/obmhotfix, then Unpack the hofix by calling “unzip <hotfix>.zip”. | + | 10. Remove the temp directory. |
- | 7. Copy the patches to the application home: | ||
- | * **Legacy or Home class NAS**: /share/MD0_DATA/.qpkg/AhsayOBM/obm | ||
- | * **SMB class NAS**: /share/CACHEDEV1_DATA/.qpkg/AhsayOBM/obm | ||
- | 9. Start AhsayOBM service in App Center by go to [App Center] > [MyApps] > [AhsayOBM] > [Start] |