Installation silencieuse (sans surveillance) de l'Agent BrynQ

Installation silencieuse (sans surveillance) de l'Agent BrynQ

Ce guide s'adresse aux équipes informatiques qui déploient l'Agent BrynQ avec des scripts ou un outil de distribution de logiciels. Pour une installation normale, suivez Installer l'Agent BrynQ.

⚠ Sage 100 France ne peut pas être configuré en mode silencieux. Une installation silencieuse ne peut pas choisir les sociétés Sage et n'affiche jamais la page où vous créez les modèles d'import de BrynQ dans Sage. Configurez Sage une fois avec le programme d'installation interactif : suivez Module Sage 100 France. Ensuite, les installations silencieuses et les mises à jour automatiques conservent la configuration Sage telle quelle.

Avant de commencer

Les prérequis sont les mêmes que pour une installation interactive : Windows Server 2016 ou plus récent (64 bits), des droits d'administrateur local, un accès sortant vers BrynQ (app.brynq.com, port 443) et vers le Cloudflare Tunnel (port 7844), et un jeton d'API BrynQ lié à un client, pour un seul client (Le jeton d'API pour l'Agent BrynQ). Voir Installer l'Agent BrynQ.

Lancer le programme d'installation en mode silencieux

Exécutez cette commande dans une invite de commandes ou une fenêtre PowerShell avec élévation de privilèges (Exécuter en tant qu'administrateur). Remplacez les valeurs entre < >.

brynq-agent-installer-<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART `
  /BRYNQ_API_TOKEN="<your_brynq_api_token>" `
  /AGENT_LISTEN_IP="127.0.0.1" `
  /AGENT_PORT="7070" `
  /ADMIN_PORT="7071" `
  /LANG="english" `
  /ENABLED_MODULES="sql,files" `
  /SQL_DRIVER="ODBC Driver 18 for SQL Server" `
  /SQL_SERVER="<server>" `
  /SQL_AUTHENTICATION_MODE="windows" `
  /SQL_ADVANCED_OPTIONS="Encrypt=no;TrustServerCertificate=yes" `
  /SQL_DATABASE_SCOPE="all" `
  /DIAGNOSTICS=1
ℹ Protégez le jeton. L'Agent enregistre le jeton avec la protection des données Windows (DPAPI). Mais avec /BRYNQ_API_TOKEN, le jeton figure sur la ligne de commande que vous exécutez. Lancez-la depuis un script protégé et ne laissez pas le jeton dans des journaux partagés.

Paramètres

ParamètreSignification
/BRYNQ_API_TOKENLe jeton d'API BrynQ lié à un client. Il doit appartenir à un seul client. Il est enregistré sur le serveur, protégé par la protection des données Windows (DPAPI), pour que l'Agent puisse recevoir les mises à jour.
/ENABLED_MODULESFacultatif. Liste des modules séparés par des virgules : sql, files, rest, soap, ldap. Sur une nouvelle installation, aucun module n'est activé si vous l'omettez.
/AGENT_LISTEN_IP, /AGENT_PORT, /ADMIN_PORTFacultatif. Valeurs par défaut : 127.0.0.1, 7070 et 7071. Ne les modifiez que si les ports sont déjà utilisés.
/LANGFacultatif. Langue de l'installation : english, french, german ou dutch. Sans ce paramètre, la langue d'affichage Windows du serveur est utilisée si c'est l'une de ces quatre langues, sinon l'anglais.
/DIAGNOSTICSFacultatif. /DIAGNOSTICS=1 partage les diagnostics avancés avec le support BrynQ, /DIAGNOSTICS=0 ne les partage pas. Sans ce paramètre, une installation ou une mise à jour silencieuse conserve le choix actuel. Une nouvelle installation silencieuse sans ce paramètre a les diagnostics avancés désactivés.
/SQL_DRIVER, /SQL_SERVERPour le module SQL : le pilote ODBC et le nom du SQL Server.
/SQL_AUTHENTICATION_MODEPour le module SQL : windows, ou un nom d'utilisateur et un mot de passe SQL avec /SQL_USERNAME et /SQL_PASSWORD.
/SQL_ADVANCED_OPTIONSPour le module SQL. Valeur par défaut : Encrypt=no;TrustServerCertificate=yes.
/SQL_DATABASE_SCOPE, /SQL_SELECTED_DATABASESPour le module SQL : all (toutes les bases de données, la valeur par défaut d'une installation silencieuse), ou selected avec une liste. Cela indique seulement quelles bases de données les interfaces utilisent ; cela ne limite pas l'accès. Pour limiter l'accès, ne donnez au compte SQL des droits que sur ces bases de données.
/SQL_CONNECTION_STRINGFacultatif. Toujours accepté à la place des paramètres SQL séparés, pour les anciens scripts.
/TASKS, /MERGETASKSFacultatif. Options de la page Options supplémentaires : desktopicon (raccourci sur le Bureau), startmenuicon (raccourci dans le menu Démarrer), diagnostics (partager les diagnostics avancés).
/LOG="C:\Temp\brynq-installer.log"Facultatif. Écrit un journal d'installation à l'emplacement choisi. Le programme d'installation en garde aussi une copie dans C:\ProgramData\BrynQ\Agent\logs\installer (setup-<date>-<time>.log, les dix plus récents). Les valeurs secrètes sont masquées dans ces journaux.

Vérifier le résultat

ℹ Le code de sortie n'est pas un contrôle de bon fonctionnement. Le programme d'installation peut se terminer avec le code 0 même si une étape de configuration ultérieure a échoué. Vérifiez toujours les services et les fichiers ci-dessous.
Get-Service BrynQAgent,BrynQCloudflared
Invoke-WebRequest -Uri "http://127.0.0.1:7070/brynq-agent/" -UseBasicParsing
Get-Content "C:\ProgramData\BrynQ\Agent\config\public_url.txt"
  • Les deux services sont Running (En cours d'exécution).
  • La vérification locale renvoie une réponse.
  • public_url.txt affiche https://<your-customer>.brynq-agent.com.
  • Le détail des étapes de configuration se trouve dans C:\ProgramData\BrynQ\Agent\config\install-state.json et C:\ProgramData\BrynQ\Agent\logs\installer\install-post.log.
  • L'installation s'arrête quand l'un des dossiers de BrynQ (par exemple C:\ProgramData\BrynQ ou son dossier config) a été créé par un autre utilisateur. Le journal indique la commande takeown qui corrige le problème.