2017/10/14 12:37 1/2 Installation von CoDaBix Compact

Transkript

1 2017/10/14 12:37 1/2 Installation von CoDaBix Compact Inhaltsverzeichnis Installation von CoDaBix Compact... 1 Systemanforderungen... 1 Unterstützte Betriebssysteme... 1 Erforderliche Komponenten... 1 Anforderungen für die Backend-Datenbank... 1 Hardware-Anforderungen... 2 CoDaBix Setup und erster Start... 2 CoDaBix Compact Setup... 2 Installieren und Deinstallieren von Plugins... 2 CoDaBix Compact updaten... 3 Optimieren der CoDaBix -Performance... 3 Erster Start... 3 CoDaBix Compact Einstellungen... 5 Basic Settings... 5 MySQL Settings... 7 CoDaBix Compact als Dienst installieren... 7

2 Last update: 2017/10/12 11:49 de:install Printed on 2017/10/14 12:37

3 2017/10/14 12:37 1/9 Installation von CoDaBix Compact Installation von CoDaBix Compact CoDaBix Compact ist aktuell für Windows-Betriebssysteme verfügbar. Sie können CoDaBix Compact sowohl auf Workstation- als auch auf Serverversionen von Windows installieren. CoDaBix läuft sowohl auf 32-Bit- als auch auf 64-Bit-Versionen von Windows. Aus Stabilitätsgründen empfehlen wir allerdings, CoDaBix auf einer 64-Bit-Windows-Version laufen zu lassen. Systemanforderungen Unterstützte Betriebssysteme CoDaBix Compact wird auf folgenden Windows-Betriebssystemen unterstützt: Windows-Version Workstation-Betriebssystem Server-Betriebssystem Windows 7 SP1 1) (Variante Vollständige Windows Server 2008 R2 SP1 2) Installation ) Windows Windows 10 Enterprise 2015 LTSB (Version 1507) Windows 10 Version 1607 (Anniversary Update) Windows 10 Enterprise 2016 LTSB Windows 10 Version 1703 (Creators Update) Windows 10 Version 1709 (Fall Creators Update) Erforderliche Komponenten Windows Server ) (Variante Server mit grafischer Benutzeroberfläche ) Windows Server 2012 R2 (Variante Server mit grafischer Benutzeroberfläche ) Windows Server 2016 (Variante Server mit Desktopdarstellung ) CoDaBix benötigt das.net Framework 4.6 oder höher, welches in Windows 10 bzw. Windows Server 2016 oder höher enthalten ist. Für Windows-Versionen älter als Windows 10 Version 1703 (Creators Update) empfehlen wir, das.net Framework 4.7 zu installieren 4), oder alternativ.net Framework 4.6.1, falls auf Ihrer Windows-Version.NET 4.7 nicht unterstützt wird. Unter Windows 7 SP1 und Windows Server 2008 R2 SP1 benötigt CoDaBix außerdem eine unterstützte Version des Internet Explorers (IE 11) für die Webkonfiguration. Anforderungen für die Backend-Datenbank Standardmäßig benutzt CoDaBix Compact eine eingebettete Datenbank (SQLite), welche

4 Last update: 2017/10/12 11:49 de:install keine weiteren Anforderungen stellt. Wenn Sie hingegen planen, MySQL als Backend-Datenbank zu nutzen, stellen Sie bitte sicher, dass Sie MySQL 5.7 oder höher verwenden. Wir empfehlen, MySQL auf der selben Maschine wie CoDaBix auszuführen. Hardware-Anforderungen Empfohlen: Dual-Core CPU, 4 GB RAM CoDaBix Setup und erster Start CoDaBix Compact Setup Um CoDaBix Compact zu installieren, laden Sie bitte den CoDaBix Compact Installer (MSI- Datei) herunter und führen ihn aus. Sie können dabei auswählen, welche Devices und Plugins mit CoDaBix installiert werden sollen. Hinweis: Standardmäßig wird das Demo-Data (Continuous) -Plugin mitinstalliert, welches alle paar Sekunden Demodaten generiert. Installieren und Deinstallieren von Plugins Printed on 2017/10/14 12:37

