File Fabric Upgrade To v2106.03

See also Release Notes v2106

latest update: Dec 02, 2021

These instructions apply to upgrades from versions 1901.x and above. Customers wishing to upgrade from older versions should contact SME Support.

The SME Enterprise File Fabric platform is shipped as a virtual appliance; this makes it easy to deploy. Upgrades from supported versions are accomplished in-place, without the need to 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 SME Support.

CloudFTP

Starting with version 2106.00 CloudFTP is provided as a containerized service. The upgrade to v2106 will disable the old CloudFTP. If you are using CloudFTP then you will have to start the new version manually once. You may also have to adjust the configuration manually. You can find details on migrating to the new CloudFTP here. If you need help with upgrading to the new CloudFTP, contact SME Support.

Audit Logs

The upgrade from a pre-2106 version to v2106.00 or later will empty the audit logs on your File Fabric. If you need the old audit log records, be sure to preserve them by downloading or archiving them prior to running the upgrade. Information on downloading and archiving audit logs can be found here. If you need help with preserving the old audit logs, contact SME Support.

Prerequisites

Ensure the following prerequisites are met before beginning an upgrade:

  • SME version 1901.x or later is installed and functional. (For information on upgrading from earlier versions please contact SME Support.)
  • Your File Fabric has public internet access for downloading patches.
  • A complete backup/snapshot has been done of both the system and the database.
  • If you are using the SME's ADProxy program (not needed for AD via LDAP), you have updates ADProxy to version 1.6. Download the new version here.
  • Storage providers have a valid certificates (especially when upgrading from 10.x or 1705). See Storage Provider Certificates for more information.
  • The filesystem mounted at the root (“/”) directory should have at least 20 GB of available space. If it does not, please add an additional 60GB of free space to it by following the instructions on this page.

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
  • organization 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.

Service Window

File Fabric upgrades should be performed during service windows. User access to the File Fabric should be suspended during the service window. Make the pre-upgrade backup discussed in the next section after user activity has been suspended.

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. The File Fabric does not support a database rollback, so if something does not go to plan, a system restore will be required.

Please note that the upgrade can take 20 - 30 minutes end-to-end, so you should plan your service window accordingly.

Instructions for Upgrading from v2106.00 or later

Log into the SME appliance as smeconfiguser e.g.

ssh smeconfiguser@cloudfiles.example.com

Change user to root

su -

Then process the main upgrade as follows.

yum install sme-package-2106.03
yum update

Now please reboot the system.

reboot

Microsoft Teams Changes

The 2106.03 release includes an updated Microsoft Teams App. If you have deployed a Teams App for an earlier release you will need to upgrade the app to take advantage of the new features.

Instructions for Upgrading from v2006.00 to v2006.07

Log into the SME appliance as smeconfiguser e.g.

ssh smeconfiguser@cloudfiles.example.com

Change user to root

su -

Update the external repos provided by SME:

yum update -y sme-externalrepo

Then process the main upgrade as follows.

systemctl is-enabled crond && systemctl stop crond && echo 'Stopped Cron'
systemctl is-enabled httpd && systemctl stop httpd && echo 'Stopped HTTPD'
yum makecache
yum install sme-ff-mariadb
yum remove mariadb-server
yum install MariaDB-server MariaDB-client MariaDB-common MariaDB-shared
systemctl enable mariadb
systemctl restart mariadb
mysql_upgrade
yum install sme-package-2106.03
yum update
systemctl is-enabled crond && systemctl start crond && echo 'Started Cron'
systemctl is-enabled httpd && systemctl start httpd && echo 'Started HTTPD'

Now please reboot the system.

reboot

Instructions for Upgrading from v1901.x or v1906.x

Log into the SME appliance as smeconfiguser e.g.

ssh smeconfiguser@cloudfiles.example.com

Change user to root

su -

Ensure only the expected repos are installed.

yum install https://download.storagemadeeasy.com/sme-repo-release-latest.rpm
yum erase sme-alpharepo
yum install -y sme-externalrepo

Now update the appliance with the following command

systemctl is-enabled crond && systemctl stop crond && echo 'Stopped Cron'
systemctl is-enabled httpd && systemctl stop httpd && echo 'Stopped HTTPD'
yum clean all
yum install -y sme-ff-php-config

Please note that the previous step can generate some errors and warnings on screen— this is perfectly normal.

Next we want to remove old versions of ClamAV server

yum remove clamav-server

Then process the main upgrade as follows.

yum install sme-ff-mariadb sme-ff-upgrade-tool
yum remove mariadb-server
yum install MariaDB-server MariaDB-client MariaDB-common MariaDB-shared
systemctl enable mariadb
systemctl restart mariadb
mysql_upgrade
yum install sme-package-2106.03
yum update

systemctl enable clamd@scan.service
systemctl start clamd@scan.service
systemctl is-enabled crond && systemctl start crond && echo 'Started Cron'
systemctl is-enabled httpd && systemctl start httpd && echo 'Started HTTPD'

During the upgrade you may encounter messages similar to this one:

„DB! No such file or directory:2002: :No such file or directory . 35348; rpc.php; 1.1.1.1;

There can be a small window while the database is being upgraded when this can happen. As long as your appliance is working properly after the upgrade, there is no need for concern.

Now please reboot the system.

reboot

If you are using the CloudSFTP gateway then you need to regenerate the File Fabric's SFTP RSA keys before using SFTP to access the File Fabric with CloudFTP. You will find instructions here.