Documentation sur Oracle Cloud Infrastructure

Dépannage des attachements de volume ultra-haute performance

Cette rubrique décrit les étapes de dépannage que vous pouvez suivre ainsi que les préalables à la vérification des volumes configurés pour le niveau Ultra-haute performance lorsque le volume ne peut pas être attaché ou que l'attachement de volume n'est pas multichemin.

Dépannage des échecs d'attachement de volume

Le plugiciel de gestion des volumes par blocs est obligatoire pour les volumes configurés pour le niveau Ultra-haute performance et attachés à l'aide du type d'attachement iSCSI. En cas d'échec de l'attachement du volume à l'instance, le problème est probablement dû à une configuration incorrecte du plugiciel de gestion des volumes par blocs. Consultez les suggestions de dépannage de cette section pour en savoir plus sur ces problèmes.

Erreur de journal du plugiciel de gestion des volumes par blocs : attachement de volume non autorisé ou introuvable

Si vous n'avez pas configuré les autorisations correctement pour le plugiciel de gestion des volumes par blocs, le volume ne pourra pas être attaché à l'instance.

Détails

Le volume ne s'affichera pas comme attaché dans la console et vous verrez un message d'erreur NotAuthorizedOrNotFound dans le journal du plugiciel de gestion des volumes par blocs.

Le journal du plugiciel de gestion des volumes par blocs se trouve dans :

"/var/log/oracle-cloud-agent/plugins/oci-blockautoconfig/oci-blockautoconfig.log

Voici un exemple d'entrée de journal d'erreurs pour ce problème :

2021/08/13 09:14:25.864932 compute_client_command.go:255: Updating volume attachment to the state LOGIN_SUCCEEDED ...
2021/08/13 09:14:26.155473 compute_client_command.go:260: Service error:NotAuthorizedOrNotFound.
volume attachment ocid1.volumeattachment.oc1.iad.<volume-attachment_ID> not found.
http status code: 404. Opc request id: <request_ID>

Cause

Le plugiciel de gestion des volumes par blocs ne dispose pas des autorisations suffisantes pour envoyer l'avis de statut de connexion iSCSI au service.

Résolution

