View a markdown version of this page

Résolution des modifications de configuration du système d'exploitation qui entraînent des erreurs ou des défaillances - AWS ParallelCluster
Problèmes courants de configuration du système d'exploitationMeilleures pratiques pour les modifications de configuration du système d'exploitation

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Résolution des modifications de configuration du système d'exploitation qui entraînent des erreurs ou des défaillances

Lorsque vous modifiez la configuration du système d'exploitation sur AWS ParallelCluster les nœuds, divers problèmes peuvent survenir et entraîner des échecs de création, de mise à jour ou de fonctionnement du cluster. Cette section fournit des conseils sur l'identification et la résolution des problèmes courants liés à la configuration du système d'exploitation.

Problèmes courants de configuration du système d'exploitation

Problèmes de configuration locale

L'un des problèmes de configuration du système d'exploitation les plus courants est lié aux paramètres régionaux. Si vous voyez des erreurs telles que :

cannot change locale (en_US.utf-8) because it has an invalid name

Cela se produit généralement lorsque :

  • Un processus yum d'installation a échoué et a laissé les paramètres régionaux dans un état incohérent

  • Un utilisateur a mis fin prématurément à un processus d'installation

  • Les packages régionaux sont manquants ou endommagés

Comment diagnostiquer

  1. Vérifiez si vous pouvez passer à l'utilisateur pcluster-admin :

    $ su - pcluster-admin

    Si vous voyez une erreur de ce typecannot change locale...no such file or directory, cela confirme le problème.

  2. Vérifiez les langues disponibles :

    $ localedef --list

    Si cela renvoie une liste vide ou ne contient pas les paramètres régionaux par défaut, cela signifie que la configuration de vos paramètres régionaux est interrompue.

  3. Vérifiez la dernière yum commande :

    $ yum history
$ yum history info #ID

    Si le dernier identifiant n'est pas indiquéReturn-Code: Success, les scripts de post-installation ne se sont peut-être pas exécutés correctement.

Comment résoudre

Reconstruisez les paramètres régionaux en réinstallant les modules linguistiques :

$ sudo yum reinstall glibc-all-langpacks

Après la reconstruction, vérifiez que le problème est résolu en exécutant :

$ su - pcluster-admin

Si aucune erreur ou avertissement ne s'affiche, cela signifie que le problème a été résolu.

Conflits de packages de système

Lors de l'installation de packages personnalisés ou de la modification de packages système, des conflits peuvent survenir et empêcher le bon fonctionnement du cluster.

Comment diagnostiquer

  1. Consultez le journal chef-client pour détecter les erreurs liées aux packages :

    $ less /var/log/chef-client.log

  2. Recherchez les conflits de dépendance entre les paquets dans le journal cfn-init :

    $ less /var/log/cfn-init.log

Comment résoudre

  1. Si un package spécifique pose problème, essayez de le réinstaller :

    $ sudo yum reinstall package-name

  2. En cas de conflit de dépendances, vous devrez peut-être supprimer les packages en conflit :

    $ sudo yum remove conflicting-package

  3. Si le problème persiste, envisagez de créer une AMI personnalisée avec les packages requis préinstallés à l'aide de la pcluster build-image commande. Pour de plus amples informations, veuillez consulter AWS ParallelCluster Personnalisation de l'AMI.

Modifications du fichier de configuration du système

La modification de fichiers de configuration système critiques peut provoquer des défaillances du cluster, en particulier si ces fichiers sont gérés par AWS ParallelCluster.

Comment diagnostiquer

  1. Vérifiez les erreurs dans le journal chef-client qui mentionnent des fichiers de configuration spécifiques :

    $ grep -i "config" /var/log/chef-client.log

  2. Recherchez les erreurs d'autorisation ou de syntaxe dans les fichiers de configuration :

    $ less /var/log/cfn-init.log

Comment résoudre

  1. Restaurez les fichiers de configuration modifiés dans leur état d'origine :

    $ sudo cp /etc/file.conf.bak /etc/file.conf

  2. Si vous devez apporter des modifications persistantes aux fichiers de configuration du système, utilisez des actions d'amorçage personnalisées au lieu de modifier directement les fichiers :

    HeadNode:
  CustomActions:
    OnNodeConfigured:
      Script: s3://bucket-name/config-script.sh

    Pour de plus amples informations, veuillez consulter Actions de bootstrap personnalisées.

  3. Pour les modifications de configuration qui doivent être apportées directement aux fichiers système, pensez à créer une AMI personnalisée. Pour de plus amples informations, veuillez consulter AWS ParallelCluster Personnalisation de l'AMI.

Mises à jour du noyau et problèmes de compatibilité

Les mises à jour du noyau peuvent entraîner des problèmes de compatibilité avec certains AWS services, notamment avec Amazon FSx pour Lustre.

Comment diagnostiquer

  1. Vérifiez si les mises à jour du noyau ont été appliquées :

    $ uname -r

  2. Recherchez les échecs de montage d'Amazon FSx dans les journaux :

    $ grep -i "fsx" /var/log/chef-client.log

Comment résoudre

  1. Pour Ubuntu 22.04, évitez d'effectuer la mise à jour vers la dernière version du noyau car il n'existe aucun client Amazon FSx pour ce noyau. Pour de plus amples informations, veuillez consulter Considérations relatives au système d’exploitation.

  2. Si vous avez déjà mis à jour le noyau et que vous rencontrez des problèmes, envisagez de passer à une version compatible du noyau :

    $ sudo apt install linux-image-previous-version

  3. Pour les personnalisations persistantes du noyau, créez une AMI personnalisée avec la version spécifique du noyau dont vous avez besoin. Pour de plus amples informations, veuillez consulter AWS ParallelCluster Personnalisation de l'AMI.

Meilleures pratiques pour les modifications de configuration du système d'exploitation

Pour minimiser les problèmes liés à la modification de la configuration du système d'exploitation :

  1. Utilisez des actions Bootstrap personnalisées  : au lieu de modifier directement les fichiers système, utilisez OnNodeConfigured des scripts OnNodeStart ou pour apporter des modifications de manière contrôlée. Pour de plus amples informations, veuillez consulter Actions de bootstrap personnalisées.

  2. Créer des AMI personnalisées  : pour des modifications importantes du système d'exploitation, créez une AMI personnalisée en utilisant pcluster build-image plutôt que de modifier les instances en cours d'exécution. Pour de plus amples informations, veuillez consulter AWS ParallelCluster Personnalisation de l'AMI.

  3. Testez d'abord les modifications  : avant d'appliquer les modifications à un cluster de production, testez-les sur un petit cluster de test pour garantir la compatibilité.

  4. Modifications apportées aux documents  : suivez toutes les modifications apportées à la configuration du système d'exploitation pour faciliter le dépannage.

  5. Fichiers de configuration de sauvegarde  : avant de modifier un fichier de configuration système, créez une sauvegarde :

    $ sudo cp /etc/file.conf /etc/file.conf.bak

  6. Vérifiez les journaux après les modifications  : Après avoir modifié la configuration du système d'exploitation, vérifiez les journaux pour détecter toute erreur :

    $ less /var/log/cfn-init.log
$ less /var/log/chef-client.log

En suivant ces instructions, vous pouvez minimiser le risque que des modifications de configuration du système d'exploitation entraînent des défaillances du cluster et résoudre plus efficacement les problèmes éventuels.