Data Crow Server

Seit Data Crow 4.0 ist es möglich, Data Crow als Server zu betreiben. Dies ermöglicht es den Clients, sich mit einer einzigen Instanz von Data Crow zu verbinden.

Die Server-Edition ist ein erweiterter Server, ein kombinierter Web- und Anwendungsserver. Das bedeutet, dass die Benutzer über den Thick-Client (die Data Crow-Anwendung) und/oder den Web-Client (den Browser) eine Verbindung zu Data Crow herstellen können. Der Server ermöglicht es mehreren Benutzern, sich mit einem dieser Clients (Thick-/Web-Client) gleichzeitig mit dem Server zu verbinden. Die Benutzerverwaltungsfunktion ermöglicht es Ihnen, granulare Benutzerberechtigungen pro Benutzer bis hin zur Feldebene festzulegen.

Die Server-Edition ist "headless", d. h. sie kann in Umgebungen ohne grafische Benutzeroberfläche ausgeführt werden.

Komponenten #

Der Data Crow-Server besteht aus den folgenden Komponenten:

• Anwendungsserver - dies ist die Hauptkomponente, der Server selbst. Andere Komponenten stützen sich auf diese Komponente - sie bietet alle grundlegenden Funktionen. Sie wird direkt in einem Client-Server-Setup verwendet, bei dem der vollständige Data-Crow-Client (bezeichnet als fett Client) verbindet sich direkt mit dem Server.
• Image Server - dies ist eine einfache HTTP-Komponente, die die Data Crow-Bilder bereitstellt. Sie wird von jedem Client verwendet, der Bilder anzeigt (Web-Client und Fat-Clients). Sie wird von Jetty gehostet, einem Webserver, der in Data Crow Server integriert wurde.
• API Server - die API stellt die Daten von Data Crow allen Komponenten zur Verfügung, die möglicherweise an einem anderen Ort laufen. Sie bietet Daten im JSON-Format an. Derzeit wird sie ausschließlich vom Data Crow-Webserver verwendet. Er bietet die Daten sicher über den Data Crow-Authentifizierungsmechanismus an. Der API-Server wird ebenfalls von Jetty gehostet.
• Webserver - der Webserver ermöglicht es den Nutzern, sich von jedem Gerät aus zu verbinden, das einen Webbrowser besitzt. Es ist eine einfache Möglichkeit, von einem Tablet, einem mobilen Gerät, einem Computer usw. auf die Informationen zuzugreifen. Der Webserver wird ebenfalls von Jetty gehostet. Beachten Sie, dass dies problemlos auch an einem anderen Ort eingesetzt werden kann; alle erforderlichen Dateien finden Sie in der Datei webapp-main. Kopieren Sie diese einfach auf einen beliebigen anderen Webserver. Jeder Webserver ist in der Lage, diese ohne Probleme zu hosten.

Installieren des Servers #

So installieren Sie den Server:

• Entpacken Sie die gezippte Data Crow Server-Distribution an den Installationsort.

Das war's - es ist keine weitere Installation erforderlich. Sie benötigen allerdings Java Version 17 oder höher (OpenJDK oder Java von Oracle).

Einrichten des Servers #

Genauso wie der normale Client einen Benutzerordner benötigt, in dem er die Daten und Einstellungen speichert, benötigt auch der Server einen solchen Ordner. Sie können wählen, ob die Server-Edition einen neuen, leeren Benutzerordner einrichten soll, oder ob Sie einen vorhandenen Benutzerordner verwenden wollen.

Tipp: Verwenden Sie den Thick-Client, um den anfänglichen Benutzerordner einzurichten - verwenden Sie den Client, um Benutzer anzulegen, die Systemeinstellungen zu ändern und Data Crow grundsätzlich so zu konfigurieren, dass es Ihren Anforderungen entspricht. Im Gegensatz zum Web-Client, der nicht alle Funktionen des Thick-Clients bietet.

Betrieb des Servers #

Der Server hat keine grafische Benutzeroberfläche (GUI), d.h. er ist vollständig auf die Befehlszeile angewiesen. Öffnen Sie das Terminal (Linux- und Mac-Benutzer) / die Eingabeaufforderung (Windows-Benutzer) und navigieren Sie zum Installationsordner von Data Crow Server.

Der Server kann wie folgt gestartet werden.

Java -Xmx1024m -jar datacrow-server.jar -Benutzerverzeichnis: -Anschluss: -imageserverport: -webserverport: -apiserverport: -Zugangsdaten:/

Erläuterung:

• userdir: gibt den Speicherort des Benutzerordners an.
  Beispiel (Windows): -Userdir:c:/server-data
• Hafen: gibt die Hauptportnummer für den Anwendungsserver an. Der Standardanschluss ist 9000. Wenn Sie den Port-Parameter nicht angeben, wird Port 9000 verwendet.
  Beispiel: -Anschluss:9000
  Nach dem Start des Servers stellen die Clients eine Verbindung her, indem sie den Data Crow Client im Client-Modus starten (Parameter -client).
• Webserver-Port: gibt den Port an, der für den Webserver verwendet werden soll. Wird er nicht angegeben, wird das Webserver-Modul nicht gestartet. Beachten Sie, dass der Webserver sowohl den Bildserver (zum Abrufen der Bilder) als auch den API-Server (für den Zugriff auf die Daten) benötigt.
  Beispiel: - Webserverport:8080
  Nach dem Start stellen die Clients wie folgt eine Verbindung zum Server her:
  http://:/
  Zum Beispiel: http://192.168.178.12:8080/
