PPDM: Como aplicar a licença por meio da CLI Solução temporária para o pop-up "ERRO" em branco da interface do usuário

Sintomas observados

Quando uma licença é aplicada por meio da interface do usuário do PPDM, o seguinte comportamento é observado:

Outras mensagens de erro que foram relatadas e podem ocorrer são:

Foi encontrado um defeito no produto que resulta em uma falha inesperada ao aplicar a licença no PPDM.

Os nginx reverse‑proxy A camada não consegue retransmitir corretamente o arquivo de licença carregado para o back-end dp‑ilm‑services components: Quando o back-end retorna um erro HTTP, a interface do usuário recebe o erro, mas exibe apenas um pop-up "ERROR" genérico, sem propagar os detalhes ou o código da mensagem de erro original.

Pré-requisitos

• Acesso SSH ao servidor PPDM como usuário administrador.
• O arquivo de licença válido (.xml, .lic, or .dl) transferido para o servidor PPDM.
• Privilégios root ou sysadmin no host do PPDM.

Etapas manuais de instalação de licença

1. Transfira o arquivo de licença para o servidor PPDM.

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

   Como alternativa, use uma unidade USB ou MFT para ambientes com air gap.

2. SSH no servidor PPDM.

   ssh admin@<PPDMSERVER>

3. Instale um arquivo de licença usando a 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. Confirme a licença na interface do usuário do PPDM.
   • Acesse Administration → System Management → License.
   • Verifique o tipo de licença, a capacidade, a contagem de soquetes e o status exibidos.
   • Se a interface do usuário ainda mostrar 0 TB ou uma exibição incorreta, consulte a seção Problemas relacionados conhecidos .
5. Execute um backup manual para garantir que a licença esteja funcional.
   • Reiniciar um trabalho de backup
   • Verifique se há erros relacionados à licença na página Jobs .

Opções de correção permanente

• Para problemas de exibição da licença do soquete, Upgrade para o PPDM 20.2 resolve o defeito na tela do soquete e a falha no registro da licença. Esse upgrade **não** corrige o defeito de erro em branco da interface do usuário.
• Para todos os outros erros que adicionam licença ao PPDM, a correção deve ser incluída nas versões posteriores à 20.2.  Para as versões atualmente afetadas, aplique a solução temporária da CLI , descrita acima, até que o upgrade esteja disponível.