Allgemein
      Zurück zur Startseite
      1. Knowledge Base
      2. requisis_reqIF-Manager
      3. Allgemein

      Update der requisis_Toolbox

      Anleitung zum Aktualisieren der requisis_Toolbox / ReqIF-Managers in einer Docker-Umgebung

      Den Guide für die Installation finden Sie in diesem Artikel.

      Um ein Update auf eine neue Version der requisis_Toolbox / ReqIF-Manager anzustoßen, führen Sie folgende Schritte durch:

      • Aktivieren Sie den Wartungsmodus (ab Version 3.2)
        Um ihre Nutzer rechtzeitig zu informieren. Dazu öffnen Sie die Toolbox Administration und aktivieren Sie die Option Maintenance um diesen ein zu schalten.
      • Stoppen Sie den Docker-Container
        Stoppen Sie den Docker-Container "requisis-toolbox-docker_server" zum Beispiel mit dem Befehl docker-compose down. Die Dauer des Herunterfahrens hängt davon ab, ob im Hintergrund noch Jobs laufen.
      • Editieren Sie den Tag in der .env Datei
        Öffnen Sie die Datei .env im Hauptverzeichnis mit einem Editor. In der Zeile REQUISIS_TOOLBOX_IMAGE= ändern Sie am Ende nun den Versions Tag hierzu gibt es drei mögliche Varianten:

      Der Parameter REQUISIS_TOOLBOX_IMAGE hieß in früheren Versionen noch REQIF_MANAGER_IMAGE Wenn Sie auf eine neue Version updaten ändern Sie nur den Tag in der Zeile. Ändern Sie nicht den Parameternamen!

      1. Um auf eine bestimmte Version upzudaten schreiben Sie den Tag komplett aus zum Beispiel: 4.4.01-stable für die  Version 4.4.01
        Bsp.: /requisis-toolbox:4.4.01-stable
      2. Möchten Sie hingegeben automatische Updates für Ihre Version haben benutzen Sie folgenden Tag: 4.4-stable So bald es ein Update auf die Version 4.4.02 gibt werden Sie dieses automatisch erhalten.
        Bsp.: /requisis-toolbox:4.4-stable
      3. Sie können auch immer die letzte aktuell verfügbare Version nutzen. Verwenden Sie diesen Tag nicht wenn Sie kein Update auf die nächste Hauptversion wünschen (z.B. von Version 4 auf 5):
        /requisis-toolbox:latest-stable

      Speichern Sie die Datei .env

      • Neustarten des Docker Containers
        Durch Ausführen des Skripts startDocker.sh / startDocker.cmd wird überprüft, ob Sie aktuell die neueste, in Ihrer .env-Datei konfigurierte Version verwenden, wenn nicht wird diese gegebenenfalls aktualisiert. Anschließend werden die Docker-Container neu gestartet. Dies kann aufgrund des Updates etwas Zeit in Anspruch nehmen. Sobald Sie die Oberfläche des requisis_Toolbox wieder im Browser sehen können, ist das Update abgeschlossen.
      • Überwachen des Neustarts
        Mit dem Kommando docker-compose logs -f server können Sie den Prozess des Updates und Migration verfolgen.