Atualização do Usage Meter e troca de chaves de licença

Fim da comercialização: A partir de 31 de outubro de 2025, novas implantações das ofertas do “ VMware Solutions ” não estarão mais disponíveis para novos clientes. Os clientes atuais ainda podem usar e expandir suas cargas de trabalho ativas do VMware® no IBM Cloud®. Para obter mais informações, consulte Fim do marketing para VMware em IBM Cloud.

Atualize os medidores de uso existentes do VMware vCloud para a versão 9.x ou posterior. A versão mais recente do Usage Meter do VMware vCloud disponível é a v9.1.0. Para o Usage Meter v4.8, o processo de atualização envolve receber um token de acesso para o seu Usage Meter atualmente registrado por meio do portal do Usage Meter em IBM Cloud, seguido de uma atualização no local para v9.0.1 primeiro. Após a atualização inicial para v9.0.1, não é necessário fornecer o token de acesso para atualizações posteriores para v9.x ou versões posteriores.

Para o Usage Meter v4.8, não é oferecido suporte a uma atualização direta do Usage Meter v4.8 para v9.1. Você deve primeiro atualizar da versão 4.8 para a versão 9.0.1 e, em seguida, para a versão 9.1. Para obter mais informações, consulte “ Caminho de atualização – Matriz de interoperabilidade de produtos ”.

Antes de atualizar para a versão 9 ou posterior, você deve trocar as chaves de licença VMware Cloud Foundation™ ( VCF ).

Procedimento para trocar as chaves de licença

  1. Obtenha as novas chaves de licença da Broadcom e, em seguida, recupere as chaves de licença VMware Cloud Foundation ( VCF ) no console VMware Solutions. Para obter mais informações, consulte Recuperação de chaves de licença do VCF.
  2. Obtenha as chaves do complemento VMware. Para obter mais informações, consulte Obtenção das chaves do complemento VMware.
  3. Adicione as novas chaves de licença a todos os produtos VMware e, em seguida, atribua as licenças conforme necessário. Para obter mais informações, consulte Gerenciamento de licenças de produtos VMware.

Procedimento para atualizar o medidor de uso

Para atualizar o Usage Meter, siga estas etapas:

Ativação do login SSH

  1. Faça login no console de gerenciamento do appliance VMware vCloud Usage Meter com o usuário usagemeter por meio de https://<Usage Meter IP>:5480.
  2. Clique em “Acesso ” no painel de navegação à esquerda.
  3. Em Configurações de acesso, clique em Editar no canto superior direito.
  4. Na janela Editar configurações de acesso, ative o botão Ativar login SSH. O login do SSH muda para Ativado.

Montagem do arquivo ISO de upgrade

  1. Baixe o arquivo ISO do Usage Meter no link a seguir:

    • Para atualizar do Usage Meter v4.8 (ou versão anterior) para v9.0.1, use: https://ibm.biz/~V0YiDk0EP.
    • Para atualizar do Usage Meter v9.0.1 para v9.1.0, use: https://ibm.biz/~aBF0Bw0fU.

  2. Valide a soma de verificação do arquivo SHA-2 com base no seguinte valor do SHA-256:

    • Para atualizar do Usage Meter v4.8 (ou versão anterior) para v9.0.1, consulte: ec5c46b4bdae915cb4a289dfbb03077cb802f404692bb3f2501b59b448102797.
    • Para atualizar do Usage Meter v9.0.1 para v9.1.0, consulte: d1f79f1bcc711c7753c871bd95bc434e8a31bb8fc584fc7ac88b75398be445c1.

    Abra um prompt de comando no Windows® ou uma janela de terminal em Linux® e MacOS e execute o seguinte comando:

    • Para Windows: certutil -hashfile <path-to-iso-file> SHA256
    • Para Linux: sha256sum <path-to-iso-file>
    • Para macOS: shasum -a 256 <path-to-iso-file>

  3. No cliente Web VMware vSphere®, faça login na instância do servidor vCenter.

  4. No menu Storage (Armazenamento ), selecione o armazenamento de dados em que a máquina virtual do Usage Meter ( VM ) está localizada.

  5. Na guia VMs, clique em Máquinas virtuais e verifique se o Medidor de uso está em seu armazenamento de dados de destino.

  6. Na guia Files (Arquivos ), clique em Upload files (Carregar arquivos ). O arquivo ISO começa a ser carregado.

    Você pode receber um erro sobre os certificados do host. Para resolver o problema, abra o site URL especificado que é mostrado no erro em outra guia do navegador da Web e aceite o certificado. Se ele não carregar, verifique se o host está no DNS atual do seu desktop e acesse novamente o site URL.

  7. Após a conclusão do upload, o arquivo ISO aparecerá na lista de arquivos.

  8. No menu Hosts and clusters, localize e clique com o botão direito do mouse no Usage Meter VM e selecione Edit settings (Editar configurações).

  9. Na guia Virtual hardware (Hardware virtual), na unidade de CD/DVD, selecione Datastore ISO file (Arquivo ISO do armazenamento de dados ) e clique em OK.

    Se você não vir a opção de unidade de CD/DVD, clique em Add new device (Adicionar novo dispositivo ).

  10. Na janela Selecionar arquivo, localize o armazenamento de dados no qual você carregou o arquivo ISO.

  11. Selecione o arquivo ISO e clique em OK.

  12. Na janela Editar configurações, na guia Hardware virtual, marque a caixa de seleção Conectado e clique em OK.

