Data Crow Server

Sinds Data Crow 4.0 is het mogelijk om Data Crow als server te draaien. Hierdoor kunnen klanten verbinding maken met een enkele instantie van Data Crow.

De servereditie is een geavanceerde server, een gecombineerde web- en applicatieserver. Dit betekent dat gebruikers verbinding kunnen maken met Data Crow via de thick-client (de Data Crow applicatie) en/of de webclient (de browser). De server maakt het mogelijk dat meerdere gebruikers, die een van deze clients (thick / web) gebruiken, tegelijkertijd verbinding maken met de server. Met de gebruikersbeheerfunctie kun je per gebruiker granulaire gebruikersrechten instellen, tot op veldniveau.

De servereditie is headless, wat betekent dat het kan draaien in omgevingen waar er geen grafische interface is.

Onderdelen #

De Data Crow-server bestaat uit de volgende onderdelen:

• Applicatieserver - dit is het hoofdonderdeel, de server zelf. Andere componenten vertrouwen op dit component - het biedt alle basisfaciliteiten. Het wordt rechtstreeks gebruikt in een client-naar-serveropstelling - waarbij de volledige Data Crow-client (een vet client) maakt direct verbinding met de server.
• Image Server - dit is een eenvoudige HTTP-component die de Data Crow afbeeldingen serveert. Het wordt gebruikt door elke client die afbeeldingen weergeeft (webclient en fat clients). Het wordt gehost door Jetty, een webserver die is opgenomen in Data Crow Server.
• API Server - de API biedt de gegevens van Data Crow aan aan componenten die mogelijk op een andere locatie draaien. De gegevens worden aangeboden in JSON-formaat. Momenteel wordt deze alleen gebruikt door de Data Crow webserver. De gegevens worden veilig aangeboden via het Data Crow authenticatiemechanisme. De API-server wordt ook gehost door Jetty.
• Webserver - met de webserver kunnen gebruikers verbinding maken vanaf elk apparaat met een webbrowser. Het is een gemakkelijke manier om toegang te krijgen tot de informatie vanaf een tablet, mobiel apparaat, computer, enz. De webserver wordt ook gehost door Jetty. Merk op dat dit gemakkelijk ergens anders kan worden geïmplementeerd; alle benodigde bestanden kunnen worden gevonden in de webapp-main. Kopieer deze gewoon naar een andere webserver. Elke webserver kan dit zonder problemen hosten.

De server installeren #

De server installeren:

• Unzip de gezipte Data Crow Server distributie naar de installatielocatie.

Dat is het - er is geen verdere installatie nodig. Het vereist wel Java versie 11 of hoger (OpenJDK of Java van Oracle).

De server instellen #

Net zoals de normale client een gebruikersmap nodig heeft om de gegevens en instellingen in op te slaan, heeft de server dat ook. Je kunt ervoor kiezen om de servereditie een nieuwe lege gebruikersmap te laten maken, of je kunt ervoor kiezen om een bestaande gebruikersmap te gebruiken.

Tip: gebruik de thick client om de initiële gebruikersmap in te stellen - gebruik de client om gebruikers aan te maken, de systeeminstellingen te wijzigen en in principe om Data Crow naar wens te configureren. Dit in tegenstelling tot de webclient, die niet alle mogelijkheden van de thick client heeft.

De server uitvoeren #

De server heeft geen grafische gebruikersinterface (GUI) en vertrouwt dus volledig op de opdrachtregel. Open de terminal (Linux- en Mac-gebruikers) / opdrachtprompt (Windows-gebruikers) en navigeer naar de installatiemap van Data Crow Server.

De server kan als volgt worden gestart.

Java -Xmx1024m -jar datacrow-server.jar -userdir: -port: -imageserverport: -webserverport: -apiserverport: -credentials:/

Uitleg:

• userdir: specificeert de locatie van de gebruikersmap.
  Voorbeeld (Windows): -userdir:c:/server-data
• haven: specificeert het hoofdpoortnummer voor de applicatieserver. De standaardpoort is 9000. Als je de poortparameter niet opgeeft, wordt poort 9000 gebruikt.
  Voorbeeldpoort:9000
  Wanneer de server is gestart, maken clients verbinding door de Data Crow Client in clientmodus te starten (-client parameter).
• webserverport: specificeert de poort die moet worden gebruikt voor de webserver. Als deze niet wordt opgegeven, wordt de webservermodule niet gestart. Merk op dat de webserver zowel de afbeeldingsserver (om de afbeeldingen te verkrijgen) als de API-server (om toegang te krijgen tot de gegevens) nodig heeft.
  Voorbeeldwebserverpoort:8080
  Na het starten maken clients als volgt verbinding met de server:
  http://:/
  Bijvoorbeeld: http://192.168.178.12:8080/
