Mise à jour de l'Usage Meter et échange des clés de licence

Fin de la commercialisation: à compter du 31 octobre 2025, les nouveaux déploiements des offres « VMware Solutions » ne seront plus disponibles pour les nouveaux clients. Les clients existants peuvent continuer à utiliser et à développer leurs charges de travail VMware® actives sur IBM Cloud®. Pour plus d'informations, voir Fin de la commercialisation pour VMware sur IBM Cloud.

Mettez à niveau les compteurs d'utilisation existants de VMware vCloud vers la version 9.x ou une version ultérieure. La dernière version disponible de l'outil de mesure d'utilisation « VMware » ( vCloud ) est accessible à l'adresse v9.1.0. Pour Usage Meter v4.8, le processus de mise à niveau consiste à obtenir un jeton d'accès pour votre Usage Meter actuellement enregistré via le portail Usage Meter de IBM Cloud, puis à effectuer une mise à niveau sur place vers v9.0.1. Une fois la mise à niveau initiale vers la version « v9.0.1 » effectuée, il n'est plus nécessaire de fournir le jeton d'accès pour les mises à niveau ultérieures vers la version « v9.x » ou une version ultérieure.

Pour Usage Meter v4.8, la mise à niveau directe depuis Usage Meter v4.8 vers v9.1 n'est pas prise en charge. Vous devez d'abord effectuer la mise à jour de la version 4.8 vers la version 9.0.1, puis vers la version 9.1. Pour plus d'informations, consultez la section « Parcours de mise à niveau - Matrice d'interopérabilité des produits ».

Avant de passer à la version 9 ou à une version ultérieure, vous devez échanger les clés de licence VMware Cloud Foundation™ ( VCF ).

Procédure d'échange des clés de licence

  1. Obtenez les nouvelles clés de licence Broadcom, puis récupérez les clés de licence VMware Cloud Foundation ( VCF ) à partir de la console VMware Solutions. Pour plus d'informations, voir Récupération des clés de licence VCF.
  2. Obtenir les clés d'extension VMware. Pour plus d'informations, voir Obtention des clés d'extension VMware.
  3. Ajoutez les nouvelles clés de licence à tous les produits VMware, puis attribuez les licences selon les besoins. Pour plus d'informations, voir Gestion des licences de produits VMware.

Procédure de mise à niveau du compteur d'utilisation

Pour mettre à jour Usage Meter, procédez comme suit :

Activation de la connexion SSH

  1. Connectez-vous à la console de gestion de l'appliance VMware vCloud Usage Meter avec l'utilisateur usagemeter via https://<Usage Meter IP>:5480.
  2. Cliquez sur Accès dans le panneau de navigation de gauche.
  3. Sous Paramètres d'accès, cliquez sur Modifier en haut à droite.
  4. Dans la fenêtre Edit access settings, activez le commutateur Enable SSH login. La connexion SSH devient activée.

Montage du fichier ISO de mise à niveau

  1. Téléchargez le fichier ISO de l'Usage Meter à partir du lien suivant :

    • Pour passer de la version Usage Meter v4.8 (ou antérieure) à v9.0.1, utilisez : https://ibm.biz/~V0YiDk0EP.
    • Pour passer de l' v9.0.1 Usage Meter à v9.1.0, utilisez : https://ibm.biz/~aBF0Bw0fU.

  2. Vérifiez la somme de contrôle de l' SHA-2 e à l'aide de la valeur suivante de l' SHA-256:

    • Pour la mise à niveau de Usage Meter v4.8 (ou version antérieure) vers v9.0.1, consultez : ec5c46b4bdae915cb4a289dfbb03077cb802f404692bb3f2501b59b448102797.
    • Pour la mise à niveau de l' v9.0.1 Usage Meter vers v9.1.0, consultez : d1f79f1bcc711c7753c871bd95bc434e8a31bb8fc584fc7ac88b75398be445c1.

    Ouvrez une invite de commande sous Windows® ou une fenêtre de terminal sur Linux® et MacOS, puis exécutez la commande suivante :

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

  3. Dans le client Web VMware vSphere®, connectez-vous à votre instance de serveur vCenter.

  4. Dans le menu Stockage, sélectionnez le datastore où se trouve votre machine virtuelle Usage Meter ( VM ).

  5. Dans l'onglet VMs, cliquez sur Virtual machines et vérifiez que l'Usage Meter se trouve sur votre datastore cible.

  6. Dans l'onglet Fichiers, cliquez sur Télécharger les fichiers. Le fichier ISO commence à être téléchargé.

    Il se peut que vous receviez une erreur concernant les certificats de l'hôte. Pour résoudre ce problème, ouvrez le site URL indiqué dans l'erreur dans un autre onglet du navigateur web et acceptez le certificat. S'il ne se charge pas, vérifiez que l'hôte figure dans le DNS actuel de votre bureau, puis accédez de nouveau à URL.

  7. Une fois le téléchargement terminé, le fichier ISO apparaît dans la liste des fichiers.

  8. Dans le menu Hôtes et clusters, localisez et cliquez avec le bouton droit de la souris sur Usage Meter VM, et sélectionnez Edit settings.

  9. Dans l'onglet Matériel virtuel, sur lecteur CD/DVD, sélectionnez Fichier ISO Datastore, puis cliquez sur OK.

    Si l'option Lecteur CD/DVD ne s'affiche pas, cliquez sur Ajouter un nouveau périphérique.

  10. Dans la fenêtre Sélectionner un fichier, localisez le datastore où vous avez téléchargé le fichier ISO.

  11. Sélectionnez le fichier ISO, puis cliquez sur OK.

  12. Dans la fenêtre Modifier les paramètres, sous l'onglet Matériel virtuel, cochez la case Connecté, puis cliquez sur OK.