• imageserverport: gibt den Port an, der für den HTTP-Image-Server verwendet werden soll. Der Standard ist Port 8081. Wenn Sie den Parameter port nicht angeben, wird port 8081 verwendet werden.
  Beispiel: - imageserverport:8081
• apiserverport: gibt den Port an, der für den API-Server verwendet werden soll. Der Standard ist Port 8082. Wenn Sie den Parameter port nicht angeben, wird port 8082 verwendet werden. Der API-Server wird vom Web-Client verwendet, um die Informationen vom Anwendungsserver zu beziehen.
  Beispiel: - apiserverport:8082
• Modus: gibt den Betriebsmodus an. Wenn Sie den Modus auf "lokal" einstellen, läuft der Data Crow-Server nur im Localhost-Modus. Wenn Sie diesen Parameter weglassen, wird Data Crow im externen Modus betrieben.
  Beispiel: - Modus:lokal
• Empfehlungsschreiben: Benutzername und Passwort für den Administrator. Dies ist ein aus Sicherheitsgründen erforderlicher Parameter. Der Standardbenutzer für Data Crow ist SA mit einem leeren Kennwort. Es wird empfohlen, für jeden Benutzer ein Passwort festzulegen, wenn Sie die Client-Server-Einrichtung verwenden.
  Beispiel #1 (Benutzer rwaals, pw 123456): -Zugangsdaten:rwaals/123456
  Beispiel #2 (Standardbenutzer): -Zeugnisse:SA

Ein Hinweis zu den Anmeldedaten: Sie können diese auch in der Datei datacrow.credentials angeben. Wenn diese Datei im Installationsordner des Data Crow-Servers vorhanden ist, liest Data Crow die Anmeldedaten aus dieser Datei und sie müssen nicht mehr als Parameter angegeben werden. Die Datei ist standardmäßig nicht vorhanden; erstellen Sie die Datei (eine einfache Textdatei) und geben Sie die Anmeldedaten in diese Datei ein: /.
Zum Beispiel: rwaals/123456

Überprüfen des Servers #

Wenn alles in Ordnung ist, wird der Server etwas ähnliches wie unten melden:

INFO [main] (DcServer.java:140) - Der Server wurde gestartet und ist bereit für Client-Verbindungen.

INFO [main] (DcServer.java:141) - Der Client kann sich mit der IP-Adresse 192.168.0.121 auf Port 9000 und auf Image-Port 8081 verbinden

INFO [main] (DcServer.java:144) - Abwarten auf CTRL-C zum Herunterfahren des Servers.

Sie gibt die aktuelle IP-Adresse sowie die zugewiesenen Portnummern an.
Fehler werden direkt in der Konsole angezeigt. Zusätzlich gibt es die Standard-Protokolldatei, die sich im Benutzerordner befindet (data_crow.log).
Wenn Sie den Server debuggen (oder mehr Meldungen sehen) möchten, können Sie beim Start den Parameter -debug angeben.

Anhalten des Servers #

Drücken Sie CTRL-C im Terminal-/Befehlseingabefenster.

Verbindung zu Data Crow: (Thin) Web Client #

Die Verbindung zum Webserver ist die einfachste Möglichkeit. Rufen Sie mit einem Webbrowser die Adresse des Servers wie folgt auf:

https://<server address>:<web server port>/

Zum Beispiel: https://192.168.178.120:8080/

Verbindung zu Data Crow: (Thick) Client #

Jede Installation über 4.0 kann eine Verbindung zu einem Server herstellen. Es ist eine einfache Angelegenheit, den Befehl -client beim Start von Data Crow anzugeben:

Im folgenden Beispiel zeige ich die <Befehl> für den Startbefehl des Data Crow-Clients;

• Für Windows-Benutzer ersetzen Sie dies durch:
  datacrow.exe -client
• Für andere Plattformen verwenden:
  Java -Xmx1024m -jar datacrow.jar -client
  Der Parameter -Xmx1024m gibt die Menge des für Data Crow verfügbaren Speichers an. Sie können diesen Wert bei Bedarf in eine andere Zahl ändern.

Stellen Sie eine Verbindung zum Server her, indem Sie Data Crow wie folgt starten (ändern Sie die Verknüpfung):

-Client

Wenn der Client startet, wird der folgende Anmeldedialog angezeigt:

• Login-Name: Ihren Benutzernamen (der Standardbenutzer ist SA)
• Passwort: Ihr Passwort (das Passwort für den Benutzer SA ist leer)
• Server-Adresse: die IP-Adresse des Servers (die IP-Adresse finden Sie in der Server-Konsole; in einem internen Netzwerk könnte die IP-Adresse z. B. 192.168.0.10 lauten).
• Anwendungsserver-Anschluss: der auf dem Server konfigurierte Port (Standard ist 9000). Diese Einstellung wird beibehalten.
• Image-Server-Anschluss: der auf dem Server konfigurierte Port (Standard ist 9001). Diese Einstellung wird beibehalten.

Benutzerverwaltung #

Vergewissern Sie sich, dass Sie die Benutzerverwaltung Teil von Data Crow, bevor Sie anderen den Zugriff auf den Server erlauben.