Updates in this release - 23.4.1

Upgrade to 23.3.0 or 23.3.1 before 23.4.1 mandatory

Version 23.3.0 introduced a safer and more robust upgrade mechanism. In 23.4.1, this mechanism is leveraged to perform a sensitive operation that will keep the data in a more reliable and better-performing state. To upgrade 23.4.1 is therefore necessary to upgrade to 23.3.0 or 23.3.1 first.

Since the upgrade to 23.4.1 from 23.3.x requires to perform a full database dump to disk, make sure that the sensor has enough disk space before attemping an upgrade. The following command will show the size of the database. 
psql -U n2os-dbms scadaguardian -c '\l+ scadaguardian'
Verify that the sensor's disk has enough free space to host a full copy of that size using the command df -h /data.

Rollback from 23.4.1 to a version earlier than 23.4.0

Due to a fundamental change in the system to improve security and ensure data safety, a rollback from version 23.4.1 to the previously installed version, if that previous version is 23.3.0 or 23.3.1, could present some technical difficulties if performed under certain circumstances. Under normal conditions it is prudent to backup a sensor prior to a version upgrade. During this upgrade, it is strongly recommeded to do so. In case of the need for a rollback after the installation, this functionality is provided in a best-effort fashion. Should the rollback procedure encounter unexpected difficulties, a fresh installation of the previously installed version followed by the restore of the backup will reestablish the previously working setup with the data intact. Rolling back from 23.4.1 to 23.4.0 will not present any particular difficulties.

Upgrade instructions for Container Edition

Due to architecture constraints, an operation that is necessary for the upgrade from 23.3.x to 23.4.1 cannot be automated within the Docker container, thus it is necessary to perform it manually before the upgrade. With the container on version 23.3.0 or 23.3.1 running, run the following command 
docker exec -u 0 <CID> bash -c "pg_dump scadaguardian -U n2os-dbms | gzip -9 > /data/dump-upgradev"
where <CID> is the ID of the running container. When this command returns, stop the container running version 23.3.0 or 23.3.1 and start the container on version 23.4.0. The upgrade will complete automatically. If this command is not run manually, the upgrade will fail. No data loss will occur, but the container will not start.