Amazon EC2 Windows インスタンスで SSM Agent をインストールまたは更新する場合に発生する問題のトラブルシューティング方法を教えてください。

所要時間2分

Amazon Elastic Compute Cloud (EC2) Windows インスタンスでの AWS Systems Manager Agent (SSM Agent) のインストールまたは更新に関する問題のトラブルシューティングを行いたいと考えています。

簡単な説明

デフォルトでは、SSM Agent は Windows Server 用の次の Amazon マシンイメージ (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 サービスが更新されていない。
SSM Agent のインストールまたはアップグレードがエラー 0x80070643 で失敗する。

パッケージダウンロードエラーのトラブルシューティング

SSM Agent を手動でインストールする場合、SSM Agent パッケージは Amazon Simple Storage Service (Amazon S3) バケットからダウンロードおよびインストールされます。インスタンスが 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 のリクエストを処理します。SSM Agent をインストールまたはアップグレードする前に、最新バージョンの EC2Config を使用するようにインスタンスをアップグレードしてください。

"Fatal error during installation" エラー 0x80070643 のトラブルシューティング

SSM Agent をインストールまたはアップグレードすると、次のいずれかのエラーが表示される場合があります。

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

これらのエラーを解決するには、次の手順を実行します。

以前にインストールした SSM Agent が Windows OS のコントロールパネルの [Add or remove programs] (プログラムの追加と削除) に表示されているかどうかを確認します。SSM Agent がインストールされている場合は、アンインストールまたは削除します。
次の SSM フォルダを削除するか、フォルダの名前を変更してバックアップとして維持します。
C:\Program Files\Amazon\SSM
C:\ProgramData\Amazon\SSM
注: C:\ で ProgramData フォルダを表示できない場合、フォルダが非表示になっている可能性があります。隠しフォルダを見つけるには、[View] (表示) タブで [show hidden files] (隠しファイルを表示) を選択します。
regedit コマンドを使用して、次のキーを検索して削除します。
```
Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\AmazonSSMAgent
```
注: Microsoft クリーンアップツールを使用して、以前にインストールした SSM Agent を削除し、破損したレジストリキーを修復します。詳細については、Microsoft のウェブサイトの「プログラムのインストールまたは削除をブロックする問題を修正する」を参照してください。
サーバを再起動し、SSM Agent を手動で再インストールします。

エラーが続く場合は、SSM Agent ログを参照して問題のトラブルシューティングを行います。