Paramètres des clients hérités
HandyCafe fonctionne en parallèle des installations clientes plus anciennes V3 et V4 sans interruption. La page de paramètres des clients hérités contrôle le Runtime Protocol : les écouteurs réseau qui permettent aux clients V3 et V4 de se connecter à ce serveur sur leurs ports d'origine.
L'importation de données à partir d'une installation plus ancienne est une tâche distincte sur sa propre page de paramètres. Voir Migration de Données. Les deux fonctionnalités sont indépendantes. Le support d'exécution fonctionne sans migrer aucune donnée. Une migration fonctionne sans support d'exécution. Vous pouvez également utiliser les deux ensemble.
Section Protocole d'exécution
Enable Legacy Client Support
Une bascule principale en haut de la section. Lorsqu'elle est activée, le serveur lance trois écouteurs réseau :
- Un écouteur UDP sur le groupe multicast configuré.
- Un écouteur de commandes TCP sur
UDP port + 2. - Un écouteur de transfert de fichiers TCP sur
UDP port + 7.
Désactiver la bascule arrête simultanément les trois écouteurs. Vous pouvez ajuster les numéros de port ou l'encodage pendant que la bascule est désactivée, puis la réactiver pour appliquer les changements.
Champs de configuration
| Champ | Valeur par défaut | Description |
|---|---|---|
| Auth Key | HANDYCAFE | Clé partagée de 10 caractères. Chaque trame entrante et sortante contient cette chaîne. Les trames qui ne correspondent pas sont ignorées. Tous vos clients hérités doivent utiliser la même clé. |
| UDP Multicast IP | 230.4.4.46 | Groupe multicast utilisé pour les beacons de découverte des clients et pour la distribution des commandes via UDP. Codé en dur dans la plupart des builds clients hérités. |
| Server UDP Port | 710 | Port UDP sur lequel le serveur écoute les beacons et commandes des clients. Les clients hérités envoient sur ce port. |
| Client UDP Port | 711 | Port UDP écouté par les clients hérités. Le serveur envoie les commandes de gestion unicast vers ce port sur l'adresse IP découverte du client. |
| Encoding | cp1254 | Encodage des champs texte au format filaire. Utilisez cp1254 pour les installations turques, cp1252 pour l'Europe occidentale. Les valeurs inconnues retombent sur cp1254 avec un avertissement dans les journaux du serveur. |
| Server Version | 3.4.01 | Chaîne de version diffusée dans chaque beacon UDP. Certains clients hérités refusent les trames provenant de versions qu'ils ne reconnaissent pas. Réglez cette valeur pour qu'elle corresponde à la chaîne de version de votre serveur d'origine. |
| Protocol Variant | STE | Sélection du format filaire. Voir la comparaison des variantes ci-dessous. |
| Inactivity Timeout | 10 | Secondes. Surveillance par MAC. Si aucun trafic n'arrive d'un client dans ce délai, le client est marqué hors ligne. Un délai de 10 secondes convient aux clients hérités qui diffusent un beacon toutes les 2 ou 3 secondes. |
Ports dérivés
Sous le formulaire, la page affiche une ligne en lecture seule qui montre les ports TCP dérivés :
Port TCP des commandes : 712 Port de transfert de fichiers : 717
Ces ports sont calculés à partir du port UDP du serveur. Vous ne les configurez pas séparément. Si vous modifiez Server UDP Port pour une autre valeur, les ports dérivés changent avec lui.
Variante du protocole
Le champ Protocol Variant sélectionne le format filaire utilisé par le serveur. Choisissez la variante qui correspond à la façon dont votre serveur hérité a été construit.
| Variante | Quand l'utiliser |
|---|---|
| STE (Smart/Turbo Edition) | La base de code héritée moderne. Ajoute un préfixe d'informations de licence de 70 octets à la structure de trame. La taille d'une trame est de 1337 octets. Choisissez cette option si votre installation héritée utilisait l'édition Smart ou Turbo. |
| Standard | La version héritée de base. La taille d'une trame est de 1267 octets, sans le préfixe d'informations de licence. Choisissez cette option uniquement si votre installation héritée était une édition Standard sans enregistrement de licence. |
Choisir la mauvaise variante provoque la suppression ou la mauvaise lecture des trames. Les symptômes incluent des clients qui apparaissent en ligne mais ignorent toutes les commandes, ou des données de commande décalées par le préfixe de 70 octets.
Coexistence avec les clients modernes
Les ports hérités (710, 711, 712, 717) sont totalement séparés des ports du protocole HandyCafe moderne (TCP 5001, 5002, 5003, UDP 5004). Les deux piles de protocoles fonctionnent simultanément sans conflit. Vous pouvez mélanger des clients anciens et nouveaux sur le même LAN et les gérer depuis le même Admin Panel.
Application des changements
Chaque champ de la section Protocole d'exécution est enregistré avec le bouton global Save en bas de la page. A l'enregistrement, le serveur :
- Arrête les trois écouteurs hérités s'ils étaient en cours d'exécution.
- Valide la clé d'authentification (elle ne doit pas être vide).
- Construit les nouvelles configurations d'écoute à partir des champs mis à jour.
- Redémarre les écouteurs en parallèle.
- Affiche une notification lorsque les trois sont de nouveau en ligne.
Si un port est déjà utilisé par un autre processus, le serveur renvoie une erreur et la bascule repasse à l'état désactivé. Vérifiez votre pare-feu et les autres services avec netstat, puis choisissez une plage de ports libre.
Migration de Bases de Données
L'importation de données depuis une installation de HandyCafe 3.x ou 4.x ne se fait plus sur cette page. Elle se trouve sur la page de paramètres de Migration de Données sous la source HandyCafe Legacy, aux côtés des importateurs EveryCafe et Pancafe.
Cette page couvre la détection de l'ancienne installation, ce qui est importé, la garantie en lecture seule sur les fichiers sources, l'exécution à nouveau d'une importation et l'annulation d'une. Pour un guide étape par étape, voir Comment migrer depuis une installation héritée.
Conseils
- Arrêtez le serveur hérité avant de lancer une migration. Si l'ancien système écrit encore dans sa base de données, l'import peut voir des données obsolètes ou partielles.
- Faites correspondre le champ Encoding à votre locale héritée avant la première migration. Le modifier après import ne corrigera pas rétroactivement les noms déjà corrompus.
- Lancez toujours d'abord une migration test. Vérifiez les compteurs d'enregistrements sous "Last Counts" et contrôlez quelques lignes de membres et de transactions avant de faire basculer le personnel vers le nouveau système.
- Activez la prise en charge runtime et gardez vos clients hérités connectés pendant une période de transition. Cela vous permet de vérifier que le nouveau serveur leur sert exactement le même service avant d'abandonner l'ancien.
- Si vous modifiez Server UDP Port, n'oubliez pas que les ports dérivés de commande et de transfert de fichiers changent avec lui. Les règles de pare-feu doivent être mises à jour en conséquence.