File Fabric Upgrade To v1901

latest update: Sept. 18, 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 1901 is currently available in the SME Enterprise Repository.


Ensure the following prerequisites are met before beginning an upgrade:

  • You have the new style SME File Fabric Appliance licence
  • 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

The File Fabric's license format changed in v1901. Contact Support 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.

Verify storage providers have a valid certificates (especially when upgrading from 10.x or 1705). See Storage Provider 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 found here.


Log into the SME appliance as smeconfiguser e.g.


Change user to root

su -

Install the Enterprise repo with the following command.

yum install

Now update the appliance with the following command

yum clean all
yum install sme-package-1901.05 sme-release

After the update has completed, the installed repos should be removed. This will prevent the appliance from upgrading to future releases if other patching is performed.

yum erase sme-repo-release -y
yum erase sme-earlyaccessrepo -y

Now please reboot the system.


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.