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 アプリの実行中に発生したエラーが記録されます。これらのエラー ログは効果的なトラブルシューティングのため役立ちます。
Cloud Builder アプリまたは ArcGIS Enterprise Cloud Builder CLI for AWS ユーティリティの実行時に発生する可能性のある固有のエラーに関する情報については、次の 2 つのセクションをご参照ください。 アプリとユーティリティはどちらも CloudFormation スタックを起動するため、配置の問題を特定して修正するには、CloudFormation スタック作成のトラブルシューティングに関するセクションもご参照ください。
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 (エラー ログの表示)] をクリックすると、エラーの詳細を確認できます。
[Received FAILURE signal with UniqueId <unique-id>] のような一般的なエラーが表示された場合、Cloud Builder サマリー ページの [View AWS CloudWatch Logs (AWS CloudWatch ログの表示)] セクションのログ URL をクリックし、Amazon CloudWatch ログを確認します。 該当する CloudWatch ログがデフォルト Web ブラウザーに表示されます。配置の各 Amazon Elastic Compute Cloud (EC2) インスタンスのログを確認し、エラーの原因を探ることができます。
エラーの原因を突き止めたら、Cloud Builder アプリの [戻る] をクリックし、必要に応じてパラメーターを修正し、配置を再試行します。 あるいは、失敗した配置を削除して、新しい配置を作成することもできます。
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 for Amazon Web Services アプリを使用して作成した配置の CloudWatch ログは、どこにありますか？
Cloud Builder アプリが配置を作成できない場合は、ジョブ完了ページにエラー メッセージが戻されます。 ジョブ完了ページの [View Process Log (プロセス ログの表示)] と [View Error Log (エラー ログの表示)] をクリックすると、エラーの詳細を確認できます。
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 フォルダーまたは自分の作業ディレクトリのいずれかのサブフォルダーに置く必要があります。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) バケットを使っている場合、バケットを読み書きする、適切な操作権限があることを確認してください。
CREATE コマンドで ArcGIS Enterprise Cloud Builder CLI for AWS ユーティリティを実行した後、出力ファイルを開いてみると、ここに載っていないコンポーネントがある。
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 スタックの作成のトラブルシューティング
ArcGIS Enterprise on Amazon Web Services 配置ツールは、AWS CloudFormation スタックを作成します。 AWS CloudFormation コンソールを使用して、AWS CloudFormation スタックのステータスを監視し、スタックの作成が失敗したかどうかを検出します。 (AWS Management Console の一部である) AWS CloudFormation コンソールにログインして、[イベント] タブを開き、スタックの作成、更新、削除に関する情報を見つけます。 スタックの作成に失敗した場合、[イベント] タブの情報から原因を推測できます。
ArcGIS Enterprise on Amazon Web Services 配置ツールは、ログ ファイルを仮想マシン上に作成するようにもなっており、トラブルシューティングに役立てることができます。 配置の起動が失敗した場合でも、ファイルが保持されるようにするには、AWS CloudFormation コンソールにサイン インして、[失敗時のロールバック] オプションを無効化します。
Esri が提供する CloudFormation テンプレートを使用して配置を作成すると、すべての配置ログは Amazon CloudWatch ログ サービスにエクスポートされます。 配置ログの表示の詳細については、AWS ヘルプの 「View AWS CodeDeploy logs in Amazon CloudWatch console」の「View logs in the CloudWatch console」セクションをご参照ください。
配置ログは、Amazon CloudWatch のログ サービスのログ グループとして格納されています。 ログ グループには、末尾が /stderr および /stdout の名前を持つ複数のログ ストリームがあります。 障害の原因を突き止めるには、すべてのログ ストリームをご参照ください。
これらのログは、EC2 インスタンスにも格納されています。 Microsoft Windows インスタンスでは、これらのログは C:\cinc フォルダーにあります。 Ubuntu Server インスタンスでは、これらのログは /var/logs ディレクトリにあります。
CloudWatch 配置ツールを使用して作成した配置の ArcGIS Enterprise on Amazon Web Services ログは、どこにありますか？
CloudWatch 配置ツールを使用して作成した配置の ArcGIS Enterprise on Amazon Web Services ログにアクセスするには、CloudFormation コンソール (AWS Management Console の一部) にサイン インします。 AWS Web サイトの「View CloudFormation Logs in the Console」をご参照ください。
AWS CloudFormation スタックの起動時に発生するエラー
AWS CloudFormation テンプレートを使って配置する際によく発生するメッセージや問題と、その対処法をいくつか示します。
[Launch (起動)] をクリックしてインスタンスを起動しようとすると、容量不足のエラーが表示されるのはなぜですか？
これは Amazon Elastic Compute Cloud が発行するエラーで、新しいインスタンスに対するリクエストを処理するために必要な容量が不足していることを示しています。 配置先のアーキテクチャで可能な場合は、インスタンスを別のアベイラビリティ ゾーンで要求するか、EC2 にアベイラビリティ ゾーンを選択させることで、このエラーを回避できる場合があります。 他の方法として、別のサイズのインスタンスを起動する、または後でインスタンスの起動を再度試みることもできます。
「Unable to connect to WebAdaptor URL : https://agsportalssl.esri.com/server/webadaptor (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 (mac 検証に失敗)」というメッセージがログ ファイルに出力されていますが、これは何ですか？
Windows インスタンス上のログ ファイルにこのメッセージが現れている場合、配置の S3 バケットに含まれる SSL 証明書が有効であり、PKCS 12 形式であることを確認してください。 また、入力された SSL 証明書のパスワードが正しいことも確認してください。