Differences

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

--- cloudappliance/patching_1705 [2018_01_30 17:23] – external edit 127.0.0.1
+++ cloudappliance:patching_1705 [2023_06_22 05:41] – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== How To Apply a Patch to SME File Fabric Appliance v1705 ======
+THIS DRAFT SHOULD PROBABLY NOT BE PUBLISHED. I DON"T SEE THE NEED TO UPDATE A 1705 PAGE AND THE INSTRUCTIONS IN THIS DRAFT IS NOT GOOD.  BETTER VERSION-INDEPENDENT PATCHING INSTRUCTIONS ARE HERE: https://docs.storagemadeeasy.com/cloudappliance/patches
+====== How To Apply a Patch to the SME File Fabric Appliance ======
+== last update on: Nov. 27, 2020 ==
+===== About File Fabric Patches =====
+Patches are small changes that are confined to one or a few pieces of the File Fabric's code.  They are almost always issued for the purpose of resolving an issue that is affecting one or a small number of customers.  The patches are only provided to the affected customers. Customers who are not affected by the issue that a patch resolves need not concern themselves with the patch.
+SME seldom issues patches, preferring to combine sets of changes into service packs which we release frequently. On those occasions when we do see fit to issue a patch, the changes included in the patch are always included in a subsequent service pack. In most cases this will be the next service pack to be released after the patch was developed.
 ===== Patching Best Practices =====
   * If you want to familiarise yourself with the changes introduced by a patch prior to deploying the patch to production, install it first in a non-production environment and test it there.
   * Patch your system during a service window when users are not permitted to use the system.
-  * During the service window and prior to patching the system, backup the appliance itself and, if the database is external, backup the database as well. (If you have a a multi-node (HA) system, it is only necessary to back up one node.)
+  * It is not necessary to back up the appliance or the database before installing a patch.
   * Confirm that the system is working correctly after applying the patch and prior to ending the service window.
   * If you are unable to confirm that the patched system is working properly, contact SME Support or roll back the patch prior to ending the service window. (Roll-back instructions are provided later in this document.)
-===== To Check Your Current Version =====
+===== How Patches are Provided =====
+If a patch is appropriate for your File Fabric then SME will provide you with a link to a compressed tar file //<patch_name>.tgz// containing the patch.
-There are two ways to check the version of your appliance:
-  - Log in to the appliance through the browser as appladmin and click on the hamburger menu in the upper right of the screen. The version number will be displayed.
-  - SSH into the appliance VM as smeconfiguser and execute the //smeversion// command. The version number will be displayed.
-===== Patch Contents =====
-Release notes describing the contents of version 1705 and its patches can be found here:
-[[cloudappliance/applupdatev1705/|https:%%//%%storagemadeeasy.com/wiki/cloudappliance/applupdatev1705/]]
 ===== Patching Steps =====
@@ Line 26: / Line 21: @@
 Note that these steps should be completed for each appliance in a multi-node (HA) system.
-  - Open a secure shell on the appliance as smeconfiguser:
+ssh into the File Fabric host as smeconfiguser, then:
+```
-''%%ssh smeconfiguser@yourappliancevmname%%''
+su -
-  - Become the root user:
-''%%su - root%%''
-  - Use the yum command to download and install the patch:
-''%%yum update sme-release sme-ff-ftp%%''
-The final lines of the output you see should be similar to this:
-''%%Updated:   sme-release.x86_64 0:1705.01-2%%''
+cd /var/www/smestorage/patches
-''%%Complete!%%''
+wget https://storagemadeeasy.com/files/2956165a966c1dc7576483f90927cd84.tgz -O <patch_name>.tgz
-If you see something different or encounter any issues during these steps please contact SME Support.
+chown smestorage:smestorage <patch_name>.tgz.tgz
-===== Database Update is Automatic =====
+su smestorage
-When patching version 10 an extra step was necessary to ensure that any database changes associated with the new code were applied to the appliance's database. With version 1705 database updates are handled automatically by the patching process.
+./patch -patch <patch_name>.tgz
+```
+If you encounter any issues during these steps please contact SME Support.
-===== To Roll Back a Patch =====
+===== To Roll Back the Most Recently Installed Patch =====
+ssh into the File Fabric host as smeconfiguser, then:
+```
+su -
-  * To roll back a patch it is necessary to reverse both the appliance changes made by the patch and any database changes made by the patch.
+su - smestorage
-  * If your database is internal to your appliance you can reverse all of the changes by restoring the appliance backup you made prior to applying the patch.
-  * If your database is external then you need to restore the appliance backup and restore the database backup.
+cd /var/www/smestorage/patches
+./patch -rollback
+```