Comment résoudre le problème d'échec d'une opération du Gestionnaire de correctifs (Linux) ?

Brève description

Pour résoudre les problèmes liés à l’échec des opérations de Patch Manager, recherchez les messages d'erreur associés dans la console de gestion AWS ou dans la réponse de l'API. Exécutez ensuite le dossier d'exploitation AWSSupport-TroubleshootPatchManagerLinux ou résolvez manuellement le message d'erreur qui s'affiche.

Pour plus d'informations, consultez la section Résolution des problèmes liés à Patch Manager.

Résolution

Identifier les messages d'erreur associés

Le message suivant est un exemple de message d'erreur que vous trouvez dans la console :

« failed to run commands: exit status 1 »

La console tronque sa sortie à 24 000 caractères. Pour consulter la sortie complète stockée sur le nœud géré, rendez-vous à l'emplacement suivant :

/var/lib/amazon/ssm/example-instance-id/document/orchestration/example-command-id/awsrunShellScript/PatchLinux/stdout

Remarque : Remplacez example-instance-id par l’ID d'instance de Systems Manager et example-command-id par l’ID de commande.

Si l'emplacement précédent ne contient pas la sortie de Run Command, une fonctionnalité d'AWS Systems Manager, recherchez la sortie dans Amazon Simple Storage Service (Amazon S3) ou Amazon CloudWatch. Les utilisateurs peuvent configurer les opérations pour envoyer les sorties de Run Command à Amazon S3 ou CloudWatch.

Utiliser le dossier d’exploitation AWSSupport-TroubleshootPatchManagerLinux

Utilisez le dossier d'exploitation AWSSupport-TroubleshootPatchManagerLinux pour résoudre les échecs d’application des correctifs pour les nœuds gérés basés sur Linux. Pour plus d'informations, consultez la section AWSSupport-TroubleshootPatchManagerLinux.

Résoudre manuellement les erreurs de Patch Manager

Effectuez les actions de dépannage suivantes en fonction de votre message d'erreur pour résoudre votre problème lié à Patch Manager.

« Cannot acquire lock. Another patching operation is in progress. »

L'erreur suivante s'affiche lorsque plusieurs opérations de correctif sont exécutées simultanément sur le même nœud géré :

« [ERROR]: Cannot acquire lock on /var/log/amazon/ssm/patch-baseline-concurrent.lock. Another patching operation is in progress. »

Important : Il est recommandé de lancer des opérations manuelles du correctif uniquement lorsqu'aucune opération planifiée de correctif n'est en cours.

Pour vous assurer que vous n'avez pas planifié l'exécution simultanée de plusieurs opérations de correctif sur le même nœud géré, effectuez les vérifications suivantes :

• Vérifiez les configurations de la politique de correctifs pour Quick Setup, une fonctionnalité d'AWS Systems Manager, et vérifiez qu'elles ne se chevauchent pas avec d'autres calendriers de correctifs.
• Passez en revue les associations de fenêtres de maintenance et vérifiez qu'une seule fenêtre cible chaque nœud géré avec des tâches de correction à la fois.
• Veillez à ne pas lancer les opérations de correctif manuelles lorsqu'un correctif planifié est en cours.

« Permission denied »

Si vous montez /var/lib/amazon avec des autorisations noexec, le message d'erreur suivant s'affiche :

« /var/lib/amazon/ssm/example-instance-id/document/orchestration/example-command-id/PatchLinux/ \ _script.sh : Permission denied failed to run commands: exit status 126 »

Pour résoudre ce problème, configurez les partitions exclusives sur /var/log/amazon et /var/lib/amazon, et montez-le avec des autorisations exec.

« Unable to download payload »

Si le nœud géré ne dispose pas des autorisations nécessaires pour accéder au compartiment S3 spécifié, le message d'erreur suivant s'affiche :

« Unable to download payload: https://s3.doc-example-bucket.region.amazonaws.com/aws-ssm-region/patchbaselineoperations/linux/payloads/patch-baseline-operations-1.23.tar.gz.failed to run commands: exit status 156 »

Pour résoudre ce problème, mettez à jour la configuration de votre réseau et vérifiez que vous pouvez atteindre un point de terminaison régional AWS Amazon S3. Pour en savoir plus, consultez la page Communications d’AWS Systems Manager Agent (SSM Agent) avec les compartiments S3 gérés par AWS.

« No such file or directory »

Si l’espace disponible sur le répertoire /var est insuffisant, le message d'erreur suivant s'affiche :

« IOError: [Errno 2] No such file or directory: 'patch-baseline-operations-1.23.tar.gz' Unable to extract tar file: /var/log/amazon/ssm/patch-baseline-operations/patch-baseline-operations-1.75.tar.gz. failed to run commands: exit status 155 Unable to load and extract the content of payload, abort. failed to run commands: exit status 152 »

Pour résoudre ce problème, libérez de l'espace disque dans le répertoire /var.

« Another process has acquired yum lock »

Si AWS-RunPatchBaseline s'exécute sur un nœud géré qui exécute déjà yum et qu'un autre processus a verrouillé la base de données, le message d'erreur suivant s'affiche :

« 11/22/3333 44:55:66 root [INFO]: another process has acquired yum lock, waiting 2 s and retry. »

Pour résoudre ce problème, effectuez les vérifications suivantes :

• Vérifiez qu’aucune association de State Manager, tâche de fenêtre de maintenance ou autre configuration exécutant AWS-RunPatchBaseline selon un calendrier établi ne cible le même nœud géré simultanément.
• Vérifiez qu’aucune opération manuelle yum ne s’exécute en même temps.

« An unsupported package manager and python version combination was found »

Pour les instances Red Hat Enterprise Linux (RHEL), Debian Server, Raspberry Pi ou Ubuntu Server, assurez-vous d'installer une version compatible de Python 3. Si vous n'installez aucune version prise en charge, le message d'erreur suivant s'affiche :

« An unsupported package manager and python version combination was found. Dnf requires Python 2 or Python 3 to be installed. »

Pour résoudre ce problème, installez les versions 3.0 à 3.9 de Python 3 sur le serveur approprié.

« UnsupportedOperatingSystem »

Si votre système d'exploitation (OS) ne prend pas en charge Patch Manager, le message d'erreur suivant s'affiche :

"An error occurred (UnsupportedOperatingSystem) when calling the GetDeployablePatchSnapshotForInstance operation: patch_common.exceptions. PatchManagerError: (’Unsupported Operating System’, 146) »

Pour résoudre ce problème, utilisez un système d'exploitation compatible avec Patch Manager.