Aggiornamento dell'Usage Meter e scambio di chiavi di licenza

Fine della commercializzazione: a partire dal 31 ottobre 2025, le nuove implementazioni delle offerte " VMware Solutions " non saranno più disponibili per i nuovi clienti. I clienti esistenti possono continuare a utilizzare e ampliare i propri carichi di lavoro attivi su VMware® all'indirizzo IBM Cloud®. Per ulteriori informazioni, vedere Fine della commercializzazione per VMware su IBM Cloud.

Aggiornare i contatori di utilizzo esistenti di VMware vCloud alla versione 9.x o successive. L'ultima versione disponibile di " VMware " ( vCloud ) è "Usage Meter" ( v9.1.0 ). Per Usage Meter v4.8, il processo di aggiornamento prevede innanzitutto l'ottenimento di un token di accesso per il proprio Usage Meter attualmente registrato tramite il portale di Usage Meter all'indirizzo IBM Cloud, seguito da un aggiornamento in loco a v9.0.1. Dopo l'aggiornamento iniziale a v9.0.1, non è necessario fornire il token di accesso per ulteriori aggiornamenti a v9.x o versioni successive.

Per Usage Meter v4.8, non è supportato un percorso di aggiornamento diretto da Usage Meter v4.8 a v9.1. È necessario eseguire prima l'aggiornamento dalla versione 4.8 alla versione 9.0.1 e, successivamente, alla versione 9.1. Per ulteriori informazioni, consultare la sezione " Percorso di aggiornamento - Matrice di interoperabilità dei prodotti ".

Prima di passare alla versione 9 o successiva, è necessario scambiare le chiavi di licenza VMware Cloud Foundation™ ( VCF ).

Procedura per scambiare le chiavi di licenza

  1. Ottenere le nuove chiavi di licenza Broadcom, quindi recuperare le chiavi di licenza VMware Cloud Foundation ( VCF ) dalla console VMware Solutions. Per ulteriori informazioni, vedere Recupero delle chiavi di licenza VCF.
  2. Ottenere le chiavi del componente aggiuntivo VMware. Per ulteriori informazioni, vedere Ottenere le chiavi del componente aggiuntivo VMware.
  3. Aggiungere le nuove chiavi di licenza a tutti i prodotti VMware e assegnare le licenze come richiesto. Per ulteriori informazioni, vedere Gestione delle licenze dei prodotti VMware.

Procedura di aggiornamento del contatore di consumo

Per aggiornare Usage Meter, segui questi passaggi:

Abilitazione del login SSH

  1. Accedere alla console di gestione dell'appliance VMware vCloud Usage Meter con l'utente usagemeter attraverso https://<Usage Meter IP>:5480.
  2. Fare clic su Accesso dal pannello di navigazione sinistro.
  3. In Impostazioni di accesso, fare clic su Modifica in alto a destra.
  4. Nella finestra Modifica impostazioni di accesso, attivare l'interruttore Abilita login SSH. Il login SSH cambia in Abilitato.

