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.

De server installeren
#

De server installeren:

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

Dat is alles – er is geen verdere installatie nodig. Je hebt wel Java versie 17 of hoger nodig.

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.

In het onderstaande voorbeeld zal ik laten zien <command> voor het startcommando Data Crow;

• Geen Windows: Java –Xmx1024m –jar datacrow-server.jar
  De -Xmx1024m parameter specificeert de hoeveelheid geheugen die beschikbaar is voor Data Crow. Je kunt dit indien nodig veranderen in een ander getal.
• Windows: datacrow-server.exe (of het bovenstaande, beide zijn goed)

Nu zijn we klaar om de server te starten.

<command> -gebruikersnaam: –poort: –imageserverport: -webserverport: –inloggegevens:/

Uitleg:

• De <command> Ik heb het hierboven uitgelegd, zorg ervoor dat je de juiste syntaxis gebruikt voor het platform dat je gebruikt.
• 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).
• imageserverport: specificeert de poort die gebruikt moet worden voor de HTTP-afbeeldingsserver. De standaardinstelling is poort 9001. Als u de poortparameter niet opgeeft, wordt poort 9001 gebruikt.
  Voorbeeld: – imageserverport:9001
• 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
• webserverport: specificeert de poort die gebruikt moet worden voor de webserver. Indien niet opgegeven, wordt de webservermodule niet gestart.
  Voorbeeldwebserverpoort:8080
  Na het starten maken clients als volgt verbinding met de server:
  https://:/datacrow
  Example: https://192.168.178.12:8080/datacrow.
• 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 verbinden met IP-adres 192.168.0.121 op poort 9000 en op beelddienstpoort 9001

INFO [main] (DcServer.java\:144) – Wachten op CTRL-C voor server afsluiten.

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://:/datacrow

Bijvoorbeeld: https://192.168.178.120:8080/datacrow

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
• Gebruik voor andere platforms:
  Java –Xmx1024m –jar datacrow.jar
  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.

Webserver SSL-beveiliging #

De webserver staat alleen HTTPS-verbindingen toe. Hiervoor maakt Data Crow gebruik van een zelfondertekend certificaat. Dit soort certificaten is niet veilig voor gebruik wanneer Data Crow toegankelijk is voor externe gebruikers of wanneer Data Crow in een productieomgeving wordt gebruikt. Zorg er in beide gevallen voor dat je een certificaat gebruikt dat is uitgegeven door een erkende certificeringsinstantie.

Zodra u een dergelijk certificaat hebt verkregen, gaat u naar de map „ssl“ van de Data Crow Server-installatie. Zoek het datacrow_keystore.jks en voeg uw certificaat toe aan deze Java-sleutelverzameling. Volg hiervoor de volgende instructies: https://www.baeldung.com/java-import-cer-certificate-into-keystore

Zoek vervolgens het bestand datacrow-ssl.properties en wijzig de waarde van keystore_password naar het wachtwoord van uw certificaat.