Problemen met de BrynQ Agent oplossen

Problemen met de BrynQ Agent oplossen

Problemen met de BrynQ Agent? Begin met de twee snelle controles hieronder. Die lossen de meeste problemen op of verklaren ze. Zoek daarna je situatie op in de tabel.

Werk je met Sage 100 France? Bekijk dan ook de probleemoplossingsgids voor Factorial - Sage 100 France.

Begin hier: twee snelle controles

✅ Controle 1: open de pagina Probleemoplossing. Open op de Windows-server het lokale beheerdashboard (http://127.0.0.1:7071/admin) en klik op Probleemoplossing. De pagina controleert de services, de verbinding met BrynQ en meer (zie De pagina Probleemoplossing). Opent het dashboard niet? Open Taakbeheer > Services: BrynQAgent en BrynQCloudflared moeten de status Actief hebben (en BrynQSageImport als Sage 100 France wordt gebruikt).
✅ Controle 2: wat staat er in de logbestanden? Lees ze onder Logbestanden op de pagina Probleemoplossing, of open C:\ProgramData\BrynQ\Agent\logs op de Windows-server (zie Logbestanden).

Zoek je probleem

Wat je zietWat je doet
In het installatieprogramma kun je op de pagina Cloudverbinding niet op Volgende klikkenBrynQ heeft het token nog niet geaccepteerd. Lees de melding onder het token. Zie Tokenmeldingen.
Het installatieprogramma toont aan het eind een fout (stap na de installatie)Meestal is uitgaand verkeer geblokkeerd. Controleer of de server https://app.brynq.com (poort 443) en de Cloudflare Tunnel op poort 7844 kan bereiken (zie Netwerkinstellingen). Voer daarna het installatieprogramma opnieuw uit. Zie Logbestanden van het installatieprogramma. Is alleen de laatste stap mislukt? Klik op Opnieuw: je keuzes blijven bewaard.
De installatie of een automatische update stopt omdat een map of bestand door een andere gebruiker is gemaaktZie Map gemaakt door een andere gebruiker.
Fout AGENT_TOKEN_MUST_TARGET_EXACTLY_ONE_CUSTOMERHet token is gekoppeld aan meerdere klanten of aan geen enkele (bijvoorbeeld een beheerderstoken). Vraag BrynQ om de Agent-token van deze klant. Zie De API-token voor de BrynQ Agent.
Delen van de installatie mislukken, of de Agent kan geen bestanden lezen of schrijvenVaak een probleem met rechten. Zie Problemen met rechten.
Een service is gestopt of start nietZie De services draaien niet.
BrynQ kan de Agent niet bereikenOpen de pagina BrynQ-verbinding van het beheerdashboard en lees de twee controles. Controleer beide services. Start eerst BrynQCloudflared opnieuw, daarna BrynQAgent. Bekijk de controle Uitgaande verbindingen op de pagina Probleemoplossing. Klik daarna op Opnieuw testen en test de verbinding opnieuw in BrynQ.
Deze agent meldt zich aan bij BrynQ mislukt (bijvoorbeeld "De API-token is verlopen. Vraag BrynQ om een nieuwe.")Vraag BrynQ om een nieuw token. Plak het op de pagina BrynQ-verbinding onder API-token vervangen en klik op Controleren en opslaan.
Een verzoek wordt geweigerd met 401De klant of het token in het verzoek is niet geldig. Controleer de autorisatie van de app in BrynQ.
Een verzoek wordt geweigerd met 403 of 413De module Files of REST weigert een pad, extensie of URL die niet is toegestaan, of een bestand dat te groot is. Controleer de pagina Bestanden of REST van het beheerdashboard.
Een module geeft 404 Not FoundDie module is niet ingeschakeld. Voer het installatieprogramma opnieuw uit en selecteer de module.
De SQL-verbinding misluktOpen het lokale beheerdashboard, controleer de pagina SQL (server, stuurprogramma, authenticatie) en klik op Verbinding testen. Werkt het niet meer sinds een update? Zie Na de update naar 3.10.1.
Het beheerdashboard opent nietControleer of BrynQAgent draait en of je het op de server zelf opent (http://127.0.0.1:7071/admin, of de beheerpoort die je hebt gekozen). Gebruik Edge, Chrome of Firefox: Internet Explorer kan het niet weergeven.
Poort 7070 of 7071 is al in gebruikVoer het installatieprogramma opnieuw uit. Vink op de pagina Extra opties onder Netwerk de optie Aangepaste lokale netwerkinstellingen gebruiken aan en kies andere poorten.
"Hostname already in use"Neem contact op met BrynQ-support. Het Agent-adres van je klant is al aan een andere installatie gekoppeld.
Automatische updates komen niet binnenOpen de pagina Updates in het beheerdashboard en klik op Nu controleren. Updates hebben het opgeslagen token en uitgaande toegang tot BrynQ nodig. Zie Bijwerken, verwijderen of terugdraaien.

De pagina Probleemoplossing

📍 Waar: het lokale beheerdashboard op de Windows-server, pagina Probleemoplossing.

De pagina voert deze controles uit. Klik op Controles opnieuw uitvoeren nadat je iets hebt opgelost.

ControleWat er wordt gecontroleerd
BrynQ-servicesOf de BrynQ-services draaien. Services openen opent de Windows-services.
Verbinding met BrynQOf de Agent zich aanmeldt bij BrynQ, en of BrynQ de Agent bereikt.
Handtekeningen van programma'sOf de BrynQ-programma's en -scripts zijn ondertekend en ongewijzigd. Antivirus of applicatiebeheer (AppLocker, WDAC) kan programma's zonder geldige handtekening blokkeren.
MaptoegangOf de BrynQ-services (computeraccount, LocalSystem) de BrynQ- en Sage-mappen kunnen gebruiken.
Uitgaande verbindingenapp.brynq.com:443, region1.v2.argotunnel.com:7844 en region2.v2.argotunnel.com:7844. Elk toont Bereikbaar, Naam niet gevonden (DNS) of Geblokkeerd. Een firewall of proxy houdt een geblokkeerde verbinding tegen: vraag je IT-afdeling om die toe te staan. De tunnel kan niet via een proxy lopen.
Openbaar IP-adresHet openbare IP-adres van de server. Gebruik het als BrynQ het token alleen vanaf bepaalde IP-adressen accepteert.

Pagina Probleemoplossing met alle controles in orde

Een controle met een probleem laat zien wat er mis is en wat je moet doen:

Pagina Probleemoplossing met problemen

De pagina bevat ook:

  • Supportbestand downloaden: zie Supportbestand.
  • Uitgebreide diagnose en Zelf verzamelen: Windows-gegevens zoals Microsoft Defender, Applicatiebeheer (AppLocker, WDAC) en Windows-logboeken. Staat de schakelaar uit, dan verzamel alleen jij ze en beslis je zelf of je ze deelt. Zie Beveiliging van de BrynQ Agent.
  • Toegang door support: elke toegang door BrynQ-support.
  • Zoek uw probleem: klik op een probleem om de stappen te zien.
  • Logbestanden: nieuwste eerst. Klik op een bestand om het op de pagina te lezen, of op Map openen.

Tokenmeldingen

Het installatieprogramma controleert het BrynQ API-token bij BrynQ terwijl je het typt, op de pagina Cloudverbinding. Volgende werkt pas als BrynQ het token accepteert. Het beheerdashboard controleert het op dezelfde manier op de pagina BrynQ-verbinding. Welke token je nodig hebt, hoe je hem krijgt en hoe je hem vervangt: zie De API-token voor de BrynQ Agent.

MeldingWat je doet
BrynQ accepteert dit token.Niets. Klik op Volgende.
BrynQ accepteert dit token niet (bijvoorbeeld TOKEN_NOT_FOUND of TOKEN_EXPIRED)Controleer of je het hele token hebt gekopieerd. Verlopen? Vraag BrynQ om een nieuw token.
BrynQ accepteert dit token alleen vanaf andere IP-adressen. Voeg het openbare IP-adres van deze server toe aan het token in BrynQ.Voeg het openbare IP-adres van de server (te zien op de pagina Probleemoplossing) toe aan het token in BrynQ. Klik daarna op Opnieuw controleren.
BrynQ kent dit token, maar het is geen agent-tokenEen agent-token is aan precies één klant gekoppeld. Gebruik het agent-token van deze klant.
BrynQ is bezet, of kon niet worden bereiktProbeer het over een paar minuten opnieuw met Opnieuw controleren. Lukt het nog steeds niet? Controleer de uitgaande verbindingen.

Pagina BrynQ-verbinding met een verlopen token en de tunnelservice gestopt

De services draaien niet

📍 Waar: de Windows-server.

  1. Open Taakbeheer > Services (of klik op Services openen op de pagina Probleemoplossing).
  2. Klik met de rechtermuisknop op de gestopte service en kies Starten. Zijn beide gestopt, start dan eerst BrynQCloudflared en daarna BrynQAgent.
  3. Wacht even en controleer of de status verandert in Actief.
  4. Start de service niet, of stopt hij weer? Dat is vaak een probleem met rechten (zie Problemen met rechten). Bekijk C:\ProgramData\BrynQ\Agent\logs\services en logs\agent, of voer het installatieprogramma opnieuw uit. Kom je er nog steeds niet uit? Maak een supportbestand en neem contact op met BrynQ-support (zie hieronder).

Voor IT-beheerders, in een PowerShell-venster met beheerdersrechten:

Get-Service BrynQAgent,BrynQCloudflared | Format-Table Name,Status,StartType
Restart-Service BrynQCloudflared
Restart-Service BrynQAgent
Invoke-WebRequest -Uri "http://127.0.0.1:7070/brynq-agent/" -UseBasicParsing

Problemen met rechten

Veel installatie- en serviceproblemen komen neer op Windows-rechten. Loop deze punten na:

  • Wie heeft toegang nodig? De BrynQ-services draaien als LocalSystem. Op de Agent-server bereikt dat account meestal elke lokale map. Op andere servers (een bestandsshare, Sage-bestanden op een andere machine, SQL Server elders) heeft het computeraccount van de server, DOMAIN\SERVERNAME$, de rechten nodig. Met Windows-authenticatie ziet SQL Server NT AUTHORITY\SYSTEM of dat computeraccount. De controle Maptoegang op de pagina Probleemoplossing laat zien welke mappen een probleem hebben. Details: SQL-module en Files-module.
  • Installatieprogramma geblokkeerd? Klik bij Windows heeft uw pc beschermd op Meer informatie > Toch uitvoeren. Bestand geblokkeerd na het downloaden? Rechtermuisklik > Eigenschappen > vink Blokkering opheffen aan. Werkt je organisatie met een lijst van toegestane software (App Control / WDAC, AppLocker, antivirus)? Volg Beveiliging: sta de Agent toe op basis van de ondertekeningsidentiteit, niet op basis van de vingerafdruk van het certificaat, zodat automatische updates blijven werken. De controle Handtekeningen van programma's toont een programma dat niet is ondertekend.
  • Is het een probleem met rechten? Zoek naar Access is denied, Permission denied of Login failed in logs\agent, logs\services, logs\installer\install-post-error.log of het setuplogbestand (zie Logbestanden van het installatieprogramma).
Geavanceerde controles (voor IT)
  • Logboeken (eventvwr.msc): onder Windows-logboeken > Systeem laten gebeurtenissen van Service Control Manager zien waarom een BrynQ-service niet startte of stopte. Onder Windows-logboeken > Toepassing betekent een SQL Server-melding Login failed (gebeurtenis 18456) dat het Agent-account geen SQL-toegang heeft.
  • Serviceaccount: open in services.msc een BrynQ-service > Aanmelden om te zien onder welk account hij draait.
  • Maptoegang: rechtermuisklik op de map > Eigenschappen > Beveiliging > Geavanceerd > Effectieve toegang, selecteer SYSTEM (of het computeraccount) en klik op Effectieve toegang weergeven.

Map gemaakt door een andere gebruiker

Het installatieprogramma vergrendelt de mappen van BrynQ, zodat andere gebruikers van de server ze niet kunnen wijzigen. Het stopt als een van deze mappen, of een bestand in config, door een andere gebruiker is gemaakt: C:\ProgramData\BrynQ, C:\ProgramData\BrynQ\Agent, de map config of de updatecache. Automatische updates stoppen op dezelfde manier. De melding noemt de map.

  1. Verwijder de map, of neem hem over als een beheerder hem heeft gemaakt. In een opdrachtprompt als beheerder:
    takeown /F "C:\ProgramData\BrynQ\Agent" /A /R
    Gebruik de map die in de melding staat.
  2. Voer het BrynQ-installatieprogramma opnieuw uit.

Na de update naar 3.10.1

  • SQL mislukt na de update? Een SQL-wachtwoord dat begint met { en eindigt met } wordt nu zonder de accolades gelezen. Voer het wachtwoord opnieuw in op de pagina SQL van het beheerdashboard met Wachtwoord vervangen.

Supportbestand

Het supportbestand bevat alles wat BrynQ-support nodig heeft in één zipbestand. Geheimen zijn eruit verwijderd.

  • Beheerdashboard: Probleemoplossing › Supportbestand downloaden.
  • Als het dashboard niet opent (de service BrynQAgent is gestopt of start niet): voer dit uit in een opdrachtprompt als beheerder. Het bestand wordt op je bureaublad opgeslagen, of in de map die je aan het eind toevoegt:
    "C:\Program Files\BrynQ\Agent\brynq-agent.exe" --support-file

Het bestand heet brynq-agent-support-<customer>-<server>-<date>-<time>.zip en is kleiner dan 10 MB. Het begint met README.txt: wat er mis is, de controles en de nieuwste fouten. Verder bevat het de logbestanden, de instellingen, de servicedefinities, de ConnectImport-scenario's, de historie en nieuwste logbestanden, en de setuplogbestanden. De uitgebreide diagnose zit er alleen in zolang je die deelt.

Logbestanden

MapGebruik voor
C:\ProgramData\BrynQ\Agent\logs\agentAlgemene Agent-problemen en verbindingsproblemen (logbestanden application, requests en security).
C:\ProgramData\BrynQ\Agent\logs\servicesServices die niet starten.
C:\ProgramData\BrynQ\Agent\logs\sageSage 100 France-imports (connectimport, connectimport-error, service-loop).
C:\ProgramData\BrynQ\Agent\logs\installerInstallatiestappen (install-post.log, install-post-error.log en een kopie van het setuplogbestand).

Je kunt ze ook lezen op de pagina Probleemoplossing onder Logbestanden. Logbestanden worden dagelijks geroteerd en 30 dagen bewaard. Wachtwoorden en tokens worden eruit verwijderd. Zie je ProgramData niet? Die map is standaard verborgen: typ het pad direct in de adresbalk van Verkenner.

Logbestanden van het installatieprogramma

  • Setup bewaart een kopie van zijn logbestand in C:\ProgramData\BrynQ\Agent\logs\installer\setup-<date>-<time>.log (de nieuwste tien). De waarden van geheime switches worden gemaskeerd.
  • Of open %TEMP% in Verkenner en zoek het nieuwste Setup Log*.txt.
  • Of voer het installatieprogramma uit met een logpad: brynq-agent-installer-<version>.exe /LOG="C:\Temp\brynq-installer.log"
  • De afsluitcode van het installatieprogramma zegt niet of alles is gelukt. Controleer C:\ProgramData\BrynQ\Agent\config\install-state.json en logs\installer\install-post.log.

Contact opnemen met BrynQ-support

Help ons je sneller te helpen. Stuur mee:

  • Een korte beschrijving van wat je deed en wat je ziet (een screenshot van de fout helpt).
  • Het supportbestand. Dat bevat de Agent-versie en de relevante logbestanden.
  • Geen supportbestand? Stuur dan de Agent-versie (te zien op de pagina Start van het beheerdashboard) en de relevante logbestanden mee: logs\agent bij verbindings- en algemene problemen, logs\sage bij Sage-imports, logs\installer of het Setup Log bij installatieproblemen.