5 2017/10/14 12:37 3/9 Installation von CoDaBix Compact Wenn Sie Ihre CoDaBix Compact-Installation zu einem späteren Zeitpunkt ändern möchten (z. B. um Plugins hinzuzufügen oder zu entfernen), starten Sie einfach den CoDaBix Compact Installer erneut (alternativ können Sie auch in der Windows-Systemsteuerung auf Programme und Features gehen, dann CoDaBix Compact wählen und auf Ändern klicken). Sie können dann im Installer auf Change klicken, um die Plugins von CoDaBix auszuwählen, die installiert oder deinstalliert werden sollen. CoDaBix Compact updaten Wenn Sie bereits CoDaBix Compact installiert haben und auf eine neuere Version updaten möchten, müssen Sie nicht extra die alte Version deinstallieren. Führen Sie einfach den CoDaBix Compact Installer der neueren Version aus und dieser wird automatisch CoDaBix auf die neue Version updaten. Hinweis: Wenn Sie CoDaBix als Dienst installiert hatten, müssen Sie nach dem Update den Dienst im CoDaBix Settings-Dialog erneut installieren. Optimieren der CoDaBix -Performance Sobald Sie ein Windows Update oder eine neue.net Framework-Version installieren, kann die Geschwindigkeit von CoDaBix noch langsam sein, da der.net Native Image Generator die Performance noch nicht optimiert hat. Bei Workstation-Editionen von Windows (Windows 7, 8, 10) wird diese Optimierung standardmäßig erst ausgeführt, wenn der PC im Leerlauf war, was einige Zeit dauern kann. Der CoDaBix Compact Installer enthält ein Script, mit dem Sie die Optimierung sofort durchführen können, ohne darauf warten zu müssen, bis der PC im Leerlauf war. Wir empfehlen, dieses Script immer dann auszuführen, wenn Sie Windows Updates installiert haben. Sie finden das Script im Windows-Startmenü im CoDaBix Compact -Ordner: Erster Start Wenn Sie CoDaBix Compact das erste Mal starten, wird der CoDaBix Settings-Dialog angezeigt. Bitte geben Sie ein Datenverzeichnis an (am besten einen leeren Ordner), in welchem CoDaBix Compact seine Daten (Datenbank, Konfiguration, Logdateien usw.) abspeichern soll. Anschließend klicken Sie bitte auf OK, um die Einstellungen anzuwenden. Nun werden Sie aufgefordert, ein Admin-Passwort zu setzen. Dieses benötigen Sie später für die Konfiguration.

6 Last update: 2017/10/12 11:49 de:install Hinweis: Möglicherweise wird ein Dialog der Windows Firewall angezeigt, in dem Sie gefragt werden, ob der Zugriff auf CoDaBix Compact erlaubt werden soll. Dies kommt vom OPC UA Server Plugin, welches standardmäßig einen OPC UA Server auf Port 4840 erstellt. Wenn Sie auf Zugriff erlauben klicken, können andere Geräte im Netzwerk auf den OPC-Server zugreifen. Nachdem Sie das Passwort gesetzt haben und CoDaBix Compact gestartet ist, erscheint der Login-Dialog der Webkonfiguration. Hier können Sie sich nun mit dem Benutzernamen admin und Ihrem zuvor gesetzten Passwort einloggen. Hinweis: Wenn Sie CoDaBix auf Windows 7 ausführen, könnte die folgende gelbe Informationsleiste oben angezeigt werden: Printed on 2017/10/14 12:37

7 2017/10/14 12:37 5/9 Installation von CoDaBix Compact Hierbei handelt es sich um eine reine Informationsmeldung des eingebetteten Internet Explorers. Um die Meldung nicht mehr anzuzeigen, können Sie darauf klicken und dann Diese Meldung nicht mehr anzeigen wählen. CoDaBix Compact Einstellungen CoDaBix Compact bietet einige konfigurierbare Einstellungen. Um diese zu editieren, klicken Sie auf das Zahnrad-Icon in der Symbolleiste oben rechts ( ), über das sich der CoDaBix Settings-Dialog öffnet. Basic Settings Name Data Directory Beschreibung Das Datenverzeichnis ist das Verzeichnis, in dem CoDaBix seine Datenbank (wenn Database Mode auf Embedded eingestellt ist), Logdateien und Konfigurationsdateien für die Plugins ablegt. Beim Erstellen eines Backups werden die Inhalte des Datenverzeichnisses (außer Logdateien) im Backup mit abgelegt.

