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

数据库与断线恢复故障排除

在 Remote(远程)模式下,业务数据永久保存在远程数据库中。远程数据库连不上时,FMX EPOS 可以先把符合条件的账单写入放进队列,等数据库恢复响应后再按顺序发送。以下检查由经理或管理员进行;收银员应保持收银机原样,并找经理或管理员处理。

数据库断开期间,已登录的收银机会显示警告横幅 Database offline(数据库离线,“Sales are kept on this till.”,销售保留在这台收银机上),之后显示 Syncing … local writes,直到保存的工作都已送达数据库。某项操作也可能被拒绝,并提示与数据库有关;页面可能显示 Database Connection Unavailable(“EPOS cannot reach the database right now. Check the network connection, then try again.”,暂时无法连接数据库,请检查网络连接后重试);登录页上也会显示提示。

  1. 记下完整的提示内容和时间。
  2. 检查是不是所有终端都受影响。如果只有一台,检查这台终端的网络和数据库设置。
  3. 如果某台终端上已经打开了 Back Office,查看 Back Office → Diagnostics(管理后台 → 诊断)中的 Database(数据库)和 Continuity(断线恢复)卡片。数据库恢复响应之前,无法重新登录 Back Office。
  4. 只使用 FMX EPOS 提供的离线操作。如果某项操作提示需要远程数据库,就停下来,不要猜。
  5. 不要在其他收银机上退出登录或重启。数据库断开期间,登录页会显示 “The database is unavailable or emergency bills are waiting to sync. Only the emergency terminal can sign in offline.”(数据库不可用或有应急账单等待同步,只有应急终端可以离线登录)。在其他收银机上输入 PIN 会被拒绝,并提示 “Cannot connect to the database. Check the connection and sign in again.”(无法连接数据库,请检查连接后重新登录)。
  6. 不要为了让提示消失而更改存储模式或新建数据库。要找出问题和合适的处理方法,使用 Recover Connection。
  7. 如果数据库在这台电脑上且由 FMX EPOS 安装,Recover Connection 会说明。否则请修复数据库服务器或网络连接。数据库密码被修改,或数据库被改名或删除,在 FMX EPOS 看来也像断线,所以也要检查这些情况。
  8. 排队的写入上传期间,让终端保持运行。
  9. 在每台离线营业过的终端上,查看诊断页 Database 卡片上的 Pending Writes(待上传写入)。诊断页底部的 Terminals(终端)卡片和 Database 页面上的同名卡片,会在一个列表中显示每台终端的待上传写入。

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

数据库断开期间,需要数据库的操作会被拒绝,并在提示中说明,例如 “Coupons cannot be checked while the database is offline. Record the payment without a coupon or wait for the connection.”(数据库离线时无法核对优惠券,请不使用优惠券记录付款,或等待连接恢复)。排队订单的厨房单和标签会等数据库重新连上后再打印;订单到达数据库之前,它的完整订单号显示为 Pending Sync。

数据库恢复后,有些操作仍要等本终端排队的写入到达数据库。大多数提示会写明是什么操作,并以 “Waiting for N queued writes to reach the database.” 结尾,例如 “Coupons cannot be checked. Waiting for 3 queued writes to reach the database.”(无法核对优惠券,正在等待 3 条排队写入到达数据库)。这适用于任何销售中的优惠券、积分和会员权益,排队订单的厨房单和标签打印,为保存或付款仍在排队的订单退款,以及会员费退款。订单退款会提示 “Waiting for queued writes to reach the database. No refund has been started.”(正在等待排队写入到达数据库,尚未开始任何退款),会员费退款则只提示 “Waiting for 3 queued writes to reach the database.”。

X 和 Z 报表需要远程数据库。本终端有排队或搁置的写入、当前时段有结果未知的刷卡或未记录的刷卡退款,或另一台在线终端有未确认的写入时,也不能生成 Z 报表;提示中会写明是哪台终端。如果另一台终端处于离线状态,收银机会显示 Run Z Report?,并提示 “… is offline. Its unsent data will not be in this Z. Continue?”(… 处于离线状态,它尚未发送的数据不会计入本次 Z 报表,是否继续?)。只有接受这一点时,才选择 Run Z Report。

  • 诊断页 Database 卡片上的 Pending Writes 统计本终端仍保存着的全部写入,包括被搁置待复核的写入。没有被搁置的写入,在数据库恢复响应后会自动清空。
  • Review Writes(待复核写入)统计被搁置的写入。

