PPDM:如何通过 CLI 应用许可证 UI 空白“ERROR”弹出窗口的解决方法

Сводка: 尝试使用 UI 在 PPDM 20.1 或 20.2 上安装传统容量或插槽许可证时,会出现标记为“ERROR”的空白弹出窗口,并且没有任何进一步的文本、错误代码或诊断信息。尽管文件有效,但未应用许可证。这是一个已知的 UI 缺陷,PPDM 未来版本中有一个永久修复。CLI 解决方法可用。

Данная статья применяется к Данная статья не применяется к Эта статья не привязана к какому-либо конкретному продукту. В этой статье указаны не все версии продуктов.

Симптомы

观察到的症状

通过 PPDM UI 应用许可证时,会出现以下行为:

UI 许可证应用症状详细信息
步骤 观察到的行为
1 导航至 管理 系统管理许可证
2 选择 添加编辑许可证
3 浏览并选择有效的许可证文件 (.xml, .lic, or .dl)
4 单击应用
5 此时将显示标记为 ERROR 的空白弹出窗口,其中没有其他文本、错误代码或补救指导。
6 未应用许可证 — 系统继续显示未许可或以前的许可证状态。

 

已报告和可能发生的其他错误消息包括:

其他错误或症状消息
错误或症状 可见位置
标记为“ERROR”的空白弹出窗口,没有其他文本 PPDM UI →许可证应用
应用传统许可证文件时出现“ERROR”弹出窗口 PPDM UI → /apply-legacy-license
尝试应用后许可证容量显示 0 TB PPDM UI →系统管理→许可证
409:此设备上已存在许可证。使用编辑许可证功能更新现有许可证。 重新应用时的 PPDM UI
插槽许可证显示为 容量 (TB), 而不是 插槽 PPDM UI →许可证显示

Причина

在 PPDM 中应用许可证时,发现产品缺陷导致意外故障。

The nginx reverse‑proxy 层无法将上传的许可证文件正确中继到后端 dp‑ilm‑services components: 当后端返回 HTTP 错误时,UI 会收到错误,但仅显示通用的“ERROR”弹出窗口,而不传播原始错误消息详细信息或代码。

 

注意:导致 UI 将许可证显示为 容量 (TB) 而不是 插槽 的单独缺陷只是显示问题,不会影响产品功能。  此显示问题已在 PPDM 20.2 中得到修复。

Разрешение

前提条件

  • 以管理员用户身份通过 SSH 访问 PPDM 服务器。
  • 有效的许可证文件 (.xml, .lic, or .dl)传输到 PPDM 服务器。
  • PPDM 主机上的 root 或 sysadmin 权限。

手动许可证安装步骤

  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 中确认许可证。
    • 转至Administration→System Management→License
    • 验证显示的许可证类型、容量、插槽计数和状态。
    • 如果 UI 仍显示 0 TB 或显示不正确,请参阅已知相关问题 部分。
  5. 运行 手动备份 以确保许可证正常工作。
    • 重启备份作业
    • 检查 作业 页面是否有任何与许可证相关的错误。

    永久修复选项

    • 对于套接字许可证显示问题,升级到 PPDM 20.2 — 解决套接字显示缺陷和许可证注册失败问题。此升级**不会**修复 UI 空白错误缺陷。
    • 对于将许可证添加到 PPDM 的所有其他错误,修复应包含在 20.2 之后的版本中。  对于当前受影响的版本,应用上述 CLI 解决方法 (在升级可用之前所述)。

    Затронутые продукты

    PowerProtect Data Manager
    Свойства статьи
    Номер статьи: 000484394
    Тип статьи: Solution
    Последнее изменение: 27 июл. 2026
    Версия:  3
    Получите ответы на свои вопросы от других пользователей Dell
    Услуги технической поддержки
    Проверьте, распространяются ли на ваше устройство услуги технической поддержки.