Updating within the same version
Online update
No new archive for online installation playbooks has been released
Updating within the same version to newer packages does not require running a playbook. It is sufficient to perform the following steps:
Log in to the server and navigate to the directory where Eltex-NAICE is installed (default: /etc/docker-naice):
cd /etc/docker-naice
Run the commands to stop the containers, download new images, and start the containers using the new version:
docker compose pull && docker compose down && docker compose up -d
If newer builds are available in the remote repository, they will be updated. When using a multi-host high-availability deployment, these commands must be executed on each host where the system is deployed.
An alternative option is to use a dedicated playbook that executes the commands above:
ansible-playbook update-naice-images.yml
A new archive for online installation playbooks has been released
Download the installation playbook archive again and repeat the installation procedure according to the installation instructions, making sure to reapply any previously modified variables in the group_vars/all.yml files for the new playbook archive.
For a single-host installation: v1.0_3.2 Installation using Ansible playbooks
For a high-availability installation: v1.0_3.3 High-availability installation
After completing the repeated installation, you must update the images manually as described above, or run the following playbook on each host:
ansible-playbook update-naice-images.yml
Upgrading to the next version
When upgrading from version 0.9 to version 1.0, the PostgreSQL database image is upgraded from version 15 to version 17. Installing version 1.0 on top of earlier versions will render the database inoperable.
Before starting the upgrade, it is recommended to create a backup: either a snapshot of the virtual machine (if NAICE is deployed in a virtualization environment) or an archive of the NAICE installation directory (default: /etc/docker-naice).
When upgrading to the next version with PostgreSQL running in Docker, re-run the installation using the Ansible playbook of the target version, following the installation instructions, overwriting the current deployment. If any variables in group_vars/all.yml have been modified, transfer their values from the old playbook to the new one before installation.
If upgrading across multiple versions, perform upgrades sequentially, moving to the most recent intermediate version before the target version.
When upgrading from version 0.9, all existing administrative accounts will be assigned the Super Admin role, granting full access to all system functionality.