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 | ||
|
public:how_to_apply_hotfix_to_ahsayobm_ahsayacb [2022/07/19 14:45] kirk.lim |
public:how_to_apply_hotfix_to_ahsayobm_ahsayacb [2023/05/03 17:12] (current) clarence.lee |
||
|---|---|---|---|
| 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: \\ | ||
| - | * [[https://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v7|Hotfix for v7]] | + | * [[https://portal.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_previous8_hotfix|Hotfix for v8]] | + | * [[https://portal.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]] | + | * [[https://portal.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. | ||
| + | \\ | ||
| ---- | ---- | ||
| ===== 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://portal.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v7|v7]] | [[ https://portal.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_previous8_hotfix|v8]] | [[ https://portal.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 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 73: | 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 80: | Line 96: | ||
| ===== 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://portal.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v7|v7]] | [[ https://portal.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_previous8_hotfix|v8]] | [[ https://portal.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 101: | 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 126: | 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 134: | Line 162: | ||
| ===== 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://portal.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v7|v7]] | [[ https://portal.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_previous8_hotfix|v8]] | [[ https://portal.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 152: | 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 166: | Line 205: | ||
| ===== 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://portal.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v7|v7]] | [[ https://portal.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_previous8_hotfix|v8]] | [[ https://portal.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 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]'' | ||
public/how_to_apply_hotfix_to_ahsayobm_ahsayacb.1658213103.txt.gz · Last modified: 2022/07/19 14:45 by kirk.lim