跳转到内容
FMX EPOS
下载
知识库首页

管理数据库存储和维护

在要修改的终端上,用 FMX EPOS 桌面应用打开 Back Office → Database(数据库)。数据库操作会影响所有终端,还可能暂停营业。请先处理完付款、结果不明的刷卡记录和打印恢复,再在 Terminals 卡片中确认:每台在线终端运行的 FMX EPOS 版本,数据库模型都与本终端相同。

Current Status(当前状态)卡片显示当前模式、能否连接数据库、本终端还有多少条记录等待写入数据库(Pending local writes),以及上次检查的时间。选择 Refresh Status(刷新状态)可再次检查。

Terminals(终端)卡片列出当前数据库上的所有终端。每台终端显示 Version(版本)、它的数据库模型(Schema)与本终端相比是否为 Up to date(最新)、Last Seen(最后在线时间)、Pending Writes(待上传写入)和 Maintenance(维护应答)。停止上报的终端标记为 Offline。

示意图,不是截图。实际界面可能因主题或版本而有所不同。

如果出现 Review Pending Writes(查看待上传写入),请在迁移、导入或导出之前先打开处理。未完成或结果不明的付款或打印会阻止维护,直到处理完为止。

在远程模式下,如果显示 Local Sensitive Data Remains,说明这台电脑原来的本地数据库中仍有顾客或订单数据。先完成一次经过校验的 Local to Remote 迁移,再删除这份本地副本。

在 Database Storage(数据库存储)下选择一种模式:

  • Local SQLite(本地 SQLite):数据库保存在这台电脑上的 Local SQLite File 中。
  • Remote Database(远程数据库):所有终端连接到 SQL Server 或 MySQL 8.4。

示意图,不是截图。实际界面可能因主题或版本而有所不同。

连接远程数据库:

  1. 在 Database Storage 下选择 Remote Database。
  2. 选择 Database Type(数据库类型),并填写 Server Address(服务器地址)、Instance(实例,仅 SQL Server,可选)、Port(端口)、Database Name(数据库名称)、Username(用户名)和 Password(密码)。填写了实例名时,Port 留空即可通过 SQL Server Browser 查找该实例。选择是否 Encrypt Connection(加密连接)。对于 SQL Server,只有门店有意接受该服务器的证书时,才勾选 Trust Server Certificate(信任服务器证书)。Connection Check Interval(连接检查间隔,5 到 300 秒)决定本终端多久检查一次能否连上数据库。
  3. 选择 Test Connection(测试连接)。
  4. 查看结果:Structure Ready(结构就绪)、Action Needed(需要处理)或 Connection Failed(连接失败)。
  5. 只有所选数据库确实要用作新的 FMX EPOS 数据库时,才选择 Check & Create Structure(检查并创建结构)。如果数据库还不存在,FMX EPOS 会先询问 Create Database?(是否创建数据库),再创建数据库和数据表。
  6. 选择 Save & Apply(保存并应用)。

连接设置只属于本终端。要修改另一台终端的连接,请在那台终端上操作。

Add a Terminal(添加终端)让另一台电脑通过 Guided Setup 加入这台收银机的数据库,无需手动输入连接信息。

  1. 选择 Generate Pairing Code(生成配对码)。卡片会显示由八个字符组成的配对码、This PC(本机)下这台电脑的地址,以及 Expires In(剩余时间)下的 10 分钟倒计时。
  2. 在新电脑的首次设置中,依次选择 Guided Setup、Several Tills 和 Join Another Till,找到这台收银机或输入它的一个地址,再输入配对码。详见完成首次设置。
  3. 新电脑加入后,卡片会显示 Code used by(代码使用者)和该电脑的名称。

示意图,不是截图。实际界面可能因主题或版本而有所不同。

选择 Cancel(取消)可撤回配对码。配对码只能用一次:被一台电脑使用后、输错五次后、倒计时结束时或关闭页面时,配对码即失效。卡片随后会显示 “The code expired.” 或 “The code was revoked after five wrong attempts.”。需要时再生成一个新的。

选择 Generate Pairing Code 或 Set Up MySQL on This PC 后,卡片还会列出这台电脑连接的网络。如果 Windows 把其中某个网络当作 Public(公用)网络,其他收银机就无法通过它连到这台电脑,卡片会给出提示。如果这是店内自己的网络,在桌面应用中选择 Make It Private(设为专用),并接受 Windows 的提示。也可以选择 Open Network Settings(打开网络设置),再选择 Wi-Fi 或 Ethernet,打开该网络的属性,把它设为 Private network(专用网络)。回到卡片,选择 Check Again(再次检查)。

FMX EPOS 只在专用网络和域网络上开放防火墙端口,从不对公用网络开放。

如果这台电脑的地址由路由器自动分配(DHCP),卡片会提示你给它设置固定 IP 地址:可以在路由器的 DHCP 设置中保留它的地址,也可以在 Windows 中设置。地址一旦变化,其他收银机和手机就会与它断开连接。

在使用 Local SQLite 的收银机上安装 MySQL

Section titled “在使用 Local SQLite 的收银机上安装 MySQL”

