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? Zie dan ook de probleemoplossing voor Factorial - Sage 100 France.

Begin hier: twee snelle controles

✅ Controle 1: draaien de services? Open op de Windows-server Taakbeheer > Services. BrynQAgent en BrynQCloudflared moeten Actief (Running) zijn (en BrynQSageImport als Sage 100 France wordt gebruikt).
✅ Controle 2: wat staat er in de logbestanden? Open C:\ProgramData\BrynQ\Agent\logs op de Windows-server (zie Logbestanden).

Zoek je probleem op

Wat je ziet	Wat je doet
Het installatieprogramma toont aan het eind een fout (stap na de installatie)	Meestal een ongeldig token of geblokkeerde uitgaande toegang. Controleer of het BrynQ API-token bij precies één klant hoort en of de server https://app.brynq.com en https://api.cloudflare.com kan bereiken. Start het installatieprogramma daarna opnieuw. Zie Installatielogs.
Foutmelding AGENT_TOKEN_MUST_TARGET_EXACTLY_ONE_CUSTOMER	Het token geeft toegang tot meer dan één klant. Maak een nieuw token aan via Admin Portal > API Access > Add API token en selecteer alleen deze klant.
Delen van de installatie mislukken, of de Agent kan geen bestanden lezen of schrijven	Vaak een rechtenprobleem. Zie Rechtenproblemen.
Een service is gestopt of start niet	Zie De services draaien niet.
BrynQ kan de Agent niet bereiken	Controleer beide services. Herstart eerst BrynQCloudflared en daarna BrynQAgent. Controleer of uitgaand HTTPS-verkeer nog is toegestaan. Test daarna de verbinding in BrynQ opnieuw.
Een verzoek wordt geweigerd met 401	De klant of het token in het verzoek is niet geldig. Controleer de autorisatie van de app in BrynQ.
Een module geeft 404 Not Found	Die module is niet ingeschakeld. Start het installatieprogramma opnieuw en selecteer de module.
De SQL-verbinding mislukt	Open het lokale beheerdashboard, controleer het SQL Connection Profile (server, driver, authenticatie, toegestane databases) en klik op Validate and Save.
Het beheerdashboard opent niet	Controleer of BrynQAgent actief is en of je het op de server zelf opent (http://127.0.0.1:7071/admin, of de beheerpoort die je hebt gekozen).
Poort 7070 of 7071 is al in gebruik	Start het installatieprogramma opnieuw, vink Use custom local network settings (Select Additional Tasks) aan en kies andere poorten.
"Hostname already in use"	Neem contact op met BrynQ support. Het Agent-adres van je klant is al gekoppeld aan een andere installatie.
Automatische updates komen niet binnen	Controleer het onderdeel Updates in het beheerdashboard en klik op Check Now. Updates hebben het opgeslagen token en uitgaande toegang tot BrynQ nodig. Zie Bijwerken, verwijderen of terugzetten.

De services draaien niet

📍 Waar: de Windows-server.

Open Taakbeheer > Services.
Klik met de rechtermuisknop op de gestopte service en kies Starten. Zijn beide gestopt? Start dan eerst BrynQCloudflared en daarna BrynQAgent.
Wacht even en controleer of de status verandert in Actief (Running).
Start de service niet, of stopt hij weer? Dat is vaak een rechtenprobleem (zie Rechtenproblemen). Bekijk C:\ProgramData\BrynQ\Agent\logs\services en logs\agent, of voer het installatieprogramma opnieuw uit. Kom je er niet uit? Neem contact op met BrynQ support (zie hieronder).

Voor IT-beheerders, in een PowerShell-venster met verhoogde rechten:

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

Rechtenproblemen

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 kan dat account meestal elke lokale map bereiken. Op andere servers (een netwerkshare, Sage-bestanden op een andere machine, SQL Server elders) heeft het computeraccount van de server, DOMEIN\SERVERNAAM$, de rechten nodig. Bij Windows-authenticatie ziet SQL Server NT AUTHORITY\SYSTEM of dat computeraccount. Details: SQL-module en Files-module.
Installatieprogramma geblokkeerd? Klik bij Uw pc is beveiligd door Windows op Meer informatie > Toch uitvoeren. Bestand geblokkeerd na het downloaden? Rechtsklik > 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 zijn ondertekeningsidentiteit, niet op de certificaatvingerafdruk, zodat automatische updates blijven werken.
Is het een rechtenprobleem? Zoek naar Access is denied, Permission denied of Login failed in logs\agent, logs\services, logs\installer\install-post-error.log of de nieuwste Setup Log*.txt in %TEMP%.

Geavanceerde controles (voor IT)

Logboeken (Event Viewer, 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 > tabblad Aanmelden (Log On) om te zien onder welk account hij draait.
Maptoegang: rechtsklik op de map > Eigenschappen > Beveiliging > Geavanceerd > Effectieve toegang, selecteer SYSTEM (of het computeraccount) en klik op Effectieve toegang weergeven.

Logbestanden

Map	Gebruik hem voor
C:\ProgramData\BrynQ\Agent\logs\agent	Algemene Agent-problemen en verbindingsproblemen (logs application, requests en security).
C:\ProgramData\BrynQ\Agent\logs\services	Services die niet starten.
C:\ProgramData\BrynQ\Agent\logs\sage	Sage 100 France-imports (connectimport, connectimport-error, service-loop).
C:\ProgramData\BrynQ\Agent\logs\installer	Installatiestappen (install-post.log, install-post-error.log).

Logs 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 rechtstreeks in de adresbalk van Verkenner.

Installatielogs

Open %TEMP% in Verkenner en zoek het nieuwste bestand Setup Log*.txt.
Of start het installatieprogramma met een logpad: brynq-agent-installer-<version>.exe /LOG="C:\Temp\brynq-installer.log"
De exitcode van het installatieprogramma vertelt niet of alles gelukt is. Controleer C:\ProgramData\BrynQ\Agent\config\install-state.json en logs\installer\install-post.log.

Contact met BrynQ support

Help ons je sneller te helpen. Stuur mee:

Een korte beschrijving van wat je deed en wat je ziet (een schermafbeelding van de fout helpt).
De versie van de Agent (zichtbaar op de pagina Home van het beheerdashboard).
De relevante logbestanden: logs\agent bij verbindings- en algemene problemen, logs\sage bij Sage-imports, logs\installer of het Setup Log bij installatieproblemen.