===== Nasuni Access Anywhere 2301.2 Upgrade Guide ===== **Latest update: Oct 9, 2023** The latest versions available are: * Nasuni Access Anywhere Server 2301.2.2-10 * WebStream 1.1 These instructions apply to upgrades from versions 1901 and above. See also [[server:2301:release-notes|]] ## 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 [[server:upgrades#multiple_node_upgrades|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 from 2106 itself should take under 10 minutes. Upgrades from older releases will take longer. ## Upgrading from 2301.x ### 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 clean all yum update sme-externalrepo yum install sme-package-2301.2.2-10 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 with the 2301 release. ### 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 [[:server:applying-license]] for more information. ## Upgrading from 2106.x ### Upgrade Precautions * Appliances that were previously 'unbranded' will observe the transition of the product naming change from "SME" and "Access Anywhere" 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 [[:server/determine_layout|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. ### 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 clean all yum update sme-externalrepo yum update php yum install sme-package-2301.2.2-10 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 [[:server:applying-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|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 [[:translation]]. === Localizations === A substantial number of localization changes have been made. Customers may wish to refresh their existing localization packs against the available template files. ## Upgrading from 2006.x Follow the instructions above for upgrading from 2106.x but for the main upgrade use these steps instead. You can ignore warnings. systemctl is-enabled crond && systemctl stop crond && echo 'Stopped Cron' systemctl is-enabled httpd && systemctl stop httpd && echo 'Stopped HTTPD' yum clean all yum update sme-externalrepo yum makecache yum update php 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-2301.2.2-10 systemctl is-enabled crond && systemctl start crond && echo 'Started Cron' systemctl is-enabled httpd && systemctl start httpd && echo 'Started HTTPD' reboot ## Upgrading from 1901.x and 1906.x Follow the instructions above for upgrading from 2106.x but for the main upgrade use these steps instead. You can ignore warnings. systemctl is-enabled crond && systemctl stop crond && echo 'Stopped Cron' systemctl is-enabled httpd && systemctl stop httpd && echo 'Stopped HTTPD' yum clean all yum update sme-externalrepo yum makecache yum update php yum install -y sme-ff-php-config yum remove clamav-server 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-2301.2.2-10 systemctl is-enabled crond && systemctl start crond && echo 'Started Cron' systemctl is-enabled httpd && systemctl start httpd && echo 'Started HTTPD' reboot