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 [2022/07/19 14:02] kirk.lim |
public:how_to_apply_hotfix_to_ahsayobm_ahsayacb [2022/07/25 11:50] kirk.lim [Hotfix installation instructions for AhsayOBM for QNAP NAS] |
||
---|---|---|---|
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: \\ | ||
* [[https://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]] | ||
Line 34: | Line 35: | ||
5. Install the hotfix files: \\ | 5. Install the hotfix files: \\ | ||
<WRAP INDENT> | <WRAP INDENT> | ||
- | <color #ed1c24>Extract contents of zip download, keeping the same directory structure, overwrite the contents (existing files) in your AhsayOBM installation path.\\ | + | **Overview** |
- | For example, extract the file “bin\obc.jar” (inside the zip download) to “C:\Program Files\AhsayOBM\bin\obc.jar”.</color> | + | 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”.\\ | ||
+ | \\ | ||
+ | <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. | ||
+ | </color> | ||
+ | \\ | ||
+ | \\ | ||
+ | Note: The contents of hotfix ZIP are subject to change and directories may differ than listed in this article. | ||
</WRAP> | </WRAP> | ||
Line 69: | Line 77: | ||
</WRAP> | </WRAP> | ||
- | 7. (For Windows only) Open the AhsayOBM system tray icon from [Start Menu] > [All Programs] > [AhsayOBM] > [AhsayOBM] , login , and confirm version | + | 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 82: | Line 90: | ||
__Windows__<WRAP INDENT> | __Windows__<WRAP INDENT> | ||
[ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay A-Click Backup Services ] > [ Stop ] | [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay A-Click Backup Services ] > [ Stop ] | ||
+ | </WRAP> | ||
__macOS__<WRAP INDENT> | __macOS__<WRAP INDENT> | ||
Run the script file at [ / Applications / AhsayACB / bin / StopScheduler.sh ] | Run the script file at [ / Applications / AhsayACB / bin / StopScheduler.sh ] | ||
+ | </WRAP> | ||
+ | </WRAP> | ||
4. (For Windows only) Close the AhsayACB system tray icon. \\ | 4. (For Windows only) Close the AhsayACB system tray icon. \\ | ||
Line 91: | Line 101: | ||
5. Install the hotfix files: \\ | 5. Install the hotfix files: \\ | ||
<WRAP INDENT> | <WRAP INDENT> | ||
- | <color #ed1c24>Extract contents of zip download, keeping the same directory structure, overwrite the contents (existing files) in your AhsayACB installation path.\\ | + | **Overview** |
- | For example, extract the file “bin\obc.jar” (inside the zip download) to “C:\Program Files\AhsayACB\bin\obc.jar”.</color> | + | 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”.\\ | ||
+ | \\ | ||
+ | <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. | ||
+ | </color> | ||
+ | \\ | ||
+ | \\ | ||
+ | Note: The contents of hotfix ZIP are subject to change and directories may differ than listed in this article. | ||
</WRAP> | </WRAP> | ||
+ | |||
<WRAP INDENT> | <WRAP INDENT> | ||
__Windows__<WRAP INDENT> | __Windows__<WRAP INDENT> | ||
Line 115: | Line 133: | ||
</WRAP> | </WRAP> | ||
- | 7. (For Windows only) Open the AhsayACB system tray icon from [ Start Menu ] > [ All Programs ] > [ AhsayACB ] > [ AhsayACB ] , login , and confirm version | + | 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. | 8. Installation is now complete. | ||
Line 125: | Line 143: | ||
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]])\\ | 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. | + | 2. Turn off scheduler daemon, if it is enabled, in //AhsayOBM->Settings// . |
- | 3. Make sure no backup/restore job is in progress. Close OBM if it is opened. | + | 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 142: | Line 160: | ||
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**"// | 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. Set the permissions for the hotfix files, i.e. chmod 755 -R /volume1/@appstore/AhsayOBM/obm/wui | + | 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. | 13. Please reboot the NAS for proper restart of the application. | ||
- | 14. Reopen the AhsayOBM. Enable scheduler daemon in AhsayOBM->Settings if necessary. | + | 14. Reopen the AhsayOBM. Enable scheduler daemon in //AhsayOBM->Settings// if necessary. |
---- | ---- | ||
Line 157: | Line 181: | ||
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]])\\ | 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. | ||
Line 167: | Line 191: | ||
6. Change directory to **/share/obmhotfix**, then Unpack the hotfix by calling **//“unzip <hotfix>.zip”//**. | 6. Change directory to **/share/obmhotfix**, then Unpack the hotfix by calling **//“unzip <hotfix>.zip”//**. | ||
- | 7. Copy the patches to the application home: | + | 7. Copy the patches to the application home. |
- | * **Legacy or Home class NAS**: /share/MD0_DATA/.qpkg/AhsayOBM/obm/bin (by calling **//“cp -R bin/* /share/MD0_DATA/.qpkg/AhsayOBM/obm/bin)//** | + | <WRAP INDENT> |
- | * **SMB class NAS**: /share/CACHEDEV1_DATA/.qpkg/AhsayOBM/obm/bin (by calling **//“cp -R bin/* /share/CACHEDEV1_DATA/.qpkg/AhsayOBM/obm/bin)//** | + | **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> | ||
+ | <WRAP INDENT> | ||
+ | **Example**:\\ | ||
+ | * **Legacy or Home class NAS**: /share/MD0_DATA/.qpkg/AhsayOBM/obm/bin (by execute ''**cp -R bin/* /share/MD0_DATA/.qpkg/AhsayOBM/obm/bin**'' )\\ | ||
+ | * **SMB class NAS**: /share/CACHEDEV1_DATA/.qpkg/AhsayOBM/obm/bin (by execute ''**cp -R bin/* /share/CACHEDEV1_DATA/.qpkg/AhsayOBM/obm/bin**'' ) | ||
+ | </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 | + | 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] | + | 9. Start AhsayOBM service in App Center by go to ''[App Center] > [MyApps] > [AhsayOBM] > [Start]'' |
10. Remove the temp directory. | 10. Remove the temp directory. | ||