Exécution de la commande de mise à niveau

Avant d'exécuter les commandes de mise à niveau de votre Usage Meter, effectuez les étapes suivantes :

  1. Dans le client Web VMware vSphere®, connectez-vous à votre instance de serveur vCenter.
  2. Dans le menu Hôtes et clusters, localisez et cliquez avec le bouton droit de la souris sur Usage Meter VM, et sélectionnez Edit settings.
  3. Dans l'onglet Matériel virtuel, sur le lecteur CD/DVD, décochez la case Connecté, puis cliquez sur OK.
  4. Dans le menu Hôtes et grappes, localisez et cliquez avec le bouton droit de la souris sur Usage Meter VM, puis sélectionnez Snapshots > Take snapshot (Instantanés > Prendre un instantané).
  5. Saisissez un nom pour votre instantané, puis cliquez sur Créer.

Utilisez SSH pour vous connecter à l'Appliance Usage Meter VM et effectuez les étapes suivantes :

  1. Ouvrez une invite de commande sous Windows ou une fenêtre de terminal sur Linux et MacOS et exécutez les commandes suivantes en tant qu'utilisateur de root:

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

    Il se peut que vous deviez exécuter umount /root/upgrade pour démonter toute mise à niveau antérieure avant d'exécuter mount -o loop /dev/cdrom /root/upgrade pour mettre à niveau le compteur d'utilisation VM.

  2. Saisissez le jeton d'accès généré pour le compteur d'utilisation dans la console IBM Cloud® for VMware Solutions. Pour plus d'informations, voir Enregistrer le compteur d'utilisation sur IBM.

  3. Saisissez y pour accepter que l'appareil de mesure de l'utilisation VCF fasse partie de l'organisation du fournisseur IBM.

  4. Saisissez y pour confirmer la création d'un instantané du compteur d'utilisation VM.

    Un message d'erreur concernant le nom d'hôte de l'Usage Meter peut apparaître. Entrez y pour continuer le chemin de mise à niveau.

  5. Le processus de mise à niveau démarre et lorsqu'il est terminé, entrez y pour redémarrer le compteur d'utilisation VM.

  6. Une fois le redémarrage terminé, ouvrez l'Usage Meter URL dans un navigateur web et connectez-vous pour vérifier la version mise à jour. Confirmez ensuite l'état de santé de l'appareil de mesure de l'utilisation.

