Aller au contenu principal

Mise à jour d'Avantage : rien à réinstaller côté connecteur, mais MainTCP à vérifier

S’applique àAvantage

Réponse courte​

Une mise à jour d'Avantage ne touche à rien dans le connecteur. Contrairement à Acomba, le connecteur n'a aucun composant d'Avantage installé chez lui : pas de bibliothèque ACCEO, pas de composant COM, pas de clé de registre. Il parle à MainTCP par le réseau (TCP, port 2131 par défaut) et lit les fichiers de données de la compagnie par ODBC. L'installateur d'Avantage ne remplace donc rien de son côté, et le connecteur n'exige aucune version précise d'Avantage : la version annoncée par MainTCP à la connexion (par exemple « Avantage - Intégration 20.0, Server 20.0 ») est lue, pas vérifiée. Le connecteur a été écrit contre l'Intégration NG10.5 et fonctionne avec les serveurs 20.0.

Comme pour Acomba, la mise à jour elle-même reste une opération manuelle sur les postes du client ; le connecteur ne la déclenche pas.

Le vrai point d'attention est MainTCP. Ce n'est pas un service Windows : il se ferme avec la session qui l'a lancé, et l'installateur d'Avantage le remplace ou le redémarre. Tant qu'il n'écoute pas de nouveau, le connecteur est muet.

Avant la mise à jour​

  1. Choisissez un moment creux et prévenez ceux qui appellent l'API : pendant l'opération, les appels vers cette compagnie échoueront.
  2. Activez le mode maintenance de l'agent (page Configuration, bloc Paramètres additionnels) : les tâches de lecture et d'écriture sont refusées, rien n'entre dans Avantage pendant que l'installateur travaille — voir Gérer le service. Il n'y a pas, comme avec Acomba, de SDK à libérer avant.
  3. Connecteur OnlineERP (légataire) : arrêtez le service du connecteur le temps de l'opération, comme pour Acomba.
  4. Appliquez la mise à jour sur tous les postes, y compris celui où résident les données et où tourne MainTCP — c'est lui que le connecteur interroge.

Après la mise à jour : MainTCP d'abord​

  1. Vérifiez que MainTCP écoute de nouveau, à la même adresse IP et au même port que dans la fiche de connexion.
    • Lancé à la main : relancez MainTCP.exe depuis le dossier officiel d'Avantage (celui des données), pas depuis une copie.
    • Installé en service avec NSSM : nssm status MainTCP doit répondre SERVICE_RUNNING (sinon nssm start MainTCP), et le service doit pointer toujours sur le MainTCP.exe du dossier officiel d'Avantage (propriétés du service, ou nssm edit MainTCP). La procédure complète : Faire tourner MainTCP en service Windows.
  2. Désactivez le mode maintenance de l'agent.
  3. Testez la connexion : le bouton Tester de la fiche de connexion fait ouvrir la compagnie par le connecteur et valide d'un coup MainTCP et l'accès ODBC aux données. Puis un GET /api/Entity/CompanyInfo depuis l'API, et enfin une lecture et une écriture réelles par votre intégration — le test et CompanyInfo ne couvrent pas l'écriture.

Si le connecteur ne répond plus après​

  • « Connexion refusée sur l'IP et le port » : MainTCP ne tourne pas, ou le pare-feu du poste bloque le port 2131 — voir les erreurs fréquentes de la page de configuration.
  • Les autres causes classiques d'un appel qui échoue : Dépannage.

Le risque théorique : la structure des fichiers de données​

Le connecteur lit les fichiers .dbf de la compagnie avec des noms de colonnes fixés dans son code. Une version majeure d'Avantage qui changerait la structure de ces fichiers pourrait donc perturber les extractions. Ce cas ne s'est jamais produit à ce jour ; en cas de doute sur une version majeure, validez avec notre support avant de l'appliquer.

Cette page vous a-t-elle été utile ?