See also Release Notes v2106

latest update: September 22, 2022

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.

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.

If you have customized the File Fabric's Look & Feel settings, as appladmin navigate to the “Colors, Fonts and CSS Customization” tab on appladmin’s “Look & Feel Settings” page and click the “Update options” button to reapply your customizations.

Ensure the following prerequisites are met before beginning an upgrade:

• SME version 1906.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 updated 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.

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.

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.

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 update sme-externalrepo
yum update php
yum install sme-package-2106.07
yum update

Now please reboot the system.

reboot

The 2106.04 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.

Storage File Locking must be explicitly enabled per-provider from Provider Settings.

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.

yum update php
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.07
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

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

yum update php
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.07
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'

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

Now please reboot the system.

reboot