HandyCafe Docs
it-admin

Synchronisation de Fichiers

La synchronisation de fichiers distribue des fichiers depuis le serveur HandyCafe vers les PC clients du réseau. Utilisez-la pour envoyer des mises à jour de jeux, des fichiers de configuration, des installateurs de logiciels et des éléments de menu client sans avoir à visiter chaque machine.

Elle utilise une approche basée sur un manifeste pour que seuls les fichiers modifiés ou nouveaux soient transférés, ce qui rend les synchronisations répétées rapides.

La page se trouve dans Paramètres > Synchronisation de Fichiers.

Activer la Synchronisation Client

Un bouton en haut à droite de la page contrôle l'ensemble de la fonctionnalité. Tant que Activer la Synchronisation Client est désactivé, la page indique que la synchronisation client est en pause et les actions de publication et de suppression sont bloquées. Activez-le avant de publier quoi que ce soit.

Publier une Source de Synchronisation

La section Publier Source de Synchronisation est l'endroit où une synchronisation est créée. Elle nécessite deux valeurs :

Champ Description
Chemin Source Le fichier ou dossier sur le serveur que vous souhaitez distribuer. Utilisez Choisir Fichier ou Choisir Dossier pour le sélectionner, ou saisissez directement le chemin.
Chemin Cible sur Clients Le chemin absolu où le contenu doit arriver sur chaque client. Ceci n'est pas optionnel. Exemple : C:\Games\SteamLibrary\common\Game ou /opt/apps/game.

Le chemin cible doit être valide sur les machines clientes, pas sur le serveur. Si vos clients conservent leurs jeux sur D: et que vous entrez un chemin C:, la synchronisation atterrit au mauvais endroit.

Sélectionnez Publier Synchronisation une fois que les deux champs sont remplis. Le contenu est servi aux clients directement depuis le chemin source. Le serveur ne conserve pas de seconde copie.

Comment Fonctionne la Synchronisation

Comparaison Basée sur un Manifeste

Lorsqu'une synchronisation commence, le serveur génère un manifeste de fichiers : une liste de chaque fichier à synchroniser avec son checksum. Chaque client compare ce manifeste avec ses propres fichiers locaux.

  • Les fichiers qui n'existent pas sur le client sont marqués pour téléchargement.
  • Les fichiers dont les checksums diffèrent (c'est-à-dire qu'ils ont été modifiés) sont marqués pour téléchargement.
  • Les fichiers qui correspondent sont entièrement ignorés.

Seul le delta entre le serveur et le client est transféré, ce qui rend les synchronisations répétées rapides.

Transfert Basé sur des Morceaux

Les fichiers volumineux sont divisés en morceaux plus petits pour le transfert via TCP :

  • Fiabilité. Si un morceau échoue, seul ce morceau est réessayé plutôt que l'ensemble du fichier.
  • Suivi de progression. La progression du transfert est rapportée au niveau du morceau.
  • Efficacité réseau. Les tailles des morceaux sont ajustées pour les conditions typiques du LAN.

Les transferts utilisent le port dédié aux fichiers depuis les Paramètres Réseau, 5002 par défaut. Si ce port est bloqué par un pare-feu, aucun fichier n'atteindra les clients.

Dossiers Synchronisés

La liste des Dossiers Synchronisés montre une ligne par chemin cible, chacun avec sa version publiée la plus récente. Une ligne indique le nombre de versions, le nombre de fichiers et la taille totale. Utilisez Actualiser pour recharger la liste.

Sélectionnez une ligne pour ouvrir ses détails à droite. Le panneau de détails liste chaque entrée de cette source avec son chemin, son type (fichier ou répertoire), sa taille et son checksum, ainsi que le chemin racine de la source, le chemin cible et l'heure de publication. La boîte de recherche filtre les entrées par chemin relatif ou cible.

Supprimer une Synchronisation

Deux actions de suppression différentes existent. Elles font des choses différentes :

  • Supprimer Dossier Synchronisé retire le chemin cible de la liste de synchronisation. Vos fichiers source sur le serveur ne sont pas touchés.
  • Supprimer Entrée enlève un élément du chemin source original sur le serveur. Ceci est permanent et est également poussé aux clients. HandyCafe demande d'abord une confirmation.

Les deux actions nécessitent que Activer la Synchronisation Client soit activé.

Cas d'Utilisation

  • Déploiement de mises à jour de jeux. Envoyez des correctifs de jeux à tous les PC de jeu en même temps pour que chaque machine exécute la même version.
  • Envoi de fichiers de configuration. Distribuez des paramètres réseau mis à jour ou des préférences d'application à tous les clients.
  • Distribution de logiciels. Installez des applications sur les PC clients en synchronisant des paquets d'installation ou des applications portables.
  • Mise à jour des éléments de menu client. Synchronisez de nouvelles icônes, affiches ou fichiers multimédias utilisés par le menu client.

Conseils

  • Planifiez les grandes synchronisations pendant les heures creuses pour que les sessions actives ne se disputent pas la bande passante.
  • Vérifiez deux fois le chemin cible avant de publier. C'est la cause la plus courante d'une synchronisation qui semble réussir alors que rien n'apparaît sur le client.
  • Le serveur et les clients doivent être sur le même LAN.

Pages Connexes