Differences

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

Link to this comparison view

cloudappliance:patching_1705 [2018_01_30 17:23] (current)
Line 1: Line 1:
 +====== How To Apply a Patch to SME File Fabric Appliance v1705 ======
 +
 +===== 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.)
 +  * 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 =====
 +
 +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 =====
 +
 +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 smeconfiguser@yourappliancevmname%%''​
 +
 +  - 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%%''​
 +
 +''​%%Complete!%%''​
 +
 +If you see something different or encounter any issues during these steps please contact SME Support.
 +
 +===== Database Update is Automatic =====
 +
 +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.
 +
 +===== To Roll Back a Patch =====
 +
 +  * 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.
 +  * 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.
 +