使用 Local SQLite 的收银机无法共享数据,所以卡片不提供配对码,而是提供在这台电脑上安装 MySQL 的选项。电脑必须是 64 位 Windows;如果是 32 位 Windows,卡片会说明,你也可以改用 Data Migration 把数据迁移到另一台电脑上的数据库服务器。设置 MySQL 之前,Windows 会先请求权限。

示意图,不是截图。实际界面可能因主题或版本而有所不同。

  1. 选择 Set Up MySQL on This PC(在本机安装 MySQL)。FMX EPOS 会先检查这台电脑上已有的内容。
  2. 选择随后出现的按钮:
    • Install MySQL(安装 MySQL):从 Oracle 下载 MySQL 8.4(约 270 MB)并安装,只对当前网络开放其端口。如果之前安装的 MySQL 在这台收银机的文件夹里留下了数据库,选择 Use These Databases(使用这些数据库)让 MySQL 重新使用它们,或选择 Start Again(重新开始)把它们加上日期和时间改名后放在一边,从新数据库开始。
    • Prepare Database(准备数据库):已安装 MySQL 时出现。先填写 MySQL Root Password(MySQL root 密码),FMX EPOS 会在上面创建本店的数据库。
    • Continue(继续):FMX EPOS 之前安装 MySQL 未完成时出现。它会完成这次安装。
  3. 等待进度行完成。远程连接字段会自动填好,并打开 Local to Remote 的 Data Migration 预览。在你选择 Migrate & Switch 之前,收银机仍使用 Local SQLite 营业。
  4. 核对预览,输入 MIGRATE 并选择 Migrate & Switch,具体见下文“在本地和远程之间迁移数据”。

数据迁移到 MySQL 后,卡片会照常提供 Generate Pairing Code。

FMX EPOS 在这台电脑上安装或准备过 MySQL 时,会显示 This PC’s MySQL Server(本机 MySQL 服务器)。Show Root Password(显示 root 密码)会显示 MySQL 的 root 密码,只在维护时需要;Hide(隐藏)可再次隐藏。每次显示都会记入审计日志。

远程模式下,所有业务数据都保存在远程数据库中。远程数据库不可用时,符合条件的收银操作会暂存在终端上,等数据库恢复后再发送。

只要无法登录数据库,FMX EPOS 就会把它当作不可用,所以修改了数据库密码、或数据库被改名或删除,效果与网络故障相同。请在空闲时段,在每台终端的 Database Storage 中修改这些信息。已经断开连接的收银机可以使用 Recover Connection(恢复连接):它会找出问题并给出合适的操作,例如 FMX EPOS 在这台电脑上安装的服务器有 Start MySQL(启动 MySQL)或 Reinstall MySQL(重新安装 MySQL),新的地址、登录名或密码用 Enter New Connection Details(输入新的连接信息)。参见 Recover Connection。

Database 页面会显示还有多少条写入在等待。数据库一直拒绝(原因不是离线)的写入,会列在 Orders → Payment Review → Local Writes Needing Review(订单 → 付款复核 → 待复核的本地写入)中。这个列表只显示当前所用终端上暂存的写入,所以要在记录这些写入的那台终端上打开。Retry Database Write(重试数据库写入)会再次尝试保存下来的修改,绝不会重复刷卡机请求。使用 Reconcile 之前,请先阅读待复核的本地写入。

远程模式下,Terminals 卡片上还有 Emergency Terminal(应急终端)。数据库不可用期间,只有这台终端可以让员工登录、开桌台和打印厨房单。其他收银机会保留自己的销售,等数据库恢复后再发送,它们的厨房单也要等到那时才打印。这是整个门店共用的一项设置。

  1. 在 Emergency Terminal 下选择一台收银机,或选择 No Emergency Terminal(不设应急终端)。
  2. 选择 Save Emergency Terminal(保存应急终端)。

选择 No Emergency Terminal 时,Diagnostics(诊断)会警告:断线期间没有任何终端可以让员工登录、开桌台或打印厨房单。参见应急终端状态。

Data Migration(数据迁移)会复制所有应用记录,校验副本,把本终端切换到新数据库,最后才清除旧数据库。请在收银机空闲时进行。

  1. 选择 Local to Remote(本地到远程)或 Remote to Local(远程到本地)。
  2. 只有目标中已有数据、而你确实要覆盖它时,才勾选 Replace All Application Data Already in the Target(替换目标中已有的全部应用数据)。目标中有数据时,预览会注明。
  3. 选择 Preview Migration(预览迁移)。
  4. 核对来源、目标、记录数量和提示信息。只有预览允许时才能继续。
  5. 在 Type MIGRATE to confirm(输入 MIGRATE 确认)中准确输入 MIGRATE。
  6. 选择 Migrate & Switch(迁移并切换),在终端报告结果之前不要关闭。

示意图,不是截图。实际界面可能因主题或版本而有所不同。