Pour configurer les autorisations pour le plugiciel de gestion des volumes par blocs :

  1. Créer un groupe dynamique : Créez un groupe dynamique avec les règles de correspondance de l'exemple de code suivant afin d'inclure toutes les instances des compartiments spécifiés :

    ANY {instance.compartment.id = 'ocid1.tenancy.oc1..<tenancy_ID>', instance.compartment.id = 'ocid1.compartment.oc1..<compartment_OCID>'

  2. Configurer une politique pour un groupe dynamique : Configurez une politique qui accorde des autorisations au groupe dynamique créé à l'étape précédente afin de permettre à l'agent d'instance d'appeler le service de volume par blocs pour extraire la configuration des attachements :

    Allow dynamic-group InstantAgent to use instances in tenancy
Allow dynamic-group InstantAgent to use volume-attachments in tenancy

Ressources

Erreur de journal du plugiciel de gestion des volumes par blocs : l'agent utilisateur ne peut pas être vide

L'instance de calcul doit avoir une adresse IP publique ou une passerelle de service pour pouvoir se connecter aux services Oracle, sinon le volume ne pourra pas être attaché.

Détails

Le volume ne s'affichera pas comme attaché dans la console et vous verrez un message d'erreur user agent can not be blank dans le journal du plugiciel de gestion des volumes par blocs.

Le journal du plugiciel de gestion des volumes par blocs se trouve dans :

"/var/log/oracle-cloud-agent/plugins/oci-blockautoconfig/oci-blockautoconfig.log

Voici un exemple d'entrée de journal d'erreurs pour ce problème :

2021/10/15 22:16:07.881953 compute_client_command.go:255: Updating volume attachment to the state LOGIN_SUCCEEDED ...
2021/10/15 22:16:07.882185 compute_client_command.go:260: user agent can not be blank
2021/10/15 22:16:07.882204 iscsi_commands_helper.go:302: user agent can not be blank
2021/10/15 22:16:07.882212 iscsi_commands_helper.go:310: user agent can not be blank

Cause

Le plugiciel de gestion des volumes par blocs ne peut pas envoyer l'avis de statut de connexion iSCSI au service en raison de la configuration du réseau.

Résolution

Si l'instance n'a pas d'adresse IP publique, configurez une passerelle de service sur le réseau en nuage virtuel. La passerelle de service permet à votre instance d'accéder aux services Oracle en privé, sans exposer les données sur l'Internet public. Ci-dessous se trouvent des notes spéciales afin de configurer la passerelle de service pour utiliser le plugiciel de gestion des volumes par blocs :

  • Lors de la création de la passerelle de service, activez l'option Tous les services de <region> dans Oracle Services Network.
  • Lors de la configuration du routage pour le sous-réseau qui contient l'instance, configurez une règle de routage dont le type de cible est réglé à Passerelle de service et le service de destination à Tous les services de <region> dans Oracle Services Network.

Pour des instructions détaillées, voir Accès aux services Oracle : Passerelle de service.

Ressources

L'attachement de volume n'est pas multichemin

Lorsque vous attachez un volume configuré pour le niveau Ultra-haute performance, pour atteindre la performance optimale, l'attachement de volume doit être activé pour la configuration multichemin. Le service Volumes par blocs tente d'activer l'attachement pour la configuration multichemin lorsque le volume est attaché. Si tous les préalables n'ont pas été considérés, l'attachement de volume ne sera pas activé pour la configuration multichemin.

Vérifier si un attachement de volume est multichemin

Pour vérifier si un attachement de volume est multichemin dans la console à partir de la page Détails du volume :

  1. Ouvrez le menu de navigation et sélectionnez Stockage. Sous Stockage par blocs, sélectionnez Volumes par blocs.

  2. Sélectionnez le volume par blocs pour lequel vous voulez vérifier l'attachement de volume.

  3. Sélectionnez Instances attachées dans la section Ressources.

  4. Vérifiez la valeur affichée dans la colonne Multichemin.

    • Oui : Le volume est configuré pour le niveau Ultra-haute performance et l'attachement de volume est activé pour la configuration multichemin. Aucune autre action n'est requise.

    • Non : Le volume n'est pas configuré pour le niveau Ultra-haute performance. Il n'est pas nécessaire que le volume soit multichemin. Aucune autre action n'est requise.
    • Non avec une icône d'avertissement : Le volume est configuré pour le niveau Ultra-haute performance, mais l'attachement de volume n'est pas activé pour la configuration multichemin. Pour optimiser la performance, vous devez vous assurer que le volume est attaché à une forme d'instance prise en charge et que les préalables requis sont configurés.

Si le volume est configuré pour le niveau Ultra-haute performance, mais pas pour la configuration multichemin, la colonne Multipath contient Non avec une icône d'avertissement.

Pour des procédures supplémentaires permettant de vérifier si un volume est activé pour la configuration multichemin, notamment à l'aide de l'interface de ligne de commande ou de l'API, voir Vérifier si un attachement de volume est activé pour plusieurs chemins.

Si votre volume n'est pas multichemin, pour résoudre le problème, consultez les informations décrites dans cette section et résolvez les problèmes éventuels.

L'instance doit être basée sur une forme de calcul prise en charge

Vous devez attacher un volume configuré pour le niveau Ultra-haute performance à une instance basée sur une forme prise en charge et configurée pour au moins 16 coeurs.

Formes prises en charge

Toutes les formes sans système d'exploitation courantes prennent en charge les attachements iSCSI multichemins. Voir Formes sans système d'exploitation pour plus d'informations sur les caractéristiques de performance des volumes par blocs attachés à des instances sans système d'exploitation.

Les formes de machine virtuelle courantes configurées pour 16 coeurs ou plus prennent en charge les attachements multichemins. Pour plus d'informations sur les caractéristiques de performance des volumes attachés à des machines virtuelles, voir Formes de machine virtuelle pour les volumes iSCSI et paravirtualisés.

Résolution

Si le volume n'est pas attaché à une instance avec une configuration de forme prise en charge, vous devez détacher le volume et l'associer à une instance avec une configuration de forme prise en charge.

Vous pouvez également modifier l'instance existante afin qu'elle ait la configuration de forme correcte. Toutefois, vous devez vous assurer de détacher et de rattacher le volume après avoir modifié l'instance.

Avertissement

Si l'instance comporte moins de 8 OCPU, vous constaterez peut-être un problème. Une fois que vous avez modifié l'instance pour prendre en charge les attachements multichemins, l'attachement de volume n'est toujours pas activé pour la configuration multipathique, même après que vous avez détaché et rattaché le volume. Dans ce scénario, vous devez créer de nouveau l'instance à partir d'une forme prise en charge, puis attacher le volume à la nouvelle instance. Pour plus d'informations, voir L'attachement de volume paravirtualisé n'est pas activé pour la configuration multichemin après le redimensionnement de l'instance.

Ressources

L'image de calcul doit prendre en charge les attachements multichemins

Vous devez attacher un volume configuré pour le niveau Ultra-haute performance à une instance exécutant une image qui prend en charge les attachements multichemins. Cela inclut les images personnalisées.

Images prises en charge pour les attachements iSCSI

Seules les images de plate-forme exécutant Oracle Linux ou les images personnalisées basées sur une image Oracle Linux prennent en charge les attachements multichemins.

Utilisez l'une des dernières images de plate-forme Oracle Linux, avec une version UEK6U1 ou ultérieure de Unbreakable Enterprise Kernel (UEK).

Pour les images personnalisées, la version de Unbreakable Enterprise Kernel (UEK) doit également être UEK6U1 ou ultérieure. La version UEK6U1 d'UEK est associé à la version principale du noyau 5.4.17-2036, publiée en novembre 2020. Vous devez également mettre à jour la propriété Storage.Iscsi.MultipathDeviceSupported pour l'image personnalisée à true et relancer l'instance. Pour plus d'informations, voir Configuration des capacités d'image pour les images personnalisées

Images prises en charge pour les attachements paravirtualisés

Pour les attachements multichemins, l'instance attachée doit exécuter une des images suivantes ou une image personnalisée basée sur une de ces images :

  • Oracle Linux
  • Ubuntu
  • CentOS
  • Windows
Note

Les attachements multichemins ne sont pas pris en charge pour les instances Oracle Autonomous Linux.

Utilisez l'une des dernières images de plate-forme Oracle Linux, avec une version UEK6U1 ou ultérieure de Unbreakable Enterprise Kernel (UEK).

Ressources

Rattacher le volume

Si vous avez mis à jour la configuration de forme ou remplacé l'image d'une instance par une autre qui prend en charge les attachements multichemins, vous devez détacher le volume de l'instance, puis le rattacher à l'instance.

Ressources

Générer un fichier de diagnostic pour les attachements iSCSI

Pour les attachements iSCSI, si vous avez suivi toutes les étapes décrites dans cette rubrique et que vous rencontrez toujours un problème avec l'attachement de volume, suivez les étapes décrites sous Étape 4 : Générer un fichier de diagnostic pour Oracle Cloud Agent pour générer un fichier de diagnostic et communiquer avec Oracle Support. Cette étape ne s'applique pas aux attachements paravirtualisés.

Ressources

Attachement de volume incorrectement signalé comme multichemin

Dans certains cas, un attachement de volume s'affiche comme multichemin dans la console. Toutefois, l'attachement n'est pas réellement multichemin et le volume n'atteint pas la performance attendue pour le niveau Ultra-haute performance. Ce problème peut se produire lorsque vous utilisez les outils oci-utils et oci-iscsi-config en même temps pour configurer un volume.

Utilisez l'une des méthodes suivantes pour vérifier si vous rencontrez ce problème.

Option 1 : Commande Linux multipath
Utilisez la commande multipath pour confirmer qu'un attachement de volume est réellement multichemin sur une instance Linux. Connectez-vous à l'instance et exécutez la commande multipath avec le marqueur ll, comme suit :
# multipath -ll
Si la sortie de commande ne retourne rien, cela confirme que l'instance n'a aucun attachement multichemin.
Option 2 : Vérifier node.startup
Vérifiez les enregistrements de noeud dans /var/lib/iscsi/nodes/{IQN} pour node.startup, comme suit :
#cd /var/lib/iscsi/nodes/{IQN}
#grep -Hrn 'node.startup'
Si l'un d'eux comporte node.startup=automatic, l'attachement de volume n'est pas multichemin. Ils doivent tous afficher node.startup=manual.

Résolution

Si l'attachement n'est pas multichemin, vous pouvez contourner ce problème en utilisant le fichier /etc/fstab. Mettez à jour le fichier /etc/fstab pour indiquer au service systemd d'attendre que le service multipathd soit en cours d'exécution avant de monter le système de fichiers. Pour ce faire, ajoutez x-systemd.requires=multipathd.service au volume. Par exemple :
UUID={$AFFECTED_VOLUME_UUID} /test ext4 defaults,_netdev,nofail,x-systemd.requires=multipathd.service 0 2

Redémarrez l'instance après avoir mis à jour le fichier /etc/fstab.

Pour plus d'informations sur le fichier /etc/fstab, voir Options traditionnelles du fichier fstab et Options du fichier fstab pour les volumes par blocs utilisant des chemins de périphérique cohérents.