HeadLight Suite Docs

Frequently Asked Questions

Frequently Asked Questions

Find answers to frequently asked questions here:

Where is my data stored?

Content (documentation, procedures, inspection sheets, etc.) is stored in a storage space, configurable per project, by default on a Minio instance.

Business data (users, contracts, equipment, etc.) is stored in PostgreSQL databases.

“Local” data for offline operation of mobile applications is stored in an encrypted SQLITE database.

To learn more: /fr/tech-doc/architecture

What is the log retention period?

The duration is configurable during deployment; however, the default configuration retains infrastructure logs for 30 days and security logs for 365 days.

To learn more: /fr/tech-doc/global/logs

Troubleshooting

Find here error messages that may occur and how to resolve them:

Issues on the first page

You are not connected to the server

On the first page, the “Login to your account” button may be unclickable and a red flag may appear:

“You are not connected to the server”

This message means that the application is not connected to the reference API.

Let’s go into the technical details to fix this issue; it can have several causes:

{
“status”: “UP”,
“version”: “9.18.7”
}


This error is displayed by Keycloak right after the user has authenticated. This issue may occur when:


Loop when clicking “Login to your account”

If the “Login to your account” button loops on the first page even after waiting a few seconds, please check that the last user logged in on the tablet has a contract (their access token is likely still available).

Contact your administrator to delete the session as well as the offline token of this user
revoke_offline_token.jpg


An authentication error?

After authenticating on the Keycloak login page, I get an error “2007: no token for the user or the client”

This error is generated by Keycloak; it may occur if your tablet is not set to the same time or time zone as your server. You need to go to your tablet settings and reconfigure the time and timezone, then restart your tablet.

It may also occur if your user account does not have the “offline_access” role in Keycloak. You must add it manually from the Keycloak interface, in the user profile, under the “Role mapping” tab.

A user not recognized even after a successful password reset?

Go back to the page before login (press the back button, physical or virtual).
Scan your environment QR code (the installation file may not point to the correct environment).

Here is our production one:
![production qrcode](Thomas Blot\Downloads\image (1).png)

Unable to access the authentication page

After clicking “Login to your account”, an error may occur:

sllhandshakeerror.png

Exception: handshakeException: handshake error in client (OS Error: CERTIFICATE_VERIFY_FAILED: unable to get local issuer certificate (…/…/…/flutter/third_party/boringssl/src/ssl/handshake.cc:391))

This error comes from an unsuccessful SSL handshake. In simple terms, your tablet does not have secure access to Keycloak.

Let’s go into the technical details to fix this issue; it can have several causes:

In both cases, the testing and remediation procedure is as follows:

Android

Go to the following location:
Settings > Security and privacy > Other security settings > View security certificates

And check that your root certificate is present and not expired.

Remediation: import the root certificate (if it is already known, an error message will appear to prevent conflicts/duplicates).

Example for our production environment, the root certificate is isrgx1.cer.
With this certificate, add it if necessary.

Windows / Surface Windows

In your search bar, search for “Manage computer certificates”

Access to this store requires a privileged account; please contact your system admin if you do not have these rights

certificat-racine-prod-mcoach.jpg

If your store does not match the window above, add the certificate:

In the toolbar, go to:

Action > All Tasks > Import

import-certificat-racine-prod-mcoach.jpg

In the wizard that appears, select “Local Computer” (these options may be grayed out).
Then select your file isrgx1.cer

And import it into “Trusted Root Certification Authorities”, as shown below:
certificat-racine-magasin.jpg

Restart the application and/or your browser and try again.


An “Invalid token id” without returning to login?

Check that the tablet is set to the correct time; a tablet with incorrect time will not be able to validate authentication.
Example: if the tablet is at 8:12 instead of 8:20, the mismatch will cause the Keycloak token to be rejected, hence the Invalid Token Id error

Windows Only

The application does not start on Windows (or closes immediately)

Open Windows Event Viewer > Windows Logs > Application and look for an error message related to “mcoach.exe”

You may be missing a version of Microsoft Visual C++ Redistributable. By default, Maintenance Coach Windows includes the latest version, but on some devices it may be necessary to use an older version. In that case, you must:

download an earlier version from the Microsoft website, for example the 2017 version available here
delete the MSVCP140.dll file located in the application installation directory (you can find it in the event details under the ModulePath field)
restart the Maintenance Coach application


RFID

The Koamtac reader is not detected or no longer reads RFID

The reader may be stuck in an incorrect state; we recommend removing its battery and restarting it before trying again.

You may be missing a version of Microsoft Visual C++ Redistributable. By default, Maintenance Coach Windows includes the latest version, but on some devices it may be necessary to use an older version. In that case, you must:

RFD40 RFID Reader - UI Indicators

Decode LED Definitions

Good Scan = Green Led

Scan Error = Red Led

RFID Tag Read Indicator Enabled = Green Led

Read Error = Red Led