Versionsaktualisierung

Ca. 13 Min. Lesezeit

Diese Seite beschreibt das Upgrade einer vorhandenen 2WinScada-Installation auf eine neue Version, die Reparatur derselben Version und die Deinstallation. Zu den Änderungen der Version siehe Versionshinweise.

Vor dem Upgrade

1. Lesen Sie die Versionshinweise. Prüfen Sie insbesondere die Abschnitte „Hinweise zum Upgrade“ und „Verhaltensänderungen“.
2. Planen Sie ein Wartungsfenster. Während des Upgrades werden die 2WinScada-Dienste beendet; die Weboberfläche ist nicht verfügbar, Datenerfassung und Archivierung ruhen.
3. Erstellen Sie Sicherungen:
   • Erstellen Sie über die Weboberfläche eine Konfigurationssicherung. Siehe Sicherung und Wiederherstellung.
   • Erstellen Sie eine Vollsicherung der SQL-Server-Datenbank.
   • Sichern Sie den Datenordner der Archivdatenbank (QuestDB).
   • Bewahren Sie eine Kopie außerhalb des Servers auf. Bewahren Sie auch das Installationspaket der vorherigen Version auf.
4. Bereiten Sie das SQL-Sicherungsverzeichnis vor. Setup sichert die Datenbank vor einem Upgrade und vor einer Reparatur in dieses Verzeichnis. Liegt SQL Server auf diesem Computer, belegt der Assistent das Feld mit dem Standard-Sicherungsordner der Instanz vor. Das Verzeichnis muss ein absoluter lokaler Datenträgerpfad auf dem SQL-Server sein, in den das Dienstkonto von SQL Server schreiben kann; eine Netzwerkfreigabe wird nicht akzeptiert. Im Verzeichnis muss freier Speicher in Höhe der reservierten Größe der Datenbank zuzüglich 1 GB vorhanden sein. Zu den erforderlichen SQL-Berechtigungen siehe Berechtigungen.
5. Bereiten Sie das Installationskonto vor. Aktualisiert Setup die Datenbank mit SQL-Authentifizierung, werden Benutzername und Passwort dieses Installationskontos erneut abgefragt.
6. Planen Sie die Kiosk-Bildschirme ein. Nach dem Upgrade auf 2.10 können Kiosk-Konten bei der ersten Anmeldung eine Passwortänderung verlangen. Nach dem Upgrade auf 2.11 muss sich an jedem Kiosk-Bildschirm einmal jemand anmelden. Siehe Hinweise zum Upgrade auf diese Version.

Upgrade mit Setup

1. Öffnen Sie die Datei 2WinScada.Setup.<Version>.x64.exe der neuen Version auf demselben Server über Als Administrator ausführen.
2. Setup erkennt das installierte System. Auf der Seite Installationsmodus werden die installierte Version und die Paketversion angezeigt; unterscheiden sich die Versionen, ist Upgrade ausgewählt. Auf dieser Seite kann Installation nicht gewählt werden.
3. Fahren Sie mit Weiter fort. Setup übernimmt die installierten Einstellungen in den Assistenten: Komponenten, Installationsverzeichnis, Firmenname, IIS-Adressen und -Ports, SQL Server und Datenbank, SQL-Sicherungsverzeichnis sowie die QuestDB-Optionen. Das Installationsverzeichnis kann beim Upgrade nicht geändert werden. Die installierten Einstellungen für den MQTT-Broker und MCP werden im Assistenten nicht angezeigt; das Upgrade übernimmt sie unverändert.
4. Prüfen Sie die Seiten:
   • Die vorhandene Komponentenauswahl bleibt erhalten. Eine neue Komponente kann hinzugefügt werden. Ein neu hinzugefügter MQTT Publisher startet mit ausgeschalteter Veröffentlichung; der Broker wird in der Weboberfläche auf der Seite Einstellungen > MQTT-Publisher-Einstellungen eingegeben. Siehe MQTT Publisher.
   • Passwörter werden im Assistenten nicht angezeigt. Die von der Anwendung verwendeten Angaben für SQL, QuestDB, MQTT und MCP werden aus den installierten Einstellungsdateien übernommen.
   • Auf der Seite Datenbank und Wiederherstellung ist das SQL-Sicherungsverzeichnis (bei Upgrade und Reparatur erforderlich; Pfad auf SQL-Host) erforderlich.
   • Aktivieren Sie bei einem normalen Upgrade nicht die Option Lokale QuestDB-Engine aktualisieren (Datensicherung erforderlich) auf der Seite QuestDB-Leistung und Ports. Das Upgrade der QuestDB-Engine ist ein separater, bewusst durchgeführter Vorgang.
