Configurer le serveur pour des comparaisons à distance
Afin de permettre aux Clients DiffDog à distance d'appeler DiffDog Server, suivre les étapes suivantes :
1.Sur le serveur, veuillez vous assurer que DiffDog Server est installé, mis sous licence et qu'il fonctionne (voir Configurer sur Windows, Configurer sur Linux et Configurer sur macOS).
2.Sur le serveur, définir l'hôte HTTP et le port sur lequel DiffDog Server doit écouter les requêtes de client. Par défaut, DiffDog Server est configuré pour écouter les connexions HTTP sur l'adresse et le port spécifiés dans un fichier de configuration de serveur. En éditant le fichier de configuration de serveur, vous pouvez spécifier une adresse et un port différent. Pour que DiffDogServer accepte les connexions entrantes depuis d'autres appareils, veuillez vous assurer que le paramètre http.socket-host est défini sur 0.0.0.0.
Assurez-vous que l'hôte et le port sur le serveur ne sont pas bloqués par le pare-feu. Par exemple, sur un serveur Windows, vous pouvez laisser passer une application à travers le pare-feu en éditant les règles disponibles dans Control Panel\All Control Panel Items\Windows Defender Firewall\Advanced Settings\Inbound Rules. |
3.Redémarrer DiffDog Server en tant que service. Pour plus d'informations voir :
•Lancer et stopper les services (Linux)
•Lancer et stopper les services (macOS)
•Lancer et stopper les services (Windows)
4.Procéder comme suit :
a.Si l'appareil du client est exécuté sur le même système d'exploitation et plateforme que la machine du serveur, localiser le sous-répertoire cmdlclient du répertoire d'installation du programme et le copier sur l'appareil client. Vous trouverez ce répertoire sous le chemin suivant :
Windows | C:\Program Files\Altova\DiffDogServer2025\cmdlclient |
Linux | /opt/Altova/DiffDogServer2025/cmdlclient |
macOS | /usr/local/Altova/DiffDogServer2025/cmdlclient |
Au minimum, vous devriez copier le programme d'exécution et le fichier de configuration .ini disponible dans le même répertoire ; d'autres fichiers sont optionnels. Si vous souhaitez appeler DiffDog Server à distance depuis plus d'un appareil client, copier le répertoire cmdlclient sur chaque appareil client devant appeler DiffDog Server.
b.Si l'appareil machine est exécuté sur un système d'exploitation ou sur une plateforme différente de l'appareil de serveur, suivre les étapes suivantes :
a) Télécharger le paquet d'installation du serveur depuis la page de téléchargement Altova (https://www.altova.com/fr/download) et l'installer sur le système d'exploitation du client. Une fois l'installation effectuée, vous trouverez les fichiers du client dans le sous-répertoire cmdlclient relatif au répertoire d'installation du programme.
b) Copier le sous-répertoire cmdlclient vers un autre emplacement et désinstaller le pack de serveur depuis la machine client.
5.Sur l'appareil client, éditer le fichier de configuration client afin que celui-ci pointe vers l'adresse et le port sur lequel DiffDog Server écoute les requêtes HTTP. Par exemple, imaginons que DiffDog Server écoute sur 192.0.2.0 et le port 29800. Dans ce cas, éditer le fichier de configuration client de manière à ce que les paramètres server.host et server.port disposent de ces valeurs respectives.
Sur l'appareil client, vous êtes maintenant prêt à appeler le DiffDog Server à distance pour comparer des fichiers ou des répertoires. Par exemple, la commande ci-dessous comparera path\to\my\file1.txt sur le client avec path\to\my\file2.txt sur le serveur, en utilisant le mode de comparaison de texte. Veuillez noter que, pour que la commande diff puisse travailler correctement, ces chemins de fichier doivent réellement exister sur le client et le serveur respectivement.
diffdogcmdlclient diff --client-left=path\to\client\file.txt --server-right=path\to\server\file.txt --mode=text |
Lors de l'exécution de la commande, DiffDog Client lit les détails de connexion du fichier de configuration client, se connecte à DiffDog Server, et effectue la comparaison. Comme indiqué plus haut, le fichier de configuration doit pointer vers un hôte et un port où DiffDog Server fonctionne et qui écoute les requêtes HTTP.
Dépannage
La table suivante regroupe les principaux problèmes que vous pouvez rencontrer et leur solution.
Problème | Solution |
|---|---|
Lors de l'exécution de DiffDogCmdlClient.exe on Windows, un message d'erreur s'affiche dans la ligne de commande : "Cette version n'est pas compatible avec la version de Windows que vous utilisez. Vérifiez le système d'information de votre ordinateur et contactez l'éditeur de votre logiciel". | Cela peut se produire si vous exécutez un programme d'exécution 64-bit sur un système d'exploitation 32-bit. Voir étape 4b ci-dessus pour une solution. |
Lors de l'exécution de la commande diff, un message d'erreur s'affiche dans la ligne de commande : "Erreur inconnue lors du traitement de la ligne de commande". | S'assurer que les chemins sur le serveur sont fournis avec l'aide des options --server-left ou --server-right. De même, s'assurer que les chemins sur le client sont fournis avec les options --client-left or --client-right. |
Lors de l'exécution de la commande diff, un message d'erreur s'affiche dans la ligne de commande : "Le serveur limite l'accès aux alias mais le client n'a pas spécifié un nom d'alias". | Spécifier l'option de ligne de commande --alias. |
Lors de l'exécution de la commande diff, un message d'erreur s'affiche dans la ligne de commande : "[ERROR] FatalError: opération I/O sur le fichier 'file:///home/altova/Documents/Address.xsd' a échoué. Détails : System Error 13: Permission refusée [ERROR] [PH] Échec de la préparation du chemin pour la comparaison. Contrôler le journal pour plus d'info" | Veuillez vous assurer que vous disposez d'un accès lecture-écriture vers les chemins nécessaires dans le serveur à distance.
|