Procédures générales

Installer MainTCP en tant que service Windows

Préambule

MainTCP est un micrologiciel développé par ACCEO [Avantage] qui permet à des logiciels tiers de se connecter aux données d’Avantage. Concrètement, il ouvre un port local et sera à l’écoute sur ce port. Toutefois, ce micrologiciel n’est pas un service Windows, et n’a pas été conçu de la sorte. Pour assurer un accès constant et un redémarrage automatique, nous recommandons la procédure suivante pour créer un service Windows MainTCP.

Installation

Pour exécuter le logiciel MainTCP.exe d’Avantage comme un service, vous pouvez utiliser l’outil NSSM (Non-Sucking Service Manager). Voici un résumé de la procédure :

  1. Téléchargez NSSM
    • Rendez-vous sur le site officiel de NSSM et téléchargez l’outil.
    • https://nssm.cc/download
  2. Installez NSSM
    • Extrayez le contenu du fichier téléchargé dans un répertoire de votre choix.
    • Exemple : C:\utilities\nssm
  3. Configurez le service
    1. Ouvrez une Invite de commandes ou une console Windows PowerShell en mode administrateur.
    2. Naviguez jusqu’au répertoire où vous avez extrait NSSM en exécutant la commande suivante:
      • CMD ou PowerShell : cd C:\utilities\nssm\win32
    3. Utilisez la commande suivante pour installer MainTCP.exe comme un service :
      • CMD : nssm install MainTCP “C:\chemin\vers\MainTCP.exe”
      • PowerShell : ./nssm.exe install MainTCP “C:\chemin\vers\MainTCP.exe”
    4. Exemples :
      1. Invite de commandes
      2. PowerShell
  4.  Démarrez le service
    • Une fois configuré, vous pouvez démarrer le service avec la commande :
    • CMD : nssm start MainTCP
    • PowerShell : ./nssm.exe start MainTCP
      • Il est possible que vous voyez une erreur. Probablement que le service avait déjà été démarré.
  5. Vérifiez le service
    • Vous pouvez vérifier que le service fonctionne correctement en utilisant la commande :
      • CMD : nssm status MainTCP
      • PowerShell : ./nssm.exe status MainTCP
    • Exemple:
    • Vous pouvez aussi ouvrir le gestionnaire de service Windows pour le démarrer