public:how_to_apply_hotfix_to_ahsayobm_ahsayacb
Differences
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:51] kirk.lim [Hotfix installation instructions for AhsayOBM for Synology 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 141: | Line 159: | ||
| 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, 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. | ||
public/how_to_apply_hotfix_to_ahsayobm_ahsayacb.txt · Last modified: 2023/05/03 17:12 by clarence.lee