System and updates
Check the installed version and install new LOKI versions.
Under System, administrators see which version of LOKI is installed and install new versions. LOKI never installs updates by itself: an administrator decides when a new version is installed.
The installed version
At the top is the Installed version with a note on its state:
| Note | Meaning |
|---|---|
| Up to date | There is no newer version. |
| Update available | A new version can be installed. |
| Older version offered | ignaite offers a return to an older version, for example after a fault in the current one. |
| Installing | An installation is in progress. |
| Failed | The last installation failed; LOKI keeps running on the previous version. |
At the bottom of the page are the device's Maintenance group and when LOKI last looked for new versions. LOKI looks regularly by itself.
Installing a new version
If a new version is available, the page shows “New version … available” with a summary and the Changes. If you have skipped versions, their changes are listed under Also included. You will find the same texts in the release notes.
Choose a time
During the installation all services are replaced; the chat and dashboard are briefly unavailable. Choose a time when few people are working with LOKI, and announce the interruption if appropriate.
Read the notes
If it says “This version changes the database. A backup is created automatically before the installation.”, LOKI backs up the database itself beforehand. You do not need to do anything.
Install
Click Install now. After “Update requested”, the installation starts shortly.
Wait
The page shows the progress: Preflight checks, Downloading images, Backing up the database, Replacing services, Waiting for system start and finally Done. If the connection drops briefly, the page reconnects by itself. Do not switch the device off in the meantime.
The old version keeps running until the new one has been fully downloaded. The actual interruption only begins when the services are replaced.
If something goes wrong
If the new version does not start properly, LOKI automatically returns to the previous version (Rolling back). Afterwards it says “Last update failed” and “The system was automatically rolled back to version … and keeps running normally.” Your data is preserved. Contact ignaite with the error message shown.
If a version cannot be installed
Under “This version cannot be installed”, LOKI gives the reason:
| Reason | What to do |
|---|---|
| The offered version is older than the installed one. | A return to an older version must be approved by ignaite. |
| The release requires a newer version. | First install the intermediate version named. |
| The release uses a different embedding model. | This version does not match the documents already processed on this device. Contact ignaite. |
Returning to an older version
If ignaite offers a return to an older version, the page shows “Return to version …”. If the older version does not know about a database change made by the current one, LOKI warns “This return deletes data”: the affected fields and their contents are permanently deleted; your other documents remain unchanged. The version can then only be installed once you explicitly confirm this.
Messages
| Message | Meaning |
|---|---|
| Update was not started | The request has been recorded, but the update service on the device has not picked it up. LOKI keeps running unchanged. Contact ignaite. |
| Updates cannot be checked | The device's credentials for the update source were rejected. LOKI keeps running but does not receive new versions. Contact ignaite. |
| Offered version was rejected | The signature of the offered version could not be verified, so LOKI did not install it. Contact ignaite. |
| “The update source is currently unreachable.” | LOKI keeps running normally. New versions appear as soon as the connection is restored. |
Authenticity of updates
Every version is signed by ignaite. LOKI checks the signature before installing and rejects versions whose signature is not valid.