8 Last update: 2017/10/12 11:49 de:install Name Local HTTP Port Service HTTP(S) Bindings File Access Security Log Level Beschreibung CoDaBix benutzt einen eingebetteten Webserver (HTTP), der auf dem angegebenen TCP-Port für lokale Verbindungen lauscht, um die Webkonfiguration und das REST / JSON Interface bereitzustellen. Standardmäßig benutzt CoDaBix den Port Hinweis: Wenn Sie Ports 1024 (wie z. B. Port 80) verwenden möchten oder die CoDaBix Web GUI oder das REST / JSON Interface auf anderen Geräten im Netzwerk aufrufen möchten, müssen Sie CoDaBix Compact als Dienst installieren (siehe unten). Für Letzteres müssen Sie außerdem die Service HTTP(S) Bindings -Optionen öffnen und dort die Option Use the Local Port as remote HTTP Binding aktivieren. Anderenfalls sind nur Ports > 1024 möglich und auf CoDaBix kann über HTTP nur vom lokalen PC aus zugegriffen werden. Wenn CoDaBix als Dienst ausgeführt wird, können Sie diverse HTTP- und HTTPS-Bindings, bestehend aus Hostnamen, Port und SSL-Zertifikat (für HTTPS), für Remoteverbindungen festlegen. Dies ermöglicht Ihnen, eine Verbindung zu CoDaBix von fremden Geräten herzustellen, optional über eine authentifizierte und verschlüsselte TLS-Verbindung. Hinweis: Um ein SSL-Zertifikat verwenden zu können, muss dieses im Personal- oder im Web Hosting-Zertifikatsspeicher des Kontos Lokaler Computer in Windows gespeichert sein und Sie müssen einen privaten Schlüssel für das Zertifikat besitzen. Zwischenzertifikate (auch CA-Zertifikat genannt) müssen im Intermediate Certificate Authorities-Zertifikatsspeicher gespeichert sein. Um Zertifikate unter Windows zu verwalten, können Sie MMC verwenden, indem Sie certlm.msc starten und dann den Ordner Eigene Zertifikate (bzw. Webhosting) für Ihr Zertifikat sowie Zwischenzertifizierungsstellen für Ihre Zwischenzertifikate öffnen; oder Sie können Powershell verwenden, wenn Sie zum Pfad Cert:\LocalMachine\My (oder Cert:\LocalMachine\WebHosting) für Ihr Zertifikat sowie Cert:\LocalMachine\CA für Ihre Zwischenzertifikate wechseln. In CoDaBix können Sie auf Dateien Ihres Systems zugreifen, wenn Sie File Nodes erstellen (und auf diese dann per HTTP-Access-URL oder über einen OPC UA Client zugreifen), oder ein Script schreiben, das die io.file- und io.directory-namespaces benutzt. Um einen Benutzer, der das CoDaBix - Adminpasswort sowie lokalen oder Netzwerkzugriff auf die Web-Konfiguration hat, daran zu hindern, auf beliebige Dateien zuzugreifen (vor allem wenn CoDaBix als Dienst läuft), können Sie Zugriff auf bestimmte Pfade erlauben oder verweigern. Außerdem können Sie alternative Zugangsdaten angeben, die beim Zugriff auf den Pfad benutzt werden sollen (dies geschieht über Impersonation), oder alternativ den Pfad als Netzwerkresource hinzufügen. Standardmäßig ist das Datenverzeichnis für Lese- und Schreibzugriff sowie das Installationsverzeichnis für Lesezugriff zugelassen. Gibt das Logging-Detaillevel an, das CoDaBix Compact beim Schreiben von Logdateien benutzen soll. Es werden nur solche Einträge geschrieben, deren Schweregrad mindestens so hoch ist wie das angegebene Level. 'No' bedeutet, dass keine Logdateien erstellt werden. Printed on 2017/10/14 12:37