5. Prüfen Sie die Seite Zusammenfassung und starten Sie das Upgrade. Vor dem Fortfahren prüft Setup die Einstellungen auf diesem Computer; kann eine Einstellung nicht verwendet werden, hält es an, ohne etwas zu ändern, und Sie können sie mit Zurück korrigieren.

Kann Setup die installierten Einstellungen nicht sicher lesen, bleibt es auf der Seite Installationsmodus und zeigt den Grund an.

Was Setup ausführt

1. Es führt die Vorprüfungen durch und bereitet die neuen Dateien in einem separaten Bereich vor.
2. Es beendet die 2WinScada-Dienste.
3. Es sichert die Anwendungsdateien, die Einstellungen und die SQL-Datenbank.
4. Es wendet die Datenbankänderungen der Reihe nach an und legt die neuen Dateien ab.
5. Es startet die Dienste und führt die Health-Checks durch.

Schlägt ein Schritt fehl, kehrt Setup automatisch zur vorherigen Version zurück. Die Meldung „Die automatische Wiederherstellung ist abgeschlossen.“ bedeutet nicht, dass das Upgrade durchgeführt wurde; das System läuft in der vorherigen Version. Beheben Sie den ersten Fehler und starten Sie das Upgrade erneut. Kann auch das Zurücksetzen nicht abgeschlossen werden, bietet Setup beim nächsten Öffnen die Wiederherstellung an; vor Abschluss der Wiederherstellung wird kein neuer Vorgang gestartet. Löschen Sie Installationsprotokolle und Sicherungsordner nicht von Hand.

Was beim Upgrade erhalten bleibt

• Vorhandene Einstellungsdateien werden mit den Einstellungen der neuen Version zusammengeführt; die Werte des Kunden bleiben erhalten.
• Die Lizenzdateien bleiben erhalten.
• IIS-Adressen, Zertifikatsbindungen und Interneteinstellungen bleiben erhalten.
• Die Speichereinstellungen der installierten QuestDB werden nicht geändert.
• Eine Portänderung oder ein Umzug der Datenbank ist nicht Teil des Upgrades.

Datenbankänderungen in 2.10

In 2.10 wird das Datenbankschema aktualisiert; Setup wendet die erforderlichen Änderungen automatisch und wiederholbar an. Gespeicherte Seiten müssen nicht konvertiert werden.

Hinweise zum Upgrade auf diese Version

2.11: Cookie zur Sitzungserneuerung

Ab 2.11 speichert die Weboberfläche den Schlüssel zur Sitzungserneuerung statt im Browserspeicher in einem Cookie, das Skripte nicht lesen können. Einzelheiten: Browsersitzung.

• Vor dem Upgrade geöffnete Sitzungen arbeiten bis zur nächsten Anmeldung auf die bisherige Weise. Damit der Schutz auch an Kiosk-Bildschirmen greift, melden Sie sich nach dem Upgrade an jedem Kiosk-Bildschirm einmal an. Teilen sich mehrere Kiosks ein Konto, geben Sie den Kiosks zuerst getrennte Konten. Siehe Sitzungserneuerung und gemeinsam genutzte Konten.
• In einer Sitzung, die durch eine Anmeldung nach dem Upgrade geöffnet wurde, macht eine Abmeldung den Erneuerungsschlüssel dieses Browsers auch auf dem Server ungültig. In vor dem Upgrade geöffneten Sitzungen bleibt der Schlüssel bis zur nächsten Anmeldung im Browserspeicher, und eine Abmeldung macht ihn auf dem Server nicht ungültig.
• Weboberfläche und API müssen auf derselben Website liegen. In der von Setup eingerichteten Struktur ist keine weitere Einstellung nötig. In älteren Installationen, in denen die Weboberfläche die API über einen anderen Port aufruft, öffnen Sie die Oberfläche mit dem Namen und dem Schema der API-Adresse.
• Verwenden Sie HTTPS; bei HTTPS wird das Cookie nur über eine verschlüsselte Verbindung gesendet.
• Der MCP-Server und API-Clients sind nicht betroffen.

