User Tools

Site Tools


public:how_to_apply_hotfix_to_ahsaycbs

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
public:how_to_apply_hotfix_to_ahsaycbs [2020/01/14 13:13]
kirk.lim [Hotfix installation instructions for AhsayCBS on AhsayUBS]
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 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]])\\ +Before proceeding, ​you should be comfortable with Command-Line Interface and have familiarity with *nix shellOtherwise, you may want to consult with your IT before proceeding.
-   Example: cbs-nix-hotfix-task12345.zip\\ +
-   * Example: cbs-nix-v830999.zip\\+
  
-2Before shutting down AhsayCBS and installing the hotfix, Verify no active jobs.\\ +1Enable SSH (if not already enabled)\\
- * Login to AhsayCBS Web Console > Click [Live Activities]\\+
  
-3. (optional) It is good practice ​to disable AUA for each user before updating AhsayCBS.\\+ - Login to UBS admin web console \\ 
 + * Username: admin\\ \\ 
 + - Enable SSH by: \\ 
 + * Click on the "​Start"​ button on ''​[System] > [Settings] > [SSHD]''​ page \\
  
-4Login to UBS admin web console \\+2Connect ​to your AhsayUBS via SSH terminal, using your AhsayUBS ​admin credentials. (Note: The credential is not your AhsayCBS ​web console ​login)\\
  
-5Shutdown ​the AhsayCBS service by: \\ +3Create a temporary directory on your AhsayUBS volume for the hotfix download\\ 
-  - Click on the "Stop" ​button on [Backup Server] ​[Server Status] page \\ + * Example, create a directory ​on the // /​ubs/​mnt/​eslsfw//​ volume\\ 
-  - Click on the "Stop" ​button on [Backup Server] ​[Server Status] page in the "NFS Service" ​section\\ +<WRAP INDENT><​WRAP INDENT>​ 
-6. Enable share folder on AhsayUBS by: + mkdir /​ubs/​mnt/​eslsfw/​obsr/​HOTFIX  
-  Click on the "Share AhsayCBS"​ button on [Backup Server[Server Statuspage \\ +</​WRAP></​WRAP>​ 
-7Enable SSH by: \\ + 
-  Click on the "​Start"​ button on [System] > [Settings] > [SSHD] page \\ +4. For the hotfix version you will download, create a sub-directory within the temporary directory.\\ 
-8Access the AhsayUBS sharefolder by using this path: + * Example, if you are downloading hotfix v8.3.0.999:​\\ 
-  ​* ​\\${AhsayUBS-IP-Address}\obsr \\+<WRAP INDENT><​WRAP INDENT>​ 
 + mkdir ​"/​ubs/​mnt/​eslsfw/​obsr/​HOTFIX/​HF830999" ​ 
 +</WRAP></​WRAP>​ 
 + 
 +5. Change directory to the temporary sub-directory.\\ 
 +<WRAP INDENT><​WRAP INDENT>​ 
 + cd "/​ubs/​mnt/​eslsfw/​obsr/​HOTFIX" 
 +</WRAP></​WRAP>​ 
 + 
 +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: \\192.168.1.103\obsr \\ 
-9. Use the following credentials to access to the share folder: \\ 
-  * Username: root \\ 
-  * Password (default): ahsayubs \\ 
-10. In the share folder, create a directory named "​hotfix"​ for temporary storage for the hotfix files. \\ 
-\\ 
-11. Unzip and Transfer the downloaded hotfix files to the "​hotfix"​ directory.\\ 
    * Example, Unzipped contains directories:​ //build//, //lib//, //​webapps//​\\    * 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>​\\    * <color #​ed1c24>​Note:​ The contents of hotfix ZIP are subject to change and directories may differ than listed in this article. </​color>​\\
  
-12SSH to the AhsayUBS with the following login credentials ​\\ +8Before shutting down AhsayCBS and installing ​the hotfix, Verify no active jobs.\\ 
-  Username: root \\ +   ​Login to AhsayCBS ​Web Console > Click [Live Activities]\\
-  * Password (default): ahsayubs \\ +
-13. Grant write permission for the related ​AhsayCBS ​server files: ​\\ +
-  * mount -uw /​ubs/​mnt/​esfmfw+
  
-14. 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.) +9. (optional) It is good practice ​to disable AUA (via CBS UI) for each user before updating AhsayCBS.\\
-    * Based on the directories you unzipped, 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 copy of those directories the hotfix will overwrite:\\ +10. Login to UBS admin web console \\ 
- * Copy "// ​/​ubs/​mnt/​esfmfw/​obsr/​system/​obsr/​build//" to "// /ubs/mnt/esfmfw/obsr/system/obsr/​build.83030//"\\ + 
- * Copy "// ​/​ubs/​mnt/​esfmfw/​obsr/​system/​obsr/​lib//" ​to "// ​/ubs/mnt/esfmfw/obsr/system/obsr/lib.83030//"\\ +11. Shutdown the AhsayCBS service by: \\ 
- * Copy "// ​/​ubs/​mnt/​esfmfw/​obsr/​system/​obsr/​webapps//" ​to "// ​/ubs/mnt/esfmfw/obsr/system/obsr/​webapps.83030//​"\\+ - 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>​\\    * <color #​ed1c24>​Note:​ The contents of hotfix ZIP are subject to change and directories may differ than listed in this article. </​color>​\\
-\\ + 
-15. To Install the hotfix; Copy the hotfix files to the correct location: \\ +14. To Install the hotfix; Copy the hotfix files to the correct location. Example: \\ 
-  ​* ​cp -/​ubs/​mnt/​eslsfw/​obsr/​hotfix/ /​ubs/​mnt/​esfmfw/​obsr/​system/​obsr+<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>​ \\   * <color #​ed1c24>​Note:​ You should not install a hotfix if the hotfix version is **lower** than your **current** CBS version.</​color>​ \\
  
-16. Remove the temporary directory afterward:​\\ +15. Reboot the AhsayUBS machine afterward via the AhsayUBS ​admin web console (System > Reboot) ​\\ 
-  * rm -rf /​ubs/​mnt/​eslsfw/​obsr/​hotfix/​ \\ + 
-17. Reboot the AhsayUBS machine afterward via the AhsayUBS 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 \\+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.1578978801.txt.gz · Last modified: 2020/01/14 13:13 by kirk.lim

Page Tools