기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# `AWSSupport-TroubleshootPatchManagerLinux`
<a name="automation-troubleshoot-patch-manager-linux"></a>

 **설명** 

 `AWSSupport-TroubleshootPatchManagerLinux` 실행서는의 도구인 Patch Manager를 사용하여 Linux 기반 관리형 노드에서 패치 장애를 일으킬 수 있는 일반적인 문제를 해결합니다 AWS Systems Manager. 이 런북의 주요 목표는 패치 명령 실패의 근본 원인을 식별하고 문제 해결 계획을 제안하는 것입니다.

 **어떻게 작동하나요?**

 `AWSSupport-TroubleshootPatchManagerLinux` 실행서는 문제 해결을 위해 사용자가 제공한 두 인스턴스 ID/명령 ID를 고려합니다. 명령 ID가 제공되지 않은 경우 제공된 인스턴스에서 지난 30일 이내에 실패한 최신 패치 명령을 선택합니다. 명령 상태, 사전 조건 이행 및 OS 배포를 확인한 후 실행서는 로그 분석기 패키지를 다운로드하고 실행합니다. 출력에는 문제 근본 원인과 문제를 해결하는 데 필요한 작업이 포함됩니다.

**문서 유형**

자동화

**소유자**

Amazon

**플랫폼**

 
+ Amazon Linux 2 및 AL2023
+ Red Hat Enterprise Linux 8.X 및 9.X
+ Centos 8.X 및 9.X
+ SUSE 15.X

**파라미터**

**필수 IAM 권한**

실행서를 성공적으로 사용하려면 `AutomationAssumeRole` 파라미터에 다음 작업이 필요합니다.
+ `ssm:SendCommand`
+ `ssm:DescribeDocument`
+ `ssm:GetCommandInvocation`
+ `ssm:ListCommands`
+ `ssm:DescribeInstanceInformation`
+ `ssm:ListCommandInvocations`
+ `ssm:GetDocument`
+ `ssm:DescribeAutomationExecutions`
+ `ssm:GetAutomationExecution`

 **지침** 

다음 단계에 따라 자동화를 구성합니다.

1.  AWS Systems Manager 콘솔[https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootPatchManagerLinux/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootPatchManagerLinux/description)에서 로 이동합니다.

1. Execute automation(자동화 실행)을 선택합니다.

1. 입력 파라미터에 다음을 입력합니다.
   + **InstanceId(필수):**

     대화형 인스턴스 선택기를 사용하여 패치 명령이 실패한 Linux 기반 SSM 관리형 노드(Amazon Elastic Compute Cloud(Amazon EC2) 또는 하이브리드 활성화 서버)의 ID를 선택하거나 SSM 관리형 인스턴스의 ID를 수동으로 입력합니다.
   + **AutomationAssumeRole(선택 사항):**

     Automation이 사용자를 대신하여 작업을 수행할 수 있도록 허용하는 IAM 역할의 ARN을 입력합니다. 역할이 지정되지 않은 경우 Automation은이 실행서를 시작하는 사용자의 권한을 사용합니다.
   + **RunCommandId(선택 사항):**

     `AWS-RunPatchBaseline` 문서의 실패 실행 명령 ID를 입력합니다. 명령 ID를 제공하지 않으면 실행서는 선택한 인스턴스에서 지난 30일 이내에 실패한 최신 패치 명령을 찾습니다.  
![InstanceId 필드, AutomationAssumeRole 드롭다운 및 RunCommandId 필드를 보여주는 입력 파라미터 섹션입니다.](http://docs.aws.amazon.com/ko_kr/systems-manager-automation-runbooks/latest/userguide/images/awssupport-troubleshoot-patch-manager-linux_input_parameters.png)

1. 실행을 선택합니다.

1. 자동화가 시작됩니다.

1. 문서는 다음 단계를 수행합니다.
   + **CheckConcurrency:**

     동일한 인스턴스를 대상으로 하는이 실행서의 실행이 하나만 있는지 확인합니다. 실행서가 동일한 인스턴스를 대상으로 진행 중인 다른 실행을 찾으면 오류가 반환되고 종료됩니다.
   + **ValidateCommandID:**

     제공된 명령 ID가 입력 파라미터로 `AWS-RunPatchBaseline` SSM 문서에 대해 실행되었는지 확인합니다. 명령 ID가 제공되지 않은 경우 실행서는 선택한 인스턴스에서 지난 30일 `AWS-RunPatchBaseline` 동안 실행에 실패한의 최근 실행을 고려합니다.
   + **BranchOnCommandStatus:**

     제공된 명령의 상태가 실패했는지 확인합니다. 그렇지 않으면 실행서가 실행을 종료하고 제공된 명령이 성공적으로 실행되었다는 보고서를 생성합니다.
   + **VerifyPrerequistes:**

     위에서 언급한 사전 조건이 충족되었는지 확인합니다.
   + **GetPlatformDetails:**

     운영 체제(OS) 배포 및 버전을 검색합니다.
   + **GetDownloadURL:**

     PatchManager Log Analyzer 패키지의 다운로드 URL을 검색합니다.
   + **EvaluatePatchManagerLogs:**

     인스턴스에서 PatchManager Log Analyzer python 패키지를 다운로드하고 실행하여 로그 파일을 평가합니다.
   + **GenerateReport:**

     식별된 문제와 제안된 솔루션을 포함하는 실행서 실행에 대한 최종 보고서를 생성합니다.

1. 완료되면 출력 섹션에서 실행의 자세한 결과를 검토합니다.  
![네트워크 연결 솔루션에서 S3 다운로드 오류를 보여주는 결과 문제 해결.](http://docs.aws.amazon.com/ko_kr/systems-manager-automation-runbooks/latest/userguide/images/awssupport-troubleshoot-patch-manager-linux_outputs.png)

 **참조** 

Systems Manager Automation
+ [이 자동화 실행(콘솔)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-TroubleshootPatchManagerLinux/description)
+ [자동화 실행](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html)
+ [Automation 설정](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html)
+ [Support Automation Workflows 랜딩 페이지](https://aws.amazon.com/premiumsupport/technology/saw/)