被搁置的写入列在 Payment Review(付款复核)的 Local Writes Needing Review(待复核的本地写入)中。数据库因连接中断以外的原因拒绝某条写入时,例如数据错误或两台收银机同时修改同一条记录,这条写入就会被搁置;排在它后面的相关写入也会一起被搁置(“Waiting for an earlier update to be reviewed.”)。标为 Review 的写入会在失败后分别等待 1、5 和 15 分钟自动重试,前提是数据库可以连接,而且没有更早的被搁置写入挡住它;等待更早更新的写入在那条更新处理完后会继续。有些错误需要员工或支持人员处理。使用 Reconcile 之前,先查看显示的原因。其他订单照常同步。这个列表只出现在保存这些写入的那台终端上。

处理待复核的写入:

  1. 在保存这条写入的终端上,打开 Back Office → Orders → Payment Review(订单 → 付款复核)。收银机上的 Cash & Card → Payment Review(现金与刷卡 → 付款复核)也列出同样的写入和按钮。
  2. 阅读 Reason 列。Operation 列会按订单写出订单的保存、付款或退款,例如 Order Payment · #12 · £12.50 · Card,其他写入则写出类型。展开 Recorded Details(记录详情),查看保存的记录。如果看不出对应的是哪张订单、哪位顾客或哪笔付款,截图发给技术支持。
  3. 在 FMX EPOS 中确认这条记录最终应该是什么样子。
  4. 解决出错原因后,选择 Retry Database Write(重试数据库写入)。重试不会再向 Clover 发送请求。如果这条写入还留在列表中,说明它没有写入成功:请重新阅读 Reason。
  5. Reconcile(核对处理)只能作为最后手段(见下方警告)。

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

收银机连不上数据库时,Recover Connection(恢复连接)会找出原因并给出合适的操作。只有在桌面应用中、数据库没有响应且终端没有因维护而暂停时,才能使用它。在每台连不上的收银机上,从登录页或 Database Connection Unavailable 页面选择它。

What Is Wrong(问题所在)说明数据库在哪里,以及 FMX EPOS 发现了什么。What To Do(处理方法)列出可选的操作,最可能解决问题的排在最前面,标为 Recommended(推荐)。Return to Sign In(返回登录)不做任何更改。

页面显示 可选操作
这台电脑上的 MySQL 服务已停止 Start MySQL、Reinstall MySQL、Use Another Database
这台电脑上的 MySQL 正在运行,但拒绝收银机连接 Reinstall MySQL、Enter New Connection Details、Use Another Database
这台电脑上的 MySQL 已被移除,或只剩一部分 Reinstall MySQL、Use Another Database
它的数据库已经没有了 Use Another Database
数据库在另一台电脑上,没有响应 Enter New Connection Details、Use Another Database

Windows 会请求权限,然后服务启动,收银机回到登录页。

FMX EPOS 下载 MySQL 8.4(约 270 MB,因此这台电脑需要联网),并让它重新使用这台电脑上的数据库。Windows 会先请求权限。销售、菜单和设置保持不变。

数据库服务器运作正常,只是换了位置或登录信息改了时,使用这一项。你需要门店一位在用的后台管理员的用户名和密码。

  1. 选择 Enter New Connection Details(输入新的连接信息),然后选择 Continue。New Connection Details(新的连接信息)页面随即打开。
  2. 填写 Database Server IP Address(数据库服务器 IP 地址)和 Port(端口)。如果数据库的登录名或密码改了,在 Database Login(数据库登录名)和 Database Password(数据库密码)中填写新的;Database Login 留空则保留这台收银机原来的登录名。然后在 Administrator Username 和 Password 中填写后台管理员的用户名和密码。这里用的是后台登录信息,不是数据库登录名。
  3. 选择 Check Database(检查数据库)。
  4. FMX EPOS 会说明该数据库属于哪家门店,并询问 “Connect this till to it? Its waiting sales and emergency bills then go there.”(把这台收银机连接到它?等待中的销售和应急账单随后会发送到那里)。选择 Connect This Till(连接这台收银机),或选择 Cancel。
  5. 收银机回到登录页。之后它排队的写入会发送到新地址上的数据库。

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

