重要なディレクトリとファイル
On this page:
JIRA インストレーションディレクトリ
- by the Windows or Linux installers, or
- by extracting the contents of a JIRA installation archive or WAR distribution archive file (i.e. a
.tar.gz
or.zip
file).
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'. Linux のデフォルトのインストレーション ディレクトリは次の通りです。
/opt/atlassian/jira/
- WAR distribution — the
webapp
subdirectory of the 'JIRA Installation Directory'.
Please Note: To edit files in this
webapp
directory, first copy them to theedit-webapp
subdirectory (if they are not already present inedit-webapp
) and edit the copies inedit-webapp
. Refer to the 'Webapp Layout' section of the JIRA WAR Configuration Overview for details. Copies of thejira-application.properties
andentityengine.xml
file are already available in theedit-webapp
sub-directory.
<jira-application-dir>/atlassian-jira/WEB-INF/classes/jira-application.properties
This file tells JIRA where to find the JIRA Home Directory.
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>/atlassian-jira/
WEB-INF/classes/jpm.xml
atlassian-jira/
WEB-INF/classes/jpm.xmlThis 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 customized (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>/atlassian-jira/
WEB-INF/lib/
atlassian-jira/
WEB-INF/lib/This is the directory where plugins built on Atlassian's Plugin Framework 1 (i.e. 'Plugins 1' plugins) are stored. If you are installing a new 'Plugins 1' plugin, you will need to deploy it into this directory.
'Plugins 2' plugins should be stored in the JIRA Home Directory.
<jira-application-dir>/atlassian-jira/
WEB-INF/classes/log4j.properties
atlassian-jira/
WEB-INF/classes/log4j.propertiesJIRA's logging configuration file. See 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>/atlassian-jira/
WEB-INF/classes/entityengine.xml
atlassian-jira/
WEB-INF/classes/entityengine.xmlThis file configures the OFBiz Entity Engine which JIRA uses to store persist data in a datasource. See Configuring the Entity Engine for JIRA.
以下に解説するサブディレクトリ/ファイルは、JIRA インストレーションディレクトリのルートに存在します。
conf/server.xml
This file is used for JIRA SSL configuration. See Running JIRA over SSL or HTTPS.
メモリ設定
JAVA_OPTS メモリ設定の編集に使用されるファイルは、Jira のインストール方法、およびインストールに使用されたオペレーティング システムによって異なります。
たとえば、Windows 上で Tomcat を使用して Jira を実行する場合 (手動セットアップ)、次のファイルを更新します:bin\setenv.bat
。
一方、Linux / Unix 上で Tomcat を使用して Jira を実行する場合、次のファイルを更新します:bin/setenv.sh
。
See Increasing JIRA Memory for further details.
JIRA ホーム ディレクトリ
If JIRA was installed using the automated Windows or Linux installers, the default location of the JIRA Home Directory is:
C:\Program Files\Atlassian\Application Data\JIRA
(Windows)、または/var/atlassian/application-data/jira
(Linux の場合)
If you install JIRA from an archive file, the JIRA Home Directory can be any suitable location that is accessible by your JIRA installation. Typical example locations might be:
C:\jira\home
(Windows)、または/var/jira-home
(Linux または Solaris の場合)
However, avoid locating the JIRA Home Directory inside the JIRA Installation Directory.
For information on specifying the location of the JIRA Home Directory, please see Setting your JIRA Home Directory.
重要なファイル
dbconfig.xml
This file (located at the root of your JIRA Home Directory) defines all details for JIRA's database connection. This file is typically created by running the JIRA Setup Wizard on new installations of JIRA or by configuring a database connection using the JIRA Configuration Tool.
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.
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 customized (from their default values).
重要なサブディレクトリ
data
This directory contains application data for your JIRA instance, including attachments (for every version of each attachment stored in 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
これは、アトラシアンの Plugin Framework 2 (例: 'Plugins 2' プラグイン) に基づいて構築されたプラグインが保管されているディレクトリです。新しい 'Plugins 2' プラグインをインストールする場合、installed-plugins
サブディレクトリ配下にあるこのディレクトリにデプロイする必要があります。
'Plugins 1' plugins should be stored in the JIRA Installation Directory.
このディレクトリが存在しない場合は、 JIRA 起動時に作成されます。
caches
このディレクトリに、 JIRA は下記を含むキャッシュを格納します:
- Lucene インデックス - 「Jira サーバーのインデックスの問題のトラブルシューティング」を参照してください。
- OSGi フレームワークのキャッシュ
これらのファイルは JIRA のパフォーマンスに不可欠なものなので、JIRA 実行中に外部から変更または削除してはなりません。
See Search Indexing for further details.
tmp
多様な実行時の機能 (インポート、エクスポート、ファイルのアップロード、インデックス) で作成された一時的なコンテンツはすべて、このディレクトリに格納されます。
JIRA 実行中にこのディレクトリからファイルを削除できますが、JIRA をシャットダウンしてからこのディレクトリのコンテンツを変更することを推奨します。