PPDM: How to Apply License via CLI Workaround for UI Blank “ERROR” Popup

Observed Symptoms

When a license is applied through the PPDM UI, the following behavior is observed:

Additional error messages that have been reported and may occur are:

A product defect was found that results in an unexpected failure when applying the license in PPDM.

The nginx reverse‑proxy layer fails to correctly relay the uploaded license file to the backend dp‑ilm‑services component. When the backend returns an HTTP error, the UI receives the error but only displays a generic "ERROR" popup without propagating the original error message details or code.

Prerequisites

• SSH access to the PPDM server as the admin user.
• The valid license file (.xml, .lic, or .dl) transferred to the PPDM server.
• Root or sysadmin privileges on the PPDM host.

CLI License Installation Steps

1. Transfer the license file to the PPDM server.

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

   Alternatively, use MFT or a USB drive for air‑gapped environments.

2. SSH into the PPDM server.

   ssh admin@<PPDMSERVER>

3. Install a license file using the 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. Confirm the license in the PPDM UI.
   • Go to Administration → System Management → License.
   • Verify the displayed license type, capacity and socket count, and status.
   • If the UI still shows 0 TB or an incorrect display, see the Known Related Issues section.
5. Run a manual backup to ensure the license is functional.
   • Execute a backup job.
   • Check the Jobs page for any license‑related errors.

Permanent Fix Options

• For socket license display issue, Upgrade to PPDM 20.2 - resolves the socket‑display defect and the license registration failure. This upgrade does **not** fix the UI blank‑error defect.
• For all other errors adding license to PPDM, fix to be included in releases after 20.2.  For currently impacted versions apply the CLI workaround - described above until upgrade is available.