Montaggio del file ISO di aggiornamento

  1. Scarica il file ISO di Usage Meter dal seguente link:

    • Per eseguire l'aggiornamento da Usage Meter v4.8 (o versioni precedenti) a v9.0.1, utilizzare: https://ibm.biz/~V0YiDk0EP.
    • Per effettuare l'aggiornamento da Usage Meter v9.0.1 a v9.1.0, utilizzare: https://ibm.biz/~aBF0Bw0fU.

  2. Verifica il checksum di SHA-2 in base al seguente valore SHA-256:

    • Per l'aggiornamento da Usage Meter v4.8 (o versioni precedenti) a v9.0.1, consultare: ec5c46b4bdae915cb4a289dfbb03077cb802f404692bb3f2501b59b448102797.
    • Per l'aggiornamento da Usage Meter v9.0.1 a v9.1.0, consultare: d1f79f1bcc711c7753c871bd95bc434e8a31bb8fc584fc7ac88b75398be445c1.

    Aprire un prompt dei comandi su Windows® o una finestra di terminale su Linux® e MacOS ed eseguire il seguente comando:

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

  3. Nel client Web VMware vSphere®, accedere all'istanza di vCenter Server.

  4. Nel menu Storage, selezionare il datastore in cui si trova la macchina virtuale Usage Meter ( VM ).

  5. Nella scheda Macchine virtuali, fare clic su Macchine virtuali e verificare che Usage Meter sia sul datastore di destinazione.

  6. Nella scheda File, fare clic su Carica file. Il file ISO inizia a essere caricato.

    È possibile che venga visualizzato un errore relativo ai certificati host. Per risolvere il problema, aprire il sito URL indicato nell'errore in un'altra scheda del browser web e accettare il certificato. Se non viene caricato, verificare che l'host sia presente nel DNS del desktop corrente e quindi accedere nuovamente a URL.

  7. Al termine del caricamento, il file ISO apparirà nell'elenco dei file.

  8. Nel menu Host e cluster, individuare e fare clic con il pulsante destro del mouse su Usage Meter VM e selezionare Edit settings.

  9. Nella scheda Hardware virtuale, selezionare l'unità CD/DVD, il file ISO del datastore e fare clic su OK.

    Se non viene visualizzata l'opzione Unità CD/DVD, fare clic su Aggiungi nuova periferica.

  10. Nella finestra Seleziona file, individuare il datastore in cui è stato caricato il file ISO.

  11. Selezionare il file ISO e fare clic su OK.

  12. Nella finestra Modifica impostazioni, nella scheda Hardware virtuale, selezionare la casella di controllo Connesso, quindi fare clic su OK.

Esecuzione del comando di aggiornamento

Prima di eseguire i comandi di aggiornamento per il misuratore di consumo, completare i seguenti passaggi:

  1. Nel client Web VMware vSphere®, accedere all'istanza di vCenter Server.
  2. Nel menu Host e cluster, individuare e fare clic con il pulsante destro del mouse su Usage Meter VM e selezionare Edit settings.
  3. Nella scheda Hardware virtuale, nell'unità CD/DVD, deselezionare la casella di controllo Connesso e fare clic su OK.
  4. Nel menu Host e cluster, individuare e fare clic con il pulsante destro del mouse su Usage Meter VM, quindi selezionare Snapshots > Take snapshot.
  5. Inserisci un nome per la tua istantanea e fai clic su Crea.

Utilizzare SSH per accedere alla periferica Usage Meter VM e completare i passaggi seguenti:

  1. Aprite un prompt dei comandi su Windows o una finestra di terminale su Linux e MacOS ed eseguite i seguenti comandi come utente root:

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

    Potrebbe essere necessario eseguire umount /root/upgrade per smontare eventuali aggiornamenti precedenti prima di eseguire mount -o loop /dev/cdrom /root/upgrade per aggiornare l'Usage Meter VM.

  2. Inserire il token di accesso generato per il misuratore di consumo nella console IBM Cloud® for VMware Solutions. Per ulteriori informazioni, consultare la sezione Registrazione del contatore di consumi con IBM.

  3. Immettere y per accettare che l'apparecchio di misurazione degli usi VCF faccia parte dell'organizzazione dei fornitori di IBM.

  4. Immettere y per confermare la creazione di un'istantanea del misuratore di consumo VM.

    Potrebbe apparire un messaggio di errore sul nome dell'host del misuratore di consumo. Immettere y per continuare il percorso di aggiornamento.

  5. Il processo di aggiornamento si avvia e, al termine, immettere y per riavviare l'Usage Meter VM.

  6. Al termine del riavvio, aprire Usage Meter URL in un browser web e accedere per verificare la versione aggiornata. Confermare quindi lo stato di salute dell'apparecchio Usage Meter.

