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:
-
Vor dem Migrieren von Keycloak mit
docker compose downdie 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. -
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 Ordnerkeycloak-dbkopieren und unter anderem Namen abspeichern
-
-
Konfiguration aus altem Keycloak exportieren
-
docker-compose.ymlim Texteditor öffnen -
Folgendes anpassen:
-
restart: alwaysbei 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 keycloakWarten, bis die Datei
export.jsonim Keycloak-Datenverzeichnis (/data/keycloak-db) existiert. -
Keycloak stoppen:
docker compose down
-
Keycloak updaten und Daten importieren
-
docker-compose.ymlerneut öffnen -
Änderungen vornehmen:
-
Den Command aus Schritt 2 entfernen
-
Image-Tag von
:latestauf:25ändern -
restart: alwayswieder einkommentieren (#entfernen) -
Unter
keycloak -> environmentfolgenden Eintrag hinzufügen (ersetze<SCADA-HOSTNAME>durch den tatsächlichen Hostnamen):KEYCLOAK_HOSTNAME: <SCADA-HOSTNAME>/authBeispiel: Ist SCADA unter
https://scada-01erreichbar, dann muss der Hostnamehttps://scada-01/authlauten. -
Zusätzlich unter
keycloak -> environmenthinzufügen:THEME: jumo
-
-
Keycloak hochfahren
docker compose up -d keycloak
-
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:
-
audako herunterfahren:
docker-compose down -
docker-compose.ymlbei mongo-Container anpassen:restart: alwayszurestart: "no"ändern -
Mongo Container einzeln starten:
docker-compose up -d mongo -
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() -
docker-compose.ymlaufmongo:5.0umstellen -
Mongo Container einzeln starten:
docker-compose up -d mongo -
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() -
docker-compose.ymlaufmongo:6.0umstellen -
Mongo Container einzeln starten:
docker-compose up -d mongo -
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() -
docker-compose.ymlwieder vonrestart: "no"aufrestart: alwaysändern -
audako wieder normal hochfahren:
docker-compose up -d