Skip to content

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.2.0 there is an extra step before the normal upgrade process.

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:

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.

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 && \
sudo rm *.dll && \
sudo rm -r ./resource && \
sudo rm -r ./wwwroot && \
sudo unzip -o -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.

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.