ネットワークと接続性のトラブルシューティング ガイド
このページではまず、アプリケーション リンクで自動的に診断できる特定のネットワークおよび接続エラーと、それらを修正するために行える操作について説明します。
後半では、アプリケーション リンクを使用したときに発生する可能性があるネットワークおよび接続エラーの特定および修正に役立つ、一般的なトラブルシューティング ガイドを提供しています。
このページの内容
一般的なネットワークおよび接続エラー
リモート アプリケーションにアクセスできない
アプリケーション リンクがリモート アプリケーションへの接続を試みましたが、リモート アプリケーションのホスト名を解決できませんでした。
アトラシアン アプリケーション ログに次のようなエラー メッセージが表示される場合があります。
java.net.UnknownHostException: Unable to resolve host
考えられる原因 | 実行可能な対応策 |
---|---|
DNS の構成に誤りがある。 | 特にプライベート ネットワークについて、DNS 構成を確認します。 後述の「nslookup」をご確認ください。 |
リモート アプリケーションのアプリケーション URL の構成に誤りがあるか、アプリケーション URL が最近変更されている可能性があります。 | リモート アプリケーションのアプリケーション URL を確認します。
|
リモート アプリケーションが応答しない
アプリケーション リンクがリモート アプリケーションへの接続を試みましたが、接続が却下されました。
アトラシアン アプリケーション ログに次のようなエラー メッセージが表示される場合があります。
java.net.ConnectException: Connection refused
考えられる原因 | 実行可能な対応策 |
---|---|
リモート アプリケーションがダウンしている。 |
|
アプリケーション URL の構成に誤りがあります。 | ローカルの終端でアプリケーション URL の構成を確認します。
|
ファイアウォールがアクセスをブロックしている。 | 以降の「ネットワーク ツール」を使用し、ファイアウォール構成が対象のポートを許可しているかどうかを確認します。 |
ファイアウォールによってリクエストがブロックされる
アプリケーション リンクがリモート アプリケーションへの接続を試みましたが、リモート アプリケーションへのリクエストがネットワークのファイアウォールによってブロックされています。
ブラウザに HTTP 405 メッセージが表示される場合があります。
考えられる原因 | 実行可能な対応策 |
---|---|
ファイアウォールがリクエストをブロックしています。 |
|
ネットワーク リクエストのタイムアウト
アプリケーション リンクはリモート アプリケーションに到達できましたが、接続を確立できませんでした。
アトラシアン アプリケーション ログに次のようなエラー メッセージが表示される場合があります。
java.net.ConnectException: connect timed out
考えられる原因 | 実行可能な対応策 |
---|---|
リモート アプリケーションがデッドロックになっています。 |
|
ファイアウォールがリクエストをブロックしています。 |
|
リモート アプリケーションが見つからない
アプリケーション リンクがリモート アプリケーションへの接続を試みましたが、到達できませんでした。
アトラシアン アプリケーション ログに次のようなエラー メッセージが表示される場合があります。
java.net.NoRouteToHostException
ネットワーク応答のタイムアウト
アプリケーションがリモート アプリケーションとの接続を確立できましたが、レスポンスを受け取ることができませんでした。
アトラシアン アプリケーション ログに次のようなエラー メッセージが表示される場合があります。
java.net.SocketTimeoutException: connect timed out
考えられる原因 | 実行可能な対応策 |
---|---|
リモート アプリケーションがデッドロックになっています。 |
|
ネットワークの接続に問題があります。 |
|
予期せぬレスポンス
アプリケーション リンクがリモート アプリケーションへの接続を試みましたが、予期せぬ HTTP レスポンスを受け取りました。これはほとんどの場合、リモート アプリケーションが HTTP 50x レスポンスのみを返すプロキシの背後にあることを示します。
アトラシアン アプリケーション ログに次のようなエラー メッセージが表示される場合があります。
UNEXPECTED_RESPONSE
UNEXPECTED_RESPONSE_STATUS
<response code>
<response body>
考えられる原因 | 実行可能な対応策 |
---|---|
HTTP 403: Forbidden
|
|
HTTP 404: Page not found
|
|
HTTP 405: Method not allowed
|
|
HTTP 500: Internal server error
|
|
HTTP 503: Service unavailable
|
|
HTTP 504: Gateway timeout
|
|
ステータスなし、または前述のステータスとは異なるステータスが返される |
|
アプリケーション リンクの一般的な接続エラーのトラブルシューティング
以降の一般的なトラブルシューティング ガイドを使用して、上述のよくあるエラー タイプでは網羅されていない、アプリケーション リンクの接続の問題の解決にご利用ください。
考えられる原因 | 可能な処置 |
---|---|
アプリケーションをホストするサーバーが実行されていない。 |
|
1 つまたは両方のサーバーがネットワークに接続されていない。 |
|
アプリケーションをホストしているサーバーが実行されているが、アプリケーションが接続しようとしているポートでリッスンしていない。 |
|
ホスト アドレスとポートの特定の組み合わせを使用する接続が、ファイアウォールまたはその他のネットワーク デバイスによってブロックされている。 |
|
リモート アプリケーションをホストしているサーバーでのアドレスとポートの組み合わせに誤りがあるか、組み合わせが変更された。 |
|
接続に使用されているプロトコルが誤っている (例: HTTPS ではなく HTTP を使用している)。 |
|
ログのエラー メッセージ
アプリケーション ログ (またはブラウザ ウィンドウの HTTP メッセージ) に次のエラー メッセージが表示される場合があります。
詳細な情報については上述のリンクをご利用ください。
アプリケーション ログの場所
Server.xml の場所
ネットワーク接続ツール
以降のツールを使用して、2 台のマシン間でのネットワーク接続をテストできます。次の項目を確認することが目的です。
- 各マシンが互いに通信できること。
- 必要なポートが開いており、そこへの接続を行えること。
- 特定のホスト名/アドレスとポートの組み合わせで、各アプリケーションが互いに通信できること。
各アプリケーション同士の間にあるファイアウォールまたは他のネットワーク デバイスが、アプリケーション同士の通信を許可するように構成されていること。
特定のネットワーク構成をバイパスし、プロキシされていないアプリケーション リンクを作成することもできます。