Differences

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

--- public:how_to_apply_hotfix_to_ahsaycbs [2020/01/24 15:13]
kirk.lim rewrite
+++ 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 ======
 ===== 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: \\
-  * [[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) =====
-. 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>
+. 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-v830999.zip\\
@@ Line 30: / Line 64: @@
 \\
 . 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]''\\
 \\
-. (optional) It is good practice to disable AUA for each user before updating AhsayCBS.\\
+. (optional) It is good practice to disable AUA (via CBS UI) for each user before updating AhsayCBS.\\
 \\
 . Shutdown the AhsayCBS service by: \\
   * __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__
-    - 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\\
@@ Line 47: / Line 81: @@
 . Install the hotfix files: \\
   * __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__
-    * 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> \\
@@ Line 58: / Line 92: @@
 . Startup the AhsayCBS service by: \\
   * __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__
-    - 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\\
@@ Line 69: / Line 103: @@
 . Installation is now complete \\
 \\
-. Login to your AhsayCBS web management console and go to [System Settings] > [License] > [Update License] to verify the Product Version \\
+. 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 =====
@@ Line 80: / Line 117: @@
 		* Username: admin\\ \\
 	- Enable SSH by: \\
-		* Click on the "Start" button on [System] > [Settings] > [SSHD] page \\
+		* Click on the "Start" button on ''[System] > [Settings] > [SSHD]'' page \\
 . Connect to your AhsayUBS via SSH terminal, using your AhsayUBS admin credentials. (Note: The credential is not your AhsayCBS web console login)\\
@@ Line 86: / Line 123: @@
 . Create a temporary directory on your AhsayUBS volume for the hotfix download\\
 	* Example, create a directory on the // /ubs/mnt/eslsfw// volume\\
+<WRAP INDENT><WRAP INDENT>
 	mkdir /ubs/mnt/eslsfw/obsr/HOTFIX
+</WRAP></WRAP>
 . For the hotfix version you will download, create a sub-directory within the temporary directory.\\
-	* Example, if you are downloading hotfix v8.3.0.99:\\
+	* Example, if you are downloading hotfix v8.3.0.999:\\
+<WRAP INDENT><WRAP INDENT>
-	mkdir "/ubs/mnt/eslsfw/obsr/HOTFIX/HF83099"
+	mkdir "/ubs/mnt/eslsfw/obsr/HOTFIX/HF830999"
+</WRAP></WRAP>
 . Change directory to the temporary sub-directory.\\
+<WRAP INDENT><WRAP INDENT>
 	cd "/ubs/mnt/eslsfw/obsr/HOTFIX"
+</WRAP></WRAP>
 . 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: ([[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]])\\
+   * 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]])\\
-   * Syntax: \\
-	fetch   http://host.domain.com/path/path2/file.zip
+   * Replace below syntax with the URL of the hotfix download.\\
-   * Replace with the URL to the hotfix download.\\
+   * Syntax: \\
+<WRAP INDENT><WRAP INDENT>
+	fetch   http://host.domain.com/path/path2/file.zip
+</WRAP></WRAP>
 . 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/HF83099
+	unzip -n *.zip  -d /ubs/mnt/eslsfw/obsr/HOTFIX/HF830999
+</WRAP></WRAP>
    * Example, Unzipped contains directories: //build//, //lib//, //webapps//\\
@@ Line 115: / Line 159: @@
 . Before shutting down AhsayCBS and installing the hotfix, Verify no active jobs.\\
+   * Login to AhsayCBS Web Console > Click [Live Activities]\\
-. (optional) It is good practice to disable AUA for each user before updating AhsayCBS.\\
+. (optional) It is good practice to disable AUA (via CBS UI) for each user before updating AhsayCBS.\\
 . Login to UBS admin web console \\
 . 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 \\
-	- Click on the “Stop” button on [Backup Server] > [Server Status] page in the “NFS Service” section\\
+	- Click on the “Stop” button on ''[Backup Server] > [Server Status]'' page in the “NFS Service” section\\
 . Grant write permission for the related AhsayCBS server files: \\
+<WRAP INDENT><WRAP INDENT>
 	mount -uw /ubs/mnt/esfmfw
+</WRAP></WRAP>
 . 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.) \\
@@ Line 131: / Line 178: @@
     * 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 copy of those directories the hotfix will overwrite. In the below example, we are writing to // /ubs/mnt/eslsfw // \\
+	* 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>\\
 . 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> \\
-. Reboot the AhsayUBS machine afterward via the AhsayUBS console (System > Reboot) \\
+. Reboot the AhsayUBS machine afterward via the AhsayUBS admin web console (System > Reboot) \\
-. Once AhsayUBS has booted, reutrn to the AhsayUBS console and Disable SSH.\\
+. Once AhsayUBS has booted, reutrn to the AhsayUBS admin web console and Disable SSH.\\
 . Check CBS Service has started. If not running, click on Start.\\
-	* Check the Status on [Backup Server] > [Server Status] page \\
+	* Check the Status on ''[Backup Server] > [Server Status]'' page \\
-. Login to your AhsayCBS web management console and go to [System Settings] > [License] > [Update License] to verify the Product Version \\
+. Login to your AhsayCBS web management console and go to ''[System Settings] > [License] > [Update License]'' to verify the Product Version \\
 . 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> \\

User Tools

Site Tools

Differences

Page Tools