Differences

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

--- cloudappliance/1906/upgrade-guide [2020_02_13 16:33] – zim
+++ cloudappliance:1906:upgrade-guide [2023_07_06 23:54] (current) – removed steven
@@ Line 1: / Line 1: @@
-===== File Fabric Upgrade To v1906 =====
-See also [[:cloudappliance/applupdatev1906|Release Notes v1906.]]
-latest update: December 17, 2019
-The SME Enterprise File Fabric platform is shipped as a virtual appliance, this makes it easy to deploy. The new generation of Enterprise File Fabric has a more comprehensive way to upgrade.  Upgrades from v10.x SME appliance or later are accomplished in-place, without the need to redeploy and migrate to a new virtual machine.
-Please note that this procedure is written for systems that follow "standard" supported deployment architectures, for advanced deployments please contact support.
-Enterprise File Fabric 1906 is currently available in the SME Enterprise Access Repository.
-==== Prerequisites ====
-Ensure the following prerequisites are met before beginning an upgrade:
-  * You have the new style SME File Fabric Appliance license
-  * SME version 10.0.X, 1705.X, 1712.X, 1808.X is installed and functional
-  * Public internet access for download patches
-  * A complete backup / snapshot has been done of both the system and the database
-<WRAP center round important 100%>
-The File Fabric's license format changed in v1901. Contact Support [[support@storagemadeeasy.com]] to obtain a new license key.
-If you use the File Fabric's Cloud FTP or Cloud SFTP protocol converter, your license key should allow access using the name "localhost" in addition to the FQDN that users use to access the File Fabric.  If it does not then please contact support to get a new key before upgrading from a version older than v1901 or installing v1901 or v1906.
-</WRAP>
-Verify storage providers have a valid certificates (especially when upgrading from 10.x or 1705). See [[cloudproviders:certificates]] for more information.
-In addition, you must ensure you have full administrator access to the systems.  The following user accounts and passwords will be required:
-  * smeconfiguser
-  * root
-  * appladmin
-  * organizational admin(s) of your organization
-We always recommend that customers first perform an upgrade on a test system. This gives you the opportunity to try out any new features, and validate expected behaviour before and after the upgrade.
-During the upgrade, ongoing uploads will be canceled and the site will be unavailable for a short duration, please schedule downtime accordingly.
-=== Prepare for the upgrade ===
-To receive upgrades for File Fabric you will need a valid support contract.
-Start by backing up the appliance. This upgrade will be an upgrade of both software and the database, please do not proceed without a good backup. SME does not support a database rollback, so if something does not go to plan, a system restore will be required.
-== Checking storage certificates ==
-Enterprise File Fabric version 1712 introduced greater security controls around storage providers SSL/TLS support. You should ensure you are familiar with these updates before proceeding. Details for this can be [[https://docs.storagemadeeasy.com/cloudappliance/smeinplaceupgrade#checking_storage_certificates|found here]].
-=== Upgrade ===
-Log into the SME appliance as smeconfiguser e.g.
-<code>
-ssh smeconfiguser@cloudfiles.example.com
-</code>
-Change user to root
-<code>
-su -
-</code>
-Install the Enterprise repo with the following command.
-<code>
-yum install https://download.storagemadeeasy.com/sme-repo-release-latest.rpm
-yum install -y sme-externalrepo
-</code>
-Now update the appliance with the following command
-<code>
-yum clean all
-yum install sme-package-1906.06-09
-</code>
-A new configuration value will need to be added to the SME configuration file. Add the following to /var/www/smestorage/public_html/config.inc.php:
-<code>
-var $redishost = 'localhost:6379';
-</code>
-Now please reboot the system.
-<code>
-reboot
-</code>
-<WRAP center round important 100%>
-Customers using SME’s AD Proxy program to communicate with their LDAP system may experience a problem when trying to import users manually.  When the problem occurs an error message saying “AD proxy: Active Directory Unknown error”  will be displayed.  This problem will only occur if the File Fabric has been upgraded from an older version to v1808 or v1901. The problem can be resolved by reentering the LDAP Base DN on the org. admin’s Auth Systems setup page.
-</WRAP>