Aller au contenu

Installer le connecteur

En bref

Un seul installeur SenSaaS pose, dans C:\Program Files (x86)\SenSaaS, le connecteur et son service Windows ServeurSensaas, l'outil de configuration, le Report Designer et le client EasyConnect. Il dépose la bibliothèque des modèles d'impression et installe au passage les composants .NET manquants. Sur un poste équipé de la version 1, il remplace le connecteur, le Report Designer et le client EasyConnect installés séparément. Une fois l'installation terminée, l'outil de configuration s'ouvre sur l'assistant de premier lancement.

Avant de commencer

  • Vérifiez les prérequis machine : Windows, Sage 100 installé avec ses objets métiers, SQL Server accessible.
  • Connectez-vous avec un compte administrateur de la machine : l'installeur exige l'élévation.
  • Choisissez le mode d'accès : le réseau privé EasyConnect, proposé par défaut, n'exige aucun port entrant ; à défaut, prévoyez le port HTTPS à ouvrir sur le pare-feu et l'adresse publique par laquelle vos utilisateurs joindront le connecteur.
  • Gardez à portée de main l'adresse email de votre compte SenSaaS (revendeur ou client) : l'assistant s'en sert pour rattacher le connecteur à votre société.

Installer avec l'installeur

L'installeur est un exécutable signé, nommé Setup_SenSaaS.exe : le nom ne porte ni la version de Sage ni celle du connecteur, affichée dans les propriétés du fichier. Hormis les composants .NET, tout ce qu'il installe est embarqué : rien d'autre n'est téléchargé pendant l'installation.

  1. Lancez l'exécutable et acceptez l'élévation demandée par Windows.
  2. Prérequis .NET : l'installeur vérifie la présence des composants .NET 10 en version x86 (Desktop Runtime et ASP.NET Core Runtime). S'ils manquent, il les télécharge et les installe silencieusement. Un redémarrage peut être demandé par le programme d'installation de Microsoft.
  3. Reprise d'une installation de la version 1 : si le poste porte le connecteur, le Report Designer ou le client EasyConnect de la version 1, l'installeur les remplace (voir Migrer depuis la version 1).
  4. Dossier d'installation : C:\Program Files (x86)\SenSaaS.
  5. Copie des fichiers : le connecteur (SenSaaS.Serveur.exe), l'outil de configuration (SenSaaS.Configuration.exe) et le Report Designer (SenSaaS.ReportDesigner.exe, avec ses langues dans Langues\) sont posés dans ce dossier.
  6. Journaux : à la première installation, le fichier NLog.config est créé actif, au niveau Debug, et le dossier C:\ProgramData\Sage\SenSaaS\logs est créé. Voir Journalisation.
  7. Client EasyConnect : ses fichiers sont posés dans le sous-dossier EasyConnect\ et le service Windows EasyConnect est créé (démarrage automatique) puis démarré. Il démarre ainsi avant le connecteur, qui peut écouter sur son adresse EasyConnect. Voir EasyConnect.
  8. Bibliothèque de modèles d'impression : elle est déposée dans C:\ProgramData\Sage\SenSaaS\Reports\, sans jamais écraser un fichier existant. Voir Modèles d'impression.
  9. Raccourcis, pour tous les utilisateurs : dans le menu Démarrer (dossier SenSaaS), Configuration SenSaaS, Report Designer SenSaaS et Désinstaller SenSaaS ; sur le Bureau, Configuration SenSaaS et Report Designer SenSaaS.
  10. Service Windows : le service ServeurSensaas est créé puis démarré en dernier (voir ci-dessous).
  11. Fin : laissez cochée l'option qui lance l'outil de configuration pour enchaîner sur l'assistant de premier lancement.

L'installation apparaît dans Paramètres › Applications sous une seule entrée SenSaaS, éditeur Flow SAS.

Installation silencieuse

L'installeur accepte l'option /S pour une installation sans interface, utilisée notamment par la mise à jour automatique. En mode silencieux, rien n'est lancé à la fin, et l'installation est annulée si l'outil de configuration ou le Report Designer est ouvert : fermez-les au préalable. En mode interactif, l'installeur demande de les fermer.

L'installeur consigne son déroulé dans le fichier SenSaaS.Updater.log du dossier d'installation. C'est la première chose à consulter si l'installation échoue.

Le service Windows

Élément Valeur
Nom du service ServeurSensaas
Nom affiché Serveur SenSaaS
Exécutable SenSaaS.Serveur.exe dans le dossier d'installation, reconnaissable à son icône de serveurs empilés sur fond dégradé
Compte Système local (LocalSystem)
Démarrage Automatique (différé)

