Démarrer, arrêter, mettre à jour, désinstaller

L'agent est un service Windows : il démarre avec le serveur et tourne sans session ouverte. Voici les gestes à connaître une fois l'installation faite.

Voir l'état et redémarrer

Par le Gestionnaire de service

Le raccourci Service Manager (bureau ou menu Démarrer) ouvre une petite fenêtre qui affiche le poste hôte, le nom du service et son état, avec trois boutons : Démarrer le service, Arrêter le service, Redémarrer le service. Rafraîchir le statut du service relit l'état réel. Si plusieurs instances sont installées, choisissez-la dans le sélecteur Instance.

Par les services Windows

Windows + R → services.msc → service Solution Infomedia - ERPConnector Agent Service → clic droit → Redémarrer. C'est strictement équivalent.

Quand redémarrer

• après une réactivation manuelle qui ne s'est pas reconnectée d'elle-même (un changement de rôle ou de jeton dans la page Configuration relance normalement la connexion tout seul) ;
• quand l'agent apparaît hors ligne dans le portail alors que le serveur est allumé ;
• après une coupure réseau prolongée, si l'agent n'est pas revenu de lui-même.

Il n'y a pas à redémarrer l'agent après avoir modifié une connexion de compagnie dans le portail : la fiche est relue à la tâche suivante.

Savoir si l'agent est bien connecté

L'erreur nº 1 côté API, « Aucun client (Service Windows) trouvé pour le code de licence spécifié », veut dire une seule chose : au moment de l'appel, aucun agent de cette licence n'était connecté au HUB. Service arrêté, serveur éteint, réseau coupé — ou agent pas encore activé. Dans l'ordre :

1. Gestionnaire de service : le service est-il En cours d'exécution ? Sinon, démarrez-le.
2. Interface locale, page Configuration, bloc Diagnostics de connexion → Rafraîchir : l'agent dit s'il est connecté au HUB, et depuis quand.
3. Portail client : la licence montre son agent en ligne ou non.
4. Pare-feu : l'agent doit pouvoir sortir en HTTPS (443) vers gateway.erpconnector.ca.

Le reste du diagnostic (codes 401, 429, 503, erreurs retournées par le logiciel comptable) : Dépannage.

Mode maintenance

Dans la page Configuration, bloc Paramètres additionnels, le mode maintenance met l'agent en pause sans l'arrêter : les tâches de lecture et d'écriture sont refusées, seules les tâches système passent. Utile le temps d'une intervention sur le logiciel comptable — typiquement une mise à jour d'Acomba — pour que rien n'entre dans l'ERP pendant l'opération. N'oubliez pas de le désactiver ensuite.

Mises à jour

L'agent se met à jour tout seul : le composant de mise à jour installé avec lui applique les versions publiées par Solution Infomédia. Une mise à jour peut redémarrer le service quelques secondes ; les appels en cours à ce moment reçoivent une erreur passagère et le mécanisme de reprise de votre intégration doit les rejouer.

Côté serveur central, les interventions planifiées ont lieu le dimanche soir : Fenêtre de maintenance.

Journaux

• Interface locale : page Journaux, pour lire les dernières lignes sans chercher les fichiers.
• Fichiers : C:\ProgramData\Solution Infomedia\ERPConnector\Logs\.
• Observateur d'événements Windows : journal Application, source SolinfoERPConnector.

Joignez le journal du jour à toute demande de support : c'est ce qu'on vous demandera en premier.

Réparer ou désinstaller

Relancez le programme d'installation (le même fichier, ou la version courante téléchargée du portail) : sur un poste où l'agent est déjà installé, il propose Réparer (réinstalle les fichiers et services manquants ou corrompus) ou Désinstaller (retire complètement ERP Connector). Paramètres > Applications > Solution Infomédia - ERP Connector mène au même endroit.

La configuration survit à la désinstallation

La désinstallation retire les programmes et le service, mais conserve C:\ProgramData\Solution Infomedia\ERPConnector\ (activation, configuration, journaux). Une réinstallation retrouve donc son activation : pas besoin d'un nouveau jeton. Pour repartir de zéro, supprimez ce dossier après la désinstallation.

Une installation cassée qui refuse de se réparer ou de se désinstaller (double installation, service orphelin) : écrivez à supportprogweb@solutioninfomedia.com, nous avons un outil de nettoyage pour ça.