실패한 Patch Manager(Linux) 작업을 어떻게 문제 해결합니까?

간략한 설명

실패한 Patch Manager 작업을 해결하려면 AWS Management Console 또는 API 응답에서 관련 오류 메시지를 확인하십시오. 그런 다음 AWSSupport-TroubleshootPatchManagerLinux 런북을 실행하거나, 표시되는 오류 메시지를 수동으로 해결하십시오.

자세한 내용은 Patch Manager 문제 해결을 참조하십시오.

해결 방법

관련 오류 메시지 식별

다음 메시지는 콘솔에서 확인할 수 있는 오류 메시지의 예시입니다.

"failed to run commands: exit status 1"

콘솔은 출력을 24,000자로 제한됩니다. 관리형 노드에 저장된 전체 출력을 검토하려면 다음 위치로 이동하십시오.

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

참고: example-instance-id를 사용 중인 Systems Manager 인스턴스 ID로 바꾸고, example-command-id를 명령 ID로 바꾸십시오.

이전 위치에 AWS Systems Manager의 기능인 Run Command의 출력이 없는 경우, Amazon Simple Storage Service(Amazon S3) 또는 Amazon CloudWatch에서 출력을 확인하십시오. 사용자는 Run Command 출력을 Amazon S3 또는 CloudWatch로 전송하도록 작업을 구성할 수 있습니다.

AWSSupport-TroubleshootPatchManagerLinux 런북 사용

Linux 기반 관리형 노드에서 패치 실패 문제를 해결하려면 AWSSupport-TroubleshootPatchManagerLinux 런북을 사용하십시오. 자세한 내용은 AWSSupport-TroubleshootPatchManagerLinux를 참조하십시오.

Patch Manager 오류 수동 해결

Patch Manager 문제를 해결하려면 오류 메시지에 따라 다음 문제 해결 작업을 완료하십시오.

"Cannot acquire lock. Another patching operation is in progress"

동일한 관리형 노드에서 여러 패치 작업이 동시에 실행될 때 다음 오류가 발생합니다.

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

중요: 예약된 패치 작업이 진행 중이지 않을 때만 수동 지금 패치(Patch now) 작업을 시작하는 것이 좋습니다.

동일한 관리형 노드에서 여러 패치 작업이 동시에 실행되도록 예약되지 않았는지 확인하려면 다음을 확인하십시오.

• AWS Systems Manager의 기능인 Quick Setup의 패치 정책 구성을 점검하고 다른 패치 일정과 중첩되지 않는지 확인하십시오.
• 유지 관리 기간 연결 항목을 검토하고, 한 번에 하나의 유지 관리 기간만 각 관리형 노드의 패치 작업을 대상으로 지정하는지 확인하십시오.
• 예약된 패치 작업이 진행 중일 때는 수동 지금 패치(Patch now) 작업을 시작하지 않도록 유의하십시오.

"Permission denied"

/var/lib/amazon을 noexec 권한으로 마운트한 경우 다음 오류 메시지가 발생합니다.

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

이 문제를 해결하려면 /var/log/amazo와 /var/lib/amazon에 전용 파티션을 구성하고 exec 권한을 마운트하십시오.

"Unable to download payload"

관리형 노드에 지정된 S3 버킷에 액세스하는 데 필요한 권한이 없는 경우 다음 오류 메시지가 발생합니다.

"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"

이 문제를 해결하려면 네트워크 구성을 업데이트하고 리전 엔드포인트에 접속할 수 있는지 확인하십시오. 자세한 내용은 AWS 관리형 S3 버킷과 AWS Systems Manager Agent(SSM Agent)의 통신을 참조하십시오.

"No such file or directory"

/var 디렉터리에 사용 가능한 디스크 공간이 없는 경우 다음 오류 메시지가 발생합니다.

"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"

이 문제를 해결하려면 /var 디렉터리 하위에 디스크 공간을 추가로 확보하십시오.

"Another process has acquired yum lock"

이미 yum이 실행 중인 관리형 노드에서 AWS-RunPatchBaseline이 실행되어 다른 프로세스가 데이터베이스를 잠근 경우 다음 오류 메시지가 발생합니다.

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

이 문제를 해결하려면 다음을 확인하십시오.

• AWS-RunPatchBaseline을 실행하는 State Manager 연결, 유지관리 창 작업, 또는 다른 구성을 설정할 때 동일한 관리형 노드에서 작업을 동시에 하지 않도록 해야 합니다.
• 수동 yum 작업이 동시에 실행되지 않아야 합니다.

"An unsupported package manager and python version combination was found"

Red Hat Enterprise Linux(RHEL), Debian Server, Raspberry Pi 또는 Ubuntu Server 인스턴스의 경우 지원되는 Python 3 버전이 설치되어 있는지 확인하십시오. 지원되는 버전을 설치하지 않은 경우 다음 오류 메시지가 발생합니다.

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

이 문제를 해결하려면 해당 서버에 Python 3 버전 3.0~3.9를 설치하십시오.

"UnsupportedOperatingSystem"

운영 체제(OS)가 Patch Manager를 지원하지 않는 경우 다음 오류 메시지가 발생합니다.

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

이 문제를 해결하려면 Patch Manager를 지원하는 OS를 사용하십시오.