Update

Einleitung

Folgen Sie diesen Schritten, um Ihre Relution Installation zu aktualisieren.

Docker Installation

Bearbeiten Sie die docker-compose.yml Datei und ersetzen Sie
image: relution/relution:xxx mit image: relution/relution:latest

Relution zu aktualisieren ist dann sehr einfach:

cd /opt/relution/
docker compose pull
docker compose up --detach

Stellen Sie sicher, dass Sie docker_relution mit dem Namen des Relution Containers container_name, den Sie in der docker-compose.yml angegeben haben, ersetzen, wenn er vom Standard abweicht.

Dieser Befehl wird die neuste Version des Docker Images herunterladen und installieren. Der Relution Dienst wird für einige Minuten nicht erreichbar sein, solange der Container neu startet.

Mit dem folgenden Kommando können alte Container und Caches gelöscht werden, wodurch teilweise sehr viel Speicherplatz frei wird.

docker system prune -a

WARNING! This will remove:
  - all stopped containers
  - all networks not used by at least one container
  - all images without at least one container associated to them
  - all build cache

Are you sure you want to continue? [y/N]

Native Installation Linux

  1. Laden Sie das neuste Relution Paket herunter: Latest Relution Package → .
  2. Stoppen Sie den Relution Dienst.
  3. Sichern Sie Ihre Relution Datenbank.
  4. Sichern Sie das Installationsverzeichnis.
    mv <INSTALL_DIR> <INSTALL_DIR>.bak
  5. Extrahieren Sie das Zip-Paket nach <INSTALL_DIR>.
  6. Setzen Sie erneut den Eigentümer des <INSTALL_DIR>-Verzeichnis, z.B.:
    sudo chown -R relution:relution /opt/relution
  7. Kopieren Sie <INSTALL_DIR>.bak/application.yml nach <INSTALL_DIR>/application.yml.
  8. Starten Sie den Relution Dienst.
  9. Warten Sie bis der Relution Dienst gestartet ist.

Native Installation Windows

  1. Laden Sie das neuste Relution Paket herunter: Latest Relution Package →
  2. Stoppen Sie den Relution Dienst services.msc
  3. Sichern Sie das bestehende Installationsverzeichnis nach relution_bak_
  4. Extrahieren Sie das Zip-Paket nach in das alte Installationsverzeichnis <INSTALL_DIR>
  5. Kopieren Sie die Konfigurationsdatei aus der Sicherung relution_bak_/application.yml nach <INSTALL_DIR>/application.yml
  6. Starten Sie den Relution Dienst
  7. Warten Sie bis der Relution Dienst gestartet ist. im Verzeichnis <INSTALL_DIR>/log/relution.txt kann die Log eingesehen werden

Die Datenbank wird auf den neusten Stand geupdatet. Das Update der Datenbank kann etwas Zeit in Anspruch nehmen.

Bekannte Fehlermeldungen

Der Dienst Relution auf Lokalem Computer konnte nicht gestartet werden. Der Dienst hat keinen Fehler zurückgegeben. Es kann sich um einen internen Windows-Fehler oder einen internen Dienstfehler handeln. Bitte wenden Sie sich an Ihren Systemadministrator, falls das Problem weiterhin besteht.

Wenn Sie bei dem Starten des Relution-Dienstes die folgende Meldung erhalten, könnte sie auf eine zu niedrige verwendete Java-Version hinweisen.
Um dies zu beheben, laden und installieren Sie bitte die aktuelle Java 17 LTS von folgendem Link: Adoptium Java
Während der Installation aktivieren Sie die Option Home PATH setzen, ansonsten müssen Sie den Home Path nachträglich manuell in den Windows-Variablen eintragen.
Nach der Installation starten Sie den Relution-Dienst erneut.

Checkliste nach dem Update

  • Benötigen Relution Apps auf den mobilen Geräten ebenfalls ein Update?
  • Benötigen angepasste CSS Dateien ein Update?
  • Sind eingeschriebene Geräte noch erreichbar?
    • Senden Sie eine Geräteinformationen aktualisieren Aktion an ein Gerät.
  • Funktioniert die Einschreibung für die verschiedenen Plattformen noch?.

Update von Version 4 auf Relution 5

Um auf die Version 5.x updaten zu können, muss die Version 4.79.2 oder eine neuer Version von Relution 4.79 installiert sein, da die Datenbank Migrationsskripte sonst nicht funktionieren.

Wir empfehlen, die Datenbank vor dem Update zu sichern.

Update Docker auf Relution Version 5

Um die Docker Umgebung zu aktualisieren, bearbeiten Sie die docker-compose.yml Datei tragen Sie beim Image Tag 4.79.2 ein.

      image: relution/relution:4.79.2

Starten Sie den Docker und lassen Sie das Update auf Version 4.79.2 installieren. Fahren Sie den COntainer anschließend wieder herunter. Ändern Sie das Image Tag in der docker-compose.yml Datei wieder auf latest.

      image: relution/relution:latest

Update Native auf Relution Version 5

Installieren Sie erst die Version 4.79.2 → wie oben beschrieben.

Nach Installation der 4.79.2 können Sie die Version 5 aus dem
Latest Relution Package → installieren.