Erzwungene Passwortänderung und Kiosk-Bildschirme

Ab 2.10 werden Konten, deren Passwort vom Administrator festgelegt wurde, sowie Konten aus älteren Installationen, deren Passwort nie geändert wurde, bei der Anmeldung zuerst zum Bildschirm Ändern Sie Ihr Passwort geleitet; bevor das Passwort geändert ist, ist keine andere Aktion möglich.

Kiosk-Bildschirme

Verwenden dauerhaft eingeschaltete Panel-PCs und Wandbildschirme ein solches Konto, bleiben sie nach dem Upgrade auf 2.10 auf diesem Bildschirm stehen, sobald die Sitzung erneuert wird. Ändern Sie unmittelbar nach dem Upgrade das Passwort des an den Kiosk-Bildschirmen verwendeten Kontos in ein starkes Passwort; ist im Browser ein Passwort gespeichert, aktualisieren Sie es ebenfalls. Siehe Panel-PC und Kiosk.

Schreiben über die ID im Ereigniscode

In 2.10 schreiben die Aufrufe setTag(<Zahl>, ...) und writeTag({ Id: ... }) im Ereigniscode von Seiten über die ID des Tags. Ermitteln Sie vor dem Upgrade die Seiten, die solche Aufrufe enthalten (mit der rein lesenden Inventarabfrage, die der 2WinScada-Support bereitstellt), und prüfen Sie, ob diese Schreibvorgänge vor Ort das gewünschte Verhalten sind.

Rezeptberechtigungen

In 2.10 wurden Rezeptdefinition und Rezeptanwendung getrennt: Bei Neuinstallationen wendet die Gruppe Operators Rezepte nur an; definiert und geändert werden Rezepte von der Gruppe Rezeptverantwortliche.

Bei aktualisierten Installationen ändern sich die Gruppen- und Rollenzuweisungen nicht: Operators behält die Rolle für die Rezeptverwaltung, und die Gruppe Rezeptverantwortliche wird nicht hinzugefügt. Wenn Sie die Aufgabentrennung umsetzen möchten:

1. Legen Sie auf dem Bildschirm Benutzergruppen eine Gruppe für die Personen an, die Rezepte verwalten (z. B. Rezeptverantwortliche), und erteilen Sie dieser Gruppe die Rollen Operate, Monitor, RecipeManagement und RecipeApplier.
2. Verschieben Sie die Benutzer, die Rezepte verwalten, in diese Gruppe.
3. Entfernen Sie die Rolle RecipeManagement aus der Gruppe Operators; RecipeApplier bleibt bestehen.

Treiberdefinitionen und Konten

Listen Sie vor dem Upgrade die folgenden Definitionen auf und prüfen Sie sie nach dem Upgrade:

