Updateguide requisis_Toolbox 3.2.08 -> 4.1.xx

Dieser Guide beschreibt das Vorgehen beim Updaten der requisis_Toolbox und aller darin enthaltenden Tools. (ReqiF-Manager, Compare-Module, ReqIF-Viewer)

Führen Sie die folgenden Schritte nacheinander aus. Sollten Sie Fragen haben, wenden Sie sich bitte an unseren Produkt Support den Sie via Email erreichen. Hinweis: Eine Version 4.0 gibt es nicht.


  1. Aktivieren Sie den Wartungsmodus in der ReqIF Manager GUI und warten Sie ab, bis alle Jobs abgearbeitet wurden. Mehr dazu im Nutzerhandbuch Kapitel 7.5 Maintenence.
  2. Erstellen Sie ein Backup.  Hier finden Sie eine kurze Anleitung und entsprechende Skripte.
  3. Vor dem Update auf die Version, müssen Sie sicherstellen, dass Sie Version 3.2.08 oder neuer verwenden. Dies können Sie über das GUI in der rechten oberen Ecke einsehen, dort wird die aktuell verwendete Version angezeigt.
  4. Falls Sie noch nicht Version 3.2.08 oder neuer verwenden, aktualisieren Sie zuerst auf die letzte 3.2 Version. Verwenden Sie dazu den hier verlinkten Updateguide und verwenden Sie den Tag 3.2-stable. 
  5. Wenn die Version 3.2.08  oder neuer bei Ihnen läuft, können Sie mit der Aktualisierung auf Version 4.1.xx beginnen.
  6. Fahren Sie hierzu den Dockercontainer mit dem Kommando: docker-compose down herunter.

  7. Öffnen Sie die .env Datei im Hauptverzeichnis mit einem Editor und ändern Sie die Zeile beginnend mit  REQIF_MANAGER_IMAGE wie folgt:
    REQIF_MANAGER_IMAGE=harbor.requisis.com:443/requisis/requisis-toolbox:4.1-stable
    1. Achtung: Die Repository-URL hat sich geändert von harbor.requisis.com:443/requisis/requisis-toolbox/reqif-manager zu harbor.requisis.com:443/requisis/requisis-toolbox
  8. Speichern Sie zum Abschluss die Datei ab.
  9. Navigieren Sie aus dem Hauptordner in den Ordner store/toolbox/config und öffnen Sie mit einem Editor die Datei parameters.yml.
  10. In der Datei muss Parameter auth.ldap.server, der den Pfad zum LDAP Server beinhaltet, angepasst werden. Bsp.:
    Version 3.2: auth.ldap.server: 'ldap://my-ldap-server.net'
    Version 4.1: auth.ldap.server: 'my-ldap-server.net'
  11. Falls vorher eine Verbindung über ldaps aufgebaut wurde, muss der neue Parameter auth.ldap.encryption von none auf den Typ der Verschlüsselung (tls oder ssl) geändert werden. 
  12. Speichern Sie die Änderungen in der parameters.yml Datei ab.
  13. Fahren Sie zum Schluss mit dem Start Skript startDocker.cmd bzw. startDocker.sh die Container wieder hoch. Im Anschluss sollten Sie sich wie gewohnt in die requisis_Toolbox einloggen können.
  14. Deaktivieren Sie den Wartungsmodus im ReqIF-Manager.