Citrix Hypervisor

Résoudre les problèmes de mise en réseau

Important :

La mise à jour cumulative 1 de Citrix Hypervisor 8.2 prend fin le 25 juin 2025. Planifiez votre mise à niveau vers XenServer 8 dès maintenant pour assurer une transition en douceur et un support continu. Pour plus d’informations, consultez Mise à niveau.

Si vous utilisez vos fichiers de licence Citrix Virtual Apps and Desktops pour obtenir une licence pour vos hôtes Citrix Hypervisor 8.2 Cumulative Update 1, ces fichiers de licence ne sont pas compatibles avec XenServer 8. Avant la mise à niveau, vous devez acquérir les fichiers de licence socket XenServer Premium Edition à utiliser avec XenServer 8. Ces fichiers de licence de socket sont disponibles en tant que droits des abonnements Citrix pour le cloud privé, Citrix Universal Hybrid Multi-Cloud, Citrix Universal MSP et Citrix Platform License pour l’exécution de vos charges de travail Citrix. Les clients Citrix qui n’ont pas encore migré vers ces nouveaux abonnements peuvent demander à participer à une promotion gratuite pour 10 000 licences de sockets XenServer Premium Edition. Pour plus d’informations, consultez XenServer.

Si vous n’obtenez pas de licence compatible pour XenServer 8 avant la mise à niveau, lorsque vous mettez à niveau vos hôtes, ils reviennent à l’édition d’essai de 90 jours. L’édition d’essai offre les mêmes fonctionnalités que l’édition Premium, avec quelques limitations. Pour plus d’informations, consultez Présentation des licences XenServer 8.

Si vous rencontrez des problèmes lors de la configuration de la mise en réseau, assurez-vous d’abord que vous n’avez pas directement modifié le domaine de contrôle ifcfg-* Fichiers. L’agent hôte du domaine de contrôle gère le ifcfg fichiers directement, et toutes les modifications sont écrasées.

Diagnostic de la corruption du réseau

Certains modèles de cartes réseau nécessitent des mises à niveau du micrologiciel de la part du fournisseur pour fonctionner de manière fiable en charge ou lorsque certaines optimisations sont activées. Si vous constatez que le trafic vers les machines virtuelles est corrompu, essayez d’obtenir le dernier microprogramme auprès de votre fournisseur, puis appliquez une mise à jour du BIOS.

Si le problème persiste, vous pouvez utiliser l’interface de ligne de commande pour désactiver les optimisations de déchargement de réception ou de transmission sur l’interface physique.

Avertissement :

La désactivation des optimisations de déchargement de réception ou de transmission peut entraîner une perte de performances et une utilisation accrue du processeur.

Tout d’abord, déterminez l’UUID de l’interface physique. Vous pouvez filtrer sur le appareil comme suit :

  xe pif-list device=eth0
<!--NeedCopy-->

Ensuite, définissez le paramètre suivant sur le PIF pour désactiver le déchargement TX :

  xe pif-param-set uuid=pif_uuid other-config:ethtool-tx=off
<!--NeedCopy-->

Enfin, rebranchez le PIF ou redémarrez l’hôte pour que la modification prenne effet.

Réinitialisation d’urgence du réseau

Des paramètres réseau incorrects peuvent entraîner une perte de connectivité réseau. Lorsqu’il n’y a pas de connectivité réseau, le serveur Citrix Hypervisor peut devenir inaccessible via XenCenter ou SSH distant. La réinitialisation d’urgence du réseau fournit un mécanisme simple pour récupérer et réinitialiser le réseau d’un hôte.

La fonction de réinitialisation d’urgence du réseau est disponible à partir de l’interface de ligne de commande à l’aide de la fonction xe-reset-networking et dans la commande Interface réseau et gestion section de xsconsole.

Les paramètres incorrects qui entraînent une perte de connectivité réseau incluent le renommage des interfaces réseau, la création de liaisons ou de VLAN, ou des erreurs lors de la modification de l’interface de gestion. Par exemple, si vous saisissez une adresse IP incorrecte. Vous pouvez également exécuter cet utilitaire dans les scénarios suivants :

  • Lorsqu’une mise à niveau de pool propagée, une mise à niveau manuelle, l’installation d’un correctif ou l’installation d’un pilote entraîne un manque de connectivité réseau, ou

  • Si un maître de pool ou un hôte d’un pool de ressources ne peut pas entrer en contact avec d’autres hôtes.

Utilisez le xe-reset-networking utilitaire uniquement en cas d’urgence, car il supprime la configuration de tous les PIF, liaisons, VLAN et tunnels associés à l’hôte. Les réseaux invités et les VIF sont conservés. Dans le cadre de cet utilitaire, les machines virtuelles sont arrêtées de force. Avant d’exécuter cette commande, arrêtez proprement les machines virtuelles dans la mesure du possible. Avant d’appliquer une réinitialisation, vous pouvez modifier l’interface de gestion et spécifier la configuration IP, DHCP ou Static qui peut être utilisée.

Si le maître de pool nécessite une réinitialisation du réseau, réinitialisez d’abord le réseau sur le maître de pool avant d’appliquer une réinitialisation du réseau aux membres du pool. Appliquez la réinitialisation du réseau sur tous les hôtes restants du pool pour vous assurer que la configuration réseau du pool est homogène. L’homogénéité du réseau est un facteur important pour la migration en direct.

Remarque :

Si l’adresse IP du maître de pool (l’interface de gestion) change à la suite d’une réinitialisation du réseau ou xe host-management-reconfigure, appliquez la commande network reset aux autres hôtes du pool. Cela permet de s’assurer que les membres du pool peuvent se reconnecter au maître de pool sur sa nouvelle adresse IP. Dans ce cas, l’adresse IP du Pool Master doit être renseignée.

