Aller au contenu

Installer le connecteur

En bref

L'installeur SenSaaS pose le connecteur, l'outil de configuration et le service Windows ServeurSensaas sur la machine Sage. Il installe au passage les composants .NET manquants. Une fois l'installation terminée, l'outil de configuration s'ouvre sur l'assistant de première configuration.

Avant de commencer

  • Vérifiez les prérequis machine : Windows, Sage 100c installé, SQL Server accessible.
  • Connectez-vous avec un compte administrateur de la machine : l'installeur exige l'élévation.
  • Prévoyez le port d'écoute (443 par défaut) et, si vous exposez le connecteur sur Internet, le certificat que vous utiliserez.

Installer avec l'installeur

L'installeur est un exécutable signé, nommé SenSaaS_Sagev<version Sage>_<version>.exe.

  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 9 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. Dossier d'installation — par défaut C:\Program Files (x86)\Optima Concept\Serveur Sensaas. Lors d'une mise à jour, l'installeur réutilise le dossier de l'installation existante.
  4. Copie des fichiers — les binaires du connecteur et de l'outil de configuration sont posés dans le dossier d'installation.
  5. Raccourcis — un raccourci Configuration SenSaaS est créé sur le Bureau et dans le menu Démarrer (dossier Optima Concept › SenSaaS), avec un raccourci de désinstallation.
  6. Service Windows — le service ServeurSensaas est créé puis démarré (voir ci-dessous).
  7. Fin — laissez cochée l'option Lancer Configuration SenSaaS pour enchaîner sur la première configuration.

Installation silencieuse

L'installeur accepte l'option /S pour une installation sans interface, utilisée notamment par la mise à jour automatique. En mode silencieux, l'installation est refusée si l'outil de configuration est ouvert : fermez-le au préalable.

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
Démarrage Automatique (différé)

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 redémarre simplement. Le compte sous lequel il s'exécute et ses réglages de démarrage sont donc conservés.

Ports d'écoute et HTTPS

Les points d'écoute sont définis dans l'outil de configuration, écran Serveur Web. Les valeurs par défaut d'une installation neuve sont les suivantes :

Paramètre Valeur par défaut
Adresse IP d'écoute * (toutes les cartes réseau)
HTTPS Activé, port 443
HTTP Désactivé, port 80
Redirection HTTP vers HTTPS Activée
Hôtes autorisés *
Outil de test de l'API Désactivé

Trois modes d'exposition sont possibles, cumulables :

  • HTTPS sur un port local : le mode standard, à privilégier. Il exige un certificat (auto-signé généré par l'outil, ou Let's Encrypt).
  • HTTP : non chiffré, à réserver au réseau local ou derrière un proxy inverse.
  • EasyConnect : écoute HTTPS sur un réseau privé, sans ouvrir de port entrant sur votre pare-feu. Voir EasyConnect.

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 première configuration :

  1. Sécurité et apparence — définir le mot de passe administrateur de l'outil.
  2. Dossiers Sage — déclarer les dossiers accessibles.
  3. Base SenSaaS — renseigner la connexion à la base SQL propre à SenSaaS.
  4. Serveur web — définir les adresses d'écoute et le certificat.
  5. Finalisation — vérifier le récapitulatif.

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.
  • Mise à jour manuelle : téléchargez le nouvel installeur et lancez-le. Il détecte l'installation existante, réutilise son dossier, 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.
  • L'installeur attend jusqu'à 40 secondes la libération des fichiers par le service ; s'il n'y parvient 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.

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 le service ServeurSensaas ;
  • 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é

La configuration chiffrée du dossier C:\ProgramData\Sage\SenSaaS\ et la base de données SenSaaS ne sont pas supprimées. Réinstaller le connecteur sur la même machine retrouve donc la configuration précédente. 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 100c ?

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.

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