Serveur Data Crow

Depuis Data Crow 4.0, il est possible de faire fonctionner Data Crow en tant que serveur. Cela permet aux clients de se connecter à une seule instance de Data Crow.

L'édition serveur est un serveur avancé, un serveur web et d'application combiné. Cela signifie que les utilisateurs peuvent se connecter à Data Crow en utilisant le client lourd (l'application Data Crow) et/ou le client web (le navigateur). Le serveur permet à plusieurs utilisateurs, utilisant l'un ou l'autre de ces clients (épais / web), de se connecter au serveur en même temps. La fonction de gestion des utilisateurs vous permet de définir des autorisations granulaires par utilisateur, jusqu'au niveau du champ.

L'édition serveur est sans tête, ce qui signifie qu'elle peut fonctionner dans des environnements où il n'y a pas d'interface graphique.

Le serveur a plusieurs rôles, il est :

• un serveur d'applications, permettant à un client lourd de se connecter en toute sécurité.
• un serveur web, permettant aux navigateurs de se connecter.
• un serveur API, permettant à d'autres services externes à Data Crow de se connecter et de récupérer des informations (uniquement avec votre autorisation). La version web utilise cette API, tout comme l'application Data Crow Reader.

Installation du serveur
#

Pour installer le serveur :

• Décompressez la distribution zippée de Data Crow Server à l'emplacement d'installation.

C'est tout : aucune installation supplémentaire n'est nécessaire. Il faut toutefois disposer de la version 17 ou d'une version plus récente de Java.

Mise en place du serveur #

Tout comme le client normal, le serveur a besoin d'un dossier utilisateur dans lequel il stocke les données et les paramètres. Vous pouvez choisir de demander à l'édition du serveur de créer un nouveau dossier utilisateur vide ou d'utiliser un dossier utilisateur existant.

Conseil : utiliser le client lourd pour configurer le dossier initial de l'utilisateur - utiliser le client pour créer des utilisateurs, modifier les paramètres du système et, fondamentalement, pour configurer Data Crow en fonction de vos besoins. Contrairement au client web, qui ne dispose pas de toutes les fonctionnalités du client lourd.

Exécution du serveur
#

Le serveur n'a pas d'interface utilisateur graphique (GUI), ce qui signifie qu'il s'appuie entièrement sur la ligne de commande. Ouvrez le terminal (utilisateurs Linux et Mac) / l'invite de commande (utilisateurs Windows) et naviguez jusqu'au dossier d'installation de Data Crow Server.

Dans l'exemple ci-dessous, je vais montrer <command> pour la commande de démarrage Data Crow ;

• Windows : Java –Xmx1024m –jar datacrow-server.jar
  Le paramètre -Xmx1024m spécifie la quantité de mémoire disponible pour Data Crow. Vous pouvez modifier ce paramètre si nécessaire.
• Windows : datacrow-server.exe (ou l'un ou l'autre, les deux fonctionneront)

Nous sommes maintenant prêts à démarrer le serveur.

<command> -userdir : –port : –imageserverport : -webserverport : –credentials:/

Explication :

• Le <command> Comme je l'ai expliqué plus haut, assurez-vous d'utiliser la syntaxe correcte pour la plate-forme que vous utilisez.
• userdir : spécifie l'emplacement du dossier de l'utilisateur.
  Exemple (Windows) : -userdir:c:/server-data
• port : spécifie le numéro de port principal du serveur d'application. Le port par défaut est 9000. Si vous ne fournissez pas le paramètre port, le port 9000 sera utilisé.
  Exemple: -port:9000
  Une fois le serveur démarré, les clients se connectent en démarrant Data Crow Client en mode client (paramètre -client).
• imageserverport : spécifie le port à utiliser pour le serveur d'images HTTP. Le port par défaut est le 8081. Si vous ne fournissez pas le paramètre de port, le port 8081sera utilisé.
  Exemple: - imageserverport:8081
• webserverport : spécifie le port à utiliser pour le serveur web. S'il n'est pas fourni, le module du serveur web ne sera pas démarré.
  Exemple: - webserverport:8080
  Au démarrage, les clients se connectent au serveur de la manière suivante :
  https://:/datacrow
  Example: https://192.168.178.12:8080/datacrow.
• les références : le nom d'utilisateur et le mot de passe de l'administrateur. Ce paramètre est obligatoire pour des raisons de sécurité. L'utilisateur par défaut de Data Crow est SA avec un mot de passe vide. Il est recommandé de définir un mot de passe pour chaque utilisateur lors de l'utilisation de la configuration client-serveur.
  Exemple #1 (utilisateur rwaals, pw 123456) : -credentials:rwaals/123456
  Exemple #2 (utilisateur par défaut) : -credentials:SA

Un conseil sur les informations d'identification ; vous pouvez également les fournir dans le fichier datacrow.credentials. Lorsque ce fichier est présent dans le dossier d'installation du serveur Data Crow, Data Crow lira les informations d'identification à partir de ce fichier et il ne sera plus nécessaire de les fournir en tant que paramètre. Le fichier n'existe pas par défaut ; créez le fichier (un fichier texte brut) et entrez les informations d'identification dans ce fichier : /.
Par exemple : rwaals/123456

Autres paramètres facultatifs :

• lier à Cette option remplace la configuration par défaut selon laquelle le serveur Data Crow se connecte à votre adresse IP. Elle n'est nécessaire que dans des cas imprévus où Data Crow ne parvient pas à détecter l'adresse IP à laquelle il doit se connecter.
• nom d'hôte : le nom du serveur. Utile si vous ne voulez pas utiliser l'adresse IP comme adresse principale.
• api_address_overrule: Cette option permet de remplacer la configuration automatique de l'adresse du serveur API par Data Crow. Elle vous permet de rediriger l'adresse API vers un autre port local utilisé, par exemple, par Caddyfile (proxy inversé).
• adresse_image_paramètre_écrasé Cette option permet de remplacer la configuration automatique de l'adresse du serveur d'images par Data Crow. Elle vous permet de rediriger l'adresse du serveur d'images vers un autre port local utilisé, par exemple, par Caddyfile (proxy inversé).
• répertoire Indiquez le répertoire d'installation du serveur Data Crow (en cas de problème).
• déboguer : Permettre au serveur Data Crow d'enregistrer toutes les informations de connexion.

Vérification du serveur #

Si tout se passe bien, le serveur produira un rapport similaire à celui présenté ci-dessous :

INFO [main] (DcServer.java\:140) – Le serveur a démarré, prêt pour les connexions client.

INFO [main] (DcServer.java\:141) – Le client peut se connecter à l'adresse IP 192.168.0.121 sur le port 9000 et sur le port d'image 9001

INFO [main] (DcServer.java\:144) – Écoute du CTRL-C pour l'arrêt du serveur.

Il spécifie l'adresse IP réelle ainsi que les numéros de port attribués.
Les erreurs seront affichées directement dans la console. En outre, il existe un fichier journal par défaut, situé dans le dossier de l'utilisateur (data_crow.log).
Si vous souhaitez déboguer le serveur (ou voir plus de messages), vous pouvez fournir le paramètre -debug au démarrage.

Arrêt du serveur #

Appuyez sur CTRL-C dans la fenêtre du terminal ou de l'invite de commande.

Connexion à Data Crow : Client Web (léger) #

La connexion au serveur web est l'option la plus simple. Naviguez, à l'aide d'un navigateur web, jusqu'à l'adresse du serveur, comme suit :

http://:/

Par exemple : https://192.168.178.120:8080/

Connexion à Data Crow : Client (lourd) #

Toute installation supérieure à 4.0 peut se connecter à un serveur. Il suffit de fournir la commande -client au démarrage de Data Crow :

Dans l'exemple ci-dessous, je montrerai l'élément <commande> pour la commande de démarrage du client Data Crow ;

• Pour les utilisateurs de Windows, remplacez ceci par :
  datacrow.exe
• Pour les autres plateformes, utiliser :
  Java –Xmx8096m –jar datacrow.jar
  Le–Xmx8096m Ce paramètre définit la quantité de mémoire allouée à Data Crow. Vous pouvez modifier cette valeur si nécessaire.

Connectez-vous au serveur en lançant Data Crow comme suit (modifiez le raccourci) :

-client

Lorsque le client démarre, la boîte de dialogue de connexion suivante s'affiche :

• Nom de connexionvotre nom d'utilisateur (l'utilisateur par défaut est SA)
• Mot de passevotre mot de passe (le mot de passe de l'utilisateur SA est vide)
• Adresse du serveurl'adresse IP du serveur (voir la console du serveur pour l'adresse IP, par exemple dans un réseau interne l'IP pourrait être 192.168.0.10).
• Port du serveur d'applicationle port tel qu'il est configuré sur le serveur (9000 par défaut). Ce paramètre est mémorisé.
• Adresse du serveur d'images: l'adresse du serveur d'images, généralement la même adresse que le serveur lui-même.
• Port du serveur d'imagesle port tel qu'il est configuré sur le serveur (9001 par défaut). Ce paramètre est mémorisé.

Serveur Web avec sécurité SSL #

Si vous souhaitez accéder à votre collection Data Crow lors de vos déplacements, héberger le serveur Data Crow sur un VPS (serveur privé virtuel) constitue une option pratique et abordable. Un petit VPS fonctionnant sous Ubuntu avec 2 Go de RAM et 100 Go de stockage est largement suffisant, et de telles instances sont largement disponibles à un faible coût mensuel.

Mise en place du serveur

Commencez par un serveur virtuel Ubuntu sans interface graphique — aucune interface graphique n'est nécessaire. Installez Java (OpenJDK 21 ou une version supérieure est recommandée), puis transférez les fichiers du serveur Data Crow et votre répertoire de données vers le serveur virtuel à l'aide de SCP. Connectez-vous via SSH, décompressez les archives et organisez-les comme suit :

~/datacrow_server
~/datacrow_server/data

Commencez Data Crow avec :

java -jar datacrow-server.jar -userdir:./data -hostname: -webserverport:8080 -port:9000 -imageserverport:8082 -apiserverport:8081

Pour maintenir le serveur en cours d'exécution après votre déconnexion, utilisez tmuxdémarrer une session tmux, exécuter la commande de démarrage, puis se détacher avec Ctrl+B suivi de D. Le serveur continuera de s'exécuter en arrière-plan.

À ce stade, Data Crow est accessible à une adresse telle que http://<your-ip>:8080 — fonctionnel, mais non sécurisé.

Ajouter HTTPS avec Caddy

Pour servir Data Crow via HTTPS, vous pouvez utiliser Chariot En tant que proxy inverse, Caddy gère automatiquement l'approvisionnement des certificats SSL.

Étape 1 — Ajouter un enregistrement DNS

Ajouter un Un enregistrement à la configuration DNS de votre domaine pointant vers l'adresse IP de votre VPS. Par exemple, ajouter un enregistrement nommé mon à datacrow.org te donne my.datacrow.org.

Étape 2 — Installer Caddy

sudo apt update && sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl

curl -1sLf ‘https://dl.cloudsmith.io/public/caddy/stable/gpg.key’ | sudo gpg –dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg

curl -1sLf ‘https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt’ | sudo tee /etc/apt/sources.list.d/caddy-stable.list

sudo apt update && sudo apt install caddy

Étape 3 — Configurer le Caddyfile

my.datacrow.org {
proxy_inverse localhost:8080
}

my.datacrow.org:8083 {
proxy_inverse localhost:8081
}

my.datacrow.org:8084 {
proxy_inverse localhost:8082
}

Ceci mappe respectivement l'interface web, le serveur d'API et le serveur d'images via Caddy.

Étape 4 — Lancer Data Crow avec les remplacements d'adresse

Étant donné que l'API et le serveur d'images sont désormais hébergés via Caddy sur des ports externes différents, il faut indiquer à Data Crow les adresses accessibles au public. Ajoutez les paramètres suivants à votre commande de démarrage :

-apiserverport:8081
-api_address_overrule:https://my.datacrow.org:8083/datacrow-api/api
-imageserverport:8082
-imageserver_address_overrule:https://my.datacrow.org:8084

Caddy redirige de manière transparente les requêtes entrantes sur les ports 8083 et 8084 vers les ports internes 8081 et 8082. Vous obtenez ainsi une adresse claire et sécurisée par HTTPS pour votre instance Data Crow.