• Nicht unterstützte Tag- und Gerätedefinitionen: Modbus-Tags vom Typ String oder mit Länge > 1, Modbus-/Siemens-Adressen, die nicht zum Datentyp passen, Siemens-Tags vom Typ LInt/ULInt/LWord und BACnet-Geräte mit IPv6-Adresse werden nicht gelöscht, bleiben aber in der Qualität Bad. Siehe Protokolle – Grenzen der Unterstützung.
• OPC-UA-Kanäle: Prüfen Sie nach dem Upgrade, ob Sicherheitsmodus, Sicherheitsrichtlinie und Identitätstyp jedes Kanals zu dem vom Server angebotenen Endpunkt passen; Kanäle, die nicht passen oder mit einem nicht unterstützten Identitätstyp (Certificate, IssuedToken) gespeichert wurden, gehen auf Bad. Kanäle, die mit der Identität User und der Sicherheitseinstellung None / None gespeichert wurden, verbinden sich mit dem unverschlüsselten Endpunkt; wählen Sie bei Kanälen, die sich mit Benutzername und Passwort verbinden, SignAndEncrypt, sofern der Server es unterstützt. Prüfen Sie auch die Einstellungen für Priorität und Totband in den Geräten. Siehe OPC-UA-Client.
• Verbrauchssummen: In 2.10 wurde die Verbrauchsberechnung für Zähler aktualisiert; die Summen können von den Berichten aus 2.9 abweichen. Siehe Zählerregel.
• Median-Wert von Logs und erweiterten Tags: In 2.10 wurde die Berechnung von Median (Mean) aktualisiert; nach 2.10 geschriebene Median-Werte können von früheren Datensätzen abweichen. Siehe Log-Definitionen (Archiv).

Weitere Änderungen

• Standardkonten: Die bei Neuinstallationen angelegten Beispielkonten werden aktualisierten Installationen nicht hinzugefügt; vorhandene Konten bleiben erhalten. Ändern Sie nach dem Upgrade die Passwörter gemeinsam genutzter Konten und entfernen Sie nicht verwendete Konten.
• SystemAdmin-Schutz: 2.10 führt einen zusätzlichen Integritätsschutz für Administratorkonten ein. Prüfen Sie nach dem Upgrade, dass auf der Seite Systeminformationen keine Warnkarte angezeigt wird; wenden Sie sich bei einer Warnung an Ihren Systemintegrator. Siehe Schutz des Administratorkontos. Wird die SystemAdmin-Anmeldung trotz korrektem Passwort abgelehnt oder wurde das SystemAdmin-Passwort vergessen, siehe Wenn das Passwort vergessen wurde oder die Anmeldung abgelehnt wird.
• Datenbank-Wartungsdienst: Der außer Betrieb genommene Dienst 2WinScada.Db.Maintanence wird beim Upgrade beendet und auf Deaktiviert gesetzt. Seine Aufgaben übernimmt der Haupt-API-Dienst.
• Hilfsdienste: Externe Systeme greifen über die Haupt-API auf die Dienste Notification und RecordDevice zu. Stellen Sie Integrationen, die die internen Ports dieser Dienste verwenden, auf die Haupt-API um.
• Lizenzen: Prüfen Sie vor dem Upgrade mit dem 2WinScada-Support, ob Ihre Lizenz mit 2.10 kompatibel ist. Prüfen Sie nach dem Upgrade die Lizenzwarnungen im Setup-Protokoll. Siehe Lizenz.
• QuestDB-Protokolle: Setup begrenzt die Größe und die Aufbewahrungsdauer der QuestDB-Protokolle. Die neue Einstellung gilt ab dem nächsten Neustart des QuestDB-Dienstes.
• QuestDB-Profil mit 2 GB: Systeme, die mit dem alten 2-GB-Profil installiert wurden, behalten dieses Profil; ein Wechsel auf das 4-GB-Profil wird empfohlen.

WhatsApp-Benachrichtigung

Mit 2.10.0 kam WhatsApp als zusätzlicher Kanal für Alarmbenachrichtigungen hinzu. Vorhandene Benachrichtigungsdefinitionen bleiben ohne WhatsApp; das Upgrade ändert ihr Verhalten nicht. Wenn WhatsApp verwendet werden soll:

• Erlauben Sie vom Server, auf dem der Benachrichtigungsdienst läuft, ausgehende HTTPS-Verbindungen (TCP 443) zur Adresse graph.facebook.com. Siehe Ausgehende Verbindungen.
• Importieren Sie Ihre neue Lizenz mit WhatsApp-Berechtigung nach dem Upgrade der Software auf 2.10.0. Siehe WhatsApp-Berechtigung.
• Bereiten Sie das Meta-Konto, die genehmigte Vorlage und die Einwilligungen der Empfänger vor. Siehe WhatsApp-Einstellungen.

