webserver.js Einrichtung

Vor der Einrichtung von webserver.js ist sicherzustellen, dass folgende Voraussetzungen erfüllt sind:

Eine WinCC OA Installation (Version 3.21 oder höher) mit der installierten Setup-Komponente Umgebung für JavaScript.
Der WinCC OA JavaScript Manager für Node.js ist verfügbar.
Gültige SSL-Zertifikate für HTTPS-Verbindungen (siehe SSL-Zertifikate).

webserver.js wird als Backend für das WinCC OA Dashboard und Webanwendungen eingesetzt. In den folgenden Abschnitten wird beschrieben, wie der Manager-Eintrag hinzugefügt und der Server für das Projekt konfiguriert wird.

Die WinCC OA Console wird geöffnet.
Dem Projekt wird ein JavaScript Manager hinzugefügt.
In der Console wird ein neuer Manager mit folgenden Einstellungen hinzugefügt:
- Manager-Typ: node
- Skript: webserver-js/run.js
Zusätzliche Parameter müssen vor dem Skriptpfad angegeben werden. Beispiel:
```
-num 4 webserver-js/run.js
```
Der Abschnitt [webserverjs] wird in der Projektkonfigurationsdatei konfiguriert.
In die config-Datei des Projekts wird ein Abschnitt [webserverjs] eingefügt. Der Standard-HTTPS-Port ist 8443. Um einen anderen Port zu verwenden, wird dieser explizit angegeben:
```
[webserverjs]
httpsPort = 8443
```
Der Standardport ist 8443. Dieser Port unterscheidet sich vom Standardport von webclient_http.ctl, sodass beide parallel ohne Portkonflikte betrieben werden können.
Der JavaScript-Manager wird gestartet.

Der Manager wird in der Console gestartet oder neu gestartet. Sobald er läuft, wird das Dashboard geöffnet, indem in einem Webbrowser zu https://<hostname>:8443 navigiert wird.

webserver.js ist jetzt in Betrieb und das WinCC OA-Dashboard wird bereitgestellt. Dies kann überprüft werden, indem die konfigurierte URL in einem Webbrowser geöffnet wird.

Migration von älteren Komponenten

Bei einer Migration von einer bestehenden dashboard.ctl- oder HTTP-Server-Konfiguration sind die folgenden Änderungen zu beachten:

Table 1. Migration von dashboard.ctl / HTTP Server zu webserver.js
Einstellung	dashboard.ctl (alt)	webserver.js (neu)
Manager-Typ	`WCCOActrl`	`node`
Skript	`dashboard.ctl`	`webserver-js/run.js`
Konfigurationsabschnitt (WSS)	`[wssServer]`	`[webserverjs]`
Konfigurationsabschnitt (Dashboard)	`[httpServer]`	`[webserverjs]`
Standardport	`8448`	`8443`
Parameterposition	Nach dem Skriptnamen	Vor dem Skriptpfad

Das folgende Beispiel zeigt die erforderlichen Änderungen in der Datei config/progs.

Vorher (dashboard.ctl):

WCCOActrl        | always |      30 |        3 |        1 |webclient_http.ctl -num 2
WCCOActrl        | always |      30 |        3 |        1 |dashboard.ctl

Nachher (webserver.js):

WCCOActrl        | always |      30 |        3 |        1 |webclient_http.ctl -num 2
node             | always |      30 |        3 |        1 |webserver-js/run.js

Note:

Der CTRL Manager mit webclient_http.ctl wird weiterhin für die ULC UX-Weiterleitung und andere Zwecke benötigt, die nicht von webserver.js abgedeckt werden. Er darf nicht entfernt werden. Beide Manager können parallel betrieben werden, sofern sie unterschiedliche Portnummern verwenden.