The local admin dashboard of the BrynQ Agent

The local admin dashboard of the BrynQ Agent

📘 Setting up Factorial - Sage 100 France? Follow the complete step-by-step guide: Setup an automated data interface between Factorial and Sage.

The BrynQ Agent has a small admin page on the server itself. Use it to check the connection with BrynQ and updates, to review or change the settings of each module without reinstalling, and to solve problems.

Open the admin page

📍 Where: a browser on the Windows server where the Agent is installed.

  • Open http://127.0.0.1:7071/admin, or use the desktop or Start Menu shortcut if you created one during installation.
  • Did you choose a different admin port during installation? Use that port instead of 7071.
  • Use Microsoft Edge, Google Chrome or Firefox. Internet Explorer (the default on Windows Server 2016 and 2019) cannot show the admin page.
  • The page opens in your browser's language. Switch between English, French, German and Dutch with the language selector at the top right.
  • Anyone who is signed in on the server can open the page.
ℹ Local only. The admin page only works from the server itself. It is not reachable from other computers or through the internet.

A tour of the admin page

The menu on the left has the pages below, in this order. The pages for modules you did not enable are not used by BrynQ.

Home

Home page of the BrynQ Agent admin page

  • At the top: the Agent version, the public Agent address and whether automatic updates are on.
  • One card per module with its status. Click a card to open that module's page. See What does the status mean.
  • Agent Information: version, Auto Updates, Enabled Modules, Public URL, Agent Port and BrynQ connection.

BrynQ connection

BrynQ connection page

  • This agent signs in to BrynQ: BrynQ accepts the stored API token for your customer.
  • BrynQ reaches this agent: BrynQ reaches the Agent at its public address, through the tunnel.
  • Below the checks: the BrynQ customer, the BrynQ API, the API token (Stored on this server), the Public URL and the Tunnel service. Click Test again to run both checks again.
  • Did BrynQ give you a new token, or does it no longer accept the stored one? Under Replace API token, paste the token in New API token and click Check and save. BrynQ checks the token first; it is saved only when BrynQ accepts it for this customer. See The API token for the BrynQ Agent.

Updates

Updates page

  • At the top: your version and Up to date when you have the newest one. Click Check now to look for a new version. When there is one, install it with Install version ….
  • Enable automatic updates is on by default. The Agent first checks about a minute after it starts, then every Check Interval (hours) (24 by default).
  • Pinned Version: leave it empty to always install the newest version.
  • Click Save Settings after a change. Status on the right shows the current settings and the last check.

SQL

Change the SQL Server connection: choose the ODBC Driver and Server from the lists, choose Windows authentication or SQL username / password, and click Validate and Save. Test connection tests the saved connection, and Replace password lets you enter a new password. Databases used by BrynQ only records which databases the interfaces use; it does not limit access. More: SQL module.

LDAP

Change the Active Directory connection: Host, User, Distinguished Name (Base DN), Unique Identifier, Use SSL / TLS and the password. Click Validate and Save. More: LDAP (Active Directory) module.

REST

Change the settings of the internal REST API: Default Timeout (seconds) and Allowed URL Patterns (one per line; empty means any URL). Click Save. More: REST module.

SOAP

Change the settings of the internal SOAP web service: Default WSDL URL, Default Timeout (seconds) and Verify SSL. Click Save. More: SOAP module.

Files

  • Allowed Base Directories (one per line): the folders the Files module may use.
  • Allowed Extensions (one per line) and Max File Size (MB).
  • Click Save. Endpoints on the right lists what BrynQ can call on this module.

More: Files module.

SAGE 100 France

Only with Sage 100 France. At the top you see the status pill (Active or Needs attention), how often BrynQ checks for new files, the number of companies and how many checks are ready. The page has six tabs.

Overview

SAGE 100 France page, Overview tab

  • Service: the Windows service BrynQSageImport and its status, how often it checks for new files, the service account and the scenario.
  • Checks: what BrynQ checks before each import, such as the ConnectImport path, the PRH files, the import files and Excel. A green tick means OK; a red cross means that part needs a fix.

Companies

