翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # `AWSSupport-TroubleshootPatchManagerLinux` **説明** `AWSSupport-TroubleshootPatchManagerLinux` ランブックは、 のツールである Patch Manager を使用して、Linux ベースのマネージドノードでパッチ障害を引き起こす可能性がある一般的な問題をトラブルシューティングします AWS Systems Manager。このランブックの主な目的は、パッチコマンドが失敗する根本原因を見きわめ、修復プランを提案することにあります。 **動作の仕組み** `AWSSupport-TroubleshootPatchManagerLinux` ランブックでは、トラブルシューティングのために提供された 2 つのインスタンス ID/コマンド ID を考慮します。コマンド ID が指定されていない場合、指定されたインスタンスで過去 30 日以内に失敗した最新のパッチコマンドが選択されます。コマンドステータス、前提条件フルフィルメント、および OS ディストリビューションを確認した後、ランブックはログアナライザーパッケージをダウンロードして実行します。出力には、問題の根本原因と、問題を解決するために必要なアクションが含まれます。 **ドキュメントタイプ** オートメーション **[所有者]** Amazon **[Platforms]** (プラットフォーム) + 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 を入力します。ロールが指定されていない場合、オートメーションはこのランブックを開始するユーザーのアクセス許可を使用します。 + **RunCommandId (オプション):** `AWS-RunPatchBaseline` ドキュメントの Failed Run Command ID を入力します。コマンド ID を指定しない場合、ランブックは選択したインスタンスで過去 30 日以内に失敗した最新のパッチコマンドを検索します。 ![\[Input parameters form for EC2 Instance Connect troubleshooting with instance ID and optional fields.\]](http://docs.aws.amazon.com/ja_jp/systems-manager-automation-runbooks/latest/userguide/images/awssupport-troubleshoot-patch-manager-linux_input_parameters.png) 1. [実行] を選択します。 1. 自動化が開始されます。 1. ドキュメントは以下のステップを実行します。 + **CheckConcurrency:** 同じインスタンスをターゲットとするこのランブックの実行が 1 つだけであることを確認します。ランブックが同じインスタンスをターゲットとする別の実行を検出した場合、エラーが返されて終了します。 + **ValidateCommandID:** 指定されたコマンド ID が入力パラメータとして SSM `AWS-RunPatchBaseline` ドキュメントに対して実行されたかどうかを検証します。コマンド ID が指定されていない場合、ランブックは選択したインスタンスで`AWS-RunPatchBaseline`過去 30 日以内に失敗した最新の の実行を考慮します。 + **BranchOnCommandStatus:** 指定されたコマンドのステータスが失敗することを確認します。それ以外の場合、ランブックは実行を終了し、指定されたコマンドが正常に実行されたことを示すレポートを生成します。 + **VerifyPrerequistes:** 上記の前提条件が満たされていることを確認します。 + **GetPlatformDetails:** オペレーティングシステム (OS) のディストリビューションとバージョンを取得します。 + **GetDownloadURL:** PatchManager Log Analyzer パッケージのダウンロード URL を取得します。 + **EvaluatePatchManagerLogs:** インスタンスで PatchManager Log Analyzer Python パッケージをダウンロードして実行し、ログファイルを評価します。 + **GenerateReport:** 特定された問題と推奨される解決策を含むランブック実行の最終レポートを生成します。 1. 完了したら、出力セクションで実行の詳細な結果を確認します。 ![\[Troubleshooting results showing an error downloading payload and suggested solutions.\]](http://docs.aws.amazon.com/ja_jp/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) + [オートメーションの設定](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html) + [「自動化ワークフローをサポート」ランディングページ](https://aws.amazon.com/premiumsupport/technology/saw/)