一、簡介
為確保 Mavis 系統的設定資料與關鍵資訊在系統異常、硬體故障或升級維護時能夠安全保存並快速復原,本指南說明 Mavis 系統的備份與還原機制及其操作方式。
Mavis 提供標準化的備份還原腳本,可協助管理者快速建立系統備份檔,並在需要時進行完整還原,以降低系統中斷風險並確保營運連續性。
二、備份與還原工具說明
2.1 取得備份還原腳本
在執行備份或還原作業前,請先向指定聯絡窗口取得官方提供的備份還原腳本:
腳本名稱:
simple-backup.sh
前置確認
請確認
simple-backup.sh腳本已上傳至以下兩台伺服器,並具備可執行權限:
待備份的原 Mavis 伺服器
待還原的新 Mavis 伺服器
可使用以下指令確認腳本具備執行權限:
ls -l simple-backup.sh chmod +x simple-backup.sh # 若尚未具備執行權限
提醒:
腳本未正確上傳或缺少執行權限,將導致備份或還原作業失敗。
系統進行備份作業期間,Mavis 平台服務將暫時中斷,待作業完成後恢復正常。
三、腳本使用方式與參數說明
3.1 指令語法
./simple-backup.sh {-b [-c <copy_destination>] | -r <backup_file>}3.2 參數說明
| 參數 | 說明 |
|---|---|
-b | 建立系統備份 |
-c <copy_destination> | (選用)備份完成後,將備份檔透過 rsync 複製至指定遠端位置 |
-r <backup_file> | 使用指定的備份檔進行系統還原 |
四、備份操作說明
4.1 建立系統備份
在 Mavis 伺服器上執行以下指令,即可進行系統備份,並在備份完成後自動將檔案傳送至遠端伺服器(範例 IP:192.168.89.160):
./simple-backup.sh -b -c root@192.168.89.160:/root說明:
-b:執行備份作業-c:指定遠端備份儲存位置(使用rsync傳送至遠端伺服器)備份檔會自動依系統版本與時間命名(例如:
mavis-backup-<version>-<date>.tgz)
建議:備份作業建議於系統低使用量時段進行,以減少對運行服務的影響。
五、還原操作說明
5.1 準備新機器
在進行還原前,請確保新機器已完成以下準備:
安裝與原 Mavis 系統相同的軟體版本
確認作業系統環境符合 Mavis 安裝需求
具備必要的網路連線與檔案存取權限
建議先進行初步系統測試,確保環境可正常運行
注意:還原作業會覆蓋系統現有資料,請務必確認新機器無重要資料,或已做好額外備份。
5.2 還原系統資料
當需要將系統回復至指定備份狀態時,請在已完成 Mavis 安裝的新機器伺服器上執行以下指令進行還原:
./simple-backup.sh -r mavis-backup-v2.2.6-2026-01-21-05.tgz說明:
-r:執行還原作業<backup_file>:指定欲還原的備份檔名稱
注意事項:
還原過程中將完全覆蓋現有系統資料,請確認新機器無重要資料,或已做好備份
確認備份檔完整且可讀取
還原過程中請勿中斷作業
還原完成後,建議檢查系統狀態與服務運行情況
5.3 檢查還原系統資料庫
完成系統還原後,建議透過查詢資料庫內容,確認系統資料是否已正確還原。本節說明如何在 Mavis 環境中使用指令查詢使用者資料,以驗證還原結果。
Mavis 系統部署於 Kubernetes 環境中,可透過 kubectl exec 進入 apiserver Pod,並使用 PostgreSQL 指令查詢資料庫內容。
use-sql () {
local sql="$1"
echo "$sql" >&2
kubectl -n pentium exec "$(kubectl -n pentium get pod -l app=apiserver -o name)" -- bash -c "
set -a; source /run/secrets/pare/postgres/postgres; set +a && \
PGPASSWORD=\"\$PASSWORD\" PGOPTIONS=\"--search_path=\$SCHEMA_NAME\" \
psql -At -F $'\t' -h \"\$HOST\" -p \"\$PORT\" -U \"\$USERNAME\" -d \"\$DATABASE_NAME\" -v ON_ERROR_STOP=1 \
-c \"$1\" "
}
use-sql "SELECT id, is_mfa_enabled FROM users;"驗證重點
確認使用者資料筆數與還原前一致
檢查關鍵欄位(如
is_mfa_enabled)是否符合預期設定若查詢結果異常,請確認還原作業是否完整,或聯繫技術支援窗口協助處理
建議:除使用者資料外,可依實際需求查詢其他關鍵資料表,以進一步驗證系統還原完整性。