SAGE 100 France page, Companies tab

  • One row per Sage company with its PRH file and its import files (employees, pending employees, absences).
  • Add Company: upload the PRH file; the company name is taken from its file name. Edit and Remove change or remove a company.
  • After adding or removing a company, open ConnectImport, refresh the scenario and save it.

Service

SAGE 100 France page, Service tab

  • Sage user code and Token of the Sage service account. Use Replace token for a new Sage token. This is not the BrynQ API token: that one is on the BrynQ connection page.
  • Check for new import files every … minutes: how often BrynQ looks in the company folders for a new import file. This is not how often the interface runs. The default is 15.
  • Scenario code: the ConnectImport scenario the Agent runs. Change it only to use your own scenario. Click Save.

Scenario

SAGE 100 France page, Scenario tab

  • ConnectImport scenario: name, code, import mode, and per company the import file and the Sage import definition. Click an import file to download it. Reload reads the scenario again.
  • Recreate scenario › Recreate... rebuilds the scenario from the BrynQ settings and overwrites the current one. Only do this when the scenario is broken.

Advanced

SAGE 100 France page, Advanced tab

  • Paths and import definitions: ConnectImport, the Sage data folder, the import root and the names of the Sage import definitions. These are set by the installer; run the installer again to change them.
  • Other Sage installations on the server, when there are any.
  • Warnings, when they apply: for example the BrynQ import models are in another Sage installation, a newer Sage is installed, the service can't use the data folder, or ConnectImport is missing.

Troubleshooting

SAGE 100 France page, Troubleshooting tab

  • Download support file and the Advanced diagnostics switch, the same as on the main Troubleshooting page.
  • Start here: two quick checks: are the BrynQ services running, and what do the Sage log files say.
  • Find your problem: click a Sage import problem to see the steps.
  • Contacting BrynQ support: what to send with your question.

More about the Sage settings: Sage 100 France module.

Troubleshooting

Checks

Troubleshooting page with all checks OK

  • The page checks the BrynQ services, the Connection with BrynQ, the Program signatures, Folder access, Outbound connections and the Public IP address of the server. Click a check to see the details.
  • At the top: No issues found or the number of issues. Click Run checks again after a fix.
  • Find your problem: click a problem to see the steps.

Log files

Troubleshooting page, a log file opened on the page

  • One tab per kind of log: BrynQ Agent, Sage import, Sage ConnectImport, Windows services and Installer.
  • Newest first. Click a file to read it on the page; Close hides it again. Open folder opens the log folder on the server's desktop.

Support file

  • Download support file (under Share with BrynQ support): one file with logs, service status and settings for BrynQ support. Secrets are left out.
  • What does BrynQ support see? explains what is in it and what support can read.

Advanced diagnostics and Collect myself

Advanced diagnostics window opened with Collect myself

  • The Advanced diagnostics switch is Off by default: BrynQ support cannot collect Windows details. Turn it On to let support collect them when the logs are not enough.
  • Collect myself shows the same details in a window, so you decide whether to share them: Microsoft Defender, Application control (AppLocker, WDAC), Excel messages, Windows logs, folder permissions and system settings. Download advanced diagnostics saves them as a file.

Accesses by BrynQ support

Accesses by BrynQ support window

  • Next to Collect myself you see Support accesses: how many times BrynQ support read information from this Agent, and when last.
  • Click it to see the list Accesses by BrynQ support: when, what and from which address.

More: Security of the BrynQ Agent and Troubleshooting the BrynQ Agent.

What does the status mean

Home cards

  • Validated: the module is on and set up.
  • Not Configured: the module is on, but its settings are missing. Open its page and fill them in.
  • Disabled: the module is off. BrynQ does not use it.
  • Needs attention (SAGE 100 France only): see below.

The SAGE 100 France status pill

  • Active: the import service runs and all checks on the Overview tab are OK.
  • Needs attention: the import service is stopped, or a check on the Overview tab failed. Open the Overview tab to see which.

What problems look like: here the Sage import service is stopped and one check failed.

SAGE 100 France page showing Needs attention

And on the Troubleshooting page, each check with a problem opens with the details and what to do:

Troubleshooting page with several issues found

Where your settings are stored

  • All settings are stored only on the server, in C:\ProgramData\BrynQ\Agent\config.
  • Open folder buttons open the folder on the server's desktop.

Good to know