This commit is contained in:
2024-05-24 18:44:12 +00:00
parent f5c1a52564
commit ce91c23597
4 changed files with 166 additions and 8 deletions

View File

@@ -14,19 +14,19 @@ IN PROGRESS....
Released 2024-TBD-TBD
**CAUTION / TAKE NOTE**: this release contains changes that require a couple of extra steps from the normal upgrade process you may be accustomed to. Be sure to follow our [upgrade instructions](ops-upgrade.md) which have been updated to cover the unique steps required for this particular upgrade from version 8.1.5 to version 8.2.0.
**CAUTION / TAKE NOTE**: this release contains changes that require a **pre upgrade step** from the normal upgrade process you may be accustomed to. Be sure to follow our [upgrade instructions](ops-upgrade.md) and the **pre upgrade step** for this particular upgrade from version 8.1.5 to version 8.2.0.
**Changed**
- Server: updated to use .NET 8.x LTS from previously used .NET 6.x LTS. .NET 6.x is reaching end of support this upcoming November. With this update to .NET 8.x come numerous benefits including performance and security gains. AyaNova 8.2 requires the .NET 8 runtime framework to be installed _before_ upgrading to this release. We have updated the [upgrade instructions](ops-upgrade.md) to guide you through this change please be sure to review this before upgrading.
- Server: updated to use .NET 8.x LTS from previously used .NET 6.x LTS. .NET 6.x is reaching end of support this upcoming November. With this update to .NET 8.x come numerous benefits including performance and security gains. AyaNova 8.2 requires the .NET 8 runtime framework to be installed _before_ upgrading to this release. We have updated the [upgrade instructions](ops-upgrade.md) with a **pre upgrade step** to guide you through this change please be sure to follow this before upgrading.
- Server: switched the report rendering system from Chromium to Chrome browser to align with the default browser now supported by the Puppeteer headless browser controller library that we use for report generation. This change means that a couple of folders must be created and a folder removed to house the new location for the headless Chrome browser used for report generation. We have updated the [upgrade instructions](ops-upgrade.md) to guide you through this change please be sure to review this before upgrading to ensure report rendering continues to work.
- Server: switched the report rendering system from Chromium to Chrome browser to align with the default browser now supported by the Puppeteer headless browser controller library that we use for report generation. This change means that a couple of folders must be created and a folder removed to house the new location for the headless Chrome browser used for report generation. We have updated the [upgrade instructions](ops-upgrade.md) with a **pre upgrade step** to guide you through this change please be sure to follow this before upgrading to ensure report rendering continues to work.
- Server: all 3rd party dependencies for AyaNova server have been upgraded to their most recent release versions to use with .NET 8.x. This is not a breaking change. This change improves performance, stability and security for each component used.
**Added**
- Docs: added documentation about a potential issue with "US" being prepended to currency values for non US users and how to correct it in [user settings currency code](home-user-settings.md#currency-code)
- Docs: added documentation about a potential issue with "US" being prepended to currency values on reports for non US users and how to correct it in [user settings currency code](home-user-settings.md#currency-code)
### AyaNova 8.1.5

View File

@@ -2,11 +2,11 @@
The linux desktop upgrade process involves replacing the AyaNova program files with the latest version and restarting the AyaNova server.
These instructions assume the original installation steps were followed without changes, if you had to make changes adjust accordingly.
These instructions assume the original installation steps were followed without changes and Ubuntu or compatible distro was used, if you had to make changes or have an alternative distro adjust accordingly.
### Expired Maintenance plan
If you do not have an active Maintenance plan you will [not be able to update](adm-license.md#maintenance-expired-message).
If you do not have an active Maintenance plan [updating will BREAK your AyaNova application](adm-license.md#maintenance-expired-message).
### 1\. Backup
@@ -22,6 +22,29 @@ Alternatively you can hard shut down AyaNova using the ctrl-c key combination in
### 3\. Upgrade
#### Pre-upgrade step
If your current AyaNova version is older than 8.2.0 there is an extra step before the normal upgrade script process below.
8.2.0 switched to .NET 8 LTS from the prior used .NET 6 LTS and also switched to using Chrome instead of Chromium for the report rendering headless browser so this script accomodates these changes.
From a terminal window run the following commands:
```bash
sudo apt-get update && apt-get upgrade && \
sudo apt-get install -y aspnetcore-runtime-8.0 && \
sudo mkdir /var/ayanova/Chrome && \
sudo mkdir /var/ayanova/ChromeHeadlessShell && \
sudo chown -vR :www-data /var/ayanova && \
sudo chmod -R g+rwx /var/ayanova/Chrome && \
sudo chmod -R g+rwx /var/ayanova/ChromeHeadlessShell && \
sudo chmod g+rw /var/ayanova/
```
If there is an issue or error break apart the commands and execute each one individually to find the error.
#### upgrade script
The following shell script will automatically remove the old AyaNova files, download and unzip the latest AyaNova files then start the server.
From a terminal window run the following commands:

View File

@@ -2,7 +2,7 @@
The linux server upgrade process involves replacing the AyaNova program files with the latest version and restarting the AyaNova server.
These instructions assume the original installation steps were followed without changes, if you had to make changes adjust accordingly.
These instructions assume the original installation steps were followed without changes and Ubuntu or compatible distro was used, if you had to make changes or have an alternative distro adjust accordingly.
### Expired Maintenance plan
@@ -16,7 +16,28 @@ If you do not have a fresh backup there will be no way to recover from potential
### 2\. Upgrade
Ensure all other Users are logged out of AyaNova before proceeding.
#### Pre-upgrade step
If your current AyaNova version is older than 8.2.0 there is an extra step before the normal upgrade script process below.
8.2.0 switched to .NET 8 LTS from the prior used .NET 6 LTS and also switched to using Chrome instead of Chromium for the report rendering headless browser so this script accomodates these changes.
From a terminal window run the following commands:
```bash
sudo apt-get update && apt-get upgrade && \
sudo apt-get install -y aspnetcore-runtime-8.0 && \
sudo mkdir /var/ayanova/Chrome && \
sudo mkdir /var/ayanova/ChromeHeadlessShell && \
sudo chown -vR :www-data /var/ayanova && \
sudo chmod -R g+rwx /var/ayanova/Chrome && \
sudo chmod -R g+rwx /var/ayanova/ChromeHeadlessShell && \
sudo chmod g+rw /var/ayanova/
```
If there is an issue or error break apart the commands and execute each one individually to find the error.
#### upgrade script
The following shell script will automatically stop the AyaNova server service, remove the old AyaNova files, download and unzip the latest AyaNova files then start the server service.