跳至內容
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(本機 SQLite 檔案)中。
  • 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

「在使用 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(重新開始)則把它們改名(加上日期和時間)放在一旁保留,並以新的數據庫開始。
    • 已安裝 MySQL 時會出現 Prepare Database(準備數據庫)。先輸入 MySQL Root Password(MySQL root 密碼),FMX EPOS 會在其上建立店舖的數據庫。
    • 如之前由 FMX EPOS 進行的 MySQL 安裝未完成,會出現 Continue(繼續)。它會完成這次安裝。
  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 或 Reinstall 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 匯出、不超過 512 MB 的 .eposdata 檔案。檔案必須由與本機使用相同數據庫模型的 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 都會拒絕開始維護。按訊息所指的終端機和項目處理後,再重新開始。斷線或儲存結果不確定後的恢復方法,參閱數據庫與斷線應變疑難排解。