• imageserverport: specificeert de poort die gebruikt moet worden voor de HTTP image server. De standaardinstelling is poort 8081. Als u de poortparameter niet opgeeft, wordt poort 8081 worden gebruikt.
  Voorbeeld: - beeldenserverpoort:8081
• apiserverport: specificeert de poort die moet worden gebruikt voor de API-server. De standaardinstelling is poort 8082. Als u de poortparameter niet opgeeft, wordt poort 8082 worden gebruikt. De API-server wordt door de webclient gebruikt om de informatie naar de applicatieserver te halen.
  Voorbeeld: - apiserverport:8082
• modus: specificeert de werkingsmodus. Door de modus in te stellen als lokaal zal de Data Crow server alleen in een localhost modus werken. Als deze parameter weggelaten wordt, zal Data Crow in externe modus werken.
  Voorbeeldmodus:lokaal
• credentials: gebruikersnaam en wachtwoord voor de beheerder. Dit is een verplichte parameter om veiligheidsredenen. De standaardgebruiker voor Data Crow is SA met een leeg wachtwoord. Het is aanbevolen om een wachtwoord in te stellen voor elke gebruiker bij gebruik van de client-server setup.
  Voorbeeld #1 (gebruiker rwaals, pw 123456): -referenties:rwaals/123456
  Voorbeeld #2 (standaardgebruiker): -referenties:SA

Een tip over de referenties; je kunt deze ook invoeren in het bestand datacrow.credentials. Wanneer dit bestand aanwezig is in de installatiemap van de Data Crow server zal Data Crow de credentials uit dit bestand lezen en hoeven ze niet meer als parameter te worden opgegeven. Het bestand bestaat standaard niet; maak het bestand aan (een tekstbestand) en voer de referenties in dit bestand in: /.
Bijvoorbeeld: rwaals/123456

De server controleren #

Als alles goed is, zal de server iets rapporteren dat lijkt op het onderstaande:

INFO [main] (DcServer.java:140) - Server is gestart, klaar voor clientverbindingen.

INFO [main] (DcServer.java:141) - Client kan verbinding maken met IP-adres 192.168.0.121 op poort 9000 en op image-poort 8081

INFO [main] (DcServer.java:144) - Luisteren naar CTRL-C voor afsluiten van server.

Het specificeert het eigenlijke IP-adres en de toegewezen poortnummers.
Fouten worden direct in de console weergegeven. Daarnaast is er het standaard logbestand in de gebruikersmap (data_crow.log).
Als je de server wilt debuggen (of meer berichten wilt zien), kun je bij het opstarten de parameter -debug opgeven.

De server stoppen #

Druk op CTRL-C in terminal / opdrachtpromptvenster.

Verbinding maken met Data Crow: (Thin) Web Client #

Verbinding maken met de webserver is de eenvoudigste optie. Navigeer met een webbrowser naar het adres van de server:

https://server address:web server port/

Bijvoorbeeld: https://192.168.178.120:8080/

Verbinding maken met Data Crow: (Thick) Client #

Elke installatie boven 4.0 kan verbinding maken met een server. Het is een simpele kwestie van het -client commando mee te geven bij het opstarten van Data Crow:

In het onderstaande voorbeeld laat ik de <commando> voor het Data Crow client startcommando;

• Windows-gebruikers kunnen dit vervangen door:
  datacrow.exe -client
• Gebruik voor andere platforms:
  Java -Xmx1024m -jar datacrow.jar -client
  De -Xmx1024m parameter specificeert de hoeveelheid geheugen die beschikbaar is voor Data Crow. Je kunt dit indien nodig veranderen in een ander getal.

Maak verbinding met de server door Data Crow als volgt te starten (wijzig de snelkoppeling):

-client

Wanneer de client start, wordt het volgende inlogvenster weergegeven:

• Login name: uw gebruikersnaam (de standaardgebruiker is SA)
• Password: je wachtwoord (het wachtwoord voor gebruiker SA is leeg)
• Server Address:Het IP-adres van de server (raadpleeg de serverconsole voor het IP-adres, binnen een intern netwerk kan het IP-adres bijvoorbeeld 192.168.0.10 zijn).
• Application Server Port:De poort zoals geconfigureerd op de server (standaard 9000). Deze instelling wordt onthouden.
• Image Server Port:De poort zoals geconfigureerd op de server (standaard is 9001). Deze instelling wordt onthouden.

Gebruikersbeheer #

Zorg ervoor dat u de gebruikersbeheer deel van Data Crow voordat anderen toegang krijgen tot de server.