Documentation for JIRA 5.2. Documentation for other versions of JIRA is available too.

On this page:

JIRA インストレーションディレクトリ

「JIRA インストレーションディレクトリ」は、以下のいずれかの方法によって JIRA アプリケーションファイルおよびライブラリが抽出されたディレクトリを意味します:

Jira は、このディレクトリに一切のデータを保管せず、またこのディレクトリのデータの変更も行いません。

重要なファイルとディレクトリ

The directories/files described below are found under different sub-directories of the 'JIRA Installation Directory', depending on whether you have installed a 'recommended' or WAR distribution of JIRA. Please substitute the following directories for the <jira-application-dir> placeholder (used throughout the rest of this section), as follows:

  • 'Recommended' distributions — the atlassian-jira subdirectory of the 'JIRA Installation Directory' installed using the 'Windows Installer', 'Linux Installer' or from an 'Archive File'.
  • WAR distribution — the webapp subdirectory of the 'JIRA Installation Directory'.
    (info) Please Note: To edit files in this webapp directory, first copy them to the edit-webapp subdirectory (if they are not already present in edit-webapp) and edit the copies in edit-webapp. Refer to the 'Webapp Layout' section of the JIRA WAR Configuration Overview for details. Copies of the jira-application.properties and entityengine.xml file are already available in the edit-webapp sub-directory.
 

<jira-application-dir>/WEB-INF/classes/jira-application.properties

This file tells JIRA where to find the JIRA Home Directory.
(warning) Be aware that your JIRA Home Directory defined in this file can be overridden. See Setting your JIRA Home Directory for more information.

<jira-application-dir>/WEB-INF/classes/jpm.xml

This file stores the default values for JIRA's advanced configuration settings and should not be modified. The default values of properties in this file are customised (i.e. overridden) by redefining them in either the jira-config.properties file (in your JIRA Home Directory) or the JIRA database (via the JIRA administration area). See Advanced JIRA Configuration for more information.

<jira-application-dir>/WEB-INF/lib/

これは、アトラシアン のプラグインフレームワーク 1 (即ち、「Plugins 1」のプラグイン) によって構築されたプラグインが保管されているディレクトリです。新しいinstalling a new 'Plugins 1' plugin 場合、それをこのディレクトリにデプロイする必要があります。
「Plugins 2」のプラグインは、JIRA ホーム ディレクトリ

<jira-application-dir>/WEB-INF/classes/log4j.properties

JIRA のログ構成ファイルです。Logging and Profiling

Jira によって生成された実際のログファイルは、次の場所で確認できます。

  • Jira アプリケーション ログbin/atlassian-jira.log
  • Application server log — generally the application server log file can be found under the logs directory. However, this can vary depending on the application server you are running. Please see Where are the application server logs? for further details.

<jira-application-dir>/WEB-INF/classes/entityengine.xml

このファイルは、JIRA が永続的データをデータソース内に保存する際に利用する、OFBiz エンティティエンジンを構成します。Configuring the Entity Engine for JIRA

以下に解説するサブディレクトリ/ファイルは、JIRA インストレーションディレクトリのルートに存在します。

 

conf/server.xml

このファイルは、JIRA SSL 構成に利用します。JIRA を SSL または HTTPS 上で実行する

メモリ設定

JAVA_OPTS メモリ設定の編集に使用されるファイルは、Jira のインストール方法、およびインストールに使用されたオペレーティング システムによって異なります。

たとえば、Windows 上で Tomcat を使用して Jira を実行する場合 (手動セットアップ)、次のファイルを更新します:
bin\setenv.bat
一方、Linux / Unix 上で Tomcat を使用して Jira を実行する場合、次のファイルを更新します:
bin/setenv.sh

詳しくは Increasing JIRA Memory を参照して下さい。

JIRA ホーム ディレクトリ

”JIRA Home Directory” には JIRA の機能性の定義に関連する重要なデータがあります。このドキュメントでは、JIRA Home Directory 内にある各種ファイルとサブディレクトリの目的を概説します。

自動 Windows、または、Linux インストーラーを使用して JIRA をインストールした場合には、デフォルトの JIRA Home Directory の場所は:

  • C:\Program Files\Atlassian\Application Data\JIRA (Windows)、または
  • /var/atlassian/application-data/jira (Linux の場合)

アーカイブファイルから JIRA をインストールする 場合は、JIRA インストールがアクセスできる場所であればどこでも JIRA Home Directory を設定できます。よくある場所の例です:

  • C:\jira\home (Windows)、または
  • /var/jira-home (Linux または Solaris の場合)

(warning) However, avoid locating the JIRA Home Directory inside the JIRA Installation Directory.

(tick) For information on specifying the location of the JIRA Home Directory, please see Setting your JIRA Home Directory.

重要なファイル

dbconfig.xml

このファイル (JIRA Home Directory 内にあります) は、JIRA のデータベース接続に関連する全情報を定義するものです。通常、新規 JIRA インストール時に JIRA セットアップウィザード を実行するか、または、JIRA 設定ツール を使用してデータベース接続を設定すると、このファイルが作成されます。

You can also create your own dbconfig.xml file. This is useful if you need to specify additional parameters for your specific database configuration, which are not generated by the Setup Wizard or JIRA Configuration Tool. For more information, refer to the 'manual' connection instructions of the appropriate database configuration guide in the Connecting JIRA to a Database section.

jira-config.properties

This file (also located at the root of your JIRA Home Directory) stores custom values for most of JIRA's advanced configuration settings. Properties defined in this file override the default values defined in the jpm.xml file (located in your JIRA Installation Directory). See Advanced JIRA Configuration for more information.

(info) In new JIRA installations, this file may not initially exist and if so, will need to be created manually. See  Making changes to the jira-config.properties file for more information. This file is typically present in JIRA installations upgraded from version 4.3 or earlier, whose advanced configuration options had been customised (from their default values).

重要なサブディレクトリ

data

このディレクトリは、JIRA インスタンスのアプリケーション データを格納しています。ここには、 添付ファイル (JIRA に格納されたすべてのバージョンのすべての添付ファイル) も含まれます。

export

JIRA はこのディレクトリに automated backup archives を配置します。

log

JIRA はこのディレクトリにログを配置します。(注意: JIRA ホーム ディレクトリが設定されていない場合、これらのログは代わりにその時点のワーキング ディレクトリに配置されることになります)。

このログは、最初のログメッセージが書き込まれた時点で作成されます。例えば、内部アクセスログは、JIRA が書き込みを始めるまで作成されません。

You can change the location of the log file using log4j.properties as described in the documentation on Logging and Profiling.

plugins

This is the directory where plugins built on Atlassian's Plugin Framework 2 (i.e. 'Plugins 2' plugins) are stored. If you are installing a new 'Plugins 2' plugin, you will need to deploy it into this directory under the installed-plugins sub-directory.

“Plugins 1” プラグインは、JIRA インストールディレクトリ に格納されるべきです。

このディレクトリが存在しない場合は、 JIRA 起動時に作成されます。

caches

このディレクトリに、 JIRA は下記を含むキャッシュを格納します:

これらのファイルは JIRA のパフォーマンスに不可欠なものなので、JIRA 実行中に外部から変更または削除してはなりません。

詳細は、Search Indexing を参照してください。

tmp

多様な実行時の機能 (インポート、エクスポート、ファイルのアップロード、インデックス) で作成された一時的なコンテンツはすべて、このディレクトリに格納されます。

JIRA 実行中にこのディレクトリからファイルを削除できますが、JIRA をシャットダウンしてからこのディレクトリのコンテンツを変更することを推奨します。