Comment puis-je migrer ma licence d'instance EC2 BYOL RHEL vers une licence RHUI ?

Résolution

Important : Avant d'arrêter et de démarrer votre instance, effectuez les actions suivantes :

• Créez un instantané de votre volume Amazon Elastic Block Store (Amazon EBS).
  Remarque : Si votre instance est sauvegardée par un stockage d'instances ou si ses volumes de stockage d'instances contiennent des données, Amazon EC2 supprime les données lorsque vous arrêtez l'instance.
• Supprimez temporairement l'instance de son groupe Amazon EC2 Auto Scaling lorsque vous avez terminé les étapes de résolution.
  Remarque : Si vous arrêtez une instance qui se trouve dans un groupe Auto Scaling Amazon EC2, vous pouvez la résilier en fonction de vos paramètres de protection de réduction horizontale. Les instances que vous lancez avec Amazon EMR, AWS CloudFormation ou AWS Elastic Beanstalk peuvent faire partie d'un groupe Auto Scaling.
• Définissez le comportement d'arrêt de l'instance** sur **Arrêter pour vous assurer que les instances ne se résilient pas lorsque vous les arrêtez.

Remarque : Lorsque vous arrêtez et démarrez une instance, son adresse IP publique change. Une bonne pratique consiste à utiliser une adresse IP Elastic pour acheminer le trafic externe vers votre instance au lieu d'une adresse IP publique. Si vous utilisez Amazon Route 53, vous devrez peut-être mettre à jour les enregistrements DNS Route 53 lorsque l'adresse IP publique change.

Pour migrer votre instance vers une licence RHUI, procédez comme suit :

1. Si vous utilisez un proxy sur votre instance, désactivez le proxy pour l'adresse IP du service de métadonnées d'instance (IMDS).

2. Pour déterminer si votre instance utilise une licence BYOL ou AWS, exécutez la commande suivante en fonction de la version de votre IMDS :
   IMDSv1 :

   curl http://169.254.169.254/latest/dynamic/instance-identity/document 2>/dev/null | grep billingProducts

   IMDSv2 :

   curl --noproxy '*' -w "\n" -s \
    -H "X-aws-ec2-metadata-token: \
    $(curl --noproxy '*' -s -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 300")" \
    http://169.254.169.254/latest/dynamic/instance-identity/document \
    | grep billingProducts

   Exemple de sortie :

   $ curl http://169.254.169.254/latest/dynamic/instance-identity/document 2>/dev/null | grep billingProducts
    "billingProducts" : null,

   Remarque : Si billingProducts est null, l'instance utilise BYOL.

3. Utilisez une Amazon Machine Image (AMI) AWS Marketplace pour lancer une nouvelle instance RHEL avec la même version RHEL que l'instance d'origine. Assurez-vous d'utiliser la même zone de disponibilité que l'instance d'origine, puis sélectionnez un type d'instance similaire.

4. Exécutez la commande suivante pour vérifier le code de facturation de l'instance, puis vérifiez que la nouvelle instance utilise RHUI :

   curl http://169.254.169.254/latest/dynamic/instance-identity/document 2>/dev/null | grep billingProducts
    "billingProducts" : [ "bp-6fa54006" ],

5. Exécutez la commande suivante pour vérifier que le package client RHUI est installé sur la nouvelle instance :

    sudo rpm -qa | grep rhui

   Exemple de sortie :

   $ sudo rpm -qa | grep rhui
   rh-amazon-rhui-client-4.0.4-1.el8.noarch

6. Exécutez l'une des commandes suivantes pour télécharger mais pas installer le fichier RPM du package client RHUI sur la nouvelle instance :

   sudo yum install --downloadonly --downloaddir=/tmp rh-amazon-rhui-client -y

   -ou-

   sudo yumdownloader --downloaddir=/tmp rh-amazon-rhui-client

7. Exécutez la commande suivante pour vérifier que vous avez correctement téléchargé le package RPM sur la nouvelle instance :

   ls -l /tmp | grep rh-amazon-rhui-client
   -rw-r--r--. 1 root root 43680 Mar 4 19:42 rh-amazon-rhui-client-4.0.5-1.el8.noarch.rpm

8. Exécutez l'une des commandes suivantes pour copier le fichier RPM du client RHUI de la nouvelle instance vers l'instance d'origine :

   scp /tmp/rh-amazon-rhui-client-*.rpm ec2-user@BYOL-instance-ip:/tmp/

   -ou-

   rsync -avz /tmp/rh-amazon-rhui-client-*.rpm ec2-user@BYOL-instance-ip:/tmp/

9. Exécutez la commande suivante pour supprimer la configuration et les packages RHUI existants de l'instance d'origine :

   sudo yum remove $(rpm -qa | grep rhui) -y

10. Exécutez la commande suivante pour utiliser le fichier RPM copié afin d'installer le client RHUI sur l'instance d'origine :

sudo yum install /tmp/rh-amazon-rhui-client-*.rpm -y

11. Exécutez la commande suivante pour vérifier que vous avez correctement installé le package sur l'instance d'origine :

sudo rpm -qa | grep rhui

12. Ouvrez la console Amazon EC2, puis notez la configuration réseau de votre instance d'origine, telle que l'adresse IP, l'adresse IP Elastic et les groupes de sécurité. Vous devrez peut-être créer ces paramètres dans la nouvelle instance.
13. Arrêtez les nouvelles instances et les instances d’origine.
14. Détachez tous les volumes Amazon EBS des deux instances. Notez les noms ou les ID de périphérique de chaque volume sur l'instance d'origine.
15. Attachez les volumes de l'instance d'origine à la nouvelle instance.
    **Remarque :**Utilisez les mêmes noms de périphériques que ceux que portaient les volumes sur l'instance d'origine :
16. Démarrez la nouvelle instance.
17. Connectez-vous à la nouvelle instance, puis exécutez la commande suivante pour vérifier que vous pouvez obtenir le code de facturation :

curl http://169.254.169.254/latest/dynamic/instance-identity/document 2>/dev/null | grep billingProducts
"billingProducts" : [ "bp-6fa54006" ],

18. Exécutez la commande suivante pour vérifier que la configuration du référentiel est correcte :

sudo yum clean all
sudo yum repolist

19. Supprimez les volumes détachés de l'instance d'origine si vous n'en avez plus besoin. Vous pouvez les conserver en tant que sauvegarde lorsque vous validez vos mises à jour.

Résoudre les problèmes

Si l'instance ne démarre pas après avoir échangé des volumes, vérifiez que vous avez associé les volumes aux noms de périphériques corrects. Si les problèmes persistent, créez un instantané du volume racine et répétez les étapes de résolution.

Si vous ne pouvez pas accéder au référentiel, exécutez la commande suivante pour vérifier que vous avez installé le client RHUI :

rpm -qa | grep rhui

Vérifiez également votre connectivité réseau au serveur de métadonnées.

Informations connexes

Migrer les systèmes BYOL RHEL vers des instances incluses dans les licences AWS à l'aide d'AWS Application Migration Service

Questions fréquentes relatives à Red Hat Enterprise Linux sur Amazon EC2