Comment installer et activer le dernier pilote ENA pour mise en réseau améliorée sur une instance EC2 qui exécute RHEL ?

Résolution

Remarque : Si des erreurs surviennent lorsque vous exécutez des commandes de l'interface de la ligne de commande AWS (AWS CLI), consultez la section Résoudre des erreurs liées à l’AWS CLI. Vérifiez également que vous utilisez bien la version la plus récente de l’AWS CLI.

Certaines versions antérieures du système d'exploitation RHEL n'incluent pas de pilote ENA. Pour les instances Nitro, vous devez mettre à jour le pilote ENA si vous modifiez votre type d'instance EC2 pour la connectivité réseau. Pour installer le dernier pilote ENA sur votre instance EC2, effectuez les étapes suivantes en fonction de votre version de RHEL.

Avant d'installer ou de mettre à jour un pilote ENA, il est recommandé de créer un instantané du volume Amazon Elastic Block Store (Amazon EBS) de votre instance.

Pour plus d'informations sur la mise à jour des pilotes Linux, consultez la section Guide des bonnes pratiques et d’optimisation des performances du pilote ENA sur Linux sur le site Web de GitHub.

Important : Lorsque vous arrêtez une instance, Amazon EC2 supprime toutes les données des volumes de stockage d'instances. Pour vérifier le type de périphérique racine, consultez la section Déterminer le type de périphérique racine de votre AMI. Vous devez sauvegarder les données stockées sur un volume de stockage d'instances si vous souhaitez conserver ces données.

RHEL version 7.4 et versions ultérieures

Par défaut, le pilote ENA pour la mise en réseau améliorée est installé sur RHEL version 7.4 et versions ultérieures des Amazon Machine Images (AMI). Pour plus d'informations, consultez la section Activer la mise en réseau améliorée avec ENA sur vos instances EC2.

Versions RHEL antérieures à 7.4

Pour installer le pilote ENA, procédez comme suit :

1. Exécutez la commande suivante pour mettre à niveau le noyau vers la dernière version :

   sudo yum upgrade kernel -y

2. Arrêtez l’instance.

3. Pour mettre à jour l'instance, exécutez la commande modify-instance-attribute de l'AWS CLI suivante :

   aws ec2 modify-instance-attribute --instance-id exampleID --ena-support --region exampleRegion

   Remarque : Remplacez exampleID par l’ID de votre instance et exampleRegion par votre région AWS.

4. Démarrez l'instance.

5. Pour vérifier que vous avez correctement installé le pilote ENA sur l'instance, exécutez la commande suivante :

   ethtool -i eth0

   Remarque : Remplacez eth0 par le nom de l'interface que vous souhaitez vérifier. Si votre système d'exploitation utilise des noms de réseau prévisibles, il se peut que le nom du réseau soit différent. Pour plus d'informations, consultez la page Comprendre les noms de périphériques d'interface réseau prévisibles sur le site Web de Red Hat.

RHEL 6

Remarque : RHEL 6 n'inclut pas les pilotes NVMe prêts à la production pour Amazon EC2, et vous ne pouvez pas effectuer de mise à niveau vers des pilotes NVME. Pour utiliser une instance basée sur Nitro ou tout autre type d'instance avec des volumes de stockage d'instances NVMe, effectuez une mise à niveau vers RHEL 7.4 ou une version ultérieure.

Télécharger et installer le pilote ENA

Procédez comme suit :

1. Pour mettre à jour le noyau et redémarrer le système afin d'utiliser le noyau le plus récent, exécutez la commande suivante :

   sudo yum upgrade kernel -y && sudo reboot

2. Pour installer le package de développement afin de créer des modules de noyau qui correspondent au noyau, exécutez les commandes suivantes :

   sudo yum install kernel-devel-$(uname -r) gcc git patch rpm-build wget -ycd /usr/src/
   sudo wget https://github.com/amzn/amzn-drivers/archive/master.zip
   sudo unzip master.zip
   cd amzn-drivers-master/kernel/linux/ena
   sudo make

3. Pour copier le module dans le répertoire de modules, exécutez la commande suivante :

   sudo cp ena.ko /lib/modules/$(uname -r)/

4. Pour régénérer les fichiers de mappage des dépendances de modules de noyau, exécutez la commande suivante :

   sudo depmod

