Skip to content

AyaNova linux desktop platform upgrade

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 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 application.

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.

2. Stop the AyaNova server

To shut down the AyaNova server cleanly use the AyaNova web app form accessed from Server Operations -> Server State and the menu item Shut down server.

Alternatively you can hard shut down AyaNova using the ctrl-c key combination in the terminal console window where AyaNova is running however this is not recommended.

2.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.

3. Upgrade

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:

cd /opt/ayanova && \
sudo curl -O https://www.ayanova.com/download/ayanova-linux-x64-desktop.zip && \
sudo rm *.dll && \
sudo rm -r ./resource && \
sudo rm -r ./wwwroot && \
sudo unzip -o ayanova-linux-x64-desktop.zip -x "config.json" && \
sudo chmod 777 ./AyaNova && \
sudo ./AyaNova

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.