Execução do comando de upgrade

Antes de executar os comandos de atualização do Medidor de consumo, conclua as etapas a seguir:

  1. No cliente Web VMware vSphere®, faça login na instância do servidor vCenter.
  2. No menu Hosts and clusters, localize e clique com o botão direito do mouse no Usage Meter VM e selecione Edit settings (Editar configurações).
  3. Na guia Hardware virtual, na unidade de CD/DVD, desmarque a caixa de seleção Conectado e clique em OK.
  4. No menu Hosts e clusters, localize e clique com o botão direito do mouse no Usage Meter VM e selecione Snapshots > Take snapshot.
  5. Digite um nome para o seu instantâneo e clique em Criar.

Use o SSH para fazer login no Usage Meter Appliance VM e conclua as etapas a seguir:

  1. Abra um prompt de comando no Windows ou uma janela de terminal em Linux e MacOS e execute os seguintes comandos como o usuário root:

    1. mkdir /root/upgrade
    2. mount -o loop /dev/cdrom /root/upgrade
    3. bash /root/upgrade/upgrade-um.sh

    Talvez seja necessário executar umount /root/upgrade para desmontar qualquer atualização anterior antes de executar mount -o loop /dev/cdrom /root/upgrade para atualizar o medidor de uso VM.

  2. Digite o token de acesso gerado para o medidor de uso no console IBM Cloud® for VMware Solutions. Para obter mais informações, consulte Registro do medidor de uso em IBM.

  3. Digite y para concordar que o aparelho VCF Usage Meter faça parte da IBM 's Provider Organization (Organização de Provedores).

  4. Digite y para confirmar a criação de um instantâneo no Medidor de consumo VM.

    Pode ser exibida uma mensagem de erro sobre o nome do host do Medidor de uso. Digite y para continuar o caminho do upgrade.

  5. O processo de atualização é iniciado e, quando for concluído, digite y para reiniciar o Medidor de consumo VM.

  6. Após a conclusão da reinicialização, abra o Usage Meter URL em um navegador da Web e faça login para verificar a versão atualizada. Em seguida, confirme a integridade do dispositivo do Medidor de uso.

