ArcGIS Enterprise および ArcGIS Server を Amazon Web Services (AWS) 上に配置する方法は数多くあります。このトピックでは、配置オプションのタイプごとに、生じうる問題への対処法を解説します。
ArcGIS Enterprise Cloud Builder for Amazon Web Services のトラブルシューティング
ArcGIS Enterprise Cloud Builder for Amazon Web Services およびファイルを展開した位置の Logs フォルダー以下に、2 つのフォルダーがあります。
Logs フォルダー以下には次の 2 つのサブフォルダーがあります。
- Log - コンソール ログを収容します。ユーティリティを実行する都度、作成されるファイルです。Log フォルダーには CloudFormation イベント ログもあります。配置の際に作成した各スタックごとに、ArcGIS Enterprise Cloud Builder CLI for AWS ユーティリティで CREATE コマンドを実行したり、ArcGIS Enterprise Cloud Builder for Amazon Web Services アプリに配置を追加したりするたびに出力されます。
- ErrorLog - エラー ログ ファイルを収容します。ArcGIS Enterprise Cloud Builder CLI for AWS ユーティリティまたは ArcGIS Enterprise Cloud Builder for Amazon Web Services アプリの実行中に発生したエラーを記録するものです。エラー ログを調べれば、エラーに対して効率的に対処できます。
ArcGIS Enterprise Cloud Builder for Amazon Web Services アプリのトラブルシューティング
ArcGIS Enterprise Cloud Builder for Amazon Web Services アプリは、アプリの使用時に入力するさまざまな値を検証します。追加情報は、前のセクションに記載したログ ファイルの場所にあります。
ドメイン名が無効であるというメッセージを受信しました。
Cloud Builder がドメイン名を検証できない原因はいくつかありますが、特に可能性が高いのは、ドメイン名サーバー (DNS) のドメイン名がない、またはマッピングが不正であることです。たとえば、ドメイン名が DNS の内部でマッピングされていない、または正しくマッピングされていないなどです。
指定したドメイン名が、DNS の CNAME または A レコードに解決されることを確認してください。Cloud Builder で指定したドメイン名が正しくマッピングされていることを確認するには、Cloud Builder アプリを実行しているコンピューターの Microsoft Windows コマンド プロンプトで nslookup コマンドを使用します。
ドメイン名マッピングが正しい場合は、Cloud Builder を実行しているコンピューターでローカル DNS キャッシュをクリアし、Cloud Builder アプリでもう一度ドメイン名を検証します。
それでもドメイン名が検証されない場合は、IT 管理者にお問い合わせのうえサポートをご依頼ください。
配置の作成に失敗しました。
Cloud Builder アプリが配置を作成できない場合は、Cloud Builder ジョブ完了ページにエラー メッセージが表示されます。ジョブ完了ページの [View Process Log (プロセス ログの表示)] と [View Error Log (エラー ログの表示)] をクリックすると、エラーの詳細を確認できます。
[Wait condition received failed message: 'Chef run failed. See 'c:\\chef\chef-run.log' for details’ (待機中に次のエラー メッセージが表示されました: 'Chef の実行に失敗しました。詳細については、'c:\\chef\chef-run.log' をご参照ください)] という一般的なエラーが表示された場合は、Cloud Builder サマリー ページの [View AWS CloudWatch Logs (AWS CloudWatch ログの表示)] セクションのログ URL をクリックし、AWS CloudWatch ログを確認します。該当する CloudWatch ログがデフォルト ブラウザーに表示されます。配置の各 Amazon Elastic Compute Cloud (EC2) インスタンスのログを確認し、エラーの原因を探ることができます。
エラーの原因を突き止めると、Cloud Builder アプリの [Back (戻る)] をクリックし、必要に応じてパラメーターを修正し、配置を再試行します。あるいは、失敗した配置を削除して、新しい配置を作成することもできます。
ArcGIS Enterprise Cloud Builder for Amazon Web Services アプリが何度もクラッシュし、ArcGIS Enterprise Cloud Builder for AWS の機能が停止したことを示すエラーが返されます。
ArcGIS Enterprise Cloud Builder for Amazon Web Services アプリがクラッシュし、エラー メッセージ: [ArcGIS Enterprise Cloud Builder for AWS has stopped working. A problem caused the program to stop working correctly. Windows will close the program and notify you if a solution is available (ArcGIS Enterprise Cloud Builder for AWS の機能が停止しました。問題が発生したため、プログラムが正常に動作していません。Windows がプログラムを終了します。解決策が見つかると通知します)]. というエラー メッセージが表示される場合、必須の Microsoft Visual C++ 再頒布可能パッケージがコンピューターにインストールされていない可能性があります。詳細については、Cloud Builder の前提条件と、パッケージをダウンロードするリンクをご参照ください。
ArcGIS Enterprise Cloud Builder CLI for AWS ユーティリティの実行中に発生しうるエラー
ArcGIS Enterprise Cloud Builder CLI for AWS ユーティリティの実行中によく発生するメッセージや問題と、その対処法をいくつか示します。
操作権限エラー。
ArcGIS Enterprise Cloud Builder CLI for AWS ユーティリティを実行するユーザーには、Logs および Output フォルダーへの書き出しアクセス権限 (階層を再帰的にたどった全フォルダーが対象) が必要です。該当する操作権限が付与されているか確認してください。
「Cannot find file <file_name>」というメッセージが表示されます。
JSON 形式の設定ファイルを、Configuration フォルダー、またはそのいずれかのサブフォルダー以下に置く必要があります。ない場合は Configuration 以下に移動し、改めてユーティリティを実行してください。
「Invalid deployment configuration file extension. It must be '.json'」というメッセージが表示されます。
設定ファイルは拡張子が .json でなければなりません。そうでない場合は、拡張子を変更した上で、改めて実行してください。
「Invalid JSON format for file <file_name>」というメッセージが表示されます。
設定ファイルの内容は、有効な JSON 形式でなければなりません。
ヒント:
JSONLint などの JSON バリデーターで検証してください。
「Failed to access AWS account with provided credentials」というメッセージが表示されます。
JSON 設定ファイルに有効な AWS 証明書があって、ユーティリティが AWS に接続できるようになっていることを確認してください。証明書が有効であれば、次に、ArcGIS Enterprise Cloud Builder CLI for AWS ユーティリティを実行するコンピューターから、アカウントにアクセスできることを確認します。
ArcGIS Enterprise Cloud Builder CLI for AWS ユーティリティで PREP コマンドを実行する際、アクセスが拒否された旨のエラー。
配置ファイルに既存の Amazon Simple Storage Service (S3) バケットを使っている場合、バケットを読み書きする、適切な操作権限があることを確認してください。
ArcGIS Enterprise Cloud Builder CLI for AWS ユーティリティで CREATE コマンドを実行した後、出力ファイルを開いてみると、ここに載っていないコンポーネントがある。
CREATE コマンドの出力ファイルには、ユーティリティが AWS 上に作成したコンポーネントごとに見出しがあります。この見出しがそれぞれ、設定 JSON ファイルに記述したノードに対応しています。設定ファイル中のノードは、ユーティリティが作成するべきコンポーネントを表します。設定ファイルから除外したノードに対応するコンポーネントは作成されません。
設定ファイル中の各ノードには、少なくとも 1 つ、パラメーターが必要です。"Default" ノード以下にパラメーターをすべて記述しても足りません。作成しようとする配置の各部分にノードを対応づけ、それぞれに対して少なくとも 1 つ、パラメーターと値がなければなりません。設定ファイル中にノードがあってもパラメーターがなければ、そのノードは無視されます。たとえば、ArcGIS GIS Server サイトのパラメーターを "Default" に記述する、設定ファイルに空の "Server" ノードを置く、といったことはできません。ユーティリティはこの場合、ArcGIS GIS Server サイトを作成しないことになります。
設定ファイルに、必要なノードをすべて記述したこと、配置する各コンポーネントに少なくとも 1 つ、パラメーターがあることを確認してください。設定ファイルに記述する各ノードの必須パラメーターの一覧については、「ArcGIS Enterprise Cloud Builder CLI for AWS パラメーター」をご参照ください。
ArcGIS Enterprise Cloud Builder CLI for AWS ユーティリティを実行すると、コマンド プロンプトの実行が停止したように見えます。
ArcGIS Enterprise Cloud Builder CLI for AWS ユーティリティまたは Microsoft Windows コマンド ウィンドウで実行した任意のユーティリティの実行が停止した場合は、コマンド ウィンドウの [簡易編集モード] を無効にします。
AWS CloudFormation スタックの作成のトラブルシューティング
AWS CloudFormation コンソールを使用して、AWS CloudFormation スタックのステータスを監視し、スタックの作成が失敗したかどうかを検出します。(AWS CloudFormation の一部である) AWS Management Console コンソールにログインして、[Events (イベント)] タブを開き、スタックの作成、更新、削除に関する情報を見つけます。スタックの作成に失敗した場合、通常、[Events (イベント)] タブの情報によって、失敗した原因の概要を把握できます。
Esri CloudFormation テンプレートは、ログ ファイルを仮想マシン上に作成するようにもなっており、トラブルシューティングに役立てることができます。配置の起動が失敗した場合でも、ファイルが保持されるようにするには、AWS CloudFormation コンソールにサイン インして、失敗時のロールバック オプションを無効化します。
Esri テンプレートから起動するときに配置が失敗した場合、Amazon Elastic Compute Cloud (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 Management Console にログ グループへのリンクが示されます。スタックの作成が失敗した場合は、AWS Management Console で CloudFormation の [Resources (リソース)] リストに移動して、ログ グループを見つけます。インスタンスが起動される前にスタックの作成が失敗した場合、ログ グループが作成されていない可能性がある点に注意してください。
AWS CloudFormation スタックの起動時に発生するエラー
AWS CloudFormation テンプレートを使って配置する際によく発生するメッセージや問題と、その対処法をいくつか示します。
[Launch (起動)] をクリックしてインスタンスを起動しようとすると、容量不足のエラーが表示されるのはなぜですか？
これは Amazon Elastic Compute Cloud が発行するエラーで、新しいインスタンスに対するリクエストを処理するために必要な容量が不足していることを示しています。配置先のアーキテクチャで可能な場合は、インスタンスを別のアベイラビリティ ゾーンで要求するか、EC2 にアベイラビリティ ゾーンを選択させることで、このエラーを回避できる場合があります。他には、異なるサイズのインスタンスを構築するか、後でインスタンスを構築する方法があります。
「Error encountered during build of config: Failed to retrieve https://.s3.amazonaws.com/」というメッセージが cfn-init.log に出力されていますが、これは何ですか？
cfn-init.log ファイルにこのメッセージが現れている場合、配置の S3 バケット名が正しいこと、および認証ファイルの S3 オブジェクト キー名と SSL 証明書が正しいことを確認してください。
「Unable to connect to WebAdaptor URL: https://agsportalssl.esri.com/server/webadaptor」というメッセージが catalina.out ログ ファイルに出力されていますが、これは何ですか？
Ubuntu インスタンス上の catalina.out ログ ファイルにこのメッセージが現れている場合、配置の S3 バケットに含まれる SSL 証明書が有効であり、PKCS 12 形式であることを確認してください。また、入力された SSL 証明書のパスワードが正しいことも確認してください。
「OpenSSL::PKCS12::PKCS12Error: PKCS12_parse: mac verify failure」というメッセージが chef-run.log ファイルに出力されていますが、これは何ですか？
Windows インスタンス上の chef-run.log ファイルにこのメッセージが現れている場合、配置の S3 バケットに含まれる SSL 証明書が有効であり、PKCS 12 形式であることを確認してください。また、入力された SSL 証明書のパスワードが正しいことも確認してください。
AWS Management Console のトラブルシューティング
AWS Management Console および Esri Amazon Machine Image を使い、手作業でサイトを作成する際、次のようなエラー メッセージが現れることがあります。
Windows 上で EC2 インスタンスの管理者パスワードを取得しようとしたら、[No password was found. (パスワードが見つかりませんでした)] というメッセージが表示されるのはなぜですか？
このメッセージは、EC2 インスタンスを停止および開始した後に、[Get Windows Password] を使用しようとすると表示されます。このエラーを回避するには、最初にサイン インしたときに、管理者パスワードを覚えやすい値に変更します。
AWS Management Console から、私のインスタンスが廃止される予定であるというメッセージを受信しました。これは何を意味しているのでしょうか？
このメッセージは、劣化したハードウェア上でインスタンスが動作しており、Amazon が交換を必要としている場合に表示されます。このメッセージが表示された場合は、サイトを停止してからもう一度起動する必要があります。
サイトを再起動した後に、メッセージは表示されなくなります。