Amazon EC2 Windows 인스턴스에 SSM Agent를 설치하거나 업데이트할 때 발생하는 문제를 해결하려면 어떻게 해야 합니까?

4분 분량

Amazon Elastic Compute Cloud(EC2) Windows 인스턴스에서 AWS Systems Manager Agent(SSM Agent) 설치 또는 업데이트 문제를 해결하고 싶습니다.

간략한 설명

기본적으로 SSM Agent는 Windows Server용 다음 Amazon Machine Image(AMI)에 사전 설치되어 있습니다.

Windows Server 2016, 2019, 2022(Nano 버전 제외) 및 2025
2016년 11월 이후에 게시된 Windows Server 2008–2012 R2 AMI
참고: Windows Server 2012 및 2012 R2는 2023년 10월 10일에 지원이 종료되었습니다. 이러한 운영 체제(OS) 버전을 사용하지 않는 것이 좋습니다. 해당 버전에서 SSM Agent를 사용하려면 Microsoft의 확장 보안 업데이트(ESU)를 사용하는 것을 권장합니다. 자세한 내용은 Microsoft 웹 사이트의 Windows Server 2012 및 2012 R2 지원 종료를 참조하십시오.

Windows Server 2008 버전에서 지원되는 SSM Agent의 최종 버전은 2.3.1644.0입니다. 이 운영 체제(OS)는 Microsoft의 기능 또는 보안 업데이트 지침을 더 이상 지원하지 않습니다.

참고: EC2 인스턴스에서 AWS Systems Manager를 처음 사용하기 전에 SSM Agent의 상태를 확인하는 것이 좋습니다. 지침은 SSM Agent 상태 확인을 참조하십시오.

해결 방법

사전 요구 사항: SSM Agent를 설치하기 전에 OS가 Systems Manager를 지원하는지, 그리고 Systems Manager가 올바르게 설정되었는지 확인하십시오.

다음과 같은 시나리오로 인해 인스턴스에서 SSM Agent 설치 또는 업데이트 문제가 발생할 수 있습니다.

SSM Agent 패키지 다운로드 실패.
Windows Management Framework 3.0 이상이 비활성화됨.
Amazon EC2Config 서비스가 업데이트되지 않음.
0x80070643 오류와 함께 SSM Agent 설치 또는 업그레이드 실패.

패키지 다운로드 실패 문제 해결

SSM Agent를 수동으로 설치하면 Amazon Simple Storage Service(Amazon S3) 버킷에서 SSM Agent 패키지가 다운로드 및 설치됩니다. 인스턴스를 S3 버킷에 연결하여 패키지를 다운로드할 수 없는 경우, SSM Agent 설치가 실패합니다.

구성 형태에 따라 다음 리소스를 검토하고 인스턴스가 SSM Agent 패키지가 포함된 버킷에 액세스할 수 있는지 확인하십시오.

인스턴스가 네트워크 주소 변환(NAT) 게이트웨이가 있는 프라이빗 서브넷에 있는 경우, NAT 게이트웨이를 참조하십시오.
인스턴스가 NAT 인스턴스가 있는 프라이빗 서브넷에 있는 경우, NAT 인스턴스를 참조하십시오.
인스턴스가 인터넷 게이트웨이가 있는 퍼블릭 서브넷에 있는 경우, 인터넷 게이트웨이 기본 사항을 참조하십시오.
인스턴스가 Amazon Virtual Private Cloud(Amazon VPC) 엔드포인트가 있는 프라이빗 또는 퍼블릭 서브넷에 있는 경우, Amazon S3용 게이트웨이 엔드포인트를 참조하십시오.

다음 이유로 패키지 다운로드가 실패할 수도 있습니다.

OS의 도메인 이름 시스템(DNS) 서버가 Amazon S3 엔드포인트 URL을 해석하지 못함.
Amazon VPC에 대한 DNS 해석이 비활성화되어 있음

Windows Management Framework 3.0 이상 활성화

Windows Server 인스턴스에서 특정 Systems Manager 문서를 실행하려면 SSM Agent에 Windows PowerShell 3.0 이상이 필요합니다. Windows Server 인스턴스가 Windows Management Framework 3.0 이상을 실행 중인지 확인하십시오. 이 프레임워크에는 Windows PowerShell이 포함되어 있습니다. 자세한 내용을 알아보려면 Microsoft 웹 사이트의 WMF 3.0을 참조하십시오.

Amazon EC2Config 서비스 업데이트

인스턴스가 2016년 11월 이전 생성된 Windows Server 2008~2012 R2 OS인 경우 EC2Config가 인스턴스에서 Systems Manager 요청을 처리합니다. SM Agent를 설치하거나 업그레이드하기 전에 인스턴스를 최신 버전의 EC2Config를 사용하도록 업그레이드하십시오.

"Fatal error during installation" 오류 0x80070643 문제 해결

SSM Agent를 설치하거나 업그레이드할 때 다음 오류 중 하나가 발생할 수 있습니다.

"Fatal error during installation (0x80070643)"
"Failed to install MSI package"

이러한 문제를 해결하려면 다음 단계를 완료하십시오.

Windows OS의 제어판 내 프로그램 추가/제거 항목 아래 이전 설치된 SSM Agent가 나열되어 있는지 확인합니다. SSM Agent가 설치되어 있다면 제거하거나 삭제합니다.
다음 SSM 폴더를 삭제하거나 이름하여 백업으로 유지합니다.
C:\Program Files\Amazon\SSM
C:\ProgramData\Amazon\SSM
참고: C:\ 아래에서 ProgramData 폴더가 보이지 않는다면 숨김 처리되어 있을 수 있습니다. 숨겨진 폴더를 찾으려면 보기 탭에서 숨긴 항목 표시를 선택합니다.
regedit 명령을 사용하여 레지스트리 키를 찾고 삭제합니다.
```
Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\AmazonSSMAgent
```
참고: Microsoft 정리 도구를 사용해 이전 SSM Agent 설치를 제거하고 손상된 레지스트리 키를 복구하십시오. 자세한 내용은 Microsoft 웹 사이트의 프로그램이 설치되거나 삭제되지 않도록 하는 문제 해결을 참조하십시오.
서버를 재부팅한 후 SSM Agent를 수동으로 다시 설치합니다.

오류가 지속되면 SSM Agent 로그를 사용하여 문제를 해결하십시오.