Jira アプリケーションの TCP ポートの変更

システム管理

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

Jira アプリケーションの TCP ポートを変更する理由

既定では、Jira アプリケーションは TCP リスニング ポートに 8080 を使用しているため、通常、Jira アプリケーションを http://<yourserver>:8080 で利用できます。

ただし、 PC 上で実行している既存のサービスがポート 8080 を要求している場合、競合が発生し、Jira アプリケーション は起動に失敗します。次のようなエラーを確認できる場合があります。

LifecycleException:  Protocol handler initialization failed: java.net.BindException: Address already in use:8080

これは、他の TCP リスニング ポート (例: 8100) とシャットダウン ポート (例: 8015) を使用するように Jira アプリケーションを変更することで修正できます。

Jira アプリケーションの TCP ポートを変更する

Jira アプリケーションの TCP ポートを変更する前に、次の点をご確認ください。

  • ポート番号の選定: 選定すべきポート番号が不明な場合、netstat などのツールで使用されていないポート番号を確認し、Jira アプリケーションに割り当て可能なポート番号を判断します。使用可能なポート番号の最大値は 65535 です。これは 16 ビットの符号なし 2 進数で表せる一番大きな数字です。一般的なインターネット サービスでよく使用されているポート番号が IANA (Internet Assigned Numbers Authority) に登録されています。これらのポート番号は避けることをおすすめします。
  • ファイアウォールについての注意: Jira にポート番号を割り当てる時、ポート番号に基づき、ファイアウォールによって Jira への接続がブロックされる可能性があることにご注意ください。ローカル ネットワークをファイアウォールで保護している組織では一般に、新しいポートやホスト上で動作する Web ベースのアプリケーション (Jira など) をインストールする際には、ファイアウォール設定の変更を考慮する必要があります。個人用のノート PC やデスクトップ PC でも、同様の変更を必要とするファイアウォール ソフトウェアがインストールされている場合が多くあります。ファイアウォール外から Jira にアクセスする必要がない場合、ファイアウォール設定の変更は不要です。

Jira の TCP ポートは、Jira 設定ツールを使うか、‪server.xml ‬ファイルを手動で編集することで変更できます。"Windows Installer"、"‪Linux Installer" 、または "アーカイブ ファイル" を使用して Jira をインストールした場合は Jira 設定ツールを使用できます。

Jira 設定ツールを使用して Jira の TCP ポートを変更する

  1. Jira 設定ツールを起動します。ツールを見つける方法については「Jira 設定ツールの使用」をご参照ください。
  2. Web Server タブをクリックします。
  3. HTTP Port フィールドに、 新しい TCP リッスンポート番号を入力します。
  4. Control Port フィールドに、新しい TCP シャットダウンポート番号を入力します。
  5. [保存] ボタンをクリックします。変更内容が、Jira アプリケーション インストール ディレクトリconf サブディレクトリの server.xml ファイルに保存されます。

server.xml ファイルを編集して Jira の TCP ポート番号を変更する

Jira インストール ディレクトリの conf サブディレクトリにある server.xml ファイルを編集します。このファイルは次のような記述で始まります:

<Server port="8005" shutdown="SHUTDOWN">

  <Service name="Catalina">

    <Connector port="8080"
      maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
      enableLookups="false" redirectPort="8443" relaxedPathChars="[]|" relaxedQueryChars="[]|{}^\`&quot;&lt;&gt;" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" />

    ...

例えば、シャットダウン ポートを "8005" から "8015" に、リスニング ポート (例: <connector/> 要素内) を "8080" から "8100" に変更します (Jira で使用する TCP ポート番号の決定については、以下をお読みください)。

次に、Jira を再起動し、ブラウザで http://<yourserver>:8100 にアクセスします。

(minus) Unix サーバーを実行していて、1024 よりも小さいポート (例: ポート 80) をバインドしている場合、ポートをうまくバインドするには Jira を root として起動する必要があります

関連トピック

Confluence のリスニング ポートを変更する

最終更新日: 2021 年 12 月 9 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.