此流程有助於確保平穩過渡，最大限度地減少停機時間，並保障資料完整性。盡可能先在非生產環境中進行測試。
備份、解除安裝、重新安裝和復原流程
開始之前的重要提示：
資料庫備份和復原步驟最為關鍵。務必確保該步驟成功完成後再繼續下一步。
- 以管理員身分執行所有命令提示字元。
- 這些說明基於標準的 JMP Live 本機部署實務（涉及 JMP Pro、透過 JMP Live Database 安裝程式部署的 PostgreSQL 資料庫、Keycloak 和 JMP Live 服務）。
- 由於服務將離線，請安排在維護視窗期間進行此操作。
第一步：準備與備份
1. 將設定檔備份到新資料夾（例如 C:\Backup）
- 找到並複製位於 JMP Pool 和 JMP Live 安裝目錄中的 .env 檔案。這兩個文件將會重複使用。
- 備份 Keycloak .conf 檔案（僅供參考；不能直接重複使用）。
重要：請確保所有憑證（certs）均未儲存在預設的「程式檔案」資料夾中，因為卸載程式時該資料夾將被刪除。如有需要，請將其移至安全位置。
2. 停止所有 JMP Live 服務
- 開啟服務（services.msc）並停止：
- jmppoolsvc
- webjmpsvc
- JMP Live Keycloak
步驟 2：資料庫備份
1. 開啟提升權限的命令提示字元（以管理員身分執行）。
2. 導覽至 (cd) Backups 資料夾
3. 執行下列資料庫備份指令：
"C:\Program Files\PostgreSQL\13\bin\pg_dump" -Fc -b -h olddbhost -U dba_webjmp -f webjmp.dump webjmp
- 更新命令中的檔案路徑，使其與您的安裝路徑相符。
4. 監控進度，因為這可能需要相當長的時間，這取決於資料庫的大小。
5. 在繼續操作之前，請確認備份檔案存在且不為空/不損壞。
- 這步驟至關重要，因為備份失敗會導致資料遺失。
- 必須備份和還原整個 JMP Live 資料庫，否則不能保證新部署能夠正常運作。
步驟 3：卸載現有元件
請以任何順序卸載以下程序（透過控制台 > 程式和功能 或 新增/刪除程式）：
- JMP Live
JMP Pro
- JMP Live Database（PostgreSQL 實例）
- 鑰匙斗篷
步驟 4：資料庫的安裝與恢復
1. 安裝 JMP Live 自解壓縮可執行檔中包含的 JMP Live 資料庫元件。
2. 使用相同的提升權限的命令提示字元和備份資料夾，執行下列還原命令。
"C:\Program Files\PostgreSQL\13\bin\pg_restore" -Fc -h newdbhost -U dba_webjmp -d webjmp webjmp.dump
- 更新命令中的檔案路徑，使其與您的安裝路徑相符。
3. 確認復原操作已成功完成（檢查日誌或查詢資料庫）。
步驟 5：安裝其他 JMP Live 元件
請嚴格按照以下順序安裝：
1. JMP Pro
2. 鑰匙斗篷
- 安裝過程中，輸入所需的管理員和資料庫設定。
- 在記事本中開啟備份的 Keycloak .conf 文件，用作配置值（例如，連接埠、管理員憑證、資料庫連線）的參考。
3. JMP Live
- 安裝過程中，如果您打算在安裝後覆蓋 .env 文件，則提示資訊無需完全準確。
- 確保在提示時正確指定 JMP Pro 安裝路徑（或稍後在 JMP Pool .env 檔案中更新它；即更改任何 18 → 19 引用）。
步驟 6：安裝後配置
1. 再次停止服務（如果已自動啟動）：
- 開啟服務（services.msc）並停止：
- jmppoolsvc
- webjmpsvc
- JMP Live Keycloak
2. 覆蓋設定檔
- 將 JMP Pool 和 JMP Live 目錄中的新 .env 檔案替換為備份副本。
- 檢查並更新所有版本特定的路徑（例如 JMP Pro 路徑 18 → 19）。這些路徑可以在記事本中編輯。
儲存更改。
3. 啟動 JMP Live
- 導覽至：`C:\Program Files\JMP\JMP Live\`（或您的安裝路徑）。
- 以管理員身分執行 `launch.cmd`。
- 等待兩個命令提示字元視窗完成初始化，然後關閉它們。
4. 開始服務
- 開啟服務 (services.msc) 並依下列順序啟動：
- JMP Live Keycloak
- webjmpsvc
- jmppoolsvc
步驟 7：最終核實和重新授權
1. 存取 JMP Live Administrator Web 介面。
- https://URL/admin/login
2. 以管理員身分登入。
3. 轉到「管理」標籤。
4. 重新授權 JMP Live（依照螢幕提示完成許可/連線驗證）。
5. 測試關鍵功能：從桌面版 JMP Pro 發布範例報告，驗證使用者存取權限，檢查資料刷新等。
如果出現問題：
- 檢查服務狀態和日誌。
- 驗證資料庫連線和 Keycloak 領域設定。
- 請查閱官方 JMP Live 安裝說明或聯絡 JMP 技術支援。