如果这台收银机没有在该地址的数据库上登记,检查会被拒绝,并提示 “This till is not registered on the database at that address, so it may be another shop’s. Check the address.”(这台收银机没有在该地址的数据库上登记,它可能属于另一家门店,请核对地址)。如果该数据库已因迁移而停用,请改为在 Administrator Recovery 中把终端迁移到新数据库。

这一项会离开门店的数据库,所以只有该数据库已经没有了,或者你打算重新开始时才使用。选择 Use Another Database(使用其他数据库)和 Continue,然后选择 Leave This Database(离开这个数据库)。数据仍保留在那个数据库中,首次设置可以把收银机重新连接到它。随后首次设置打开,你可以选择这台电脑上新的 MySQL 数据库、Local SQLite、另一台数据库服务器或另一台收银机的数据库。选定其他数据库之前,Back 会回到这里。

这台收银机保存着中断期间的销售或应急账单时,不能使用这一项。它们属于那个数据库,所以要先把它们送到那里。

远程数据库中断期间,只有 Emergency Terminal(应急终端)可以继续处理餐厅桌台账单。它由管理员事先在 Database → Terminals 中选定;参见选择应急终端。没有选定时,Diagnostics 会显示警告。选定之后,这台终端必须在线过一次,才能保存一份餐厅设置的副本。其他终端仍可使用支持离线的收银操作,但不能处理桌台账单,会显示 “The database is offline. Only the emergency terminal with a saved configuration can do this until it is back.”(数据库离线。恢复之前,只有已保存设置的应急终端才能执行此操作)。

应急终端处理这些账单时处于应急模式。它的订单面板显示 EMERGENCY · NEW BILLS ONLY,桌台图显示 “Emergency Mode: only new bills opened on this terminal are shown. Existing remote bills and table occupancy cannot be checked.”,意思是只显示这台终端上新开的账单,无法查看远程已有的账单和桌台占用情况。应急模式下不能盘点现金,也不能生成 X 和 Z 报表。数据库离线期间无法核对优惠券和会员权益。

应急模式下开的账单和订单会打印厨房单,但不会出现在厨房屏幕上,断线期间不会,上传之后也不会。厨房按纸质厨房单制作这些订单。

中断期间在应急终端上录入的预约订单,按门店的 Kitchen Release(送厨)规则送到厨房。Integration Host 暂时还看不到这些订单,所以由应急终端自己放行。设为 Manual 的订单要等员工在应急终端的 Orders → Kitchen Release 中手动送厨。已经放行的订单在上传后不会再次送厨。

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

数据库恢复后,先发送普通的排队写入,再上传应急账单。上传完成之前,诊断页的 Continuity 卡片会一直显示 Emergency Mode,遇到问题时会显示在 Attention(注意)一栏:

  • “Finish or review the current payment and printing operation before synchronising emergency bills.” 或 “Record or reverse the approved card payment before synchronising emergency bills.”:先在应急终端上完成那笔付款或打印,之后上传会自动开始。
  • “Emergency bills are not uploaded until this terminal’s unfinished card requests are checked: …”: FMX EPOS 未能完成对上次运行留下的刷卡请求的自动检查,消息后会显示原因。系统会在下次同步时再试,请保持终端运行。如果同一原因反复出现,请联系支持。标为 unknown 的刷卡结果本身不会阻止上传,稍后仍需在 Payment Review 中核对。在确认是否已有款项转移之前,不要重复付款或退款。
  • “Emergency bills could not be uploaded and need review: …” 后面跟着原因:什么都没有上传。终端会继续接收应急账单,直到问题解决、上传成功为止。如果原因说明某张应急桌台在远程已被占用或正在清理,说明餐厅数据库中的同一张桌台仍有未结账单、已付款但等待释放,或正在清理。之前已经用完并释放的桌台不算。请在另一台收银机上释放那张桌台,或在应急终端上把应急账单移到一张空闲桌台;两张账单都没有被覆盖。
  • “Waiting to confirm the remote upload. Do not repeat payment or printing.”:上传过程中连接断了。在 FMX EPOS 能确认上传是否到达之前,这些账单会保持锁定。数据库恢复响应后,确认会自动进行。
  • “Emergency bills were uploaded but could not be cleared from this terminal: …”:上传已经到达。下次同步时,FMX EPOS 会把这些账单从这台终端上清除。

