JIRA の TCP ポート番号設定の変更

JIRA の TCP ポート番号設定を変更する理由

By default, JIRA uses TCP listening port 8080 (including default Apache Tomcat installations running JIRA WAR) and hence, JIRA is typically available at http://<yourserver>:8080.

しかし、同一マシンで起動中の既存サービスがすでにポート 8080 を使用している場合、競合が起き、JIRA は起動できません。次のようなエラーメッセージが表示されるでしょう:

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

この競合を回避するために、JIRA に別の TCP リッスンポート番号 (例、8100) とシャットダウンポート番号 (例、8015) を設定します。

JIRA の TCP ポート番号設定の変更

JIRA の TCP ポート番号を変更する前に、まず以下をお読みください:

• Which port number should I choose? If you are not sure which port number to choose, use a tool such as netstat to determine which port numbers are free to use by JIRA. The highest port number that can be used is 65535 because it is the highest number which can be represented by an unsigned 16 bit binary number. The Internet Assigned Numbers Authority (IANA) lists the registration of commonly used port numbers for well-known Internet services, it's advisable to avoid any of those ports.
• ファイアウォールに関する注意: JIRA にポート番号を割り当てる時、ファイアウォールが指定したポート番号によって JIRA への接続を許可しないかもしれないことに注意してください。ファイアウォールでローカル ネットワークを保護している組織は通常、新しいポートやホスト上で動作する Web ベースのアプリケーション (JIRA など) をインストール時には必ず、使用中のファイアウォールの設定を考慮する必要があります。個人用のノート PC やデスクトップ PC でさえ、同様の変更を必要とするファイアウォールソフトウェアがインストールされている場合が多々あります。ファイアウォール外から JIRA にアクセスする必要がない場合は、ファイアウォール設定の変更は必要ありません。
• JIRA WAR を使用している場合、JIRA を実行する Tomcat インストールの JIRA の TCP ポート番号の変更は、同一Tomcat インストールにデプロイされている他の Web アプリケーションに影響を及ぼすことにご注意ください。

You can change JIRA's TCP ports by using the JIRA configuration tool or by manually editing the server.xml file. If you installed JIRA using the 'Windows Installer', 'Linux Installer' or from an 'Archive File', you can use the JIRA configuration tool. The JIRA WAR distribution does not include this tool.

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

1. Start the JIRA configuration tool, see Using the JIRA Configuration Tool for instructions on where to find the tool.
2. Web Server タブをクリックします。
3. HTTP Port フィールドに、 新しい TCP リッスンポート番号を入力します。
4. Control Port フィールドに、新しい TCP シャットダウンポート番号を入力します。
5. Click the Save button. Your changes are saved to the server.xml file located in the conf subdirectory of your JIRA Installation Directory.

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

Edit the server.xml file in the conf subdirectory of the JIRA Installation Directory (or of the Apache Tomcat installation that runs your JIRA WAR installation). The start of the file looks like:

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

  <Service name="Catalina">

    <Connector port="8080"
      maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
      enableLookups="false" redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" />

    ...

For example, change the shutdown port from "8005" to "8015" and the listening port (i.e. in the <connector/> element) from "8080" to "8100". (See below to decide which TCP port numbers should be used for JIRA.)

Then, restart JIRA and point a browser to http://<yourserver>:8100

If you are running on a Unix server and bind the ports below 1024 (such as port 80 for example), you will need to start JIRA as root in order to successfully bind to the port.

関連トピック

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