Table of Contents
Nasuni Access Anywhere 2301.1 Upgrade Guide
Latest update: May 25, 2023
The latest versions available are:
- Nasuni Access Anywhere Server 2301.1.5
- WebStream 1.1
Please follow the upgrade section based on what version you are upgrading from.
Upgrading from 2301.x
Upgrade Precautions
- These instructions apply to upgrades from versions 2301.x and above.
- This procedure is written for systems that follow standard single-node deployment architectures. For advanced deployments see Multiple Node Upgrades.
Service Window
Upgrades should be performed during service windows. User access to the Access Anywhere Server should be suspended during the service window.
Prepare for the upgrade
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 upgrade does not support a database rollback, so if something does not go to plan, a system restore will be required.
The server upgrade itself should take under 5 minutes.
Server Upgrade
Log into the appliance via SSH as smeconfiguser e.g.
ssh smeconfiguser@naa.example.com
Switch to the root user
su -
Stop services
systemctl is-enabled crond && systemctl stop crond && echo 'Stopped Cron' systemctl is-enabled httpd && systemctl stop httpd && echo 'Stopped HTTPD'
Apply updates
yum install sme-package-2301.1.5-15
and
yum update
and then reenable and restart services
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
Upgrading WebStream Server
There are no updates for the WebStream Server.
Post Upgrade
License Activation
Once you have upgraded to 2301.x verify that your site is registered with Nasuni and that your license is being pulled down automatically. If you site is not registered you can download a Serial Number and Authentication code from your Nasuni Account. See Activating your License for more information.
Upgrading from 2106.x
Upgrade Precautions
- These instructions apply to upgrades from versions 2106.x and above. Customers wishing to upgrade from older versions should contact Nasuni Support.
- This procedure is written for systems that follow standard single-node deployment architectures. For advanced deployments see Multiple Node Upgrades.
- Appliances that were previously 'unbranded' will observe the transition of the product naming change from “SME” and “Enterprise File Fabric” to “Nasuni Access Anywhere”.
- Customers who have previously configured a Serial Number via their ApplAdmin screen (a feature that was only made available since 2106.06) will have their License Keys automatically downloaded from the Nasuni NOC going forward. Within 15 minutes of the upgrade completing, the system will switch its license to one automatically provided by the Nasuni NOC.
- As of v2301, Solr indexing depends on Access Anywhere using a single instance of Redis. To enable automatic configuration of Redis on failover, customers upgrading HA installation add this line:
set redishost "$1:6379" >/dev/null
to /usr/libexec/keepalived/mkmaster.sh on both nodes.
* These instructions only apply to in-place upgrades.
Before You Upgrade
Ensure the following prerequisites are met before beginning an upgrade:
- You are running 2106.X
- If you are currently using a AWS ALB with HTTP/2 Enabled, this should be configured to use HTTP/1.1 instead.
- Your appliance has access to the public internet to allow it to download packages.
- You have the ability to perform snapshots and backups prior to the upgrade.
- 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.
To check for free space on root run:
df / -h
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
Upgrades should be performed during service windows. User access to the Access Anywhere Server 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 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 product 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.
Server Upgrade
Log into the appliance via SSH as smeconfiguser e.g.
ssh smeconfiguser@naa.example.com
Switch to the root user
su -
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 update sme-externalrepo yum update php yum install sme-package-2301.1.4-14 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
Upgrading WebStream
Release 2301.1 requires WebStream 1.1.
Follow the WebStream Server upgrade information at WebStream Release Notes.
Post Upgrade
License Activation
Once you have upgraded to 2301 verify that your site is registered with Nasuni and that your license is being pulled down automatically. If you site is not registered you can download a Serial Number and Authentication code from your Nasuni Account. See Activating your License for more information.
Reapply "Look and Feel" Settings
If you have customised the platforms 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 customisations.
Microsoft Teams Changes
If you were upgrading from 2106.03 or earlier, you may require the 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.
Languages
New languages are not enabled by default. They can be enabled from the Appliance Administration interface under Settings > Languages.
See also Languages, Translation and Localization.
Localizations
A substantial number of localization changes have been made. Customers may wish to refresh their existing localization packs against the available template files.