Après avoir migré le compteur d'utilisation VM, il se peut que vous rencontriez l'erreur Connection control operation failed for disk au cours du processus de mise à niveau. Ce problème peut survenir en raison d'un instantané actif qui conserve un verrou sur le périphérique CD/DVD monté. Pour résoudre ce problème, suivez l'une des procédures suivantes. Cependant, il se peut que vous deviez les compléter toutes pour que la migration du site VM soit réussie.

  1. Supprimez tous les instantanés existants:

    1. Dans le client Web VMware vSphere, connectez-vous à votre instance de serveur vCenter en tant qu'administrateur.
    2. Dans le menu Hôtes et clusters, sélectionnez le compteur d'utilisation VM.
    3. Dans l'onglet Instantanés, sélectionnez SUPPRIMER TOUT ou indiquez l'un des instantanés dont le lecteur de CD/DVD est monté et sélectionnez SUPPRIMER.
    4. Cliquez sur OK.

  2. Déconnecter le lecteur monté :

    1. Dans le client Web vSphere, connectez-vous à votre instance de serveur vCenter en tant qu'administrateur.
    2. Dans le menu Hôtes et clusters, localisez et cliquez avec le bouton droit de la souris sur Usage Meter VM, et sélectionnez Edit settings.
    3. Désactivez la case du lecteur de CD/DVD où vous avez monté le fichier ISO de mise à niveau.
    4. Cliquez sur OK.

  3. Déconnectez le lecteur monté de l'ESXi hébergé:

    1. Dans le client Web vSphere, connectez-vous à votre instance de serveur vCenter en tant qu'administrateur.
    2. Dans le menu Hôtes et clusters, sélectionnez le compteur d'utilisation VM.
    3. Dans l'onglet Résumé, localisez les objets associés et déterminez l'hôte sur lequel se trouve le site VM.
    4. Connectez-vous à l'hôte ESXi en tant que root ou administrateur.
    5. Sélectionnez les machines virtuelles et cliquez avec le bouton droit de la souris sur Usage Meter VM dans la liste.
    6. Cliquez sur Modifier les paramètres.
    7. Sous Lecteur CD/DVD, décochez la case Connecté.
    8. Cliquez sur Sauvegarder.

Remplacement du certificat du compteur d'utilisation

Si vous ne pouvez pas accéder à l'Usage Meter URL ou vous connecter au tableau de bord après la mise à niveau, procédez comme suit pour remplacer le certificat de l'Usage Meter en raison d'un nom d'hôte incompatible :

  1. Utilisez SSH pour vous connecter à l'Usage Meter VM avec le nom d'utilisateur usagemeter.

  2. Exécutez la commande stop.sh All pour arrêter tous les services.

  3. Sous un utilisateur root, exécutez la commande hostnamectl hostname <new hostname> pour mettre à jour le nom d'hôte avec la valeur correcte.

  4. Exécutez les commandes export $(grep -v '^#' "/opt/vmware/cloudusagemetering/platform/conf/env.properties" | xargs) et mv /opt/vmware/cloudusagemetering/platform/security/keystore /opt/vmware/cloudusagemetering/platform/security/keystore.backup pour exporter les variables d'environnement et sauvegarder la base de données existante.

  5. Si le système FIPS est activé, exécutez la commande 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}". S'il est désactivé, exécutez la commande keytool -changealias -alias "usage-meter-platform" -destalias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storepass "${TRUST_STORE_PASSWORD}".

    Si vous exécutez la version FIPS désactivée alors que FIPS est activé, l'erreur keytool error: java.security.KeyStoreException: Unrecognized keystore format. s'affiche. Pour le résoudre, il faut le charger avec un type spécifié.

  6. Créez un répertoire temporaire pour la variable NGINX et exécutez la commande export NGINX_FOLDER=$(mktemp -d) pour la déplacer dans le répertoire cloudusagemetering, puis exécutez cd /opt/vmware/cloudusagemetering pour accéder au nouveau répertoire.

  7. Exécutez la commande ./platform/bin/create-keystore.sh pour créer le nouveau keystore.

  8. Exécutez les commandes rm -rf $NGINX_FOLDER et rm /opt/vmware/cloudusagemetering/platform/security/keystore.backup pour supprimer les fichiers de sauvegarde temporaires.

  9. Si le système FIPS est activé, exécutez la commande 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}" pour supprimer la base de données de sauvegarde. S'il est désactivé, exécutez la commande keytool -delete -alias "usage-meter-platform-backup" -keystore /opt/vmware/cloudusagemetering/platform/security/cacerts -storepass "${TRUST_STORE_PASSWORD}".

  10. Exécutez la commande chmod 0640 /opt/vmware/cloudusagemetering/platform/security/keystore pour mettre à jour les nouvelles autorisations du keystore et redémarrer l'Usage Meter VM.

    En raison du changement de nom d'hôte, il se peut que vous deviez mettre à jour votre entrée DNS avec le nouveau nom d'hôte ou l'ajouter si elle n'existe pas. Si vous êtes redirigé vers la page de connexion avec une erreur OAuth, effacez toutes les entrées DNS existantes pour Usage Meter et réessayez.

  11. Une fois le redémarrage terminé, ouvrez l'Usage Meter URL dans un navigateur Web pour vérifier la version mise à jour.