应急终端上仍有应急账单时,不要更新它的 FMX EPOS,因为某个版本记录的账单必须由该版本上传。不要为了强行解锁账单而删除本地应用数据或切换数据库。如果提示一直不消失,请把它发给技术支持。

Database 页面上的 Data Migration、Import Data、Export Data 和定时的 Automatic Backup 都会暂停所有终端。暂停的终端显示 Terminal Paused:“This terminal is paused for database maintenance. Do not repeat payments or printing. …”(此终端因数据库维护已暂停,请勿重复付款或打印),并有 Administrator Recovery(管理员恢复)按钮。已打开的顾客显示屏也会显示暂停,但没有这个按钮。仍有排队写入或应急账单的终端会先继续营业并把它们发送出去,然后再暂停。导出或自动备份期间不需要任何操作:提示中会说明,终端之后会自动继续。

导出或自动备份完成后会解除各终端的暂停。如果发起操作的终端在操作期间停机(例如断电),它重新启动后会解除暂停。导入或迁移成功后,只有执行操作的那台终端继续营业,其他每台终端都保持暂停:

  • 导入后,用 Resume This Terminal 逐台恢复其他终端。
  • 迁移后,用 Move to Another Database 把其他每台终端迁移到新数据库。旧数据库会被标为已停用,终端不能在它上面恢复。

如果操作在修改任何数据之前就失败了,FMX EPOS 通常会自己解除暂停。如果新数据库没有确认这次修改,提示会说它 “may or may not hold the new data”(可能保存了、也可能没有保存新数据),所有终端都保持暂停。请先检查目标数据库,再恢复发起操作的那台终端,其他终端随后会自动恢复。如果导出或自动备份完成时数据库无法连接,执行它的终端会在数据库恢复响应后解除暂停。

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

  1. 在发起操作的终端上,阅读迁移或导入的最终提示。
  2. 结果未知时,不要再次发起同一个破坏性操作。
  3. 在暂停的终端上,选择 Administrator Recovery。
  4. 要继续使用同一个数据库,在 Resume This Terminal(恢复此终端)下输入管理员的用户名和密码,然后选择 Check & Resume This Terminal(检查并恢复此终端)。
  5. 要让这台终端改用新数据库,在桌面应用中填写 Move to Another Database(迁移到另一个数据库):新的 Database Type、Server、Database、Database Username 和 Database Password,以及 Administrator Username 和 Administrator Password,然后选择 Move This Terminal(迁移此终端)。如果目标数据库里还没有用户账号,则会改为进入首次设置。
  6. 一次只处理一台终端。

如果恢复被拒绝,并提示 “An export or automatic backup started on … has not ended. Resume that terminal first; …”(在 … 上开始的导出或自动备份尚未结束,请先恢复那台终端),说明那台终端的导出或自动备份仍未结束。重新启动那台终端(自动备份则是 Integration Host):它会自行结束该操作,其他终端随即恢复。如果它不会再回来,在 Resume This Terminal 下勾选 End an export or automatic backup another terminal started and will not finish,再选择一次 Check & Resume This Terminal;该操作没有改动任何数据。如果恢复被拒绝,并提示 “The configured database is still under maintenance or has been retired. Configure the destination database before resuming this terminal.”(配置的数据库仍在维护中或已停用,请先配置目标数据库再恢复此终端),说明另一台终端的导入或迁移尚未结束,或者数据库已经迁移:先恢复发起操作的那台终端,只有在迁移之后才使用 Move to Another Database。