迁移会暂停所有终端。切换成功后,其他终端仍保持暂停,直到管理员在每台终端的 Administrator Recovery(管理员恢复)页面把它迁到新数据库。把终端迁到另一个数据库,只能在那台终端的桌面应用中操作。已清除的数据源会被标为停用。Reset Retired Database(重置已停用数据库)需要输入 RESET 确认,它让停用的数据库重新可用,但不会删除其中剩余的记录。

  1. 确认当前数据库可用。
  2. 选择 Export Data(导出数据)。
  3. 等待所有终端暂停并完成导出。
  4. 把 .eposdata 文件保存到门店安全的备份位置。

导出数据期间,各终端会显示已暂停,导出完成后自动恢复。如果导出文件会超过 512 MB 的导入上限,导出会被拒绝。

导出文件没有加密,其中包含顾客资料和订单记录,请存放在只有可信员工能接触的地方。

Export Data 导出的是业务数据库,不是整台电脑的完整备份。它不包括本终端的许可证、数据库连接、设备和打印机设置、Clover 配对、尚未发送的修改或应急账单,以及顾客显示屏媒体。更换电脑时,电脑上的其他内容请依靠门店常规的安全备份。

页面底部的 Automatic Backup(自动备份)会按计划保存一个 Export Data 文件。这是全店共用的设置,由 Integration Host 执行备份,卡片上会显示是哪台收银机。没有指定 Integration Host 时不会备份。详见连接在线订餐平台。

示意图,不是截图。实际界面可能因主题或版本而有所不同。

  1. 选择 Schedule(计划):Off、Daily 或 Weekly。每周备份还要选择 Day(星期几)。
  2. 填写 Time(时间)。请选择门店不营业的时间。
  3. 在 Keep(保留数量)中填写要保留最新的几份备份,范围 1 到 100。
  4. 填写 Folder(文件夹):Integration Host 所在电脑上的完整路径(例如 D:\FMX EPOS Backups),或网络共享文件夹。存放在那台电脑以外的副本,在硬盘损坏时仍能保住。
  5. 选择 Save Automatic Backup(保存自动备份)。

到了设定时间,在线终端会在读取数据期间暂停,与 Export Data 相同;显示为离线的收银机(例如夜间已关机)不会被等待。届时 Integration Host 必须在运行。如果它在设定时间后一小时内启动,仍会补做这次备份;否则这次备份就错过了,下一次计划备份照常进行。超出 Keep 数量的较旧备份文件会从文件夹中删除,文件夹里的其他文件不受影响。手动用 Export Data 保存到该文件夹的文件也算作备份,请把它们放在其他文件夹。

如果备份在设定时间无法开始,会在这一小时内再试:Integration Host 自己正忙,或仍有排队写入或应急账单要发送时,在它下一次检查时再试;另一台终端没有确认暂停时,所有终端解除暂停,备份五分钟后再试。备份已经开始后失败的,要等到下一次计划时间才再试。请查看卡片上显示的失败原因。如果 Integration Host 在备份期间停机,它重新启动后会解除各终端的暂停。

每台终端的卡片都会显示最近一次备份及其文件名。失败时显示 “Failed at” 和原因;错过的备份会显示类似 “The backup due 12/10/2026 03:30 was not made.” 的内容。失败或错过的备份还会显示在 Integration Host 所在的收银机上和 Diagnostics → Automatic Backup 中,直到有一次备份成功。

导入会替换当前数据库中的全部应用数据。

示意图,不是截图。实际界面可能因主题或版本而有所不同。

  1. 在 Import Data(导入数据)下,选择 Select File(选择文件),选取一个用 Export Data 导出的 .eposdata 文件,不超过 512 MB。文件必须由数据库模型与本终端相同的 FMX EPOS 版本导出。
  2. 核对显示的文件名和大小。
  3. 在 Type IMPORT to confirm replacement(输入 IMPORT 确认替换)中准确输入 IMPORT。
  4. 选择 Import & Replace(导入并替换),等待最终提示。

替换之前,FMX EPOS 会先检查文件。文件被拒绝时,数据库保持不变。导入成功后,其他终端仍保持暂停,直到管理员在每台终端的 Administrator Recovery 中恢复或迁移它。

在 Terminals 卡片中,本终端以外的任何离线终端都可以选择 Remove(移除),再用 Remove Terminal(移除终端)确认。这会删除该终端的登记信息、登记的打印机及相应的厨房路由,让发往这些打印机的打印任务失败;如果它是 Integration Host 或 Emergency Terminal,也会取消这一指定。

终端离线时,无法检查它尚未发送的本地写入。如果它还可能回来,请先重新连上并完成同步。如果确定不再使用,请先按门店自己的流程记录下来,再移除。

迁移、导入、导出和自动备份都会先暂停各终端。暂停之前,仍有本地写入或应急账单等待发送的终端会继续发送,在这些数据写入数据库之前,它的 Maintenance 列显示 Local writes must be synchronised first 或 Emergency bills must be synchronised first。

只要有在线终端运行的 FMX EPOS 版本数据库模型不同、无法暂停,或者还有未完成的刷卡操作、结果不明的刷卡记录、正在进行的打印任务或结果不明的打印,FMX EPOS 就会拒绝开始维护。按提示处理所指的终端和项目,然后重新开始。断线或保存结果不确定后的恢复,见数据库与断线恢复故障排除。