Relution Signet Customer Hub

Update

Die folgenden Schritte dienen zur Aktualisierung der Relution Installation.

Docker Installation

Die docker-compose.yml Datei bearbeiten und
image: relution/relution:xxx mit image: relution/relution:latest ersetzen

Relution zu aktualisieren ist dann sehr einfach:

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

Bei neueren Docker Versionen hat sich die Schreibweise auf docker compose ohne Bindestrich geändert.

Sicherstellen, dass docker_relution mit dem Namen des Relution Containers container_name, der in der docker-compose.yml angegeben wurde, ersetzt wird, 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]

Image-Integrität verifizieren

Vor der Durchführung eines Docker-Updates den Image-Digest überprüfen:

  1. Den SHA-256-Digest für das neue Release aus dem Relution-Release-Manifest beziehen.

  2. Das neue Image herunterladen und dessen Digest überprüfen:

    docker pull relution/relution:<new-version>
docker inspect --format='{{index .RepoDigests 0}}' relution/relution:<new-version>

  3. Den Digest mit dem veröffentlichten Manifest vergleichen. Bei Abweichungen nicht fortfahren.

  4. Nach der Überprüfung die Image-Referenz im Deployment-Manifest aktualisieren, um den verifizierten Digest zu pinnen.

Bekannte Fehlermeldungen

Update hängt bei GeneratedSelfSignedSignerKeyStore

Problem: Das Update bleibt beim Schritt GeneratedSelfSignedSignerKeyStore hängen.

Ursache: Ab Relution 26.x wird aus Compliance-Gründen ein anderer kryptografischer Zufallszahlengenerator verwendet (ein DRBG nach NIST SP 800-90A). Beim Start erzeugt Relution damit ein selbstsigniertes Signaturzertifikat (GeneratedSelfSignedSignerKeyStore) mit einem 4096-Bit-RSA-Schlüssel.

Lösung: Update auf einen aktuellen Kernel bzw. ein aktuelles Rocky- oder Alma-Linux, wie in der Docker-Installation (empfohlen) → vorausgesetzt.

Native Installation Linux

  1. Das neuste Relution Paket herunterladen: Latest Relution Package →

  2. Den Relution Dienst stoppen

  3. Die Relution Datenbank sichern

  4. Das Installationsverzeichnis sichern

    mv <INSTALL_DIR> <INSTALL_DIR>.bak

  5. Das Zip-Paket nach <INSTALL_DIR> extrahieren

  6. Erneut den Eigentümer des <INSTALL_DIR>-Verzeichnis setzen, z.B.:

    sudo chown -R relution:relution /opt/relution

  7. <INSTALL_DIR>.bak/application.yml nach <INSTALL_DIR>/application.yml kopieren

  8. Den Relution Dienst starten

  9. Warten, bis der Relution Dienst gestartet ist

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

Native Installation Windows

  1. Das neuste Relution Paket herunterladen: Latest Relution Package →

  2. Den Relution Dienst services.msc stoppen

  3. Das bestehende Installationsverzeichnis nach relution_bak_ sichern

  4. Das Zip-Paket in das alte Installationsverzeichnis <INSTALL_DIR> extrahieren

  5. Die Konfigurationsdatei aus der Sicherung relution_bak_/application.yml nach <INSTALL_DIR>/application.yml kopieren

  6. Den Relution Dienst starten

  7. Warten, 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

Erscheint beim Starten des Relution-Dienstes die folgende Meldung, kann dies auf eine zu niedrige Java-Version hinweisen:

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
Falls das Problem weiterhin besteht, den Systemadministrator kontaktieren

Zur Behebung die aktuelle Java 17 LTS von folgendem Link herunterladen und installieren: Adoptium Java →
Während der Installation die Option Home PATH setzen aktivieren, andernfalls muss der Home Path nachträglich manuell in den Windows-Variablen eingetragen werden.
Nach der Installation den Relution-Dienst erneut starten.

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?
    • Eine Geräteinformationen aktualisieren Aktion an ein Gerät senden
  • Funktioniert die Einschreibung für die verschiedenen Plattformen noch?

Bekannte Fehlermeldungen bei Datenbank-Updates

Update von 26.0.3 auf 26.1/26.2 schlägt fehl

Problem: Beim Update von Relution 26.0.3 auf Relution 26.1 oder 26.2 schlägt das automatische Datenbank-Update mit der Fehlermeldung Cannot change column 'action_uuid' fehl. In den Server-Logs erscheint folgender Fehler:

java.sql.SQLException: (conn=1539) Cannot change column 'action_uuid': used in a foreign key constraint 'fk_mdm_sb_actn_action_uuid'

Ursache: Beim Relution-Update versucht Liquibase, einer Tabellenspalte einen NOT NULL-Constraint hinzuzufügen, die als Fremdschlüssel definiert ist. Bei den MariaDB-Versionen 10.11.5–10.11.7 schlägt das mit MariaDB-Fehler 1832 fehl — ein bekanntes MariaDB-Problem (MDEV-34392 →).

Lösung: Vor dem Relution-Update muss MariaDB aktualisiert werden. Empfohlen wird eine aktuelle LTS-Version (10.11.18, 11.4.12, 11.8.8 oder 12.3.2). Vor dem MariaDB-Update ist unbedingt ein vollständiges Backup der Datenbank anzulegen.

Hinweis: Update von Relution 5.3x.x auf 26.2.x

Bei einem Update von Relution 5.3x.x auf Relution 26.2.x muss zwingend zuerst auf die Zwischenversion Relution 26.0.3 aktualisiert werden.

Docker

Bei Docker-Installationen kann die Version direkt in der compose.yml festgelegt werden.

  1. Zuerst auf die letzte veröffentlichte 5.x-Version aktualisieren:

    relution:
  image: relution/relution:5.35.4

  2. Anschließend auf die letzte veröffentlichte 26.0.x-Version:

    relution:
  image: relution/relution:26.0.3

  3. Nach erfolgreichem Update kann wieder auf latest gestellt werden, um automatisch die aktuellste Version zu nutzen:

    relution:
  image: relution/relution:latest

Linux und Windows (nativ)

Für native Installationen unter Linux und Windows gilt der gleiche Ablauf wie bei Docker:

  1. Update auf Relution 5.35.4
  2. Update auf Relution 26.0.3
  3. Update auf die aktuellste Version (latest)

Downloads: