Once a new version is available, a popup message will appear in the iDNA Applications user interface. This notification links the release notes and download links for the new version.
Download the Upgrade Package
Two upgrade packages are available:
- Online Installer: < 1 MB download (requires access to docker.panagenda.com on the virtual appliance)
- Offline Installer: ~ 1 GB download
The offline package also includes files that may not be required in your installation. Significantly less data will be transferred if the appliance has access to docker.panagenda.com, since only the files necessary for the upgrade will be downloaded.
Install Upgrade Package
Use the ssh client of your choice (e.g. putty on Windows) to connect to the appliance and execute the following commands:
Logs are available in the log directory, e.g. /opt/panagenda/logs/ia-upgrade_<year>-<month>-<day>_<timestamp>.log.
First Login After the Update
If major changes to the data warehouse occurred during the upgrade, parts of the application may not be available until the data warehouse is rebuilt. This process runs automatically at night, but can be triggered manually after the update. On the first login after the installation, more information on this topic will be displayed, along with the option to trigger the rebuild. It's safe to ignore this message until it vanishes by itself.
You may also encounter an issue with Metabase dashboards after the first login (see image below). Simply logging out (not just closing the browser) and in again will resolve this issue.