Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
server:2309:upgrade-guide [2024_01_31 18:17] – [Backup Appliance and Database] steven | server:2309:upgrade-guide [2024_04_26 16:04] (current) – [Nasuni Access Anywhere 2309.1 Upgrade Guide] steven | ||
---|---|---|---|
Line 1: | Line 1: | ||
# Nasuni Access Anywhere 2309.1 Upgrade Guide | # Nasuni Access Anywhere 2309.1 Upgrade Guide | ||
- | **Latest update: | + | **Latest update: |
The latest versions available are: | The latest versions available are: | ||
- | * Nasuni Access Anywhere Server 2309.1 | + | * Nasuni Access Anywhere Server 2309.1.4 |
* WebStream 1.1 | * WebStream 1.1 | ||
- | These instructions apply to upgrades from versions 2301.x and above. | + | __// |
See also [[: | See also [[: | ||
Line 17: | Line 17: | ||
This procedure is written for systems that follow standard single-node deployment architectures. For advanced deployments see [[server: | This procedure is written for systems that follow standard single-node deployment architectures. For advanced deployments see [[server: | ||
- | Note that this release includes an update to Solr. If you have modified the docker compose file review your changes. | + | Note that the 2309.x |
diff / | diff / | ||
+ | |||
+ | ### Backup Appliance and Database | ||
+ | |||
+ | Start by backing up the appliance. The upgrade to 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. | ||
+ | |||
+ | ### Service Window | ||
+ | |||
+ | Upgrades must be performed during service windows. User access to the Access Anywhere Server should be suspended during the service window. The server upgrade from 2301 should take under 20 minutes. | ||
+ | ## Preparation (from 2301.x) | ||
+ | |||
+ | These additional steps are required if upgrading from a 2301.x release. | ||
### Firewall Changes | ### Firewall Changes | ||
Line 32: | Line 43: | ||
For a full list of ports see [[https:// | For a full list of ports see [[https:// | ||
- | ### Service Window | ||
- | |||
- | Upgrades must be performed during service windows. User access to the Access Anywhere Server should be suspended during the service window. The server upgrade from 2301 should take under 20 minutes. | ||
### Search Upgrade | ### Search Upgrade | ||
- | The release requires an update to the schema of the embedded Solr search database. This update to the Search engine can take a while to apply. To minimise disruption to your end users, this update should be applied after the core update has completed and the service is returned to users. The time taken for the upgrade can vary, from hours to days, depending on the density of your current search index. The tooling provided by Nasuni during this update will provide feedback on progress. Whilst the update is being performed, your search results may be incomplete until this process completes. | + | The 2309 release requires an update to the schema of the embedded Solr search database. This update to the Search engine can take a while to apply. To minimise disruption to your end users, this update should be applied after the core update has completed and the service is returned to users. The time taken for the upgrade can vary, from hours to days, depending on the density of your current search index. The tooling provided by Nasuni during this update will provide feedback on progress. Whilst the update is being performed, your search results may be incomplete until this process completes. |
Before you upgrade, ensure you have enough disk space for the scheme upgrade. The required disk space depends on the current size of the Solr Index. Run this command to calculate the current Solr Index Size and see space left on the same volume. | Before you upgrade, ensure you have enough disk space for the scheme upgrade. The required disk space depends on the current size of the Solr Index. Run this command to calculate the current Solr Index Size and see space left on the same volume. | ||
Line 77: | Line 85: | ||
{{ : | {{ : | ||
- | ### Backup Appliance and Database | ||
- | |||
- | Start by backing up the appliance. The upgrade to 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. | ||
- | ## Upgrading | + | ## Upgrading |
### Server Upgrade | ### Server Upgrade | ||
Line 93: | Line 98: | ||
su - | su - | ||
| | ||
- | | + | If upgrading from 2301check the OAuth providers requiring attention. Review the output and note which users will be affected. |
yum install -y naa-cli | yum install -y naa-cli | ||
Line 104: | Line 109: | ||
systemctl is-enabled httpd && systemctl stop httpd && echo ' | systemctl is-enabled httpd && systemctl stop httpd && echo ' | ||
- | Apply updates | + | Apply software |
+ | yum clean all | ||
yum update sme-externalrepo | yum update sme-externalrepo | ||
- | yum install sme-package-2309.1 | + | yum install sme-package-2309.1.4 |
- | and | + | and to update third-party components |
yum update | yum update | ||
- | |||
- | and then reenable and restart services | ||
- | |||
- | systemctl is-enabled crond && systemctl start crond && echo ' | ||
- | systemctl is-enabled httpd && systemctl start httpd && echo ' | ||
Now please reboot the system. | Now please reboot the system. | ||
Line 126: | Line 127: | ||
There are no updates for the WebStream Server with the 2309 release | There are no updates for the WebStream Server with the 2309 release | ||
. | . | ||
- | ## Post Upgrade | + | ## Post Upgrade |
+ | |||
+ | ### License Activation | ||
- | ### License Activation | + | Once you have upgraded to 2309 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 [[: |
- | Once you have upgraded to 2309.0 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 [[: | ||
### Solr Schema Upgrade | ### Solr Schema Upgrade | ||
- | The upgrade provides a reindexing tool called Solr Migrator that upgrades the schema in-place. The purpose of this tool is to reindex data within Solr without requiring file contents to be re-read from the original storage. | + | The 2309 upgrade provides a reindexing tool called Solr Migrator that upgrades the schema in-place. The purpose of this tool is to reindex data within Solr without requiring file contents to be re-read from the original storage. |
To verify if Solr is enabled and runs as a container log in as the appladmin and navigate to Settings > Search Integration. Check that: | To verify if Solr is enabled and runs as a container log in as the appladmin and navigate to Settings > Search Integration. Check that: | ||
1. Indexing is ON and | 1. Indexing is ON and | ||
- | 2. That the Solr URI ends in 8983/solr/sme as below: | + | 2. That the Solr URI ends in 8983/solr/NAA As below: |
If indexing is disabled (and has always been disabled) you don’t need to run this tool. | If indexing is disabled (and has always been disabled) you don’t need to run this tool. | ||
Line 143: | Line 145: | ||
If the Solr URI listed is http:// | If the Solr URI listed is http:// | ||
- | As the root user on your NAA, execute the following: | + | As the root user on your NAA , execute the following: |
naa-solr-migrator | naa-solr-migrator |