Gérer le stockage de la base de données et la maintenance
Ouvrez Back Office → Database (base de données) dans l’application de bureau FMX EPOS, sur le poste que vous modifiez. Les modifications de la base de données concernent tous les postes et peuvent interrompre l’activité. Terminez d’abord les paiements, les résultats carte inconnus et les reprises d’impression en cours, puis vérifiez dans la carte Terminals que tous les postes en ligne utilisent une version de FMX EPOS dont le modèle de base de données est le même que celui de ce poste.
Consulter l’état actuel
Section intitulée « Consulter l’état actuel »La carte Current Status (état actuel) indique le mode actif, si la base de données est joignable, combien d’enregistrements de ce poste attendent encore de l’atteindre (Pending local writes) et l’heure de la dernière vérification. Sélectionnez Refresh Status pour vérifier à nouveau.
La carte Terminals (postes) liste tous les postes de la base de données active. Pour chacun, elle indique la Version, si son modèle de base de données (Schema) est Up to date (à jour) par rapport à celui de ce poste, la dernière fois qu’il a été vu (Last Seen), ses Pending Writes et sa réponse Maintenance. Un poste qui ne transmet plus son état est marqué Offline.
Terminals3
| Terminal | Version | Schema | Last Seen | Pending Writes |
|---|---|---|---|---|
| Front Till | 2.0.478 | Up to date | 14/10/2026 13:05:12 | 0 |
| Bar Till | 2.0.478 | Up to date | 14/10/2026 13:05:10 | 0 |
| Kitchen PC | 2.0.471 | Behind | Offline | — |
Illustration, pas une capture d’écran. L’écran réel peut varier selon le thème ou la version.
Si Review Pending Writes (vérifier les écritures en attente) apparaît, ouvrez-le avant toute migration, tout import ou tout export. Un paiement ou un résultat d’impression inachevé ou inconnu bloque la maintenance jusqu’à ce qu’il soit réglé.
En mode Remote, le message Local Sensitive Data Remains signifie que l’ancienne base locale de ce PC contient encore des données clients ou de commandes. Effectuez une migration Local to Remote vérifiée avant de supprimer cette copie locale.
Configurer le stockage
Section intitulée « Configurer le stockage »Choisissez un mode sous Database Storage :
- Local SQLite conserve la base de données sur ce PC, dans le Local SQLite File.
- Remote Database (base de données distante) connecte tous les postes à SQL Server ou à MySQL 8.4.
Database Storage
Illustration, pas une capture d’écran. L’écran réel peut varier selon le thème ou la version.
Pour vous connecter à une base de données distante :
- Sous Database Storage, choisissez Remote Database.
- Choisissez le Database Type et saisissez Server Address, Instance (SQL Server uniquement, facultatif), Port, Database Name, Username et Password. Avec un nom d’instance, laissez Port vide pour trouver l’instance via SQL Server Browser. Choisissez si vous voulez Encrypt Connection (chiffrer la connexion). Pour SQL Server, ne cochez Trust Server Certificate (faire confiance au certificat du serveur) que si l’établissement a délibérément choisi d’accepter le certificat de ce serveur. Connection Check Interval (intervalle de vérification de la connexion, de 5 à 300 secondes) définit la fréquence à laquelle ce poste vérifie qu’il peut joindre la base de données.
- Sélectionnez Test Connection.
- Lisez le résultat : Structure Ready (structure prête), Action Needed (action requise) ou Connection Failed (échec de la connexion).
- Ne sélectionnez Check & Create Structure (vérifier et créer la structure) que si la base de données choisie doit devenir une nouvelle base FMX EPOS. Si elle n’existe pas encore, FMX EPOS demande Create Database? avant de la créer avec ses tables.
- Sélectionnez Save & Apply (enregistrer et appliquer).
Les réglages de connexion sont propres à ce poste. Pour modifier la connexion d’un autre poste, faites-le sur ce poste-là.
Ajouter un poste
Section intitulée « Ajouter un poste »Add a Terminal (ajouter un poste) permet à un autre PC de rejoindre la base de données de cette caisse avec Guided Setup, sans que personne ait à saisir les informations de connexion.
- Sélectionnez Generate Pairing Code (générer un code d’appairage). La carte affiche un code de huit caractères, les adresses de ce PC sous This PC et un compte à rebours de 10 minutes sous Expires In.
- Sur le nouveau PC, dans la configuration initiale, choisissez Guided Setup, Several Tills puis Join Another Till, trouvez cette caisse ou saisissez l’une de ses adresses, puis saisissez le code. Voir Effectuer la configuration initiale.
- Une fois le nouveau PC connecté, la carte affiche Code used by suivi du nom du PC.
Add a Terminal
Another PC joins this till’s database with a one-time code, valid for 10 minutes.
Illustration, pas une capture d’écran. L’écran réel peut varier selon le thème ou la version.
Cancel retire le code. Un code ne sert qu’une fois : il prend fin dès qu’un PC l’a utilisé, après cinq tentatives erronées, à la fin du compte à rebours ou quand vous fermez la page. La carte indique alors « The code expired. » ou « The code was revoked after five wrong attempts. ». Générez-en un nouveau si nécessaire.
Vérifier le type de réseau
Section intitulée « Vérifier le type de réseau »Après avoir sélectionné Generate Pairing Code ou Set Up MySQL on This PC, la carte indique aussi les réseaux auxquels ce PC est connecté. Si Windows traite l’un d’eux comme un réseau Public, les autres caisses ne peuvent pas joindre ce PC par ce réseau, et la carte le signale. S’il s’agit du réseau de l’établissement, sélectionnez Make It Private dans l’application de bureau et acceptez l’invite de Windows. Vous pouvez aussi sélectionner Open Network Settings, choisir Wi-Fi ou Ethernet, ouvrir les propriétés du réseau et le définir comme Private network (réseau privé). De retour sur la carte, sélectionnez Check Again.
FMX EPOS n’ouvre ses ports de pare-feu que pour les réseaux privés et de domaine, jamais pour les réseaux publics.
Si l’adresse de ce PC a été attribuée automatiquement par le routeur (DHCP), la carte vous demande de donner au PC une adresse IP fixe, soit en réservant son adresse dans les réglages DHCP du routeur, soit en la définissant dans Windows. Si l’adresse change, les autres caisses et les téléphones perdent la connexion avec ce PC.
Installer MySQL sur une caisse en Local SQLite
Section intitulée « Installer MySQL sur une caisse en Local SQLite »Une caisse en Local SQLite ne peut pas partager ses données : la carte ne propose donc pas de code d’appairage. Elle propose à la place d’installer MySQL sur ce PC. Le PC doit fonctionner sous Windows 64 bits ; sous Windows 32 bits, la carte le signale, et vous pouvez alors déplacer les données vers un serveur de base de données situé sur un autre PC avec Data Migration. Windows demande votre autorisation avant la mise en place de MySQL.
Add a Terminal
Another PC joins this till’s database with a one-time code, valid for 10 minutes.
Illustration, pas une capture d’écran. L’écran réel peut varier selon le thème ou la version.
- Sélectionnez Set Up MySQL on This PC. FMX EPOS examine d’abord ce qui est déjà présent sur ce PC.
- Sélectionnez le bouton proposé ensuite :
- Install MySQL télécharge MySQL 8.4 depuis Oracle (environ 270 Mo), l’installe et ouvre son port à ce réseau uniquement. Si une installation précédente de MySQL a laissé des bases de données dans le dossier de cette caisse, choisissez Use These Databases pour y rebrancher MySQL, ou Start Again pour les mettre de côté, renommées avec la date et l’heure, et repartir avec de nouvelles bases.
- Prepare Database apparaît si MySQL est déjà installé. Saisissez d’abord son MySQL Root Password ; FMX EPOS y crée la base de données de l’établissement.
- Continue apparaît si une installation de MySQL lancée auparavant par FMX EPOS n’a pas abouti, et la termine.
- Attendez la fin de la ligne de progression. Les champs de connexion distante sont remplis et l’aperçu Data Migration pour Local to Remote s’ouvre. La caisse continue de fonctionner sur Local SQLite jusqu’à ce que vous sélectionniez Migrate & Switch.
- Vérifiez l’aperçu, saisissez
MIGRATEet sélectionnez Migrate & Switch, comme décrit dans Migrer les données entre Local et Remote plus bas.
Une fois les données sur MySQL, la carte propose Generate Pairing Code comme d’habitude.
This PC’s MySQL Server (serveur MySQL de ce PC) apparaît quand FMX EPOS a installé ou préparé MySQL sur ce PC. Show Root Password affiche le mot de passe root de MySQL, utile uniquement pour la maintenance, et Hide le masque à nouveau. Chaque affichage est consigné dans le journal d’audit.
Continuité en mode distant
Section intitulée « Continuité en mode distant »En mode Remote, toutes les données d’activité sont conservées dans la base de données distante. Si elle devient indisponible, les modifications de caisse éligibles sont conservées sur le poste et envoyées dès que la base est de retour.
FMX EPOS considère la base de données comme indisponible chaque fois qu’il ne parvient pas à s’y connecter : un mot de passe de base de données modifié, ou une base renommée ou supprimée, a donc le même effet qu’une panne réseau. Modifiez ces informations dans Database Storage sur chaque poste, à un moment calme. Une caisse qui a déjà perdu sa connexion peut utiliser Recover Connection : cette fonction trouve le problème et propose ce qui convient, par exemple Start MySQL ou Reinstall MySQL pour un serveur que FMX EPOS a installé sur ce PC, ou Enter New Connection Details pour une nouvelle adresse, un nouvel identifiant ou un nouveau mot de passe. Voir Recover Connection.
La page Database indique combien d’écritures sont encore en attente. Une écriture que la base de données continue de refuser (pour une autre raison qu’une absence de connexion) est listée sous Orders → Payment Review → Local Writes Needing Review. Cette liste n’affiche que les écritures conservées sur le poste que vous utilisez : ouvrez-la donc sur le poste qui les a enregistrées. Retry Database Write relance la modification enregistrée et ne répète jamais une demande au terminal de paiement. Consultez Local Writes Needing Review avant d’utiliser Reconcile.
Choisir le poste de secours
Section intitulée « Choisir le poste de secours »En mode Remote, la carte Terminals comporte aussi Emergency Terminal (poste de secours). Tant que la base de données est indisponible, seul ce poste peut connecter le personnel, ouvrir des tables et imprimer des bons de cuisine. Les autres caisses conservent leurs ventes et les envoient dès le retour de la base de données ; leurs bons de cuisine attendent jusque-là. C’est un réglage unique pour tout l’établissement.
- Sous Emergency Terminal, choisissez la caisse, ou No Emergency Terminal.
- Sélectionnez Save Emergency Terminal.
Avec No Emergency Terminal, Diagnostics avertit que, pendant une panne, aucun poste ne peut connecter le personnel, ouvrir des tables ni imprimer des bons de cuisine. Voir État du poste de secours.
Migrer les données entre Local et Remote
Section intitulée « Migrer les données entre Local et Remote »Data Migration (migration des données) copie tous les enregistrements de l’application, vérifie la copie, bascule ce poste sur la nouvelle base de données, et seulement ensuite vide l’ancienne. Lancez-la pendant que les caisses sont inactives.
- Choisissez Local to Remote (de local vers distant) ou Remote to Local (de distant vers local).
- Ne cochez Replace All Application Data Already in the Target (remplacer toutes les données d’application déjà présentes dans la cible) que si la cible contient déjà des données que vous voulez écraser. L’aperçu indique si la cible contient des données.
- Sélectionnez Preview Migration (aperçu de la migration).
- Vérifiez la source, la cible, le nombre d’enregistrements et le message. Vous ne pouvez continuer que si l’aperçu l’autorise.
- Saisissez exactement
MIGRATEdans Type MIGRATE to confirm. - Sélectionnez Migrate & Switch (migrer et basculer) et laissez le poste fonctionner jusqu’à ce qu’il affiche le résultat.
Illustration, pas une capture d’écran. L’écran réel peut varier selon le thème ou la version.
La migration met tous les postes en pause. Après une bascule réussie, les autres postes restent en pause jusqu’à ce qu’un administrateur bascule chacun d’eux sur la nouvelle base depuis sa page Administrator Recovery (reprise administrateur). Un poste ne peut être basculé sur une autre base que dans l’application de bureau de ce poste. Une source qui a été vidée est marquée comme retirée. Reset Retired Database (réinitialiser la base retirée) demande de saisir RESET pour confirmer, et rend une base retirée de nouveau utilisable sans supprimer les enregistrements qui y restent.
Exporter les données
Section intitulée « Exporter les données »- Vérifiez que la base de données active est disponible.
- Sélectionnez Export Data.
- Patientez pendant que tous les postes se mettent en pause et que l’export est réalisé.
- Enregistrez le fichier
.eposdataà l’emplacement de sauvegarde sécurisé de l’établissement.
Pendant l’export des données, les postes indiquent qu’ils sont en pause, puis ils reprennent d’eux-mêmes une fois l’export terminé. Un export dont le fichier dépasserait la limite d’import de 512 Mo est refusé.
Le fichier n’est pas chiffré et contient les coordonnées des clients et l’historique des commandes : rangez-le là où seul le personnel de confiance peut y accéder.
Export Data exporte uniquement la base de données d’activité et ne constitue pas une sauvegarde complète du PC. Il laisse de côté la licence de ce poste, sa connexion à la base de données, ses réglages d’appareil et d’imprimantes, l’appairage Clover, les modifications ou additions de secours pas encore envoyées, ainsi que les médias de l’afficheur client. Pour remplacer un ordinateur, appuyez-vous sur la sauvegarde sécurisée habituelle de l’établissement pour tout le reste.
Sauvegarder automatiquement
Section intitulée « Sauvegarder automatiquement »Automatic Backup, en bas de la page, enregistre un fichier Export Data selon un planning. C’est un réglage commun à tout l’établissement, et c’est l’Integration Host qui effectue la sauvegarde ; la carte indique de quelle caisse il s’agit. Sans Integration Host choisi, aucune sauvegarde n’est faite. Voir Connecter les plateformes de commande en ligne.
Automatic Backup
The Integration Host saves an Export Data file on a schedule. Online terminals pause while the data is read. Backups do not wait for offline terminals.
Made by the Integration Host: Front Till (this terminal).
Illustration, pas une capture d’écran. L’écran réel peut varier selon le thème ou la version.
- Choisissez le Schedule : Off, Daily ou Weekly. Pour une sauvegarde hebdomadaire, choisissez le Day.
- Saisissez l’heure dans Time. Choisissez une heure où l’établissement est fermé.
- Sous Keep, indiquez combien de sauvegardes récentes conserver, de 1 à 100.
- Saisissez le Folder : un chemin complet sur le PC de l’Integration Host, par exemple
D:\FMX EPOS Backups, ou un partage réseau. Une copie conservée hors de ce PC survit à une panne de disque. - Sélectionnez Save Automatic Backup.
À l’heure choisie, les postes en ligne se mettent en pause pendant la lecture des données, comme pour Export Data ; les caisses affichées hors ligne (par exemple éteintes pour la nuit) ne sont pas attendues. L’Integration Host doit alors fonctionner. S’il démarre moins d’une heure après l’heure choisie, il fait quand même cette sauvegarde ; sinon, cette sauvegarde est manquée et la suivante est faite normalement. Les fichiers de sauvegarde les plus anciens au-delà du nombre Keep sont supprimés du dossier ; les autres fichiers du dossier ne sont pas touchés. Les fichiers Export Data enregistrés à la main dans ce dossier comptent aussi comme des sauvegardes ; conservez-les dans un autre dossier.
Si la sauvegarde ne peut pas démarrer à cette heure, elle est réessayée dans l’heure : si l’Integration Host est lui-même occupé, ou a encore des écritures en file d’attente ou des additions d’urgence à envoyer, à sa vérification suivante ; si un autre poste ne confirme pas la pause, tous les postes sont libérés et la sauvegarde réessaie après cinq minutes. Une sauvegarde qui a commencé puis échoue n’est réessayée qu’au prochain horaire prévu. Consultez l’échec affiché sur la carte. Si l’Integration Host s’arrête pendant une sauvegarde, il libère les postes en pause quand il redémarre.
Sur chaque poste, la carte indique la dernière sauvegarde avec son nom de fichier. Un échec s’affiche sous la forme « Failed at » avec le motif, et une sauvegarde manquée par exemple sous la forme « The backup due 12/10/2026 03:30 was not made. ». Un échec ou une sauvegarde manquée s’affiche aussi sur la caisse de l’Integration Host et dans Diagnostics → Automatic Backup jusqu’à la prochaine sauvegarde réussie.
Importer et remplacer les données
Section intitulée « Importer et remplacer les données »L’import remplace toutes les données d’application de la base de données active.
Import Data
Replaces all application data after the package is checked. Up to 512 MB.
Illustration, pas une capture d’écran. L’écran réel peut varier selon le thème ou la version.
- Sous Import Data, choisissez Select File et sélectionnez un fichier
.eposdataproduit avec Export Data, de 512 Mo maximum. Il doit avoir été produit par une version de FMX EPOS dont le modèle de base de données est le même que celui de ce poste. - Vérifiez le nom et la taille du fichier affichés.
- Saisissez exactement
IMPORTdans Type IMPORT to confirm replacement. - Sélectionnez Import & Replace (importer et remplacer) et attendez le message final.
FMX EPOS vérifie le fichier avant de remplacer quoi que ce soit. Si le fichier est refusé, la base de données reste inchangée. Après un import réussi, les autres postes restent en pause jusqu’à ce qu’un administrateur reprenne ou bascule chacun d’eux depuis Administrator Recovery.
Retirer un poste hors ligne
Section intitulée « Retirer un poste hors ligne »Dans la carte Terminals, Remove est disponible pour tout poste hors ligne autre que celui-ci. Confirmez avec Remove Terminal. Cette action supprime l’enregistrement de ce poste, ses imprimantes enregistrées et leurs acheminements vers la cuisine, fait échouer les travaux d’impression envoyés à ces imprimantes et lui retire le rôle d’Integration Host ou d’Emergency Terminal s’il l’avait.
Ses écritures locales non envoyées ne peuvent pas être vérifiées tant qu’il est hors ligne. S’il est susceptible de revenir, reconnectez-le et laissez-le d’abord se synchroniser. S’il ne doit plus revenir, consignez-le selon les procédures propres à l’établissement avant de le retirer.
La maintenance ne démarre pas
Section intitulée « La maintenance ne démarre pas »La migration, l’import, l’export et la sauvegarde automatique mettent d’abord les postes en pause. Avant la pause, un poste qui a encore des écritures locales ou des additions de secours en attente continue de les envoyer, et sa colonne Maintenance indique Local writes must be synchronised first ou Emergency bills must be synchronised first jusqu’à ce qu’elles aient atteint la base de données.
FMX EPOS refuse de démarrer une maintenance tant qu’un poste en ligne utilise une version de FMX EPOS dont le modèle de base de données est différent, ne se met pas en pause, ou a encore une opération carte ouverte, un résultat carte inconnu, un travail d’impression actif ou un résultat d’impression inconnu. Traitez le poste et l’élément indiqués dans le message, puis recommencez. Pour la reprise après une déconnexion ou un enregistrement incertain, voir Dépannage de la base de données et de la continuité.