ネットワークと接続性のトラブルシューティング ガイド
This page is a part of our Application Links Troubleshooting.
The first part of this page describes the specific network and connectivity errors that can be diagnosed automatically by application links and the actions you can take to correct those errors.
後半では、アプリケーション リンクを使用したときに発生する可能性があるネットワークおよび接続エラーの特定および修正に役立つ、一般的なトラブルシューティング ガイドを提供しています。
このページの内容
- 一般的なネットワークおよび接続エラー
- リモート アプリケーションにアクセスできない
- リモート アプリケーションが応答しない
- ファイアウォールによってリクエストがブロックされる
- ネットワーク リクエストのタイムアウト
- リモート アプリケーションが見つからない
- ネットワーク応答のタイムアウト
- 予期せぬレスポンス
- アプリケーション リンクの一般的な接続エラーのトラブルシューティング
- ログのエラー メッセージ
- アプリケーション ログの場所
- Server.xml の場所
- ネットワーク接続ツール
一般的なネットワークおよび接続エラー
リモート アプリケーションにアクセスできない
アプリケーション リンクがリモート アプリケーションへの接続を試みましたが、リモート アプリケーションのホスト名を解決できませんでした。
アトラシアン アプリケーションのログに次のようなエラー メッセージが表示される場合があります。
java.net.UnknownHostException: Unable to resolve host考えられる原因 | 実行可能な対応策 |
|---|---|
| DNS の構成に誤りがある。 | 特にプライベート ネットワークについて、DNS 構成を確認します。 See nslookup below. |
| リモート アプリケーションのアプリケーション URL の構成に誤りがあるか、アプリケーション URL が最近変更されている可能性があります。 | リモート アプリケーションのアプリケーション URL を確認します。 * Is the host name correct? * Is the port correct? * Is the context path correct? * Does the application URL match the base URL for the remote application (or the display URL if the remote application is behind a reverse proxy)? |
リモート アプリケーションが応答しない
アプリケーション リンクがリモート アプリケーションへの接続を試みましたが、接続が却下されました。
アトラシアン アプリケーションのログに次のようなエラー メッセージが表示される場合があります。
java.net.ConnectException: Connection refused考えられる原因 | 実行可能な対応策 |
|---|---|
| リモート アプリケーションがダウンしている。 | ブラウザでアプリケーション URL (リモート アプリケーションがリバース プロキシの背後にある場合は表示 URL) を使用し、リモート アプリケーションが動作しているかどうかを確認します ブラウザでリモート アプリケーションにアクセスできない場合、ローカル サーバーからリモート アプリケーションの URL に ping します。アプリケーション リンクが適切に動作するには、アプリケーション URL を使用してリモート アプリケーションにアクセス可能である必要があります。以降の「ping」をご確認ください。 |
アプリケーション URL の構成に誤りがあります。 | ローカルの終端でアプリケーション URL の構成を確認します。 * Does the application URL use the correct port? * If you're using the IP address for the application URL, is that correct? * Does the application URL match the base URL of the remote application (or the display URL if the remote application is behind a reverse proxy )? * Does the application URL use the correct context path? |
| ファイアウォールがアクセスをブロックしている。 | Check that the firewall configuration allows access on the required port, using the network tools described below. |
ファイアウォールによってリクエストがブロックされる
アプリケーション リンクがリモート アプリケーションへの接続を試みましたが、リモート アプリケーションへのリクエストがネットワークのファイアウォールによってブロックされています。
ブラウザに HTTP 405 メッセージが表示される場合があります。
考えられる原因 | 実行可能な対応策 |
|---|---|
ファイアウォールがリクエストをブロックしています。 | * Check that the firewall configuration allows HTTP requests (such as PUT) on the required port. |
ネットワーク リクエストのタイムアウト
アプリケーション リンクはリモート アプリケーションに到達できましたが、接続を確立できませんでした。
アトラシアン アプリケーションのログに次のようなエラー メッセージが表示される場合があります。
java.net.ConnectException: connect timed out考えられる原因 | 実行可能な対応策 |
|---|---|
リモート アプリケーションがデッドロックになっています。 | * Check that the remote application is operational, by accessing it as usual from the browser. |
ファイアウォールがリクエストをブロックしています。 | * Check that the firewall configuration allows HTTP requests on the required port. |
リモート アプリケーションが見つからない
アプリケーション リンクがリモート アプリケーションへの接続を試みましたが、到達できませんでした。
You may see this error message in the Atlassian application logs:
java.net.NoRouteToHostException考えられる原因 | 実行可能な対応策 |
|---|---|
ファイアウォールがリクエストをブロックしています。 | * Check that the firewall configuration allows access on the required port. * Use a tool like |
| 中間ルーターがダウンしています。 | * Use a tool like |
ネットワーク応答のタイムアウト
アプリケーションがリモート アプリケーションとの接続を確立できましたが、レスポンスを受け取ることができませんでした。
アトラシアン アプリケーションのログに次のようなエラー メッセージが表示される場合があります。
java.net.SocketTimeoutException: connect timed out考えられる原因 | 実行可能な対応策 |
|---|---|
リモート アプリケーションがデッドロックになっています。 | * Check that the remote application is operational, by accessing it as usual from the browser. |
| ネットワークの接続に問題があります。 | * Use the tools described below to check the connection with the remote machine. |
予期せぬレスポンス
アプリケーション リンクがリモート アプリケーションへの接続を試みましたが、予期せぬ HTTP レスポンスを受け取りました。これはほとんどの場合、リモート アプリケーションが HTTP 50x レスポンスのみを返すプロキシの背後にあることを示します。
You may see these error messages in the Atlassian application logs:
UNEXPECTED_RESPONSE
UNEXPECTED_RESPONSE_STATUS
<response code>
<response body>考えられる原因 | 実行可能な対応策 |
|---|---|
HTTP 403: Forbidden* This usually indicates an authentication failure. However application links report authentication failures differently from a 403, so this suggests a problem with the proxy configuration instead. | * The remote application is behind a misconfigured proxy. Check the local application logs for the * If the application has been configured with an outbound proxy, the remote application URL can be added to the nonProxyHosts to allow the application link to bypass it. ** See How to Configure Outbound HTTP and HTTPS Proxy for your Atlassian application * nonProxyHosts may be configured incorrectly and non-functional. See: ** Jira server ignores http.nonProxyHosts JVM option ** JAVA Option '-Dhttp.nonProxyHosts' Does Not Work on Windows OS |
HTTP 404: Page not found* The application URL used to configure the application link is not correct, or the application's address has changed. | * Check that the application URL used to configure the application link is correct for the remote application. |
HTTP 405: Method not allowed* A firewall or proxy is preventing HTTP requests. | * Check the firewall or proxy configuration to see if HTTP requests (such as PUT) are allowed on the required port. * See A firewall is blocking requests above. |
HTTP 500: Internal server error* The remote application may not be behind a proxy, but the application may have an error, such as an out of memory error. | * Check that the remote application is operational, by accessing it as usual from the browser. * Check the application error logs. |
HTTP 503: Service unavailable* The remote application is behind a proxy and is down. | * Check that the remote application is operational by accessing it directly from your browser. * Restart the remote application, or contact your administrator. * See The remote application is not responding above. |
HTTP 504: Gateway timeout* The remote application is behind a proxy and has timed out. | * Try again later. * Check that the remote application is operational, by accessing it as usual from the browser. * Restart the remote application if necessary, or contact your administrator. |
ステータスなし、または前述のステータスとは異なるステータスが返される | * The remote application is behind a misconfigured proxy. Check the local application logs for the * The remote application is not actually of the type selected when configuring the application link. Check that the Application Type for the application link matches the remote application type. If it doesn't, you'll need to recreate the application link, making sure to choose the correct option for Application Type. See Link Atlassian applications to work together. |
アプリケーション リンクの一般的な接続エラーのトラブルシューティング
以降の一般的なトラブルシューティング ガイドを使用して、上述のよくあるエラー タイプでは網羅されていない、アプリケーション リンクの接続の問題の解決にご利用ください。
| 考えられる原因 | 可能な処置 |
|---|---|
アプリケーションをホストするサーバーが実行されていない。 | * Check that the remote server is actually running. |
1 つまたは両方のサーバーがネットワークに接続されていない。 | * Check that you can reach each server by pinging each server from the other. See ping below. |
アプリケーションをホストしているサーバーが実行されているが、アプリケーションが接続しようとしているポートでリッスンしていない。 | * Check the |
ホスト アドレスとポートの特定の組み合わせを使用する接続が、ファイアウォールまたはその他のネットワーク デバイスによってブロックされている。 | * Use telnet to test that the remote server accepts connections on a specific port. |
リモート アプリケーションをホストしているサーバーでのアドレスとポートの組み合わせに誤りがあるか、組み合わせが変更された。 | * Check the current location of the remote server. |
接続に使用されているプロトコルが誤っている (例: HTTPS ではなく HTTP を使用している)。 | * Check the |
ログのエラー メッセージ
アプリケーション ログ (またはブラウザ ウィンドウの HTTP メッセージ) に次のエラー メッセージが表示される場合があります。
詳細な情報については上述のリンクをご利用ください。
アプリケーション ログの場所
| ロギング構成 | アプリケーション ログ | Tomcat Web サーバーログ |
|---|---|---|
| Bamboo | <Bamboo installation directory> /logs | |
| Bitbucket Server / Stash | <Bitbucket ホームディレクトリ>/log <Stash ホームディレクトリ>/log | <Bitbucket Server installation directory>/logs <Stash installation directory>/logs |
| Confluence | <Confluence home directory>/logs | <Confluence installation directory >/logs |
| Crowd | <Crowd ホームディレクトリ>/logs | <Crowd インストールディレクトリ>/apache-tomcat/logs |
| Crucible | <Crucible installation directory>/var/log/ | |
| Fisheye | <FishEye installation directory>/var/log/ | |
| Jira アプリケーション | <JIRA アプリケーションホームディレクトリ>/log | <JIRA application installation directory>/logs |
Consider enabling the DEBUG level of logging on the application to get more detailed logs – DEBUG adds all stack traces, and includes HTTP response messages.
Server.xml の場所
server.xml ファイルの場所は、ご利用のアプリケーション、オペレーティング システム、およびインストール先に応じて異なります。
アトラシアン アプリケーションで共通の既定のインストール先は、次のとおりです。
- Linux:
/opt/atlassian/<application-name> - Windows:
C:\Program Files\Atlassian\<application-name> - Windows:
C:\Atlassian\<application-name>
アトラシアン アプリケーションのフォルダ構造内の場所:
| アプリケーション | server.xml の場所 |
|---|---|
| Bamboo | <install-path>/conf/ |
| Confluence | <install-path>/conf/ |
| Crowd | <install-path>/apache-tomcat/conf/ |
| Crucible | Fisheye と同様 |
| Fisheye | The Fisheye configuration file is config.xml, see Configuring the Fisheye web server and How to enable Fisheye/Crucible to listen to web requests on additional ports. |
| Jira アプリケーション | <install-path>/conf/ |
| Bitbucket Server 5.0 | N/A, replaced by <Bitbucket home directory>/shared/bitbucket.properties |
| Bitbucket Server 4.0 〜 4.14 | <Bitbucket home directory> /shared/server.xml |
| Stash 3.8 〜 3.11 | <Stash home directory>/shared/  If you are on any of these later releases but your server.xml does not exist in the directory above, it means that you are running from the <install-path>/conf/server.xml.We recommend that you copy <install-path>/conf/server.xml into <Stash home directory>/shared/ that way you won't need to worry about this when you upgrade your instance. |
| Stash 3.7 and earlier | <install-path>/conf/ |
<install-path> refers to where the application was installed on your system.
ネットワーク接続ツール
以降のツールを使用して、2 台のマシン間でのネットワーク接続をテストできます。次の項目を確認することが目的です。
- 各マシンが互いに通信できること。
- 必要なポートが開いており、そこへの接続を行えること。
- 特定のホスト名/アドレスとポートの組み合わせで、各アプリケーションが互いに通信できること。
各アプリケーション同士の間にあるファイアウォールまたは他のネットワーク デバイスが、アプリケーション同士の通信を許可するように構成されていること。
特定のネットワーク構成をバイパスし、プロキシされていないアプリケーション リンクを作成することもできます。
The ping command sends a small packet to the destination address, and notes the time it takes to respond. You can use ping to check the following:
- Network connection - if ping succeeds, then both machines are connected to the network.
- Correct DNS resolution - does the hostname (such as atlassian.com ) resolve to an IP address, and is it the correct one?
- ping を発行するマシンと宛先との間の応答時間。応答時間は短いほうが望ましいです。
traceroute
The traceroute ( tracert on Windows) command shows the flow of traffic between the current machine and the destination. Trace routes are particularly effective at identifying segments of poor performance or congestion.
telnet
The telnet command can be used to test that a host accepts a connection on a specific port. The telnet command is typically used like this:
telnet <host> <port>
例:
telnet atlassian.com 80
指定したポートでホストへの接続に成功した場合、出力は次のようになります。
telnet host.example 80
Trying 192.168.1.100...
Connected to host.example.
Escape character is '^]'.
指定したポートでホストに接続できたら、telnet セッションを終了することができます。この目的は、指定したポートで接続できることを確認することです。ファイアウォールまたは他のネットワーク構成によって接続が拒否されます。
Microsoft Windows では telnet は既定でインストールされていません。
- Use "Turn Windows features on or off" in Windows 7 to install Telnet
- Windows の Server エディションの場合、Server Manager を使用して Telnet をインストールします。
nslookup
The nslookup command is used for querying the Domain Name System (DNS) to obtain domain name or IP address mappings. It allows you to check if the remote server's DNS name can be resolved from the local server.
Typically, you run nslookup from each server and check that the correct IP address for the other server is returned.
リモートの DNS 名が解決できない場合、各サーバーの DNS エントリを更新する必要があります。
サーバーが HTTPS で接続されている場合、SSL 証明書のためにホスト アドレスのコモン ネームを更新する必要がある場合があります。