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.

Composants #

Le serveur Data Crow se compose des éléments suivants :

• Serveur d'application - il s'agit du composant principal, le serveur lui-même. Les autres composants s'appuient sur ce composant - il offre toutes les fonctions de base. Il est utilisé directement dans une configuration client-serveur - où le client complet de Data Crow (appelé gras ) se connecte directement au serveur.
• Serveur d'images - il s'agit d'un simple composant HTTP qui sert les images Data Crow. Il est utilisé par tout client affichant des images (client web et clients lourds). Il est hébergé par Jetty, un serveur web qui a été incorporé dans le serveur Data Crow.
• Serveur API - l'API met les données de Data Crow à la disposition de tous les composants susceptibles de fonctionner sur un autre site. Les données sont disponibles au format JSON. Actuellement, il est uniquement utilisé par le serveur web de Data Crow. Il offre les données en toute sécurité grâce au mécanisme d'authentification de Data Crow. Le serveur API est également hébergé par Jetty.
• Serveur web - le serveur web permet aux utilisateurs de se connecter à partir de n'importe quel appareil hébergeant un navigateur web. C'est un moyen facile d'accéder aux informations à partir d'une tablette, d'un appareil mobile, d'un ordinateur, etc. Le serveur web est également hébergé par Jetty. Notez que ceci peut facilement être déployé n'importe où ailleurs ; tous les fichiers nécessaires peuvent être trouvés dans le répertoire webapp-main. Il suffit de les copier sur n'importe quel autre serveur web. N'importe quel serveur web sera capable de les héberger sans problème.

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 autre installation n'est nécessaire. Il nécessite cependant la version 17 ou supérieure de Java (OpenJDK ou Java d'Oracle).

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.

Le serveur peut être démarré comme suit.

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

Explication :

• 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).
• webserverport : spécifie le port à utiliser pour le serveur web. S'il n'est pas fourni, le module de serveur web ne sera pas lancé. Notez que le serveur web a besoin à la fois du serveur d'images (pour obtenir les images) et du serveur API (pour accéder aux données).
  Exemple: - webserverport:8080
  Au démarrage, les clients se connectent au serveur de la manière suivante :
  http://:/
  Par exemple : http://192.168.178.12:8080/
• imageserverport : spécifie le port à utiliser pour le serveur d'images HTTP. La valeur par défaut est le port 8081. Si vous ne fournissez pas le paramètre port, port 8081 sera utilisé.
  Exemple: - imageserverport:8081
• apiserverport : spécifie le port à utiliser pour le serveur API. La valeur par défaut est le port 8082. Si vous ne fournissez pas le paramètre port, port 8082 sera utilisé. Le serveur API est utilisé par le client web pour extraire les informations du serveur d'application.
  Exemple: - apiserverport:8082
• mode : spécifie le mode de fonctionnement. En définissant le mode comme local, le serveur Data Crow fonctionnera uniquement en mode local. En omettant ce paramètre, Data Crow fonctionnera en mode externe.
  Exemple: - mode:local
• 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

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 été démarré et est prêt à recevoir les connexions des clients.

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 image 8081

INFO [main] (DcServer.java:144) - Écoute de 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 :

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

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 -client
• Pour les autres plateformes, utiliser :
  Java -Xmx1024m -jar datacrow.jar -client
  Le paramètre -Xmx1024m spécifie la quantité de mémoire disponible pour Data Crow. Vous pouvez modifier ce paramètre 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é.
• Port du serveur d'imagesle port tel qu'il est configuré sur le serveur (9001 par défaut). Ce paramètre est mémorisé.

Gestion des utilisateurs #

Assurez-vous de bien comprendre les gestion des utilisateurs de Data Crow avant de permettre à d'autres personnes d'accéder au serveur.