public:how_to_apply_hotfix_to_ahsaycbs
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_ahsaycbs [2020/01/14 13:04] kirk.lim rewrite steps1-5 |
public:how_to_apply_hotfix_to_ahsaycbs [2023/05/11 14:02] (current) clarence.lee |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== How to apply hotfix to AhsayCBS ====== | ====== How to apply hotfix to AhsayCBS ====== | ||
| ===== Requirements ===== | ===== Requirements ===== | ||
| - | You can only apply to this hotfix to machines running AhsayCBS version that the hotfix is based on. \\ \\ | + | You can only apply this hotfix to machines running AhsayCBS version that the hotfix is based on. Inappropriately installing hotfix not for your base CBS 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: \\ | ||
| - | * [[http://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]] |
| - | * [[http://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v8|Hotfix for v8]] | + | * [[https://portal.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_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. | ||
| + | \\ | ||
| + | NOTE: For branded CBS, installing CBS hotfix does not require Rebuild Client as branding is not affected unless you upgraded to new Base version just before applying CBS hotfix and had not yet performed Rebuild Client for the Base release. | ||
| + | \\ | ||
| + | |||
| + | |||
| + | ---- | ||
| + | |||
| ===== Hotfix installation instructions for AhsayCBS (Windows/Linux) ===== | ===== Hotfix installation instructions for AhsayCBS (Windows/Linux) ===== | ||
| - | 1. Download the required hotfix directly provided to you or from the Hotfix Release History page: ([[http://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v7|v7]] | [[ http://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v8|v8]])\\ | + | <html> |
| + | <!-- === Windows video demo === | ||
| + | --> | ||
| + | <TABLE BORDER=0> | ||
| + | <TR><TD><B>Windows video demo</B></TD><TD><B>Linux video demo</B></TD></TR> | ||
| + | <TR><TD> | ||
| + | <iframe allowfullscreen="" frameborder="0" height="150" src="//www.youtube.com/embed/_NfvKPlEg2U" width="250"> | ||
| + | </iframe> | ||
| + | <TD> | ||
| + | <iframe allowfullscreen="" frameborder="0" height="150" src="//www.youtube.com/embed/P_98lDyOHQ4" width="250"> | ||
| + | </iframe> | ||
| + | </TD></TD></TR></TABLE> | ||
| + | </html> | ||
| + | |||
| + | <html> | ||
| + | <!-- | ||
| + | === Linux video demo === | ||
| + | <iframe allowfullscreen="" frameborder="0" height="150" src="//www.youtube.com/embed/P_98lDyOHQ4" width="250"> | ||
| + | </iframe> | ||
| + | --> | ||
| + | </html> | ||
| + | |||
| + | 1. Download the required hotfix directly provided to you or 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]])\\ | ||
| * Example: cbs-win-hotfix-task12345.zip\\ | * Example: cbs-win-hotfix-task12345.zip\\ | ||
| * Example: cbs-win-v830999.zip\\ | * Example: cbs-win-v830999.zip\\ | ||
| Line 30: | Line 64: | ||
| \\ | \\ | ||
| 4. Before shutting down AhsayCBS and installing the hotfix, Verify no active jobs.\\ | 4. Before shutting down AhsayCBS and installing the hotfix, Verify no active jobs.\\ | ||
| - | * Login to AhsayCBS Web Console > Click [Live Activities]\\ | + | * Login to AhsayCBS Web Console > Click ''[Live Activities]''\\ |
| \\ | \\ | ||
| - | 5. (optional) It is good practice to disable AUA for each user before updating AhsayCBS.\\ | + | 5. (optional) It is good practice to disable AUA (via CBS UI) for each user before updating AhsayCBS.\\ |
| \\ | \\ | ||
| 6. Shutdown the AhsayCBS service by: \\ | 6. Shutdown the AhsayCBS service by: \\ | ||
| * __Windows__ | * __Windows__ | ||
| - | - [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite ] > [ Stop ] | + | - ''[ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite ] > [ Stop ]'' |
| - | - [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite NFS Service ] > [ Stop ] \\ | + | - ''[ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite NFS Service ] > [ Stop ]'' \\ |
| * __Linux/FreeBSD__ | * __Linux/FreeBSD__ | ||
| - | - Run the script file at [CBS_Install_Home]/bin/shutdown.sh to shutdown CBS service(e.g. / usr / local / cbs/ bin / shutdown.sh ) | + | - Run the script file at ''[CBS_Install_Home]/bin/shutdown.sh'' to shutdown CBS service (e.g. /usr/local/cbs/bin/shutdown.sh ) |
| - | - Run the script file at [CBS_Install_Home]/nfs/bin/shutdown.sh to shutdown CBS NFS service(e.g. / usr / local / cbs/ nfs / bin / shutdown.sh ) \\ | + | - Run the script file at ''[CBS_Install_Home]/nfs/bin/shutdown.sh'' to shutdown CBS NFS service (e.g. /usr/local/cbs/nfs/bin/shutdown.sh ) \\ |
| * For Branded products, substitute with your customized name for AhsayCBS\\ | * For Branded products, substitute with your customized name for AhsayCBS\\ | ||
| Line 47: | Line 81: | ||
| 7. Install the hotfix files: \\ | 7. Install the hotfix files: \\ | ||
| * __Windows__ | * __Windows__ | ||
| - | * Copy those unzipped directories from Step-2, to your CBS Installation Home path (e.g. C:\ Program Files \ AhsayCBS ) \\ | + | * Copy those unzipped directories from Step-2, to your CBS Installation Home path (e.g. C:\Program Files\AhsayCBS ) \\ |
| * __Linux/FreeBSD__ | * __Linux/FreeBSD__ | ||
| - | * Copy those unzipped directories from Step-2, to your CBS Installation Home path (e.g. / usr / local / cbs ) | + | * Copy those unzipped directories from Step-2, to your CBS Installation Home path (e.g. /usr/local/cbs ) |
| - | * <color #ed1c24>Extract all files within the zip archive to their path locations as in the zip archive (DO NOT remove any file from the AhsayCBS installation directory, only overwrite existing files when necessary). For example, copy the file, "lib\cbs.jar", inside the zip archive to "C:\Program Files\AhsayCBS\lib\cbs.jar".</color> \\ | + | * <color #ed1c24>Extract all files within the zip archive to their path locations as in the zip archive (DO NOT remove any file from the AhsayCBS installation directory, only overwrite existing files when necessary). For example, copy the file "lib\cbs.jar" (extracted from the ZIP download) to "C:\Program Files\AhsayCBS\lib\cbs.jar".</color> \\ |
| * <color #ed1c24>You should not install a hotfix if the hotfix version is **lower** than your **current** CBS version.</color> \\ | * <color #ed1c24>You should not install a hotfix if the hotfix version is **lower** than your **current** CBS version.</color> \\ | ||
| Line 58: | Line 92: | ||
| 8. Startup the AhsayCBS service by: \\ | 8. Startup the AhsayCBS service by: \\ | ||
| * __Windows__ | * __Windows__ | ||
| - | - [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite ] > [ Start ] | + | - ''[ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite ] > [ Start ]'' |
| - | - [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite NFS Service ] > [ Start ] \\ | + | - ''[ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite NFS Service ] > [ Start ]'' \\ |
| * __Linux/FreeBSD__ | * __Linux/FreeBSD__ | ||
| - | - Run the script file at [CBS_Install_Home]/bin/startup.sh to startup CBS service (e.g. / usr / local / cbs/ bin / startup.sh ) | + | - Run the script file at ''[CBS_Install_Home]/bin/startup.sh'' to startup CBS service (e.g. /usr/local/cbs/bin/startup.sh ) |
| - | - Run the script file at [CBS_Install_Home]/nfs/bin/startup.sh to startup CBS NFS service (e.g. / usr / local / cbs/ nfs / bin / startup.sh ) \\ | + | - Run the script file at ''[CBS_Install_Home]/nfs/bin/startup.sh'' to startup CBS NFS service (e.g. /usr/local/cbs/nfs/bin/startup.sh ) \\ |
| * For Branded products, refer to your customized name for AhsayCBS\\ | * For Branded products, refer to your customized name for AhsayCBS\\ | ||
| Line 69: | Line 103: | ||
| 9. Installation is now complete \\ | 9. Installation is now complete \\ | ||
| \\ | \\ | ||
| - | 10. Login to your AhsayCBS web management console and go to [System Settings] > [License] > [Update License] to verify the Product Version \\ | + | 10. Login to your AhsayCBS web management console and go to ''[System Settings] > [License] > [Update License]'' to verify the Product Version \\ |
| + | |||
| + | ---- | ||
| ===== Hotfix installation instructions for AhsayCBS on AhsayUBS ===== | ===== Hotfix installation instructions for AhsayCBS on AhsayUBS ===== | ||
| - | 1. Download the required hotfix from the Hotfix Release History page: ([[http://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v7|v7]] | [[ http://www.ahsay.com/partners/en/home/index.jsp?pageContentKey=ahsay_assets_hotfix-v8|v8]])\\ | + | Before proceeding, you should be comfortable with Command-Line Interface and have familiarity with *nix shell. Otherwise, you may want to consult with your IT before proceeding. |
| - | 2. Login to UBS web console \\ | + | |
| - | 3. Shutdown the AhsayCBS service by: \\ | + | 1. Enable SSH (if not already enabled)\\ |
| - | * Click on the "Stop" button on [Backup Server] > [Server Status] page \\ | + | |
| - | * Click on the "Stop" button on [Backup Server] > [Server Status] page in the "NFS Service" section\\ | + | - Login to UBS admin web console \\ |
| - | 4. Enable share folder on AhsayUBS by: | + | * Username: admin\\ \\ |
| - | * Click on the "Share AhsayCBS" button on [Backup Server] > [Server Status] page \\ | + | - Enable SSH by: \\ |
| - | 5. Enable SSH by: \\ | + | * Click on the "Start" button on ''[System] > [Settings] > [SSHD]'' page \\ |
| - | * Click on the "Start" button on [System] > [Settings] > [SSHD] page \\ | + | |
| - | 6. Access the AhsayUBS sharefolder by using this path: | + | 2. Connect to your AhsayUBS via SSH terminal, using your AhsayUBS admin credentials. (Note: The credential is not your AhsayCBS web console login)\\ |
| - | * \\${AhsayUBS-IP-Address}\obsr \\ | + | |
| - | 7. Use the following credentials to access to the share folder: \\ | + | 3. Create a temporary directory on your AhsayUBS volume for the hotfix download\\ |
| - | * Username: root \\ | + | * Example, create a directory on the // /ubs/mnt/eslsfw// volume\\ |
| - | * Password (default): ahsayubs \\ | + | <WRAP INDENT><WRAP INDENT> |
| - | 8. In the share folder, create a folder named "hotfix" for temporary storage for the hotfix files. \\ | + | mkdir /ubs/mnt/eslsfw/obsr/HOTFIX |
| - | \\ | + | </WRAP></WRAP> |
| - | 9. SSH to the AhsayUBS with the following login credentials \\ | + | |
| - | * Username: root \\ | + | 4. For the hotfix version you will download, create a sub-directory within the temporary directory.\\ |
| - | * Password (default): ahsayubs \\ | + | * Example, if you are downloading hotfix v8.3.0.999:\\ |
| - | 10. Copy of "build", "lib" and "webapps" folders with a suffix of ".{version#}", under the [CBS_Install_Home] for safety purpose. e.g. "build.717030", "lib.717030" and "webapps.717030" for CBS v7.17.0.30.\\ | + | <WRAP INDENT><WRAP INDENT> |
| - | \\ | + | mkdir "/ubs/mnt/eslsfw/obsr/HOTFIX/HF830999" |
| - | 11. Grant write permission for the related AhsayCBS server files: \\ | + | </WRAP></WRAP> |
| - | * mount -uw /ubs/mnt/esfmfw | + | |
| - | 12. Copy the hotfix files to the correct location: \\ | + | 5. Change directory to the temporary sub-directory.\\ |
| - | * cp -r /ubs/mnt/eslsfw/obsr/hotfix/ /ubs/mnt/esfmfw/obsr/system/obsr | + | <WRAP INDENT><WRAP INDENT> |
| - | 13. Remove the temporary folder afterward:\\ | + | cd "/ubs/mnt/eslsfw/obsr/HOTFIX" |
| - | * rm -rf /ubs/mnt/eslsfw/obsr/hotfix/ \\ | + | </WRAP></WRAP> |
| - | 14. Re-boot the AhsayUBS machine afterward via the AhsayUBS console (System > Reboot) \\ | + | |
| + | 6. Download the hotfix using the Unix command, "fetch".\\ | ||
| + | |||
| + | * Recall the URL of the required hotfix directly provided to you or 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]])\\ | ||
| + | |||
| + | * Replace below syntax with the URL of the hotfix download.\\ | ||
| + | |||
| + | * Syntax: \\ | ||
| + | <WRAP INDENT><WRAP INDENT> | ||
| + | fetch http://host.domain.com/path/path2/file.zip | ||
| + | </WRAP></WRAP> | ||
| + | |||
| + | 7. After successful download, unzip the downloaded ZIP file using the Unix command, "unzip". Destination will be the hotfix sub-directory. You should List the contents afterwards. \\ | ||
| + | <WRAP INDENT><WRAP INDENT> | ||
| + | unzip -n *.zip -d /ubs/mnt/eslsfw/obsr/HOTFIX/HF830999 | ||
| + | </WRAP></WRAP> | ||
| + | |||
| + | * Example, Unzipped contains directories: //build//, //lib//, //webapps//\\ | ||
| + | |||
| + | * <color #ed1c24>Note: The contents of hotfix ZIP are subject to change and directories may differ than listed in this article. </color>\\ | ||
| + | |||
| + | 8. Before shutting down AhsayCBS and installing the hotfix, Verify no active jobs.\\ | ||
| + | * Login to AhsayCBS Web Console > Click [Live Activities]\\ | ||
| + | |||
| + | 9. (optional) It is good practice to disable AUA (via CBS UI) for each user before updating AhsayCBS.\\ | ||
| + | |||
| + | 10. Login to UBS admin web console \\ | ||
| + | |||
| + | 11. Shutdown the AhsayCBS service by: \\ | ||
| + | - Click on the “Stop” button on ''[Backup Server] > [Server Status]'' page \\ | ||
| + | - Click on the “Stop” button on ''[Backup Server] > [Server Status]'' page in the “NFS Service” section\\ | ||
| + | |||
| + | 12. Grant write permission for the related AhsayCBS server files: \\ | ||
| + | <WRAP INDENT><WRAP INDENT> | ||
| + | mount -uw /ubs/mnt/esfmfw | ||
| + | </WRAP></WRAP> | ||
| + | |||
| + | 13. For each unzipped hotfix directory, create a rollback copy of your current CBS directories before applying the hotfix. (Note: You may need to check if you have adequate space, otherwise use alternative storage to store the rollback copy.) \\ | ||
| + | |||
| + | * Based on the directories unzipped from step-7, create a duplicate of those current directories found in your CBS installation home (ie "// /ubs/mnt/esfmfw/obsr/system/obsr/ //"). For identification, We recommend you append suffix of “//.{version#}//” for your current CBS version, to the copied directory name.\\ | ||
| + | |||
| + | * Example, your CBS is currently v8.3.0.30, you will create a complete copy of those directories the hotfix will overwrite. In the below example, we are writing to // /ubs/mnt/eslsfw // \\ | ||
| + | <WRAP INDENT><WRAP INDENT> | ||
| + | cp -R /ubs/mnt/esfmfw/obsr/system/obsr/build "/ubs/mnt/eslsfw/obsr/HOTFIX/build.83030" | ||
| + | cp -R /ubs/mnt/esfmfw/obsr/system/obsr/lib "/ubs/mnt/eslsfw/obsr/HOTFIX/lib.83030" | ||
| + | cp -R /ubs/mnt/esfmfw/obsr/system/obsr/webapps "/ubs/mnt/eslsfw/obsr/HOTFIX/webapps.83030" | ||
| + | </WRAP></WRAP> | ||
| + | |||
| + | * <color #ed1c24>Note: The contents of hotfix ZIP are subject to change and directories may differ than listed in this article. </color>\\ | ||
| + | |||
| + | 14. To Install the hotfix; Copy the hotfix files to the correct location. Example: \\ | ||
| + | <WRAP INDENT><WRAP INDENT> | ||
| + | cp -Rfvp /ubs/mnt/eslsfw/obsr/HOTFIX/HF811170/ /ubs/mnt/esfmfw/obsr/system/obsr | ||
| + | </WRAP></WRAP> | ||
| + | |||
| + | * <color #ed1c24>Note: You should not install a hotfix if the hotfix version is **lower** than your **current** CBS version.</color> \\ | ||
| + | |||
| + | 15. Reboot the AhsayUBS machine afterward via the AhsayUBS admin web console (System > Reboot) \\ | ||
| + | |||
| + | 16. Once AhsayUBS has booted, reutrn to the AhsayUBS admin web console and Disable SSH.\\ | ||
| + | |||
| + | 17. Check CBS Service has started. If not running, click on Start.\\ | ||
| + | * Check the Status on ''[Backup Server] > [Server Status]'' page \\ | ||
| + | |||
| + | 18. Login to your AhsayCBS web management console and go to ''[System Settings] > [License] > [Update License]'' to verify the Product Version \\ | ||
| + | |||
| + | 19. If you need to reclaim space and have no further need to for the rollback copies, you can Remove the temporary directory afterward:\\ | ||
| + | <WRAP INDENT><WRAP INDENT> | ||
| + | rm -rf /ubs/mnt/eslsfw/obsr/HOTFIX/ | ||
| + | </WRAP></WRAP> | ||
| + | * <color #ed1c24>Note: Before you deploy newer AhsayUBS image, you should remove this temporary directory.</color> \\ | ||
public/how_to_apply_hotfix_to_ahsaycbs.1578978249.txt.gz · Last modified: 2020/01/14 13:04 by kirk.lim