Dépannage de la base de données et de la continuité
En mode Remote (distant), c’est la base de données distante qui conserve durablement les données de l’activité. Lorsqu’elle est indisponible, FMX EPOS peut mettre en file d’attente les écritures de facturation éligibles et les envoie dans l’ordre dès que la base de données répond de nouveau. Ces vérifications reviennent à un responsable ou à un administrateur. Les caissiers laissent la caisse en l’état et font appel à l’un d’eux.
La base de données est indisponible
Section intitulée « La base de données est indisponible »Une caisse déjà connectée affiche le bandeau d’avertissement Database offline (« Sales are kept on this till. ») tant que la base de données est absente, puis Syncing … local writes jusqu’à ce que son travail conservé ait atteint la base de données. Une action peut aussi être refusée avec un message qui parle de la base de données, une page peut afficher Database Connection Unavailable (« EPOS cannot reach the database right now. Check the network connection, then try again. »), et la page de connexion l’indique aussi.
- Notez le message exact et l’heure.
- Vérifiez si tous les postes sont touchés. Si un seul l’est, contrôlez le réseau et les réglages de base de données de ce poste.
- Si le Back Office est déjà ouvert sur un poste, consultez les cartes Database et Continuity dans Back Office → Diagnostics. Une nouvelle connexion au Back Office ne fonctionne pas tant que la base de données ne répond pas.
- N’utilisez que les actions hors ligne proposées par FMX EPOS. Si une action indique qu’elle a besoin de la base de données distante, arrêtez-vous plutôt que de deviner.
- Ne fermez pas la session sur les autres caisses et ne les redémarrez pas. Tant que la base de données est inaccessible, la page de connexion affiche « The database is unavailable or emergency bills are waiting to sync. Only the emergency terminal can sign in offline. » Un code PIN saisi sur une autre caisse est refusé avec « Cannot connect to the database. Check the connection and sign in again. »
- Ne changez pas le mode de stockage et ne créez pas une autre base de données pour faire disparaître le message. Pour savoir ce qui ne va pas et ce qui convient, utilisez Recover Connection.
- Si la base de données est sur ce PC et que FMX EPOS l’a installée, Recover Connection l’indique. Sinon, réparez le serveur de base de données ou la connexion réseau. Pour FMX EPOS, un mot de passe de base de données modifié, ou une base renommée ou supprimée, ressemble aussi à une panne : vérifiez donc également ces points.
- Laissez le poste allumé pendant l’envoi des écritures en file d’attente.
- Sur chaque poste qui a fonctionné hors ligne, surveillez Pending Writes sur la carte Database de Diagnostics. La carte Terminals, en bas de Diagnostics, et celle de la page Database affichent dans une seule liste les écritures en attente de tous les postes.
Database
- Mode
- Remote
- Pending Writes
- 3
- Review Writes
- 0
Continuity
- Emergency Journal
- Inactive
- Queueing Writes
- Yes
Illustration, pas une capture d’écran. L’écran réel peut varier selon le thème ou la version.
Tant que la base de données est en panne, les actions qui en ont besoin sont refusées avec un message qui le dit, par exemple « Coupons cannot be checked while the database is offline. Record the payment without a coupon or wait for the connection. » Les bons de cuisine et les étiquettes d’une commande en file d’attente attendent la reconnexion de la base, et le numéro de commande complet affiche Pending Sync jusqu’à ce que la commande atteigne la base de données.
Une fois la base revenue, certaines actions attendent encore que les écritures en file d’attente de ce poste l’aient atteinte. La plupart des messages nomment l’action et se terminent par « Waiting for N queued writes to reach the database. », par exemple « Coupons cannot be checked. Waiting for 3 queued writes to reach the database. » Cela concerne les coupons, les points et les avantages adhérents sur toute vente, l’impression des bons de cuisine et des étiquettes d’une commande en file d’attente, le remboursement d’une commande dont l’enregistrement ou le paiement est encore en file d’attente, et le remboursement d’une adhésion. Un remboursement de commande indique « Waiting for queued writes to reach the database. No refund has been started. », et un remboursement de cotisation d’adhésion indique seulement « Waiting for 3 queued writes to reach the database. »
Les rapports X et Z ont besoin de la base de données distante. Un rapport Z est aussi refusé tant que ce poste a des écritures en file d’attente ou bloquées, que la période contient un résultat de carte inconnu ou un remboursement par carte non enregistré, ou qu’un autre poste en ligne a des écritures non confirmées ; le message désigne le poste. Si un autre poste est hors ligne, la caisse affiche Run Z Report? avec « … is offline. Its unsent data will not be in this Z. Continue? » Ne sélectionnez Run Z Report que si vous l’acceptez.
Écritures en attente et écritures à contrôler
Section intitulée « Écritures en attente et écritures à contrôler »- Pending Writes, sur la carte Database de Diagnostics, compte toutes les écritures que ce poste détient encore, y compris celles bloquées pour contrôle. Les écritures non bloquées disparaissent d’elles-mêmes dès que la base de données répond.
- Review Writes compte les écritures bloquées.
Les écritures bloquées sont listées sous Local Writes Needing Review dans Payment Review. Une écriture est bloquée quand la base de données la refuse pour une autre raison qu’une connexion perdue, par exemple une erreur de données ou deux caisses qui modifient le même enregistrement en même temps ; les écritures liées placées derrière elle dans la file sont bloquées aussi (« Waiting for an earlier update to be reviewed. »). Une écriture marquée Review est réessayée d’elle-même après des attentes de 1, 5 et 15 minutes suivant ses tentatives échouées, tant que la base de données est joignable et qu’aucune écriture bloquée antérieure ne la retient ; les écritures qui attendent une mise à jour antérieure reprennent une fois celle-ci résolue. Certaines erreurs demandent l’intervention du personnel ou du support. Vérifiez le motif affiché avant d’utiliser Reconcile. Les autres commandes continuent de se synchroniser. La liste n’apparaît que sur le poste qui détient ces écritures.
Pour traiter une écriture à contrôler :
- Sur le poste qui la détient, ouvrez Back Office → Orders → Payment Review. Cash & Card → Payment Review sur la caisse liste les mêmes écritures avec les mêmes boutons.
- Lisez la colonne Reason. La colonne Operation désigne l’enregistrement, le paiement ou le remboursement d’une commande par cette commande, par exemple Order Payment · #12 · £12.50 · Card, et les autres écritures par leur type. Dépliez Recorded Details pour voir l’enregistrement sauvegardé. Si vous ne savez pas à quelle commande, quel client ou quel paiement il se rapporte, envoyez une capture d’écran au support.
- Vérifiez dans FMX EPOS ce que doit être l’enregistrement définitif.
- Corrigez la cause, puis sélectionnez Retry Database Write. Réessayer n’envoie jamais de nouvelle demande à Clover. Si l’écriture reste dans la liste, elle n’a pas été écrite : relisez la colonne Reason.
- N’utilisez Reconcile qu’en dernier recours (voir l’avertissement ci-dessous).
Local Writes Needing Review1
| Recorded | Operation | Reason | Attempts |
|---|---|---|---|
| 21/10 13:41 | Recorded Details | Review: This order was changed on another terminal. Reopen it before saving or taking payment. | 3 |
Illustration, pas une capture d’écran. L’écran réel peut varier selon le thème ou la version.
Recover Connection
Section intitulée « Recover Connection »Quand une caisse ne peut pas joindre sa base de données, Recover Connection en cherche la raison et propose ce qui convient. Cette fonction n’existe que dans l’application de bureau, tant que la base de données ne répond pas et que le poste n’est pas en pause de maintenance. Sélectionnez-la sur la page de connexion de la caisse ou sur la page Database Connection Unavailable, sur chaque caisse qui ne peut pas se connecter.
What Is Wrong indique où se trouve la base de données et ce que FMX EPOS a trouvé. What To Do liste les choix, la solution probable en premier, marquée Recommended. Return to Sign In ne change rien.
| La page indique | Choix |
|---|---|
| Le service MySQL de ce PC est arrêté | Start MySQL, Reinstall MySQL, Use Another Database |
| MySQL fonctionne sur ce PC mais refuse l’accès à la caisse | Reinstall MySQL, Enter New Connection Details, Use Another Database |
| MySQL a été supprimé de ce PC, ou seule une partie y est présente | Reinstall MySQL, Use Another Database |
| Ses bases de données ont disparu | Use Another Database |
| La base de données est sur un autre ordinateur et ne répond pas | Enter New Connection Details, Use Another Database |
Start MySQL
Section intitulée « Start MySQL »Windows demande votre autorisation, puis le service démarre et la caisse revient à la page de connexion.
Reinstall MySQL
Section intitulée « Reinstall MySQL »FMX EPOS télécharge MySQL 8.4 (environ 270 Mo : ce PC a donc besoin d’une connexion Internet) et le rebranche sur les bases de données de ce PC. Windows demande d’abord votre autorisation. Les ventes, le menu et les réglages restent tels quels.
Enter New Connection Details
Section intitulée « Enter New Connection Details »Utilisez cette option quand le serveur de base de données fonctionne mais a été déplacé, ou que son identifiant a changé. Il vous faut le nom d’utilisateur et le mot de passe d’un administrateur actif du Back Office de l’établissement.
- Sélectionnez Enter New Connection Details, puis Continue. La page New Connection Details s’ouvre.
- Saisissez la Database Server IP Address et le Port. Si l’identifiant ou le mot de passe de la base de données a changé, saisissez les nouveaux dans Database Login et Database Password ; laissez Database Login vide pour conserver l’identifiant de cette caisse. Saisissez ensuite le nom d’utilisateur et le mot de passe d’un administrateur du Back Office dans Administrator Username et Password. Ce sont les identifiants de connexion au Back Office, pas l’identifiant de la base de données.
- Sélectionnez Check Database.
- FMX EPOS indique à quel établissement appartient la base de données et demande « Connect this till to it? Its waiting sales and emergency bills then go there. » Sélectionnez Connect This Till, ou Cancel.
- La caisse revient à la page de connexion. Ses écritures en file d’attente sont ensuite envoyées à la base de données, à sa nouvelle adresse.
Illustration, pas une capture d’écran. L’écran réel peut varier selon le thème ou la version.
Si la caisse n’est pas enregistrée dans la base de données à cette adresse, la vérification est refusée avec « This till is not registered on the database at that address, so it may be another shop’s. Check the address. » Si la base de données a été retirée par une migration, déplacez plutôt le poste vers la nouvelle base depuis Administrator Recovery.
Use Another Database
Section intitulée « Use Another Database »Ce choix quitte la base de données de l’établissement : ne l’utilisez que si cette base a disparu ou si vous voulez repartir de zéro. Sélectionnez Use Another Database, Continue, puis Leave This Database. Les données restent dans cette base, et la configuration initiale peut y reconnecter la caisse. La configuration initiale s’ouvre ensuite : vous pouvez y choisir une nouvelle base de données MySQL sur ce PC, Local SQLite, un autre serveur de base de données ou la base de données d’une autre caisse. Back revient ici tant qu’aucune autre base n’est choisie.
Ce choix n’est pas disponible tant que cette caisse détient des ventes ou des additions de secours enregistrées pendant la panne. Elles appartiennent à cette base de données : faites-les-y parvenir d’abord.
État du poste de secours
Section intitulée « État du poste de secours »Pendant une panne de la base de données distante, seul l’Emergency Terminal peut continuer à gérer les additions de tables du restaurant. Un administrateur le choisit à l’avance dans Database → Terminals ; voir Choisir le poste de secours. Si aucun n’est choisi, Diagnostics affiche un avertissement. Ce poste doit avoir été en ligne après avoir été choisi, pour détenir une copie enregistrée de la configuration du restaurant. Les autres postes peuvent poursuivre les actions de caisse qui fonctionnent hors ligne, mais pas les additions de tables : ils affichent « The database is offline. Only the emergency terminal with a saved configuration can do this until it is back. »
Pendant qu’il prend ces additions, l’Emergency Terminal est en mode secours. Son panneau de commande affiche EMERGENCY · NEW BILLS ONLY, et le plan des tables indique « Emergency Mode: only new bills opened on this terminal are shown. Existing remote bills and table occupancy cannot be checked. » Les comptages de caisse et les rapports X et Z ne sont pas disponibles en mode secours. Les coupons et les avantages adhérents ne peuvent pas être vérifiés tant que la base de données est hors ligne.
Les additions et commandes prises en mode secours impriment leurs bons de cuisine, mais elles n’apparaissent pas sur l’écran cuisine, ni pendant la panne ni après leur envoi. La cuisine travaille sur les bons papier pour ces commandes.
Une commande programmée prise sur l’Emergency Terminal pendant la panne part en cuisine selon la règle Kitchen Release de l’établissement. L’Integration Host ne voit pas encore la commande : c’est donc l’Emergency Terminal qui la libère lui-même. Une commande réglée sur Manual attend que le personnel l’envoie depuis Orders → Kitchen Release sur l’Emergency Terminal. Une commande déjà libérée n’est pas renvoyée en cuisine après l’envoi.
Emergency Mode: only new bills opened on this terminal are shown. Existing remote bills and table occupancy cannot be checked.
Illustration, pas une capture d’écran. L’écran réel peut varier selon le thème ou la version.
Au retour de la base de données, les écritures ordinaires en file d’attente sont envoyées d’abord, puis les additions de secours sont envoyées. La carte Continuity de Diagnostics affiche Emergency Mode jusqu’à la fin de l’envoi, et tout problème apparaît à côté de Attention :
- « Finish or review the current payment and printing operation before synchronising emergency bills. » ou « Record or reverse the approved card payment before synchronising emergency bills. » : terminez d’abord ce paiement ou cette impression sur le poste de secours. L’envoi démarre ensuite tout seul.
- “Emergency bills are not uploaded until this terminal’s unfinished card requests are checked: …”: FMX EPOS n’a pas pu terminer sa vérification automatique des demandes de carte laissées par l’exécution précédente ; la raison suit le message. Il réessaie à la prochaine synchronisation : laissez le poste en marche. Si la même raison revient, contactez l’assistance. Un résultat de carte marqué unknown ne bloque pas l’envoi. Vérifiez ensuite cette transaction dans Payment Review. Ne répétez pas un paiement ou un remboursement avant de savoir si de l’argent a été déplacé.
- « Emergency bills could not be uploaded and need review: … » suivi de la raison : rien n’a été envoyé. Le poste reprend la saisie d’additions de secours jusqu’à ce que le problème soit corrigé et qu’un envoi réussisse. Si la raison indique qu’une table de secours est occupée ou en cours de débarrassage à distance, la même table dans la base de données du restaurant a encore une addition ouverte, est payée et attend d’être libérée, ou est en nettoyage. Les tables utilisées et libérées plus tôt ne comptent pas. Libérez cette table sur une autre caisse, ou déplacez l’addition de secours vers une table libre sur l’Emergency Terminal ; aucune des deux additions n’a été écrasée.
- « Waiting to confirm the remote upload. Do not repeat payment or printing. » : la connexion a été coupée pendant l’envoi. Les additions restent verrouillées jusqu’à ce que FMX EPOS puisse vérifier si l’envoi est arrivé, ce qui se fait automatiquement dès que la base de données répond.
- « Emergency bills were uploaded but could not be cleared from this terminal: … » : l’envoi est arrivé. FMX EPOS efface les additions de ce poste à la synchronisation suivante.
Ne mettez pas FMX EPOS à jour sur le poste de secours tant qu’il détient encore des additions de secours, car les additions enregistrées par une version doivent être envoyées par cette même version. Ne supprimez pas les données locales de l’application et ne changez pas de base de données pour forcer le déblocage des additions. Si le message ne disparaît pas, envoyez-le au support.
Un poste est sur la page de maintenance
Section intitulée « Un poste est sur la page de maintenance »Data Migration, Import Data, Export Data et la sauvegarde Automatic Backup planifiée de la page Database mettent tous les postes en pause. Un poste en pause affiche Terminal Paused : « This terminal is paused for database maintenance. Do not repeat payments or printing. … » avec un bouton Administrator Recovery. Un afficheur client ouvert affiche la pause sans ce bouton. Un poste qui a encore des écritures en file d’attente ou des additions de secours continue de vendre pendant qu’il les envoie, puis se met en pause. Pendant une exportation ou une sauvegarde automatique, il n’y a rien à faire : le message le dit, et le poste reprend de lui-même.
Une exportation ou une sauvegarde automatique libère les postes à la fin. Si le poste qui l’a lancée s’arrête pendant l’opération, par exemple lors d’une coupure de courant, il libère les postes quand il redémarre. Après une importation ou une migration réussie, seul le poste qui l’a lancée continue ; tous les autres restent en pause :
- Après une importation, reprenez chacun des autres postes avec Resume This Terminal.
- Après une migration, déplacez chacun des autres postes vers la nouvelle base de données avec Move to Another Database. L’ancienne base est marquée comme retirée : un poste ne peut donc pas y reprendre.
Si l’opération a échoué avant de modifier des données, FMX EPOS lève normalement la pause lui-même. Si la nouvelle base de données n’a pas confirmé la modification, le message indique qu’elle « may or may not hold the new data » et tous les postes restent en pause. Vérifiez d’abord la base de données cible, puis reprenez le poste qui a lancé l’opération, et les autres postes reprennent d’eux-mêmes. Si une exportation ou une sauvegarde automatique s’est terminée alors que la base de données était injoignable, le poste qui l’a faite lève la pause dès que la base de données répond de nouveau.
Resume This Terminal
Move to Another Database
Illustration, pas une capture d’écran. L’écran réel peut varier selon le thème ou la version.
- Sur le poste qui a lancé l’opération, lisez le message final de la migration ou de l’importation.
- Tant que le résultat est inconnu, ne relancez pas la même opération destructrice.
- Sur le poste en pause, sélectionnez Administrator Recovery.
- Pour continuer avec la même base de données, saisissez le nom d’utilisateur et le mot de passe d’un administrateur sous Resume This Terminal et sélectionnez Check & Resume This Terminal.
- Pour faire pointer ce poste vers la nouvelle base de données, remplissez Move to Another Database dans l’application de bureau avec les nouveaux Database Type, Server, Database, Database Username et Database Password, ainsi qu’un Administrator Username et un Administrator Password, puis sélectionnez Move This Terminal. Une base de données sans comptes utilisateur lance à la place la configuration initiale.
- Traitez un poste à la fois.
Si la reprise est refusée avec « An export or automatic backup started on … has not ended. Resume that terminal first; … », l’exportation ou la sauvegarde automatique de ce poste est encore ouverte. Redémarrez ce poste (pour une sauvegarde automatique, l’Integration Host) : il termine l’opération lui-même et les autres postes reprennent. S’il ne reviendra pas, cochez End an export or automatic backup another terminal started and will not finish sous Resume This Terminal et sélectionnez de nouveau Check & Resume This Terminal ; cette opération n’a modifié aucune donnée. Si la reprise est refusée avec « The configured database is still under maintenance or has been retired. Configure the destination database before resuming this terminal. », l’importation ou la migration d’un autre poste n’est pas terminée, ou la base de données a été migrée : reprenez d’abord le poste qui a lancé l’opération, et n’utilisez Move to Another Database qu’après une migration.
La maintenance est refusée
Section intitulée « La maintenance est refusée »Le poste qui lance la maintenance doit d’abord envoyer ses propres écritures en file d’attente et additions de secours ; sinon il indique « Synchronise this terminal’s emergency bills and local writes before maintenance. » Il attend ensuite jusqu’à 30 secondes que chacun des autres postes enregistrés se mette en pause. Si l’un d’eux ne le fait pas, le message commence par « Maintenance did not start. Every registered terminal must confirm that it has stopped and has nothing left to synchronise. » et liste chaque poste avec sa raison, par exemple « Local writes must be synchronised first », « Emergency bills must be synchronised first », « Finish the active operation » ou « terminal has not confirmed maintenance ». Un poste éteint affiche en général « Waiting for maintenance request ».
Traitez ensuite ce que le refus indique :
- Un autre poste en ligne exécute une version de FMX EPOS avec une structure de base de données différente (« … Update both to the same version before maintenance. »). Mettez-le d’abord à jour.
- Un poste ne s’est pas mis en pause, est éteint, ou a encore des écritures non confirmées ou des additions de secours.
- « Finish or review these on all terminals before database maintenance: … » : une opération par carte est en cours, un résultat de carte est inconnu, ou un travail d’impression est en cours ou son résultat est inconnu. Le message nomme le poste sur lequel s’imprime un travail d’impression.
Every registered terminal must confirm that it has stopped and has nothing left to synchronise. Bar Till: Local writes must be synchronised first
Terminals
| Terminal | Last Seen | Pending Writes | Maintenance | Action |
|---|---|---|---|---|
| Front Till | 21/10/2026 14:02:10 | 0 | Paused | Remove |
| Bar Till | 21/10/2026 14:02:08 | 2 | Blocked: Local writes must be synchronised first | Remove |
| Kitchen PC | 20/10/2026 23:10:41 · Offline | 0 | Waiting for maintenance request | Remove |
Illustration, pas une capture d’écran. L’écran réel peut varier selon le thème ou la version.
Utilisez Diagnostics, Payment Review et la file d’attente d’impression sur le poste nommé, et consultez la carte Terminals de la page Database. Ne supprimez pas un poste uniquement pour passer outre un refus s’il peut revenir et se synchroniser.
La sauvegarde Automatic Backup planifiée n’attend pas les postes affichés Offline sur la carte Terminals : une caisse éteinte pour la nuit ne la bloque donc pas. Toutes les autres opérations de maintenance attendent chaque poste enregistré.
Conflit d’identité du poste
Section intitulée « Conflit d’identité du poste »Chaque installation de FMX EPOS a sa propre identité de poste. Si un dossier d’installation est copié sur un autre PC, les deux PC portent la même identité. Lorsque FMX EPOS constate que son identité fonctionne déjà sur un autre ordinateur, il ne démarre pas la caisse. Il affiche à la place Terminal Identity In Use avec « This terminal’s identity is also running on … » et le nom de l’autre PC. Il ne peut pas savoir lequel des deux PC est la copie.
Terminal Identity In Use
This terminal’s identity is also running on BAR-TILL-PC; one of the two PCs has a copied EPOS folder. Switch BAR-TILL-PC off first, wait a few minutes and start FMX EPOS here again. If this PC is the copy, create a new terminal identity for it instead.
Illustration, pas une capture d’écran. L’écran réel peut varier selon le thème ou la version.
- Trouvez le PC nommé dans le message et déterminez lequel est la copie.
- Si ce PC remplace l’autre, éteignez d’abord l’autre PC, attendez quelques minutes, puis redémarrez FMX EPOS ici.
- Si ce PC est la copie et que les deux doivent continuer à fonctionner, sélectionnez Create a New Terminal Identity dans la fenêtre de caisse de ce PC. Le bouton n’apparaît que dans la fenêtre de caisse. L’afficheur client, l’écran cuisine et le poste d’accueil proposent Try Again à la place.
- L’application de bureau affiche « Restarting EPOS… » et redémarre comme un nouveau poste, sur la page de connexion.
- Choisissez de nouveau les imprimantes de ce poste dans Local Settings → Printers, et vérifiez son nom de poste, sa licence et les imprimantes des postes de cuisine.
Ne créez jamais une nouvelle identité sur la caisse d’origine : ses imprimantes, ses routages et ses résultats de carte non terminés appartiennent à son identité actuelle.
FMX EPOS ne s’exécute qu’une fois par PC. Si un autre utilisateur Windows du même PC l’a déjà ouvert, le démarrage affiche « FMX EPOS is already running for another Windows user on this PC. » Fermez-le d’abord dans la session de cet utilisateur.
Un poste hors ligne doit être supprimé
Section intitulée « Un poste hors ligne doit être supprimé »Dans la mesure du possible, reconnectez d’abord le poste et laissez-le se synchroniser, car sa suppression ne permet pas de vérifier ses écritures locales non envoyées.
- Ouvrez Back Office → Database sur un poste qui fonctionne (administrateur).
- Sur la carte Terminals, repérez le poste. Remove n’est proposé que pour un autre poste affiché Offline.
- Lisez Remove Terminal? et sélectionnez Remove Terminal.
La suppression efface les enregistrements d’imprimantes et les routages de poste de cuisine du poste, et efface les choix de l’Integration Host et de l’Emergency Terminal s’ils désignaient ce poste. Les travaux d’impression qui attendent encore ses imprimantes échouent avec « The terminal was removed. Choose another printer and retry. » Ensuite, choisissez de nouveau l’Integration Host, les imprimantes des postes de cuisine et, s’il s’agissait de ce poste, l’Emergency Terminal.
Pour les changements de stockage prévus, suivez Gérer le stockage de la base de données et la maintenance.