ArcGIS Enterprise および ArcGIS Server を AWS 上に配置する方法は数多くあります。このトピックでは、配置オプションのタイプごとに、生じうる問題への対処法を解説します。
ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services のトラブルシューティング
ArcGIS Enterprise Cloud Builder CLI for AWS ユーティリティおよびファイルを抽出した位置の Logs フォルダー以下に、2 つのフォルダーがあります。
Logs フォルダー以下には次の 2 つのサブフォルダーがあります。
- Log - コンソール ログを収容します。ユーティリティを実行する都度、作成されるファイルです。Log フォルダーには CloudFormation イベント ログもあります。配置の際に作成した各スタックごとに、CREATE コマンドを実行する都度出力されます。
- ErrorLog - エラー ログ ファイルを収容します。ArcGIS Enterprise Cloud Builder CLI for AWS ユーティリティの実行中に発生したエラーを記録するものです。エラー ログを調べれば、エラーに対して効率的に対処できます。
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 コマンドを実行する際、アクセスが拒否された旨のエラー。
配置ファイルに既存の 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 マネジメント コンソールの一部である) 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] リストに移動して、ログ グループを見つけます。インスタンスが起動される前にスタックの作成が失敗した場合、ログ グループが作成されていない可能性がある点に注意してください。
AWS CloudFormation スタックの起動時に発生するエラー
AWS CloudFormation テンプレートを使って配置する際によく発生するメッセージや問題と、その対処法をいくつか示します。
[作成] をクリックしてインスタンスを作成しようとすると、容量不足のエラーが表示されるのはなぜですか？
これは Amazon EC2 が発行するエラーで、新しいインスタンスに対するリクエストを処理するために必要な容量が不足していることを示しています。配置先のアーキテクチャで可能な場合は、インスタンスを別のアベイラビリティ ゾーンで要求するか、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 マネジメント コンソールに関するトラブルシューティング
AWS Management Console および Esri Amazon Machine Images を使い、手作業でサイトを作成する際、次のようなエラー メッセージが現れることがあります。
Windows 上で EC2 インスタンスの管理者パスワードを取得しようとしたら、「No password was found.」というメッセージが表示されるのはなぜですか？
このメッセージは、EC2 インスタンスを停止および開始した後に、[Get Windows Password] を使用しようとすると表示されます。このエラーを回避するには、最初にログインしたときに、管理者パスワードを覚えやすい値に変更します。
AWS マネジメント コンソールから、私のインスタンスが廃止される予定であるというメッセージを受信しました。これは何を意味しているのでしょうか？
このメッセージは、劣化したハードウェア上でインスタンスが動作しており、Amazon が交換を必要としている場合に表示されます。このメッセージが表示された場合は、サイトを停止してからもう一度起動する必要があります。
ArcGIS Server Cloud Builder on Amazon Web Services を使用してサイトを作成した場合は、Cloud Builder を使用してサイトを停止して起動してください。
サイトを再起動した後に、メッセージは表示されなくなります。
ArcGIS Server Cloud Builder on Amazon Web Services のトラブルシューティング
ArcGIS Server Cloud Builder on Amazon Web Services の使用時に問題が発生した場合、エラー ログなどの情報が出力されるテキスト ファイルを作成し、問題のトラブルシューティングに役立てることができます。
ArcGIS Server Cloud Builder on Amazon Web Services のデバッグレベルのログ出力を有効にするには、以下の手順に従います。
- ArcGIS Server Cloud Builder on Amazon Web Services を実行している場合、これを閉じます。
- ArcGIS Server Cloud Builder on Amazon Web Services がインストールされているコンピューターの loglevel フォルダーに %USERPROFILE%\documents\ArcGISCloudBuilder という名前のプレーン テキスト ファイルを作成します。
ファイル名には、どの拡張子も含めないでください。たとえば、ファイル名は loglevel.txt ではなく loglevel にする必要があります。
- テキスト エディターでファイルを開き、最初の行に「DEBUG」と入力します。
- 編集したファイルを保存して閉じます。
- ArcGIS Server Cloud Builder on Amazon Web Services を再起動し、トラブルシューティングしようとしている問題が発生した手順を繰り返します。
これで、デバッグ レベルのログがログ ファイルに書き込まれるようになります。ArcGIS Server Cloud Builder on Amazon Web Services は、ログ ファイルに書き込むときに、ファイル名の末尾に YYYY-MM-DD の形式で日付を付け加えます。
ArcGIS Server Cloud Builder on Amazon Web Services を使用している間、新しいログ ファイルが毎日作成されます。古いログ ファイルは、必ず削除してください。
ArcGIS Server Cloud Builder on Amazon Web Services の使用中に現れるエラー
ArcGIS Server サイトを ArcGIS Server Cloud Builder on Amazon Web Services で作成する際によく発生するメッセージや問題と、その対処法をいくつか示します。
Windows 上で、新規に作成された ArcGIS Server サイトへのリモート デスクトップ接続を作成できないのはなぜですか？
まず、サイトの構築が完了するまで時間がかかります。ArcGIS Server Cloud Builder on Amazon Web Services を使用してサイトを作成した場合、[サイト一覧] ウィンドウにすべてのサイト情報と、サイトの停止、更新、削除用などのボタンが表示されるまでお待ちください。
AWS マネジメント コンソールまたは CloudFormation テンプレートを使用してサイトを構築した場合は、AWS マネジメント コンソールでインスタンスを右クリックして [Get System Log] をクリックします。Windows が使用可能になったというメッセージが表示されたら、さらに 5 分程待ってからログインしてください。
次に、ポート 3389 を経由するリモート デスクトップ接続を許可するルールがサイトのセキュリティ グループに追加されていることを確認します。これについては、「ArcGIS の Amazon EC2 セキュリティ グループの利用」で説明しています。
ログインすると ArcGIS Server Cloud Builder on Amazon Web Services により「Failed to get a list of custom configuration templates. Forbidden.」というメッセージが表示されます。これは何を意味しているのでしょうか？
このメッセージが表示される原因はいくつか考えられますが、システム時間が実際の時間と同期していないために表示される場合があります。たとえば、夏に時間を 1 時間進める地域に住んでいて、コンピューターの時間がこの変更と同期していない場合、ArcGIS Server Cloud Builder on Amazon Web Servicesは Amazon EC2 で特定の処理を実行できません。