Manuelles Upgrade

Mit Setup installierte Systeme immer mit Setup aktualisieren

Aktualisieren Sie die Datenbank eines mit Setup installierten Systems nicht von Hand. Das manuelle Upgrade ist nur für Systeme gedacht, die nicht mit Setup installiert wurden (ohne Installationsmanifest); die Schritte beschreibt die mit dem Produkt installierte Hilfe.

Prüfung nach dem Upgrade

• Der Installationsbericht zeigt, dass das Upgrade abgeschlossen ist (Wert von InstallationCompleted ist true). Der Bericht liegt in der Datei %ProgramData%\2WinScada\InstallerRuntime\deployment-result.json.
• In der Windows-Liste Dienste laufen die 2WinScada-Dienste und der lokale QuestDB-Dienst.
• Die Anmeldung an der Weboberfläche ist möglich; auf der Seite Systeminformationen werden die Dienste als laufend angezeigt, und es gibt keine Warnkarte.
• In der Fußzeile erscheint keine Lizenzanzeige, oder sie zeigt den erwarteten Status.
• Auf der Seite Systeminformationen gibt es keine SystemAdmin-Integritätswarnung.
• Die Kiosk-Bildschirme stehen nicht auf dem Bildschirm zur Passwortänderung und haben die neue Version von selbst geladen. Andere geöffnet gebliebene Bildschirme zeigen den Hinweis „Eine neue Version wurde installiert“; laden Sie auf diesen Bildschirmen die Seite neu.
• Nach dem Upgrade auf 2.11 hat sich an jedem Kiosk-Bildschirm einmal jemand angemeldet. Nach der Anmeldung öffnet sich die Sitzung in einem neuen Browser-Tab ohne Anmeldung.
• Live-Daten, Alarme, Trends und Verbrauchsdiagramme zeigen die erwarteten Werte; Benachrichtigungen und die MQTT-Veröffentlichung (falls verwendet) funktionieren.
• Tags oder Kanäle, die in der Qualität Bad geblieben sind, wurden gemäß dem Grund im Dienstprotokoll in den Treiberdefinitionen korrigiert; die OPC-UA-Kanäle sind verbunden.
• Die Datei %ProgramData%\2WinScada\Logs\setup.log enthält keine Fehler.

Reparatur

Die Reparatur wird mit einem Paket ausgeführt, dessen Version exakt der installierten Version entspricht. Sie installiert fehlende oder beschädigte Anwendungsdateien und die Dienstkonfiguration neu. Daten von SQL Server und QuestDB werden nicht gelöscht; die Version wird weder angehoben noch herabgesetzt. Sie ist kein allgemeines Werkzeug zum Ändern von Einstellungen.

Die Reparatur wird in folgenden Fällen verwendet:

• wenn Anwendungsdateien oder die Dienstkonfiguration beschädigt sind,
• wenn sich die IP-Adresse des Servers geändert hat,
• wenn das Internetprofil aktiviert oder deaktiviert werden soll (siehe Internet- und Netzwerkzugang),
• damit HSTS nach dem Wechsel auf ein vertrauenswürdiges Zertifikat aktiviert wird.

Wird dasselbe Paket wie die installierte Version ausgeführt, ist auf der Seite Installationsmodus Reparatur ausgewählt, und Upgrade ist nicht verfügbar.