5. Pour vérifier la présence du module ENA, exécutez la commande suivante :

   modinfo ena

   Lorsque vous compilez et installez le pilote ENA sur votre système, la version peut être ultérieure à 2.2.11g. La sortie de la commande affiche les informations du pilote ENA.
   Exemple de sortie :

   filename:       /lib/modules/2.6.32-754.33.1.el6.x86_64/ena.koversion:        2.2.11g
   license:        GPL
   description:    Elastic Network Adapter (ENA)
   author:         Amazon.com, Inc. or its affiliates
   retpoline:      Y
   srcversion:     17C7CD1CEAD3F0ADB3A5E5E
   alias:          pci:v00001D0Fd0000EC21sv*sd*bc*sc*i*
   alias:          pci:v00001D0Fd0000EC20sv*sd*bc*sc*i*
   alias:          pci:v00001D0Fd00001EC2sv*sd*bc*sc*i*
   alias:          pci:v00001D0Fd00000EC2sv*sd*bc*sc*i*
   alias:          pci:v00001D0Fd00000051sv*sd*bc*sc*i*
   depends:        
   vermagic:       2.6.32-754.33.1.el6.x86_64 SMP mod_unload modversions
   parm:           debug:Debug level (0=none,...,16=all) (int)
   parm:           rx_queue_size:Rx queue size. The size should be a power of 2. Max value is 8K
    (int)
   parm:           force_large_llq_header:Increases maximum supported header size in LLQ mode to 224 bytes, while reducing the maximum TX queue size by half.
    (int)
   parm:           num_io_queues:Sets number of RX/TX queues to allocate to device. The maximum value depends on the device and number of online CPUs.
    (int)

6. Pour ajouter net.ifnames=0 à /boot/grub/grub.conf et désactiver la dénomination de l'interface réseau, exécutez la commande suivante :

   sudo sed -i '/kernel/s/$/ net.ifnames=0/' /boot/grub/grub.conf

7. Arrêtez l’instance.

8. Pour activer la prise en charge réseau améliorée au niveau de l'instance, exécutez la commande modify-instance-attribute suivante :

   aws ec2 modify-instance-attribute --instance-id exampleID --ena-support --region exampleRegion

   Remarque : Remplacez exampleID par l’ID de votre instance et exampleRegion par votre région.

9. Remplacez le type d'instance par un type d'instance prenant en charge l'ENA.

10. Démarrez l'instance.

11. Utilisez SSH pour vous connecter à l'instance, puis exécutez la commande suivante pour vérifier que vous avez correctement installé le pilote ENA :

ethtool -i eth0

Exemple de sortie :

driver: enaversion: 2.2.11g
firmware-version:
bus-info: 0000:00:05.0
supports-statistics: yes
supports-test: no
supports-eeprom-access: no
supports-register-dump: no
supports-priv-flags: no

(Facultatif) Configurer le programme DKMS

Si votre application dépend directement de la version ENA, configurez le programme Dynamic Kernel Module Support (DKMS). Cela garantit qu'Amazon EC2 inclut le pilote dans les futures mises à niveau du noyau.

Remarque : Vous pouvez utiliser le référentiel EPEL (Extra Packages for Enterprise Linux) dans une instance RHEL.

Pour configurer le programme DKMS, procédez comme suit :

1. Pour installer le fichier Red Hat Package Manager (rpm), exécutez la commande suivante :

   sudo yum install https://archives.fedoraproject.org/pub/archive/epel/6/x86_64/epel-release-6-8.noarch.rpm -y

   Remarque : Pour obtenir la liste des derniers packages .rpm, consultez la page Packages disponibles dans EPEL sur le site Web de Fedora Project.

2. Pour installer DKMS, exécutez la commande suivante :

   sudo yum install dkms -y

3. Pour supprimer le noyau existant, exécutez la commande suivante :

   VER=$( grep ^VERSION /usr/src/amzn-drivers-master/kernel/linux/rpm/Makefile | cut -d' ' -f2 )

4. Pour copier les fichiers source dans le répertoire source, exécutez la commande suivante :

   sudo cp -a /usr/src/amzn-drivers-master /usr/src/amzn-drivers-${VER}

5. Pour créer le fichier de configuration DKMS, compiler et installer le module ENA, exécutez la commande suivante :

   sudo cat <<EOM | sudo tee /usr/src/amzn-drivers-${VER}/dkms.confPACKAGE_NAME="ena"
   PACKAGE_VERSION="$VER"
   CLEAN="make -C kernel/linux/ena clean"
   MAKE="make -C kernel/linux/ena/ BUILD_KERNEL=\${kernelver}"
   BUILT_MODULE_NAME[0]="ena"
   BUILT_MODULE_LOCATION="kernel/linux/ena"
   DEST_MODULE_LOCATION[0]="/updates"
   DEST_MODULE_NAME[0]="ena"
   AUTOINSTALL="yes"
   EOM
   
   sudo dkms add -m amzn-drivers -v $VER
   sudo dkms build -m amzn-drivers -v $VER
   sudo dkms install -m amzn-drivers -v $VER