AWS CloudFormation コンソールを使用して、AWS CloudFormation スタックのステータスを監視し、スタックの作成が失敗したかどうかを検出します。Esri CloudFormation テンプレートは、問題のトラブルシューティングに役立つログも作成しますが、これらのログ ファイルを保持するには、AWS のロールバックを無効化する必要があります。
CloudFormation コンソールの [Events] タブ
(AWS マネジメント コンソールの一部である) AWS CloudFormation コンソールにログインして、[Events] タブを開き、スタックの作成、更新、削除に関する情報を見つけます。スタックの作成に失敗した場合、通常、[Events] タブの情報によって、失敗した原因の概要を把握できます。
ログ ファイルを保持する配置の構成
Esri CloudFormation サンプル テンプレートは、仮想コンピューター上にログ ファイルを作成します。配置の起動が失敗した場合でも、ファイルが保持されるようにするには、AWS CloudFormation コンソールにサイン インして、失敗時のロールバックを無効化します。
Esri テンプレートから起動するときに配置が失敗した場合、EC2 インスタンスへのリモート デスクトップ接続または SSH を作成してログを表示します。ログのタイプと場所を次の表に示します。
| EC2 インスタンス タイプ | ログ ファイルと EC2 インスタンス上の場所 | ログ ファイルの説明 |
|---|---|---|
Ubuntu | /var/log/cfn-init.log | リソースのメタデータの取得と解釈、パッケージのインストール、ファイルの作成、サービスの起動に使用される CloudFormation ヘルパー スクリプトのログ ファイル |
/var/log/chef-run.log | Chef 構成管理ツールのログ ファイル | |
/var/lib/tomcat7/logs/catalina.out | Apache Tomcat アプリケーション サーバーのログ ファイル | |
Windows | C:\cfn\log\cfn-init.log | リソースのメタデータの取得と解釈、パッケージのインストール、ファイルの作成、サービスの起動に使用される CloudFormation ヘルパー スクリプトのログ ファイル |
C:\chef\chef-run.log | Chef 構成管理ツールのログ ファイル |
注意:
CloudFormation スタックの作成が成功した場合は、スタックの出力パラメーターによって、AWS マネジメント コンソールにログ グループへのリンクが示されます。スタックの作成が失敗した場合は、AWS マネジメント コンソールで CloudFormation の [Resources] リストに移動して、ログ グループを見つけます。インスタンスが起動される前にスタックの作成が失敗した場合、ログ グループが作成されていない可能性がある点に注意してください。
エラー メッセージ
以下では、スタック作成の失敗に関するトラブルシューティングのヒントを、ログ ファイルに表示される可能性があるいくつかのエラー メッセージを用いて示します。
- cfn-init.log に「Error encountered during build of config: Failed to retrieve https://.s3.amazonaws.com/」というメッセージが表示された場合は、配置の S3 バケット名が正しいこと、および認証ファイルの S3 オブジェクト キー名と SSL 証明書が正しいことを確認してください。
- Ubuntu 上の catalina.out ログ ファイルに「Unable to connect to WebAdaptor URL : https://agsportalssl.esri.com/server/webadaptor」というメッセージが表示された場合は、配置の S3 バケットに含まれる SSL 証明書が有効であり、PKCS 12 形式であることを確認してください。また、入力された SSL 証明書のパスワードが正しいことも確認してください。
- Windows 上で chef-run.log に「OpenSSL::PKCS12::PKCS12Error: PKCS12_parse: mac verify failure」というメッセージが表示された場合は、配置の S3 バケットに含まれる SSL 証明書が有効であり、PKCS 12 形式であることを確認してください。また、入力された SSL 証明書のパスワードが正しいことも確認してください。