# 管理終端升級套件

Canonical: https://www.nsecsoft.com/tw/docs/ping64-platform/platform/endpoint-lifecycle/endpoint-upgrade/

Language: zh-TW

Updated: 2026-11-15T03:16:05.439385Z

終端升級管理用於儲存已驗證的升級套件、設定適用平台的預設版本，以及向指定終端分配升級版本。套件入庫、預設版本變更、目標分配與終端實際升級是不同階段，不能只憑發佈成功判斷終端已完成升級。

## 操作前提

-   本頁適用於私有部署。使用具有平台設定權限的超級管理員帳戶，並確認相應服務授權可用。
-   從可信的發佈管道準備符合目標平台的升級套件及配套簽章檔案。頁面會上傳並驗證檔案；macOS 上傳需要 `.pkg` 套件與 `.sig` 簽章檔案。 檔案選擇器對 Windows 與所列 Linux 平台使用 `.cab`，macOS 使用 `.pkg`；能選取檔案不表示已通過驗證。
-   確定目標版本、終端平台及影響範圍，先選擇少量試點終端，依組織變更流程評估業務中斷、復原安排及擴大部署條件。
-   可選平台及選項受環境、授權與平台條件影響；麒麟、統信選項的顯示也受市場地區限制。頁面顯示平台選項不代表所有終端均已驗證可升級。

## 上傳並發佈新升級套件

1.  在系統設定中開啟「終端升級」，選擇「新建升級包」。
2.  在上傳及驗證步驟選擇目標平台、升級套件與簽章檔案，再選擇下一步。等待上傳及驗證完成，檢查解析出的版本；更換平台或檔案後應重新核對並驗證。
3.  依用途選擇「僅入庫」「設為預設版本」「分配指定終端」或「預設版本並分配終端」。頁面僅顯示適用於目前平台及情境的選項。
4.  如選擇分配，至少選擇一台與套件平台相符的終端，並檢查名稱、平台與已選範圍。僅入庫或僅設預設版本時無須選擇終端。
5.  在確認步驟核對平台、版本、發佈方式與目標，選擇「確定發佈」。返回清單確認版本、預設及分配狀態，再分別核對終端實際版本與運作狀態。

\*\*切換目標平台：\*\*新增流程中更換平台會清除所選升級套件、簽章檔案及驗證結果，也會清除已選終端並將發佈方式重設為「僅入庫」。切換後須重新選擇及驗證檔案，再選擇發佈方式和目標；不要假設先前選擇仍保留。

\*\*分配前核對其他版本：\*\*若所選終端已分配其他升級版本，此次分配會將該終端的目標版本改為本版本，不會同時保留兩個版本的分配。先與相關負責人確認影響；目標版本變更不代表終端已實際完成升級或回復至舊版。

## 選擇發佈方式

-   \*\*僅入庫：\*\*儲存套件，不修改預設版本，也不立即分配終端。
-   \*\*設為預設版本：\*\*修改平台預設版本，不等同於向現有終端分配升級。此選項只適用 Windows 與 macOS；Windows 預設版本用於後續產生的用戶端安裝套件。
-   \*\*分配指定終端：\*\*向所選且平台相符的終端分配版本，不修改預設版本。
-   \*\*預設版本並分配終端：\*\*同時設定適用平台的預設版本並分配所選終端；儲存後仍須分別核對預設版本、分配範圍與終端執行結果。

## 調整既有版本的分配

1.  在套件清單找到目標平台與版本，選擇「升級到此版本」。
2.  選擇發佈方式並檢查目前已選終端；修改目標時保留仍需分配的終端，再增加或移除其他終端。
3.  核對後發佈，返回清單檢查目標與預設狀態。提交分配會以完整目標清單取代該版本原有分配：取消選取既有終端會移除其對此版本的分配；清空清單會移除該版本現有分配。提交前應確認影響，不要視為只追加新目標。

\*\*核對已選範圍：\*\*編輯既有分配時，已選數量包含該版本原有分配；右側清單只顯示目前終端樹中可識別的已選終端，且可能分頁。逐頁核對後若數量仍不一致，未顯示的既有目標仍可能包含在送出內容中。先檢查終端樹、平台及管理範圍並重新載入；無法確認完整範圍時不要發佈，應聯絡管理員或技術支援。

同時調整既有版本的預設版本與分配時，兩項操作可能分別完成。若頁面回報失敗，先檢查清單中的分配與預設狀態，再決定是否重試，不要假設所有變更都未發生。

## 常見問題

-   \*\*上傳或驗證失敗：\*\*檢查套件、簽章檔案、平台及來源是否相符；若伺服器驗證設定不可用，聯絡平台管理員或技術支援。
-   \*\*驗證結果失效或版本已存在：\*\*依提示重新上傳驗證，或先在清單核對現有平台與版本，不要重複發佈相同版本。
-   \*\*無法選擇目標或分配失敗：\*\*檢查終端平台、可見範圍、帳戶權限及服務授權；新建套件並分配時至少須選一台平台相符的終端。
-   \*\*無法刪除套件：\*\*若版本仍被預設版本或終端分配引用，應先確認並處理引用。刪除前核實影響，不假設能直接復原。
-   \*\*發佈成功但終端未升級：\*\*分別檢查實際分配範圍、平台、連線狀態、目前版本與終端執行結果；持續異常時聯絡技術支援。
