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.
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).C:\ProgramData\BrynQ\Agent\logs op de Windows-server (zie Logbestanden).| Wat je ziet | Wat je doet |
| In het installatieprogramma kun je op de pagina Cloudverbinding niet op Volgende klikken | BrynQ 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 gemaakt | Zie Map gemaakt door een andere gebruiker. |
| Fout AGENT_TOKEN_MUST_TARGET_EXACTLY_ONE_CUSTOMER | Het 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 schrijven | Vaak een probleem met rechten. Zie Problemen met rechten. |
| Een service is gestopt of start niet | Zie De services draaien niet. |
| BrynQ kan de Agent niet bereiken | Open 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 401 | De 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 413 | De 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 Found | Die module is niet ingeschakeld. Voer het installatieprogramma opnieuw uit en selecteer de module. |
| De SQL-verbinding mislukt | Open 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 niet | Controleer 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 gebruik | Voer 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 binnen | Open 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. |
📍 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.
| Controle | Wat er wordt gecontroleerd |
| BrynQ-services | Of de BrynQ-services draaien. Services openen opent de Windows-services. |
| Verbinding met BrynQ | Of de Agent zich aanmeldt bij BrynQ, en of BrynQ de Agent bereikt. |
| Handtekeningen van programma's | Of de BrynQ-programma's en -scripts zijn ondertekend en ongewijzigd. Antivirus of applicatiebeheer (AppLocker, WDAC) kan programma's zonder geldige handtekening blokkeren. |
| Maptoegang | Of de BrynQ-services (computeraccount, LocalSystem) de BrynQ- en Sage-mappen kunnen gebruiken. |
| Uitgaande verbindingen | app.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-adres | Het openbare IP-adres van de server. Gebruik het als BrynQ het token alleen vanaf bepaalde IP-adressen accepteert. |
Een controle met een probleem laat zien wat er mis is en wat je moet doen:
De pagina bevat ook:
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.
| Melding | Wat 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-token | Een agent-token is aan precies één klant gekoppeld. Gebruik het agent-token van deze klant. |
| BrynQ is bezet, of kon niet worden bereikt | Probeer het over een paar minuten opnieuw met Opnieuw controleren. Lukt het nog steeds niet? Controleer de uitgaande verbindingen. |
📍 Waar: de Windows-server.
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
Veel installatie- en serviceproblemen komen neer op Windows-rechten. Loop deze punten na:
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.
takeown /F "C:\ProgramData\BrynQ\Agent" /A /RGebruik de map die in de melding staat.
{ en eindigt met } wordt nu zonder de accolades gelezen. Voer het wachtwoord opnieuw in op de pagina SQL van het beheerdashboard met Wachtwoord vervangen.Het supportbestand bevat alles wat BrynQ-support nodig heeft in één zipbestand. Geheimen zijn eruit verwijderd.
"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.
| Map | Gebruik voor |
C:\ProgramData\BrynQ\Agent\logs\agent | Algemene Agent-problemen en verbindingsproblemen (logbestanden 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 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.
C:\ProgramData\BrynQ\Agent\logs\installer\setup-<date>-<time>.log (de nieuwste tien). De waarden van geheime switches worden gemaskeerd.brynq-agent-installer-<version>.exe /LOG="C:\Temp\brynq-installer.log"C:\ProgramData\BrynQ\Agent\config\install-state.json en logs\installer\install-post.log.Help ons je sneller te helpen. Stuur mee: