跳至主內容

Mavis 備份與還原操作指南

  • 更新於

一、簡介

為確保 Mavis 系統的設定資料與關鍵資訊在系統異常、硬體故障或升級維護時能夠安全保存並快速復原，本指南說明 Mavis 系統的備份與還原機制及其操作方式。

Mavis 提供標準化的備份還原腳本，可協助管理者快速建立系統備份檔，並在需要時進行完整還原，以降低系統中斷風險並確保營運連續性。

 

二、備份與還原工具說明

2.1 取得備份還原腳本

在執行備份或還原作業前，請先向指定聯絡窗口取得官方提供的備份還原腳本：

  • 腳本名稱：simple-backup.sh

前置確認

請確認 simple-backup.sh 腳本已上傳至以下兩台伺服器，並具備可執行權限：

  1. 待備份的原 Mavis 伺服器

  2. 待還原的新 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 準備新機器

在進行還原前，請確保新機器已完成以下準備：

  1. 安裝與原 Mavis 系統相同的軟體版本

  2. 確認作業系統環境符合 Mavis 安裝需求

  3. 具備必要的網路連線與檔案存取權限

  4. 建議先進行初步系統測試，確保環境可正常運行

    注意：還原作業會覆蓋系統現有資料，請務必確認新機器無重要資料，或已做好額外備份。

     

5.2 還原系統資料

當需要將系統回復至指定備份狀態時，請在已完成 Mavis 安裝的新機器伺服器上執行以下指令進行還原：

./simple-backup.sh -r mavis-backup-v2.2.6-2026-01-21-05.tgz

說明：

  • -r：執行還原作業

  • <backup_file>：指定欲還原的備份檔名稱

注意事項：

  1. 還原過程中將完全覆蓋現有系統資料，請確認新機器無重要資料，或已做好備份

  2. 確認備份檔完整且可讀取

  3. 還原過程中請勿中斷作業

  4. 還原完成後，建議檢查系統狀態與服務運行情況

 

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）是否符合預期設定

  • 若查詢結果異常，請確認還原作業是否完整，或聯繫技術支援窗口協助處理

建議：除使用者資料外，可依實際需求查詢其他關鍵資料表，以進一步驗證系統還原完整性。

 

相關文章