Installer l'agent ERPConnector

L'agent est le service Windows qui relie votre serveur au HUB. Une seule installation par serveur suffit : toutes les compagnies (Acomba, Avantage, Sage 50…) accessibles depuis ce serveur passent par le même agent. Comptez une dizaine de minutes.

Avant de commencer

• Le bon serveur : allumé en permanence, avec le logiciel comptable installé dessus (ou au moins accès à ses données) — voir Prérequis et accès.
• Un compte administrateur sur ce serveur pour l'installation.
• Windows 10 / 11 ou Windows Server 2016 et plus, en 64 bits.
• Accès Internet sortant en HTTPS (port 443) vers gateway.erpconnector.ca. L'agent n'ouvre aucun port entrant : rien à ouvrir sur le pare-feu vers le serveur.
• Les composants .NET requis sont installés par le programme d'installation lui-même s'ils manquent (il les télécharge chez Microsoft) — rien à préparer, mais l'accès Internet doit être là pendant l'installation.

1. Télécharger le programme d'installation

Le programme d'installation se prend dans le portail client, dans le dossier de mise en service de votre licence (section Installation). Deux choses y sont affichées :

• le lien de téléchargement ;
• le jeton d'activation, valable 24 heures et une seule fois. Il est montré à sa création seulement : le portail n'en garde pas de copie.

Selon la configuration du portail, le jeton est inclus dans le nom du fichier téléchargé (ERPConnector_Setup_et_<jeton>.exe). Dans ce cas, ne renommez pas le fichier : c'est ce nom qui évite toute saisie à l'installation.

Copiez le fichier sur le serveur cible (le lien peut aussi être ouvert directement depuis le serveur).

2. Lancer l'installation

Exécutez le fichier en tant qu'administrateur. L'assistant Solution Infomédia — ERP Connector s'ouvre.

1. Bienvenue — le jeton d'activation est déjà rempli s'il était dans le nom du fichier ; sinon, collez-le dans le champ. Le champ peut rester vide : l'activation se fera après, à la main (voir plus bas).
2. Acceptez les conditions d'utilisation et cliquez Installer.
3. L'assistant installe d'abord les composants .NET manquants, puis les quatre composants de l'agent (service, exécuteur de tâches, Gestionnaire de service, mise à jour). Le service démarre tout seul à la fin.
4. À l'écran final, Ouvrir l'interface web de configuration ouvre votre navigateur sur l'interface locale de l'agent dès que le service est prêt. Vous pouvez aussi simplement Fermer.

Ce qui est en place ensuite :

Quoi	Où
Service Windows Solution Infomedia - ERPConnector Agent Service (démarrage automatique, compte Système local)	services.msc
Raccourci Service Manager	bureau et menu Démarrer
Programmes	C:\Program Files\Solution Infomedia\ERPConnector\
Configuration, journaux	C:\ProgramData\Solution Infomedia\ERPConnector\

3. Activer l'agent

Avec un jeton (le cas normal) : rien à faire. Au premier démarrage, l'agent échange le jeton contre ses identifiants, s'en souvient, et se connecte au HUB. Le jeton est consommé ; dans le portail, le dossier de mise en service passe l'élément Agent installé au vert dès que l'agent est vu en ligne.

Sans jeton, ou avec un jeton expiré : ouvrez l'interface locale de l'agent (bouton de l'écran final, ou depuis le Gestionnaire de service), page Configuration. Deux façons d'activer :

• section Enrôlement : collez un jeton d'activation valide — réémettez-en un depuis le portail s'il est expiré (attention : réémettre un jeton fait tourner la clé maître de la licence ; un autre agent enrôlé avec l'ancienne devrait alors être ré-enrôlé) ;
• section Authentification : saisissez la clé de licence et la clé d'API (la clé maître de la licence, fournie par Solution Infomédia ou visible une seule fois dans le portail), puis enregistrez.

L'interface locale

L'interface web de l'agent n'est accessible que depuis le serveur lui-même (http://localhost:<port>, le port est choisi automatiquement entre 5000 et 5100). Elle sert à activer l'agent, voir son statut et ses journaux. Les connexions aux compagnies (chemins, usagers) se gèrent depuis le portail client, pas ici.

4. Vérifier

• Statut : le Gestionnaire de service affiche En cours d'exécution, et la page Configuration de l'interface locale montre le connecteur connecté au HUB (bouton Rafraîchir dans Diagnostics de connexion).
• Portail : la licence montre son agent en ligne.
• API : un GET /api/Entity/CompanyInfo avec votre clé retourne le nom d'une compagnie — une fois la connexion à la compagnie saisie et testée, bien sûr.

Si l'agent ne se connecte pas : Dépannage, et pour le redémarrer, Gérer le service.

Et ensuite

1. Préparer le logiciel comptable et saisir la connexion : page Connexion et configuration de votre système — Acomba, Avantage, Sage 50.
2. Donner à vos intégrateurs leur clé d'API : S'authentifier.

Cas rare : une deuxième instance sur le même serveur

Un serveur n'a normalement qu'un agent. Si vous avez besoin d'une instance additionnelle (une autre licence sur le même serveur, par exemple pour deux entreprises distinctes), Solution Infomédia fournit un programme d'installation d'instance nommée, lancé à la main par un administrateur. Chaque instance a son propre service (Solinfo.ERPConnector.AgentService$<NOM>), ses dossiers et sa configuration ; le Gestionnaire de service les liste dans son sélecteur d'instance. Contactez-nous avant d'en avoir besoin : c'est une installation assistée.