Depois de migrar o Usage Meter VM, você poderá encontrar o erro Connection control operation failed for disk durante o processo de atualização. Esse problema pode ocorrer devido a um instantâneo ativo que mantém um bloqueio no dispositivo de CD/DVD montado. Para resolver o problema, execute um dos procedimentos a seguir. No entanto, talvez seja necessário concluir todos eles para uma migração bem-sucedida do VM.

  1. Exclua todos os instantâneos existentes:

    1. No Cliente Web VMware vSphere, faça login na instância do Servidor vCenter como administrador.
    2. No menu Hosts and clusters, selecione Usage Meter VM.
    3. Na guia Snapshots, selecione DELETE ALL ou especifique qualquer um dos snapshots que tenham a unidade de CD/DVD montada e selecione DELETE.
    4. Clique em OK.

  2. Desconecte a unidade montada:

    1. No cliente Web vSphere, faça login na instância do servidor vCenter como administrador.
    2. No menu Hosts and clusters, localize e clique com o botão direito do mouse no Usage Meter VM e selecione Edit settings (Editar configurações).
    3. Desmarque a caixa na unidade de CD/DVD onde você montou o arquivo de atualização ISO.
    4. Clique em OK.

  3. Desconecte a unidade montada do ESXi hospedado:

    1. No cliente Web vSphere, faça login na instância do servidor vCenter como administrador.
    2. No menu Hosts and clusters, selecione Usage Meter VM.
    3. Na guia Summary (Resumo ), localize os objetos relacionados e determine em qual host o VM está localizado.
    4. Faça login no host ESXi como root ou administrador.
    5. Selecione Virtual machines (Máquinas virtuais ) e clique com o botão direito do mouse no Usage Meter (Medidor de uso) VM na lista.
    6. Clique em Editar configurações.
    7. Na unidade de CD/DVD, desmarque a caixa de seleção Conectado.
    8. Clique em Salvar.

Substituição do certificado do medidor de consumo

Se não for possível acessar o Medidor de consumo URL ou fazer login no painel após a atualização, conclua as etapas a seguir para substituir o certificado do Medidor de consumo devido a um nome de host incompatível:

  1. Use o SSH para fazer login no Usage Meter VM com o nome de usuário usagemeter.

  2. Execute o comando stop.sh All para interromper todos os serviços.

  3. Em um usuário root, execute o comando hostnamectl hostname <new hostname> para atualizar o nome do host com o valor correto.

  4. Execute os comandos export $(grep -v '^#' "/opt/vmware/cloudusagemetering/platform/conf/env.properties" | xargs) e mv /opt/vmware/cloudusagemetering/platform/security/keystore /opt/vmware/cloudusagemetering/platform/security/keystore.backup para exportar as variáveis de ambiente e fazer backup do keystore existente.

  5. Se o FIPS estiver ativado, execute o comando keytool -changealias -alias "usage-meter-platform" -destalias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storetype BCFKS -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider -providerpath /opt/vmware/cloudusagemetering/platform/lib/bc-fips-*.jar -storepass "${TRUST_STORE_PASSWORD}". Se estiver desativado, execute o comando keytool -changealias -alias "usage-meter-platform" -destalias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storepass "${TRUST_STORE_PASSWORD}".

    Se você executar a versão desativada do FIPS enquanto o FIPS estiver ativado, o erro keytool error: java.security.KeyStoreException: Unrecognized keystore format. será exibido. Para resolvê-lo, carregue-o com um tipo especificado.

  6. Crie um diretório temporário para a variável NGINX e execute o comando export NGINX_FOLDER=$(mktemp -d) para movê-lo para o diretório cloudusagemetering e, em seguida, execute cd /opt/vmware/cloudusagemetering para acessar o novo diretório.

  7. Execute o comando ./platform/bin/create-keystore.sh para criar o novo keystore.

  8. Execute os comandos rm -rf $NGINX_FOLDER e rm /opt/vmware/cloudusagemetering/platform/security/keystore.backup para remover os arquivos de backup temporários.

  9. Se o FIPS estiver ativado, execute o comando keytool -delete -alias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storetype BCFKS -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider -providerpath /opt/vmware/cloudusagemetering/platform/lib/bc-fips-*.jar -storepass "${TRUST_STORE_PASSWORD}" para excluir o keystore de backup. Se estiver desativado, execute o comando keytool -delete -alias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storepass "${TRUST_STORE_PASSWORD}".

  10. Execute o comando chmod 0640 /opt/vmware/cloudusagemetering/platform/security/keystore para atualizar as novas permissões do keystore e reinicie o Usage Meter VM.

    Devido à alteração do nome de host, talvez seja necessário atualizar a entrada do DNS para o novo nome de host ou adicioná-la, caso não exista. Se você for redirecionado para a página de login com um erro OAuth, limpe todas as entradas de DNS existentes para o Usage Meter e tente novamente.

  11. Após a conclusão da reinicialização, abra o Medidor de uso URL em um navegador da Web para verificar a versão atualizada.