Differences

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

--- public:how_to_apply_hotfix_to_ahsaycbs [2019/01/30 10:19]
nelson.ng [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 ======
 ===== 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 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>
-. Shutdown the AhsayCBS service by: \\
+<!-- === 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\\
+   * Example: cbs-nix-v830999.zip\\
 \\
-__Windows__
+. Unzip the downloaded ZIP package into a temporary directory. The contents will only include relevant files necessary for the hotfix, it will not contain files that are expected to already be on your server.\\
-  * [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite ] > [ Stop ]
+   * Example, Unzipped contains directories: //build//, //download//, //java//, //lib//, //webapps//\\
-  * [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite NFS Service ] > [ Stop ]
-__Linux/FreeBSD__
+   * <color #ed1c24>Note: The contents of hotfix ZIP are subject to change and directories may differ than listed in this article. </color>\\
-  * 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 ) \\
-. 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.\\
 \\
-. Install the hotfix files: \\
+. Create a rollback copy of those directories before applying the hotfix. \\
+	* Based on the directories you unzipped in step-2, create a duplicate of those current directories found in your CBS installation home (ie "C:\Program Files\AhsayCBS", or "/usr/local/cbs/"). 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:\\
+		* Copy "//C:\Program Files\AhsayCBS\build//" to "//C:\Program Files\AhsayCBS\build.83030//"\\
+		* Copy "//C:\Program Files\AhsayCBS\download//" to "//C:\Program Files\AhsayCBS\download.83030//"\\
+		* Copy "//C:\Program Files\AhsayCBS\java//" to "//C:\Program Files\AhsayCBS\java.83030//"\\
+		* Copy "//C:\Program Files\AhsayCBS\lib//" to "//C:\Program Files\AhsayCBS\lib.83030//"\\
+		* Copy "//C:\Program Files\AhsayCBS\webapps//" to "//C:\Program Files\AhsayCBS\webapps.83030//"\\
+        * For custom installations; substitute the above with your correct Drive, Path, or directory name.
 \\
-__Windows__
+. Before shutting down AhsayCBS and installing the hotfix, Verify no active jobs.\\
-  * Expand hotfix  downloaded to [CBS_Install_Home] (e.g. C:\ Program Files \ AhsayCBS )
+	* Login to AhsayCBS Web Console > Click ''[Live Activities]''\\
-__Linux/FreeBSD__
-  * Expand hotfix  downloaded to [CBS_Install_Home] (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, expand the file, "lib\cbs.jar", inside the zip archive to "C:\Program Files\AhsayCBS\lib\cbs.jar".</color> \\
 \\
-. Startup the AhsayCBS service by: \\
+. (optional) It is good practice to disable AUA (via CBS UI) for each user before updating AhsayCBS.\\
 \\
-__Windows__
+. Shutdown the AhsayCBS service by: \\
-  * [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [Ahsay Cloud Backup Suite] > [ Start ]
+  * __Windows__
-  * [ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite NFS Service ] > [ Start ] (AhsayCBS version 7.9.0.0 or above)
+    - ''[ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite ] > [ Stop ]''
-__Linux/FreeBSD__
+    - ''[ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite NFS Service ] > [ Stop ]'' \\
-  * 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 ) \\
-. Installation is now complete \\
-. 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 =====
-. 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]])\\
+  * __Linux/FreeBSD__
-. Login to UBS web console \\
+    - Run the script file at ''[CBS_Install_Home]/bin/shutdown.sh'' to shutdown CBS service (e.g. /usr/local/cbs/bin/shutdown.sh )
-. Shutdown the AhsayCBS service by: \\
+    - 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 ) \\
-  * 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\\
+  * For Branded products, substitute with your customized name for AhsayCBS\\
-. Enable share folder on AhsayUBS by:
-  * Click on the "Share AhsayCBS" button on [Backup Server] > [Server Status] page \\
-. Enable SSH by: \\
-  * Click on the "Start" button on [System] > [Settings] > [SSHD] page \\
-. Access the AhsayUBS sharefolder by using this path:
-  * \\${AhsayUBS-IP-Address}\obsr \\
-. Use the following credentials to access to the share folder: \\
-  * Username: root \\
-  * Password (default): ahsayubs \\
-. In the share folder, create a folder named "hotfix" for temporary storage for the hotfix files. \\
 \\
-. SSH to the AhsayUBS with the following login credentials \\
+. Install the hotfix files: \\
-  * Username: root \\
+  * __Windows__
-  * Password (default): ahsayubs \\
+    * Copy those unzipped directories from Step-2, to your CBS Installation Home path (e.g. C:\Program Files\AhsayCBS ) \\
-. 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.\\
+  * __Linux/FreeBSD__
+    * 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" (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> \\
 \\
-. Grant write permission for the related AhsayCBS server files: \\
+. Startup the AhsayCBS service by: \\
-  * mount -uw /ubs/mnt/esfmfw
+  * __Windows__
-. Copy the hotfix files to the correct location: \\
+    - ''[ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite ] > [ Start ]''
-  * cp -r /ubs/mnt/eslsfw/obsr/hotfix/ /ubs/mnt/esfmfw/obsr/system/obsr
+    - ''[ Control Panel ] > [ Administrative Tools ] > [ Services ] > [ Ahsay Cloud Backup Suite NFS Service ] > [ Start ]''    \\
-. Remove the temporary folder afterward:\\
-  * rm -rf /ubs/mnt/eslsfw/obsr/hotfix/ \\
+  * __Linux/FreeBSD__
-. Re-boot the AhsayUBS machine afterward via the AhsayUBS console (System > Reboot) \\
+    - 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 ) \\
+  * For Branded products, refer to your customized name for AhsayCBS\\
+. Installation is now complete \\
+\\
+. 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 =====
+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.
+. Enable SSH (if not already enabled)\\
+	- Login to UBS admin web console \\
+		* Username: admin\\ \\
+	- Enable SSH by: \\
+		* 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)\\
+. 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.999:\\
+<WRAP INDENT><WRAP INDENT>
+	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: ([[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>
+. 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>\\
+. 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 (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 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.) \\
+    * 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>\\
+. 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 admin web console (System > Reboot) \\
+. 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 \\
+. 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