Le client EasyConnect tourne dans son propre service, EasyConnect (démarrage automatique, redémarrage en cas d'échec), exécuté depuis le sous-dossier EasyConnect\ du dossier d'installation.

Capture à venir

Le service Serveur SenSaaS dans la console des services Windows - identifiant connecteur/services-windows. L'image sera ajoutée lors de la prochaine campagne de captures.

Vous pilotez le service de trois façons :

L'écran Accueil affiche l'état du service et propose Lancer, Stopper et Relancer. C'est la voie recommandée.

Ouvrez la console Services, repérez Serveur SenSaaS, puis clic droit › Démarrer / Arrêter / Redémarrer.

Onglet Services, ligne ServeurSensaas, clic droit › Redémarrer.

Le service n'est pas recréé lors d'une mise à jour

Si le service existe déjà, l'installeur ne le recrée pas : il le repointe sur le dossier d'installation et le redémarre. Le compte sous lequel il s'exécute et ses réglages de démarrage sont donc conservés.

Si les fichiers d'un dossier Sage se trouvent sur un lecteur réseau, l'écran Dossiers Sage convertit le chemin en chemin réseau complet et propose de faire tourner le service sous le compte de l'utilisateur connecté.

Accès réseau et ports d'écoute

Les points d'écoute se règlent dans l'écran Serveur Web de l'outil de configuration. Deux modes d'accès existent, cumulables :

  • EasyConnect, proposé par défaut : écoute HTTPS sur le réseau privé EasyConnect, port 4000, sans ouvrir de port entrant sur votre pare-feu. Voir EasyConnect.
  • Standard : ouverture d'un port HTTPS, et au besoin HTTP, sur l'adresse IP locale, pour un accès direct ou derrière un proxy inverse.

Valeurs d'une configuration neuve :

Paramètre Valeur par défaut
Mode d'accès EasyConnect, port 4000
Adresse IP d'écoute (mode Standard) * (toutes les cartes réseau)
HTTPS (mode Standard) Activé, port 443
HTTP (mode Standard) Désactivé, port 80
Redirection HTTP vers HTTPS Activée
Hôtes autorisés *
Outil de test de l'API Désactivé
Écritures API v2 Activées, y compris après une migration depuis la version 1
Requêtes SQL brutes Autorisées, sous les filtres de données de l'appelant (voir Sécurité)

À l'étape Accessibilité de l'assistant, le choix par défaut rejoint le réseau EasyConnect : les écoutes HTTP et HTTPS standard sont alors coupées (elles restent réactivables dans l'écran Serveur Web). L'option "Je préfère ouvrir un port sur mon pare-feu" propose les ports 443, 4000, 7000 ou 13370 et une adresse publique facultative. Dans les deux cas, le portail SenSaaS vérifie qu'il joint le connecteur. Le détail figure dans L'assistant de première configuration.

Un changement de port, d'adresse ou de certificat n'est pris en compte qu'après redémarrage du service.

Première configuration

Au premier lancement, l'outil de configuration ne demande pas de mot de passe (il n'en existe pas encore) et ouvre directement l'assistant de premier lancement. Chaque étape est vérifiée avant de passer à la suivante :

  1. Accueil : détection des objets métiers Sage 100 et choix du mot de passe administrateur de l'outil.
  2. Compte SenSaaS : recherche de votre compte par email, puis saisie du code à six chiffres reçu par mail, pour rattacher le connecteur à votre société.
  3. Dossier Sage : test de connexion au dossier, création de la base SenSaaS, préparation des modèles d'impression, import des collaborateurs Sage comme utilisateurs inactifs.
  4. Accessibilité : EasyConnect ou port ouvert, puis synchronisation avec le portail.
  5. Finalisation : récapitulatif, enregistrement de la configuration et redémarrage du service.

Le mot de passe administrateur n'est enregistré qu'à la fin : un assistant interrompu se relance au lancement suivant. Le détail de chaque étape est décrit dans L'assistant de première configuration.

Mettre à jour

Deux voies mènent au même résultat.

  • Mise à jour automatique : le connecteur embarque un utilitaire de mise à jour qui interroge périodiquement le site SenSaaS et installe silencieusement la nouvelle version. La version 2 a son propre canal de mise à jour, distinct de celui de la version 1 : un poste en version 1 n'est pas migré automatiquement.
  • Mise à jour manuelle : téléchargez le nouvel installeur et lancez-le. Il détecte l'installation existante, arrête le service, remplace les binaires et redémarre le service.

Dans les deux cas :

  • Le fichier appsettings.json existant est conservé.
  • La configuration chiffrée (SenSaaS.config) n'est pas touchée.
  • Le fichier NLog.config n'est jamais écrasé ; s'il est absent parce que les journaux ont été désactivés, il n'est pas recréé.
  • Les fichiers des anciens outils de configuration (Configuration.exe, SenSaaS.Configuration.Avalonia.exe) sont supprimés et les raccourcis sont recréés.
  • Le client EasyConnect n'est remplacé que si sa version change : son service est alors arrêté, ses fichiers remplacés et le service redémarré. Sinon, rien n'est interrompu.
  • La bibliothèque de modèles n'est déposée que si elle ne contient encore aucun modèle.
  • L'installeur attend jusqu'à 40 secondes la libération des fichiers par le service, puis tente un arrêt forcé ; s'il n'y parvient toujours pas, il interrompt l'installation avec un message invitant à arrêter le service manuellement.

Connecteur et outil de configuration vont de pair

Le fichier de configuration est chiffré avec une clé propre à l'installation. Un outil de configuration d'une version antérieure ne sait pas relire un fichier migré par une version plus récente : installez toujours les deux ensemble, ce que fait l'installeur.

Migrer depuis la version 1

Sur un poste équipé de la version 1, l'installeur détecte et remplace, dans l'ordre :

  1. Le Report Designer de la version 1 : désinstallé en silencieux, avec sa tâche planifiée de mise à jour et ses raccourcis.
  2. Le connecteur de la version 1 (ou une préversion de la version 2), installé dans C:\Program Files (x86)\Optima Concept\Serveur Sensaas : son désinstalleur n'est pas lancé, car il supprimerait le service et son compte. appsettings.json, NLog.config et les fichiers de licence .license sont repris dans le nouveau dossier, puis l'ancien dossier est supprimé (il est conservé, et le journal le signale, si un fichier n'a pas pu être repris). Le service ServeurSensaas est repointé sur le nouveau dossier, avec son compte.
  3. Le client EasyConnect de la version 1 : désinstallé en silencieux, puis remplacé par le client du dossier SenSaaS, sous le même service EasyConnect. L'identité de la machine sur le réseau EasyConnect (son nom et son adresse) est conservée.

La configuration (C:\ProgramData\Sage\SenSaaS : configuration chiffrée, certificat, journaux, modèles) ne bouge pas.

Coupure EasyConnect de quelques secondes

Pendant le remplacement du client EasyConnect, la connexion EasyConnect de la machine est coupée quelques secondes. Une mise à jour lancée à distance par EasyConnect perd sa session, mais l'installation va jusqu'au bout et la machine revient sur le réseau avec la même identité.

Installation incomplète

Si un composant du connecteur manque dans le dossier d'installation, l'API v2 ne répond plus "connexion à Sage impossible" mais une erreur 503 de code CONFIG.INCOMPLETE, qui nomme le fichier manquant et invite à réinstaller ou à mettre à jour le connecteur. Aucune donnée n'est en cause : réinstallez la version courante avec l'installeur. Voir Dépannage.

Désinstaller

Passez par Paramètres › Applications (entrée SenSaaS), par le raccourci Désinstaller SenSaaS du menu Démarrer, ou par Uninstall.exe du dossier d'installation.

La désinstallation :

  • arrête puis supprime les services ServeurSensaas et EasyConnect ;
  • supprime les raccourcis et les entrées de registre ;
  • supprime les fichiers du dossier d'installation, sauf appsettings.json, NLog.config et les fichiers de licence .license.

Ce qui n'est pas supprimé

Le dossier C:\ProgramData\Sage\SenSaaS\ (configuration chiffrée, journaux, modèles d'impression), la base de données SenSaaS et l'identité EasyConnect de la machine (C:\ProgramData\Tailscale) ne sont pas supprimés. Réinstaller sur la même machine retrouve donc la configuration précédente et la même adresse EasyConnect. Si vous devez tout effacer, supprimez ces éléments manuellement : l'opération est irréversible.

Questions fréquentes

Puis-je installer le connecteur sur une machine sans Sage 100 ?

Non. Les objets métiers Sage sont chargés dans le processus du connecteur : ils doivent être présents et enregistrés sur la même machine. Sans eux, l'assistant diffère l'étape Dossier Sage, qu'il faudra reprendre une fois Sage installé.

Faut-il ouvrir un port sur le pare-feu ?

Non, si vous gardez EasyConnect, le mode proposé par défaut : le connecteur rejoint un réseau privé et le portail le joint par ce réseau. Seul un accès sortant est nécessaire, notamment vers le serveur EasyConnect.

Faut-il rouvrir l'outil de configuration après une mise à jour ?

Ce n'est pas nécessaire si rien n'a changé dans vos paramètres. Rouvrez-le pour vérifier l'état du service et la licence après une montée de version.

Où se trouve le fichier de configuration ?

Dans C:\ProgramData\Sage\SenSaaS\SenSaaS.config. Il est chiffré et ne doit jamais être édité à la main : voir Sécurité.

Voir aussi

Documentation de SenSaaS v2. Chaque page est écrite à partir du produit livré ; ce qui reste à vérifier y est signalé.