John Cardinal
111d7922a9
Also removes the server-only /var/ayanova chown/chmod lines from the Linux desktop upgrade page. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.2 KiB
AyaNova linux server platform upgrade
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 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 updating will BREAK your AyaNova server.
1. Backup
Before proceeding, make a backup of the database and the attachment files and store it in a safe place.
If you do not have a fresh backup there will be no way to recover from potential data loss or damage.
1.5. Pre-upgrade step
Only if your current AyaNova version is older than 8.3.0 there is an extra step before the normal upgrade process.
8.3.0 switched to .NET 10 LTS from the prior used .NET 8 LTS (8.2.0 to 8.2.4), so the .NET 10 runtime must be installed first. If you are upgrading from a version older than 8.2.0 this script also accommodates that release's changes to folder ownership and permissions.
From a terminal window run the following commands:
sudo apt-get update && sudo apt-get upgrade && \
sudo apt-get install -y aspnetcore-runtime-10.0 && \
sudo chown -vR :www-data /var/ayanova && \
sudo chmod g+rw /var/ayanova/
On Ubuntu 24.04 and 26.04 the .NET 10 runtime comes from Ubuntu's own package archive. On Ubuntu 22.04 first add the Ubuntu .NET backports package repository with sudo add-apt-repository ppa:dotnet/backports.
Installing the .NET 10 runtime replaces the shared dotnet command, the .NET 8 runtime stays installed and can be removed later if nothing else on the server uses it.
If there is an issue or error break apart the commands and execute each one individually to find the error.
After this step has completed you can continue with the normal upgrade process in the next step.
2. Upgrade
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.
Run the following shell commands:
cd /var/ayanova && \
sudo systemctl stop ayanova.service && \
sudo curl -O https://www.ayanova.com/download/ayanova-linux-x64-server.zip && \
sudo rm *.dll && \
sudo rm -r ./resource && \
sudo rm -r ./wwwroot && \
sudo unzip -o ayanova-linux-x64-server.zip -x "config.json" && \
sudo systemctl start ayanova.service
If there is an issue or error break apart the commands and execute each one individually to find the error.
From 8.3.0 the Chrome report rendering engine is downloaded into a report-browser folder under the data directory instead of the program folder. After upgrading from an earlier version the old folders are no longer used and can be removed:
sudo rm -r /var/ayanova/Chrome /var/ayanova/ChromeHeadlessShell
AyaNova should restart on it's own and perform any database schema updates if required automatically.
Open the login form in your browser and after a short delay you should see the new version number at the bottom of the login form.