File Fabric Upgrade To v2006.07
See also Release Notes v2006.
latest update: Oct 06, 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 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 v2006.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-2006.07
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
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-upgrade-tool yum install sme-package-2006.07 yum update systemctl enable clamd@scan.service systemctl start clamd@scan.service systemctl restart mariadb systemctl enable mariadb mysql_upgrade
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.