9 2017/10/14 12:37 7/9 Installation von CoDaBix Compact Name Back-end Database Mode Beschreibung Gibt an, welche Backend-Datenbank benutzt werden soll. Standardmäßig verwendet CoDaBix Compact eine eingebettete Datenbank (SQLite), welche keine zusätzliche Konfiguration benötigt. Die eingebettete Datenbank wird in den Dateien codabix.db und codabixhistorydb.db im eingestellten Datenverzeichnis gespeichert. Sie können jedoch auch einen MySQL-Server (Version 5.7 oder höher) als Backend-Datenbank verwenden. Wenn Sie dementsprechend MySQL auswählen, müssen Sie die weiteren Einstellungen unter der Kategorie MySQL Settings ausfüllen. Beim Erstellen eines Backups werden die Inhalte der Backend-Datenbank im Backup mit abgelegt. Sie können auch die aktuelle Backend-Datenbank von SQLite nach MySQL (oder von MySQL nach SQLite) migrieren, indem Sie ein Backup erstellen, den Database Mode umstellen und anschließend das Backup wiederherstellen. MySQL Settings (nur anwendbar wenn der Backend Database Mode auf MySQL gestellt ist) Name Hostname Port Database Name Login Name Beschreibung Gibt den Hostnamen bzw. die IP-Adresse des MySQL-Servers an. Gibt den TCP-Port des MySQL-Servers an. Gibt die Datenbank (auch Schema genannt) an, welche CoDaBix auf dem MySQL-Server benutzen soll. Wenn die angegebene Datenbank nicht existiert, legt CoDaBix diese sowie alle dazugehörigen Tabellen automatisch an. Gibt den Namen des MySQL-Benutzers an, unter welchem die Datenbankverbindung hergestellt werden soll. Password Gibt das Passwort des MySQL-Benutzers an. CoDaBix Compact als Dienst installieren Sie können CoDaBix Compact als Dienst installieren. Dadurch wird CoDaBix Compact automatisch und dauerhaft im Hintergrund (wie auf einem Server) ausgeführt, ohne dass explizit die CoDaBix Compact-Anwendung gestartet werden muss. Außerdem können dann andere Geräte im Netzwerk auf die CoDaBix Compact-Instanz über HTTP (z. B. auf die Webkonfiguration oder das REST / JSON Interface) zugreifen, wenn Sie in den Service HTTP(S) Bindings -Optionen die Option Use the Local Port as remote HTTP Binding aktivieren. Das Ausführen als Dienst ermöglicht auch die Verwendung von HTTP-Ports 1024, z.b. Port 80. Nachdem Sie den CoDaBix Settings-Dialog über das Zahnrad-Icon in der Symbolleiste oben rechts ( ) geöffnet haben, zeigt dieser unten den Abschnitt Service Management an, über den Sie CoDaBix als Dienst installieren, starten, stoppen und deinstallieren können: Sie können CoDaBix Compact als Dienst installieren und starten, indem Sie auf den Button Install + Start Service klicken. In diesem Fall wird ein Dialog der Benutzerkontensteuerung

10 Last update: 2017/10/12 11:49 de:install (UAC) angezeigt, da für das Installieren von Diensten Administratorrechte erforderlich sind. Um den Dienst wieder zu deinstallieren, klicken Sie auf den Uninstall Service -Button. Hinweis: Wenn Sie eine Einstellung wie das Datenverzeichnis oder den HTTP-Port ändern, während CoDaBix Compact als Dienst läuft, muss der Dienst neugestartet werden, um die neuen Einstellungen anzuwenden. Dies wird durch den folgenden Dialog angezeigt, über den Sie den Dienst neustarten lassen können: Hinweis: Der Dienst ist so konfiguriert, dass er im Fehlerfall automatisch neustartet. Dadurch wird sichergestellt, dass CoDaBix in einen sauberen, definierten Zustand neustarten kann, nachdem ein schwerwiegender Fehler aufgetreten ist. 1), 2) Einige Features sind erst unter Windows 8.1 bzw. Windows Server 2012 oder höher verfügbar. Dies beinhaltet WebSocket-Verbindungen und HTTPS-Bindings für einzelne Hostnamen. 3) Wenn Sie CoDaBix Compact auf Windows Server 2012 (nicht R2) ausführen, funktioniert die Webkonfiguration innerhalb des CoDaBix Compact Fensters nicht. Der Grund dafür ist, dass Windows Server 2012 nur den IE 10, nicht aber den IE 11 unterstützt. Um auf die Webkonfiguration zuzugreifen, können Sie einen alternativen Browser wie Mozilla Firefox verwenden. 4) Benutzer von Windows 7 SP1, Windows Server 2008 R2 SP1 oder Windows Server 2012 müssen Printed on 2017/10/14 12:37

11 2017/10/14 12:37 9/9 Installation von CoDaBix Compact möglicherweise erst ein vorausgesetztes Update installieren, bevor sie.net Framework 4.7 installieren können. Falls die Installation von.net 4.7 unter Windows 7 SP1 oder Windows Server 2008 R2 SP1 mit dem Fehler Eine Zertifikatkette zu einer vertrauenswürdigen Stammzertifizierungsstelle konnte nicht aufgebaut werden. fehlschlägt (welcher auftreten kann, wenn Sie nicht alle aktuellen Updates installiert haben), können Sie stattdessen zuerst.net Framework installieren, und später.net Framework 4.7 installieren. Falls die Installation von.net unter Windows 7 oder Windows Server 2008 R2 mit dem Fehler.NET Framework 4.x wird auf diesem Betriebssystem nicht unterstützt. fehlschlägt, müssen Sie zuerst Service Pack 1 installieren. Benutzer von Windows 8.1 oder Windows Server 2012 R2 müssen möglicherweise erst KB (x86 oder x64) und KB (x86 oder x64) (in dieser Reihenfolge) installieren, bevor sie eine neue.net-version installieren können. From: - CoDaBix Permanent link: Last update: 2017/10/12 11:49