重要なディレクトリとファイル
Jira インストレーションディレクトリ
Jira は、このディレクトリ内に一切のデータを保管せず、またこの修正も行いません。
重要なファイルとディレクトリ
以降で説明するディレクトリ / ファイルは、Windows、Linux、アーカイブ Jira の推奨されるものをインストールしたかどうかに応じて、"Jira インストール ディレクトリ" の異なるサブディレクトリに保存されます。本セクションの以降で使用する <Jira-application-dir> プレースホルダーのディレクトリを、次のように置き換えます。
- "推奨" ディストリビューション — "Windows インストーラー" や "Linux インストーラー" でインストールされた "Jira インストール ディレクトリ" の
atlassian-jiraサブディレクトリ、およびアーカイブ ファイル (.zip および .tar.gz) による関連インストール。 Linux のデフォルトのインストレーション ディレクトリは次の通りです。
/opt/atlassian/jira/
<jira-application-dir>/atlassian-jira/WEB-INF/classes/jira-application.properties
このファイルは、Jira に対して Jira アプリケーションホームディレクトリ をどこで見つけるかを伝えます。
このファイル内で定義されているお使いの Jira ホームディレクトリは、無効化できる点に注意して下さい。詳しくは Jira アプリケーションホームディレクトリの設定 を参照して下さい。
<jira-application-dir>/atlassian-jira/WEB-INF/classes/jpm.xml
atlassian-jira/WEB-INF/classes/jpm.xmlこのファイルは、Jira の詳細設定 用のデフォルト値を保管しているため、内容を変更しないでください。このファイル内のプロパティのデフォルト値は、Jira アプリケーションのホーム ディレクトリの jira-config.properties ファイルか、Jira の管理領域からアクセスできる Jira データベースで再定義されることで、カスタマイズ (上書き) されています。詳細については、「高度な Jira 設定」を参照して下さい。
<jira-application-dir>/atlassian-jira/WEB-INF/lib/
atlassian-jira/WEB-INF/lib/これは、アトラシアンのプラグインフレームワーク1 (すなわち、 「プラグイン1」プラグイン) によって構築されたプラグインが保管されているディレクトリです。新しい「プラグイン1」プラグインをインストールする場合、このディレクトリに展開する必要があります。
「プラグイン2」プラグインは、Jira アプリケーションのホームディレクトリに保管する必要があります。
<jira-application-dir>/atlassian-jira/WEB-INF/classes/log4j2.xml
atlassian-jira/WEB-INF/classes/log4j2.xmlJira のログ構成ファイルです。詳細はロギングとプロファイリングを参照してください。
Jira によって生成された実際のログファイルは、以下のロケーションで見つけられます:
- Jira アプリケーション ログ —
<localhome>/log/atlassian-jira.log - アプリケーション サーバー ログ — 一般に、アプリケーション サーバーのログ ファイルは
logsディレクトリにあります。ただし、これは実行しているアプリケーション サーバーによって異なります。
<jira-application-dir>/atlassian-jira/WEB-INF/classes/entityengine.xml
atlassian-jira/WEB-INF/classes/entityengine.xmlこのファイルは、Jira が永続データをデータソース内に保存するときに使用する、OFBiz Entity Engine を構成します。
以下に解説するサブディレクトリ/ファイルは、Jira インストレーションディレクトリのルートに存在します。
conf/server.xml
このファイルは、Jira SSL 構成に利用します。詳細はJira アプリケーションを SSL または HTTPS 上で実行するを参照してください。
logs/atlassian-jira-gc-timestamp.log
これらのファイルには、Jira アプリケーションのパフォーマンス監視に使用できるガベージ コレクション (GC) が含まれます。ログの記述では、Java がガベージ コレクションを行うタイミング、このプロセスの所要時間、開放されたリソースの量を確認できます。これらのファイルは自動的に作成され、ファイルの最大数 (5) に到達すると上書きされます。タイムスタンプは、ログに関する Jira セッションがいつ開始されたかを示します。詳細については、「ガベージ コレクション ログを使用する」を参照してください。
メモリ設定
JAVA_OPTS メモリ設定の編集に使用されるファイルは、Jira のインストール方法、並びにインストールに使用されたオペレーティングシステムに左右されます。
たとえば、Windows 上で Tomcat を使用して Jira を実行する場合 (手動セットアップ)、次のファイルを更新します:bin\setenv.bat。
一方、Linux / Unix 上で Tomcat を使用して Jira を実行する場合、次のファイルを更新します:bin/setenv.sh。
詳しくは 「Jira のメモリを増やす」 を参照して下さい。
Jira ホームディレクトリ
Windows、または、Linux の自動インストーラーを使用して Jira をインストールした場合には、デフォルトの Jira ホームディレクトリの場所は:
C:\Program Files\Atlassian\Application Data\JIRA(Windows)、または/var/atlassian/application-data/JIRA(Linux の場合)
Jira をアーカイブ ファイルからインストールする場合、Jira ホーム ディレクトリは、Jira インストールがアクセスできる任意の場所に設定できます。次のような場所が一般的です:
C:\jira\home(Windows)、または/var/jira-home(Linux または Solaris の場合)
Jira インストールディレクトリ の中に Jira ホームディレクトリを配置することは避けてください。
Jira ホーム ディレクトリの場所の指定に関する詳細は「Jira アプリケーション ホーム ディレクトリの設定 」をご参照ください。
重要なファイル
dbconfig.xml
このファイル (Jira ホーム ディレクトリ 内にあります) は、Jira のデータベース接続に関連する全情報を定義するものです。通常、新規で Jira をインストール時に Jira セットアップウィザード を実行するか、または、Jira 設定ツール を使用してデータベース接続を設定すると、このファイルが作成されます。
また、独自の dbconfig.xml ファイルを作成することもできます。これは、セットアップ ウィザードや Jira 設定ツールでは生成されない、特定のデータベース設定用の追加パラメーターを指定する必要がある場合に役立ちます。詳細については、「Jira をデータベースに接続する」の対象なデータベース設定ガイドにある「手動」接続の説明を参照してください。
jira-config.properties
このファイル (同様に Jira ホーム ディレクトリのルートに保存) は、Jira の高度な設定のほとんどのもののカスタム値を格納します。このファイルで定義されているプロパティは、jpm.xml ファイル (Jira アプリケーション インストール ディレクトリ に保存) で定義されている既定値よりも優先されます。詳細については、「高度な Jira 設定」を参照してください。
新しい Jira インストールの場合、初期段階ではこのファイルは存在しないことがあります。その場合は手動で作成する必要があります。詳細は「jira-config.properties ファイルを変更する」をご参照ください。通常、このファイルは詳細な Jira 設定で (既定値から) カスタマイズされたバージョン 4.3 以前からアップグレードした Jira インストールに存在します。
重要なサブディレクトリ
data
このディレクトリは、Jira インスタンスのアプリケーション データを格納しています。ここには、 添付ファイル (Jira に格納されたすべてのバージョンのそれぞれの添付ファイル) も含まれます。
export
Jira はこのディレクトリに automated backup archives を配置します。
log
Jira はこのディレクトリにログを配置します。(注意: Jira ホーム ディレクトリが設定されていない場合、これらのログは代わりにその時点のワーキング ディレクトリに配置されることになります)。
このログは、最初のログメッセージが書き込まれた時点で作成されます。例えば、内部アクセスログは、Jira が書き込みを始めるまで作成されません。
このログ ファイルの場所は、log4j2.xml を使用して変更できます。詳細は、「ロギングとプロファイリング」を参照してください。
plugins
これは、アトラシアンの Plugin Framework 2 (例: 'Plugins 2' プラグイン) に基づいて構築されたプラグインが保管されているディレクトリです。新しい 'Plugins 2' プラグインをインストールする場合、installed-plugins サブディレクトリ配下にあるこのディレクトリにデプロイする必要があります。
「プラグイン1」プラグインは、Jira アプリケーションのインストールディレクトリに保管する必要があります。
このディレクトリが存在しない場合は、 Jira 起動時に作成されます。
caches
このディレクトリに、 Jira は下記を含むキャッシュを格納します:
- Lucene インデックス - 「Jira サーバーのインデックスの問題のトラブルシューティング」を参照してください。
- OSGi フレームワークのキャッシュ
これらのファイルは Jira のパフォーマンスに不可欠なので、Jira 実行中に外部から変更または削除しないでください。
インデックス キャッシュは次のディレクトリに格納されます。
<sharedhome>/caches/indexesV2/snapshots(クラスターのみ): 作成されたすべてのインデックス スナップショットが保存されるメイン ディレクトリ- 完全インデックス再作成の完了時
- クラスターに参加するノードのリクエスト時
- 管理者パネルで行われた管理者リクエスト時
- 保存場所のインポート完了時
スケジュールされたインデックスのバックアップによる
このディレクトリからのスナップショットはセカンダリ ホームにレプリケートされる際に選択されて、新しいノードが管理者リクエスト (管理者が正しく設定されたクラスター固有のファイルによって新しい Jira インスタンスを起動した際) に応じてクラスターに参加します。
<localhome>/caches/indexesV2: インデックスが保存されるディレクトリ。
詳細は、「インデクシングを検索する」 を参照してください。
tmp
多様な実行時の機能 (インポート、エクスポート、ファイルのアップロード、インデックス) で作成された一時的なコンテンツはすべて、このディレクトリに格納されます。
Jira 実行中にこのディレクトリからファイルを削除できますが、Jira をシャットダウンしてからこのディレクトリのコンテンツを変更することを推奨します。