Dopo aver migrato l'Usage Meter VM, è possibile che durante il processo di aggiornamento si verifichi l'errore Connection control operation failed for disk. Questo problema potrebbe essere dovuto a un'istantanea attiva che mantiene un blocco sul dispositivo CD/DVD montato. Per risolvere il problema, eseguire una delle seguenti procedure. Tuttavia, potrebbe essere necessario completarli tutti per una migrazione di successo del sito VM.

  1. Elimina eventuali snapshot esistenti:

    1. Nel client Web VMware vSphere, accedere all'istanza di vCenter Server come amministratore.
    2. Nel menu Host e cluster, selezionare Usage Meter VM.
    3. Nella scheda Istantanee, selezionare ELIMINA TUTTO o specificare una qualsiasi delle istantanee in cui è montata l'unità CD/DVD e selezionare ELIMINA.
    4. Fai clic su OK.

  2. Scollegare l'unità montata:

    1. Nel client Web vSphere, accedere all'istanza di vCenter Server come amministratore.
    2. Nel menu Host e cluster, individuare e fare clic con il pulsante destro del mouse su Usage Meter VM e selezionare Edit settings.
    3. Deselezionare la casella dell'unità CD/DVD in cui è stato montato il file di aggiornamento ISO.
    4. Fai clic su OK.

  3. Scollegare l'unità montata dall'ESXi ospitato:

    1. Nel client Web vSphere, accedere all'istanza di vCenter Server come amministratore.
    2. Nel menu Host e cluster, selezionare Usage Meter VM.
    3. Nella scheda Riepilogo, individuare gli oggetti correlati e determinare l'host in cui si trova VM.
    4. Accedere all'host ESXi come root o come amministratore.
    5. Selezionare le macchine virtuali e fare clic con il pulsante destro del mouse su Usage Meter VM nell'elenco.
    6. Fai clic su " Modifica impostazioni ".
    7. In corrispondenza dell'unità CD/DVD, deselezionare la casella di controllo Connesso.
    8. Fare clic su Salva.

Sostituzione del certificato del contatore di consumo

Se non è possibile accedere all'Usage Meter URL o al dashboard dopo l'aggiornamento, completare i passaggi seguenti per sostituire il certificato dell'Usage Meter a causa di un hostname incompatibile:

  1. Usare SSH per accedere all'Usage Meter VM con il nome utente usagemeter.

  2. Eseguire il comando stop.sh All per arrestare tutti i servizi.

  3. Sotto un utente root, eseguire il comando hostnamectl hostname <new hostname> per aggiornare l'hostname con il valore corretto.

  4. Eseguire i comandi 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 per esportare le variabili d'ambiente e fare il backup del keystore esistente.

  5. Se FIPS è abilitato, eseguire il 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 è disattivato, eseguire il comando keytool -changealias -alias "usage-meter-platform" -destalias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storepass "${TRUST_STORE_PASSWORD}".

    Se si esegue la versione FIPS disabilitata mentre FIPS è abilitato, viene visualizzato l'errore keytool error: java.security.KeyStoreException: Unrecognized keystore format.. Per risolverlo, caricarlo con un tipo specificato.

  6. Creare una directory temporanea per la variabile NGINX ed eseguire il comando export NGINX_FOLDER=$(mktemp -d) per spostarla nella directory cloudusagemetering, quindi eseguire cd /opt/vmware/cloudusagemetering per accedere alla nuova directory.

  7. Eseguire il comando ./platform/bin/create-keystore.sh per creare il nuovo keystore.

  8. Eseguire i comandi rm -rf $NGINX_FOLDER e rm /opt/vmware/cloudusagemetering/platform/security/keystore.backup per rimuovere i file di backup temporanei.

  9. Se FIPS è abilitato, eseguire il 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}" per eliminare il keystore di backup. Se è disattivato, eseguire il comando keytool -delete -alias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storepass "${TRUST_STORE_PASSWORD}".

  10. Eseguire il comando chmod 0640 /opt/vmware/cloudusagemetering/platform/security/keystore per aggiornare i nuovi permessi del keystore e riavviare l'Usage Meter VM.

    A causa della modifica dell'hostname, potrebbe essere necessario aggiornare la voce DNS con il nuovo hostname o aggiungerla se non esiste. Se si viene reindirizzati alla pagina di accesso con un errore OAuth, cancellare le voci DNS esistenti per Usage Meter e riprovare.

  11. Al termine del riavvio, aprire Usage Meter URL in un browser web per verificare la versione aggiornata.