La réinitialisation du réseau n’est PAS prise en charge lorsque la haute disponibilité est activée. Pour réinitialiser la configuration réseau dans ce scénario, vous devez d’abord désactiver manuellement la haute disponibilité, puis exécuter la commande de réinitialisation du réseau.

Vérification de la réinitialisation du réseau

Après avoir spécifié le mode de configuration à utiliser après la réinitialisation du réseau, xsconsole et les paramètres d’affichage de l’interface de ligne de commande qui seront appliqués après le redémarrage de l’hôte. C’est une dernière chance de modifier avant d’appliquer la commande de réinitialisation d’urgence du réseau. Après le redémarrage, la nouvelle configuration réseau peut être vérifiée dans XenCenter et xsconsole. Dans XenCenter, une fois l’hôte sélectionné, sélectionnez l’icône Réseautage pour voir la nouvelle configuration réseau. La section Interface réseau et de gestion de xsconsole Affichez ces informations.

Remarque :

Exécutez une réinitialisation d’urgence du réseau sur d’autres membres du pool pour répliquer les liaisons, les VLAN ou les tunnels à partir de la nouvelle configuration du maître de pool.

Utilisation de l’interface de ligne de commande pour la réinitialisation du réseau

Le tableau suivant présente les paramètres facultatifs disponibles qui peuvent être utilisés en exécutant la commande xe-reset-networking commander.

Avertissement :

Il incombe à l’utilisateur de s’assurer de la validité des paramètres de la xe-reset-networking et de vérifier soigneusement les paramètres. Si vous spécifiez des paramètres non valides, la connectivité et la configuration du réseau peuvent être perdues. Dans ce cas, nous vous conseillons de réexécuter la commande xe-reset-networking sans utiliser de paramètres.

Réinitialisation de la configuration réseau de l’ensemble d’un pool devoir Commencer sur le maître de pool, puis réinitialiser le réseau sur tous les hôtes restants du pool.

Paramètre Obligatoire/Facultatif Description
-m, --maître Facultatif Adresse IP de l’interface de gestion du Pool Master. Par défaut, il s’agit de la dernière adresse IP connue du maître de pool.
--device Facultatif Nom de l’appareil de l’interface de gestion. Par défaut, le nom de l’appareil spécifié lors de l’installation est défini par défaut.
--mode=static Facultatif Active les quatre paramètres réseau suivants pour la configuration IP statique de l’interface de gestion. S’il n’est pas spécifié, la mise en réseau est configurée à l’aide de DHCP.
--ip Obligatoire, si mode=statique Adresse IP de l’interface de gestion de l’hôte. Valable uniquement si mode=statique.
--netmask Obligatoire, si mode=statique Masque de réseau pour l’interface de gestion. Valable uniquement si mode=statique.
--gateway Facultatif Passerelle pour l’interface de gestion. Valable uniquement si mode=statique.
--dns Facultatif Serveur DNS pour l’interface de gestion. Valable uniquement si mode=statique.
--vlan Facultatif Balise VLAN pour l’interface de gestion. Par défaut, la balise VLAN spécifiée lors de l’installation est utilisée par défaut.

Exemples de ligne de commande Pool Master

Exemples de commandes pouvant être appliquées sur un Pool Master :

Pour réinitialiser la mise en réseau pour la configuration DHCP :

  xe-reset-networking
<!--NeedCopy-->

Pour réinitialiser la mise en réseau pour la configuration IP statique :

  xe-reset-networking --mode= static --ip=ip-address \
      --netmask=netmask --gateway=gateway \
      --dns=dns
<!--NeedCopy-->

Pour réinitialiser la mise en réseau pour la configuration DHCP si une autre interface est devenue l’interface de gestion après la configuration initiale :

  xe-reset-networking --device=device-name
<!--NeedCopy-->

Pour réinitialiser la mise en réseau pour la configuration IP statique si une autre interface est devenue l’interface de gestion après la configuration initiale :

  xe-reset-networking --device=device-name --mode=static \
      --ip=ip-address --netmask=netmask \
      --gateway=gateway --dns=dns
<!--NeedCopy-->

Pour réinitialiser la mise en réseau de l’interface de gestion sur VLAN :

  xe-reset-networking --vlan=VLAN TAG
<!--NeedCopy-->

Remarque :

Le reset-réseau peut également être utilisée avec les paramètres de configuration IP.

Exemples de ligne de commande de membre de pool

Tous les exemples précédents s’appliquent également aux membres du pool. De plus, l’adresse IP du maître de pool peut être spécifiée (ce qui est nécessaire si elle a changé).

Pour réinitialiser la mise en réseau pour la configuration DHCP :

  xe-reset-networking
<!--NeedCopy-->

Pour réinitialiser la mise en réseau pour DHCP si l’adresse IP du maître de pool a été modifiée :

  xe-reset-networking --master=master-ip-address
<!--NeedCopy-->

Pour réinitialiser la mise en réseau pour la configuration IP statique, en supposant que l’adresse IP du maître de pool n’a pas changé :

  xe-reset-networking --mode=static --ip=ip-address --netmask=netmask \
      --gateway=gateway --dns=dns
<!--NeedCopy-->

Pour réinitialiser la mise en réseau pour la configuration DHCP si l’interface de gestion et l’adresse IP du maître de pool ont été modifiées après la configuration initiale :

  xe-reset-networking --device=device-name --master=master-ip-address
<!--NeedCopy-->
Résoudre les problèmes de mise en réseau