PPDM：如何透過 CLI 套用授權 UI 空白「錯誤」快顯視窗的因應措施

觀察到的症狀

透過 PPDM UI 套用授權時，會觀察到下列行為：

已報告且可能發生的其他錯誤訊息包括：

在 PPDM 中套用授權時，發現導致未預期失敗的產品缺陷。

可使用 nginx reverse‑proxy 層無法正確中繼上傳的授權檔案至後端 dp‑ilm‑services 元件當後端返回 HTTP 錯誤時，UI 會收到錯誤，但僅顯示通用的“ERROR”彈出視窗，而不會傳播原始錯誤消息詳細資訊或代碼。

事前準備作業

• 以「admin」使用者身分透過 SSH 存取 PPDM 伺服器。
• 有效的授權檔案 （.xml, .lic, or .dl） 傳輸至 PPDM 伺服器。
• PPDM 主機上的 root 或 sysadmin 權限。

CLI 授權安裝步驟

1. 將授權檔案傳輸 至 PPDM 伺服器。

   scp /path/to/license_file.xml admin@<PPDMSERVER>:/home/admin/

   或者，您也可以在實體隔離環境中使用 MFT 或 USB 磁碟機。

2. SSH 複製到 PPDM 伺服器中。

   ssh admin@<PPDMSERVER>

3. 使用 CLI 安裝授權檔案。

   Get Auth TOKEN (change <PASSWORD> to actual PPDM admin user password:
   TOKEN=$(curl -k -X POST https://localhost:8443/api/v2/login -H 'Content-Type: application/json' -d '{"username":"admin","password":"<PASSWORD>"}' | grep -Po '"access_token":\s*"\K[^"]+')
   
   Get License ID:
   LICENSEID=$(curl -k -X GET "https://localhost:8443/api/v2/licenses" -H "Authorization: Bearer $TOKEN" | grep -oP '"id":\s*"\K[^"]+')
   
   Install License file:
   curl -k -X PUT https://localhost:443/api/v2/licenses/$LICENSEID -H "Authorization: Bearer $TOKEN" -F "file=@/home/admin/license_file.xml"

4. 在 PPDM UI 中確認授權。
   • 前往管理→系統管理→授權。
   • 確認顯示的授權類型、容量、插槽數量及狀態。
   • 如果 UI 仍顯示 0 TB 或顯示不正確，請參閱已知相關問題 一節。
5. 執行 手動備份 以確保授權可正常運作。
   • 執行備份工作。
   • 檢查 工作 頁面是否有任何與許可證相關的錯誤。

永久修正選項

• 針對插槽授權顯示問題，升級至 PPDM 20.2 可解決插槽顯示瑕疵和授權註冊失敗。此升級無法**修正 UI 空白錯誤缺陷。
• 針對新增授權至 PPDM 的所有其他錯誤，修正將於 20.2 之後的版本中納入。  針對目前受影響的版本，請套用上述 CLI 因應措施 ，直到可升級為止。