This is an old revision of the document!

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.
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.)

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.

Patching Steps

Note that these steps should be completed for each appliance in a multi-node (HA) system.

ssh into the File Fabric host as smeconfiguser, then:

su -

cd /var/www/smestorage/patches

wget https://storagemadeeasy.com/files/2956165a966c1dc7576483f90927cd84.tgz -O <patch_name>.tgz

chown smestorage:smestorage <patch_name>.tgz.tgz

su smestorage

./patch -patch <patch_name>.tgz

If you encounter any issues during these steps please contact SME Support.

To Roll Back the Most Recently Installed Patch