发起维护的终端必须先发送完自己的排队写入和应急账单,否则会提示 “Synchronise this terminal’s emergency bills and local writes before maintenance.”(维护前请先同步本终端的应急账单和本地写入)。随后它最多等待 30 秒,让其他每台已登记的终端暂停。如果有终端没有暂停,提示会以 “Maintenance did not start. Every registered terminal must confirm that it has stopped and has nothing left to synchronise.” 开头,并列出每台终端及其原因,例如 “Local writes must be synchronised first”、“Emergency bills must be synchronised first”、“Finish the active operation” 或 “terminal has not confirmed maintenance”。关机的终端通常显示 “Waiting for maintenance request”。

然后按拒绝提示中列出的问题逐项处理:

  • 另一台在线终端运行的 FMX EPOS 版本使用不同的数据库结构(“… Update both to the same version before maintenance.”)。请先更新它。
  • 有终端没有暂停、已关机,或仍有未确认的写入或应急账单。
  • “Finish or review these on all terminals before database maintenance: …”:有刷卡操作正在进行、有刷卡结果未知,或有打印任务正在打印或结果未知。提示中会写明打印任务在哪台终端上打印。

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

在提示中列出的终端上使用诊断页、付款复核和打印队列,并查看 Database 页面上的 Terminals 卡片。如果某台终端还能重新连上并同步,不要只为了绕过拒绝而把它移除。

定时的 Automatic Backup(自动备份)不会等待在 Terminals 卡片上显示为 Offline 的终端,所以晚上关机的收银机不会挡住备份。其他维护操作都要等待每一台已登记的终端。

每个 FMX EPOS 安装都有自己的终端身份。如果把安装文件夹复制到另一台电脑,两台电脑就会带着同一个身份。FMX EPOS 发现自己的身份已在另一台电脑上运行时,不会启动收银机,而是显示 Terminal Identity In Use(终端身份已被占用),提示 “This terminal’s identity is also running on …” 并给出另一台电脑的名称。它无法判断哪台电脑是复制出来的。

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

  1. 找到提示中列出的那台电脑,弄清哪一台是复制的。
  2. 如果这台电脑是用来替换另一台的,先关闭另一台电脑,等几分钟,再在这台电脑上重新启动 FMX EPOS。
  3. 如果这台电脑是复制的,而且两台都要继续使用,就在这台电脑的收银窗口中选择 Create a New Terminal Identity(创建新的终端身份)。这个按钮只在收银窗口中显示。顾客显示屏、厨房屏幕和迎宾台上只有 Try Again(重试)。
  4. 桌面应用会显示 “Restarting EPOS…”,然后作为一台新终端重新启动,进入登录页。
  5. 在 Local Settings → Printers(本机设置 → 打印机)中重新选择这台终端的打印机,并检查它的终端名称、许可证和厨房工作站打印机。

绝不要在原来那台收银机上创建新身份:它的打印机、打印路由和未完成的刷卡结果都属于它当前的身份。

每台电脑上只能运行一个 FMX EPOS。如果同一台电脑上另一个 Windows 用户已经打开了它,再启动时会显示 “FMX EPOS is already running for another Windows user on this PC.”。请先在那个用户的会话中关闭它。

尽可能先让这台终端重新连上并完成同步,因为移除终端时无法检查它尚未上传的本地写入。

  1. 在一台正常的终端上以管理员身份打开 Back Office → Database。
  2. 在 Terminals 卡片中找到这台终端。只有其他显示为 Offline 的终端才提供 Remove。
  3. 阅读 Remove Terminal?,然后选择 Remove Terminal。

移除会删除该终端的打印机登记和工作站路由;如果 Integration Host 或 Emergency Terminal 选的正是这台终端,相应的选择也会被清除。仍在等待它的打印机的打印任务会失败,并提示 “The terminal was removed. Choose another printer and retry.”(该终端已被移除,请选择其他打印机后重试)。之后请重新选择 Integration Host、厨房工作站打印机;如果它是 Emergency Terminal,也要重新选择。

计划内的存储变更,请按管理数据库存储和维护操作。