• Auch bei einer Reparatur ist auf der Seite Datenbank und Wiederherstellung das SQL-Sicherungsverzeichnis (bei Upgrade und Reparatur erforderlich; Pfad auf SQL-Host) erforderlich; Setup sichert zuerst die vorhandene Datenbank in diesen Ordner.
• Ist MQTT Publisher installiert, erscheint darunter auf der Seite Komponenten die Option Fehlende MQTT-Einstellungsdatei neu erstellen (Veröffentlichung bleibt aus, bis der Broker im Web gespeichert ist). Die Option ist standardmäßig deaktiviert; aktivieren Sie sie nur, wenn die Einstellungsdatei des MQTT Publishers fehlt. Ist die Datei vorhanden oder beschädigt, bricht die Reparatur ab, und die Datei wird nicht überschrieben. Wurden die MQTT-Publisher-Einstellungen bereits in der Weboberfläche gespeichert, läuft die Veröffentlichung nach der Reparatur mit diesen Einstellungen weiter; andernfalls geben Sie die Broker-Daten auf der Seite Einstellungen > MQTT-Publisher-Einstellungen ein.

Wenn sich die IP-Adresse des Servers geändert hat

1. Öffnen Sie Setup mit dem Paket der installierten Version; Reparatur ist ausgewählt.
2. Geben Sie auf der Seite IIS und SSL im Feld Domain oder IP die neue IP-Adresse des Servers vollständig ein. Auf der Seite Zusammenfassung werden die alte und die neue Adresse angezeigt.
3. Schließen Sie die Reparatur ab und prüfen Sie den HTTP- und HTTPS-Zugriff mit der neuen Adresse.

• Die neue IP muss der Netzwerkkarte des Servers zugewiesen sein.
• Wird ein PFX-Zertifikat verwendet, muss die neue IP im Zertifikat enthalten sein.
• Wird das selbstsignierte Zertifikat erneuert, aktualisieren Sie auch das Vertrauen auf den Clients. Siehe Selbstsigniertes Zertifikat.
• Ist in IIS ein von der alten Adresse abweichender DNS-Name (Hostheader) eingetragen, bleibt dieser Name erhalten.
• Die Daten von SQL Server und QuestDB sowie die Lizenz bleiben erhalten.

Bei einer unbeaufsichtigten Reparatur werden zwei Einstellungen zusammen angegeben:

2WinScada.Setup.<Version>.x64.exe /S /MODE=Repair /DOMAIN_OR_IP=<neue IP> /UPDATE_PUBLIC_ADDRESS=1

Deinstallation

Um 2WinScada zu deinstallieren, verwenden Sie den Pfad Windows-Einstellungen > Apps > Installierte Apps > 2WinScada > Deinstallieren oder führen Sie die Datei %ProgramData%\2WinScada\InstallerRuntime\Uninstall.exe als Administrator aus.

• Vor der Bestätigung öffnet das Deinstallationsprogramm einen Plan, der zeigt, welche Ressourcen entfernt und welche beibehalten werden. Prüfen Sie den Plan sorgfältig.
• Die von Setup angelegte Datenbank und die Daten der von Setup installierten QuestDB werden gelöscht. Die von Setup installierte SQL-Server-Express-Instanz wird ebenfalls entfernt, sofern sie keine anderen Datenbanken enthält.
• Ressourcen, die Setup nicht angelegt hat, die gemeinsam genutzt oder von anderen Systemen verwendet werden, bleiben unberührt.
• Die Lizenzinformationen bleiben in jedem Fall erhalten. Siehe Deinstallation und Neuinstallation.
• Sichern Sie vor der Deinstallation Daten und Konfiguration, kopieren Sie die Sicherung auf einen anderen Computer und schließen Sie den License Manager.
• Das Ergebnis wird in die Datei %ProgramData%\2WinScada\Logs\uninstall-result.json geschrieben.
• Das Deinstallationsprogramm prüft die Ressourcen in SQL Server mit dem Windows-Konto, das die Deinstallation ausführt. Ist SQL Server nicht erreichbar oder lehnt es dieses Konto ab, bricht die Deinstallation ab; die Meldung nennt den Schritt, an dem sie abgebrochen wurde, und was das Konto benötigt. Wird der von Setup installierte SQL Server Express verwendet, kann jeder lokale Administrator des Computers die Deinstallation ausführen.

Wird die Deinstallation unterbrochen, löschen Sie weder das Installationsmanifest noch die Protokolle oder das Deinstallationsprogramm; das Deinstallationsprogramm bleibt erneut ausführbar.