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:24] kirk.lim formatting |
public:how_to_apply_hotfix_to_ahsayobm_ahsayacb [2022/07/25 16:59] 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.\\ | + | 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 7: | 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 12: | 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]])\\ | ||
+ | <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 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> | <WRAP INDENT> | ||
Line 38: | 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 81: | Line 93: | ||
===== 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]])\\ | ||
+ | <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 ACB if it is opened. \\ | 2. Make sure no backup or restore job is in progress. Close ACB if it is opened. \\ | ||
+ | |||
3. Shutdown the backup client service by: \\ | 3. Shutdown the backup client service by: \\ | ||
<WRAP INDENT> | <WRAP INDENT> | ||
Line 101: | Line 118: | ||
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 135: | Line 155: | ||
===== 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// . | ||
Line 152: | Line 175: | ||
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 167: | Line 198: | ||
===== 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 178: | Line 212: | ||
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]'' |