This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Last revision Both sides next revision | ||
public:how_to_apply_hotfix_to_ahsayobm_ahsayacb [2022/07/19 14:45] kirk.lim |
public:how_to_apply_hotfix_to_ahsayobm_ahsayacb [2022/10/12 10:46] kirk.lim |
||
---|---|---|---|
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. Inappropriately installing hotfix not for your base CBS version may have unexpected results. \\ | + | 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: \\ | ||
Line 8: | Line 8: | ||
* [[https://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_latest_hotfix|Hotfix for v9]] | * [[https://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_latest_hotfix|Hotfix for v9]] | ||
+ | \\ | ||
+ | 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. | ||
+ | \\ | ||
---- | ---- | ||
Line 13: | Line 16: | ||
===== Hotfix installation instructions for AhsayOBM ===== | ===== Hotfix installation instructions for AhsayOBM ===== | ||
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. Make sure no backup or restore job is in progress. Close OBM if it is opened. \\ | + | <WRAP INDENT> |
+ | Alternatively, you were provided with a specific hotfix to correct an issue, use that download instead. | ||
+ | </WRAP> | ||
+ | |||
+ | 2. Make sure no backup or restore job is in progress. Close the OBM GUI window if it is opened. \\ | ||
3. Shutdown the backup client service by: \\ | 3. Shutdown the backup client service by: \\ | ||
<WRAP INDENT> | <WRAP INDENT> | ||
Line 39: | Line 47: | ||
For example, extract the file “bin\obc.jar” (inside the zip download) to “C:\Program Files\AhsayOBM\bin\obc.jar”.\\ | 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 want to rollback, to undo the hotfix patch, make a full copy of the OBM Installation directory prior to overwriting files. | + | <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> | </color> | ||
+ | \\ | ||
+ | \\ | ||
+ | Note: The contents of hotfix ZIP are subject to change and directories may differ than listed in this article. | ||
</WRAP> | </WRAP> | ||
Line 74: | Line 85: | ||
</WRAP> | </WRAP> | ||
- | 7. (For Windows only) Open the AhsayOBM system tray icon from ''[Start Menu] > [All Programs] > [AhsayOBM] > [AhsayOBM]'' , login , and confirm version | + | 7. Confirm version is higher: Open the AhsayOBM GUI application, Login to OBM, then click on icon [ i ] in the upper-right of window. The version should reflect the hotfix just installed. |
+ | <HTML> | ||
+ | <!-- Open the AhsayOBM system tray icon from ''[Start Menu] > [All Programs] > [AhsayOBM] > [AhsayOBM]'' , login , and confirm version (click [ i ] icon in upper-right of app) | ||
+ | --> | ||
+ | </HTML> | ||
8. Installation is now complete. | 8. Installation is now complete. | ||
Line 82: | Line 97: | ||
===== Hotfix installation instructions for AhsayACB ===== | ===== Hotfix installation instructions for AhsayACB ===== | ||
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. Make sure no backup or restore job is in progress. Close ACB if it is opened. \\ | + | <WRAP INDENT> |
+ | Alternatively, you were provided with a specific hotfix to correct an issue, use that download instead. | ||
+ | </WRAP> | ||
+ | |||
+ | 2. Make sure no backup or restore job is in progress. Close the ACB GUI window if it is opened. \\ | ||
3. Shutdown the backup client service by: \\ | 3. Shutdown the backup client service by: \\ | ||
<WRAP INDENT> | <WRAP INDENT> | ||
Line 102: | Line 122: | ||
For example, extract the file “bin\obc.jar” (inside the zip download) to “C:\Program Files\AhsayACB\bin\obc.jar”.\\ | 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 want to rollback, to undo the hotfix patch, make a full copy of the ACB Installation directory prior to overwriting files. | + | <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> | </color> | ||
+ | \\ | ||
+ | \\ | ||
+ | Note: The contents of hotfix ZIP are subject to change and directories may differ than listed in this article. | ||
</WRAP> | </WRAP> | ||
Line 127: | Line 150: | ||
</WRAP> | </WRAP> | ||
- | 7. (For Windows only) Open the AhsayACB system tray icon from ''[ Start Menu ] > [ All Programs ] > [ AhsayACB ] > [ AhsayACB ]'' , login , and confirm version | + | 7. Confirm version is higher: Open the AhsayACB GUI application, Login to ACB, then click on icon [ i ] in the upper-right of window. The version should reflect the hotfix just installed. |
+ | <HTML> | ||
+ | <!-- 7. (For Windows only) Open the AhsayACB system tray icon from ''[ Start Menu ] > [ All Programs ] > [ AhsayACB ] > [ AhsayACB ]'' , login , and confirm version | ||
+ | --> | ||
+ | </HTML> | ||
8. Installation is now complete. | 8. Installation is now complete. | ||
Line 136: | Line 163: | ||
===== 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: ([[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]])\\ | ||
+ | <WRAP INDENT> | ||
+ | Alternatively, you were provided with a specific hotfix to correct an issue, use that download instead. | ||
+ | </WRAP> | ||
2. Turn off scheduler daemon, if it is enabled, in //AhsayOBM->Settings// . | 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. | + | 3. Make sure no backup or restore job is in progress. Close OBM application 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 153: | Line 183: | ||
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, e.g. **/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) in application home.\\ | ||
+ | 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, e.g. ''chmod 755 -R /volume1/@appstore/AhsayOBM/obm/wui'' |
+ | \\ | ||
+ | Repeat for all files copied. | ||
13. Please reboot the NAS for proper restart of the application. | 13. Please reboot the NAS for proper restart of the application. | ||
Line 168: | Line 206: | ||
===== 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: ([[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]])\\ | ||
+ | <WRAP INDENT> | ||
+ | Alternatively, you were provided with a specific hotfix to correct an issue, use that download instead. | ||
+ | </WRAP> | ||
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" | ||
Line 179: | Line 220: | ||
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) in application home.\\ | ||
+ | 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**, 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 | ||
+ | </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, 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 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]'' |