Version 4.15 Version 4.14 Version 4.13 Version 4.12 Version 4.11 Version 4.10 Version 4.9 Version ≤4.8
Version 4.15 Version 4.14 Version 4.13 Version 4.12 Version 4.11 Version 4.10 Version 4.9 Version ≤4.8

Update Guide


Wenn Sie ein Update ihres SCADA Servers durchführen möchten, beachten Sie bitte folgende Schritte.

Keycloak - v.4.16 zu v. 4.17

Optionales Keycloak-Update von Version 8 auf 25:

  1. Vor dem Migrieren von Keycloak mit docker compose down die SCADA-Anwendung herunterfahren.

    Hinweis: Wenn LDAP verwendet wird, sollte dies vor der Migration deaktiviert werden, damit der Export funktioniert.
    Zum Deaktivieren:
    User Federation → LDAP Provider → Enabled / Aktiv auf Off / Aus schalten.

  2. Backup der alten Konfiguration erstellen:

  • Daten im data-Ordner sichern:

  • Linux:

    • Terminal/Konsole im SCADA-Ordner öffnen

    • Befehl ausführen:

      cp -r ./data/keycloak-db ./data-keycloak-db-backup
      
  • Windows:

    • Explorer/Dateibrowser öffnen und zum SCADA-Ordner navigieren

    • Im data-Ordner den Ordner keycloak-db kopieren und unter anderem Namen abspeichern

  1. Konfiguration aus altem Keycloak exportieren

  • docker-compose.yml im Texteditor öffnen

  • Folgendes anpassen:

    • restart: always bei Keycloak entfernen oder mit # auskommentieren

    • Folgenden Command bei Keycloak hinzufügen:

      command: [
        "-Dkeycloak.migration.action=export",
        "-Dkeycloak.migration.provider=singleFile",
        "-Dkeycloak.migration.file=/opt/jboss/keycloak/standalone/data/export.json"
      ]
      
  • Keycloak starten:

    docker compose up -d keycloak
    

    Warten, bis die Datei export.json im Keycloak-Datenverzeichnis (/data/keycloak-db) existiert.

  • Keycloak stoppen:

    docker compose down
    
  1. Keycloak updaten und Daten importieren

  • docker-compose.yml erneut öffnen

  • Änderungen vornehmen:

    • Den Command aus Schritt 2 entfernen

    • Image-Tag von :latest auf :25 ändern

    • restart: always wieder einkommentieren (# entfernen)

    • Unter keycloak -> environment folgenden Eintrag hinzufügen (ersetze <SCADA-HOSTNAME> durch den tatsächlichen Hostnamen):

      KEYCLOAK_HOSTNAME: <SCADA-HOSTNAME>/auth
      

      Beispiel: Ist SCADA unter https://scada-01 erreichbar, dann muss der Hostname https://scada-01/auth lauten.

    • Zusätzlich unter keycloak -> environment hinzufügen:

      THEME: jumo
      
  1. Keycloak hochfahren

docker compose up -d keycloak
  1. Keycloak-Administration

  • In die Keycloak-Administration gehen

  • Zu clients → account-console navigieren

  • * zu den Web Origins hinzufügen und speichern

Optional:
Bei Bedarf LDAP wieder aktivieren und Benutzer updaten.


Runtime - v.4.10 zu v. 4.11

Folgendes zu runtime hinzufügen in docker-compose.override.yml wenn runtime genutzt wird:

DB_Connstr: ${DB_Config_Connstr}

Redis - v.4.9 zu v. 4.10

Folgendes zu historian hinzufügen in docker-compose.override.yml:

REDIS_Live_Connstr: ${REDIS_Live_Connstr}

MongoDB - v.4.9 zu v. 4.10

Optional MongoDB Update von Version 4.4 -> 6.0:

  1. audako herunterfahren:

    docker-compose down
    
  2. docker-compose.yml bei mongo-Container anpassen: restart: always zu restart: "no" ändern

  3. Mongo Container einzeln starten:

    docker-compose up -d mongo
    
  4. auf mongodb 4.4.3:

     docker exec -it audako-mongo-1 mongo admin -u root -p 'yourpwdhere'
    

    Shell Befehl ausführen:

    db.adminCommand( { setFeatureCompatibilityVersion: "4.4" } )  
    db.shutdownServer()
    
  5. docker-compose.yml auf mongo:5.0 umstellen

  6. Mongo Container einzeln starten:

    docker-compose up -d mongo
    
  7. auf mongodb 5:

    docker exec -it audako-mongo-1 mongo admin -u root -p 'yourpwdhere'
    

    Shell Befehl ausführen:

    db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )  
    db.shutdownServer()
    
  8. docker-compose.yml auf mongo:6.0 umstellen

  9. Mongo Container einzeln starten:

    docker-compose up -d mongo
    
  10. auf mongodb 6:

    docker exec -it audako-mongo-1 mongosh admin -u root -p 'yourpwdhere'
    

    Shell Befehl ausführen:

    db.adminCommand( { setFeatureCompatibilityVersion: "6.0" } )  
    db.shutdownServer()
    
  11. docker-compose.yml wieder von restart: "no" auf restart: always ändern

  12. audako wieder normal hochfahren:

    docker-compose up -d