JIRA Home Directory の設定

JIRA Home Directory には JIRA の動きを定義する重要なデータが格納されます。JIRA を起動する前に必ず、JIRA インスタンスに JIRA ホーム ディレクトリを定義する必要があります。このドキュメントでは、JIRA インスタンスに JIRA ホーム ディレクトリの場所を定義する方法について説明します。

Jira ホームの指定で必要なのは、ルート ディレクトリの場所だけです。サブ ディレクトリは、Jira の起動時、または、Jira で特定のサブ ディレクトリを必要とする機能を使用したときに、自動的に作成されます。

Jira ホームの設定方法

JIRA で JIRA Home Directory の場所を指定する方法は複数あります。いずれの方法を使用する場合でも、場所を指定する前に、以下の注意点 を確認してください。

推奨方法

JIRA で JIRA Home Directory の場所を指定するため推奨されている方法は:

• Use the JIRA Configuration Tool to change the location of your JIRA Home Directory.
  The JIRA Configuration Tool is not available in JIRA WAR distributions.
• Edit the jira-application.properties file and set the value of the 'jira.home' property to the desired location for your JIRA Home Directory. If you are specifying this location's path on Windows, use double back-slashes ("\") between subdirectories. For example, X:\\path\\to\\JIRA\‌\Home
  See the JIRA Installation Directory page to find where this file is located.
• Set an environment variable named JIRA_HOME in your operating system whose value is the location of your JIRA Home Directory. To do this:

  • Windows の場合は、次のいずれかを実行してください
    
    • Windows ユーザー インターフェイス（一般的に「マイコンピュータ」または「コンピュータ」）からこの環境変数を設定します。
    • コマンド プロンプト画面で、以下のコマンドを入力（自分の JIRA Home パスを使用する）した後、コマンド プロンプトから JIRA を実行します。
      
      • set JIRA_HOME=X:\path\to\JIRA\Home
        Please set your JIRA_HOME  environment variable value using this format, where:
        
        • X は Jira ホーム ディレクトリが格納されているドライブの文字
        • イコール ("=") の前後にスペースは不要
    • JIRA の起動に使用したバッチ ファイルで上記のコマンドを設定します。
  • Linux/Solaris では、以下のいずれかを実行してください。
    
    • JIRA を起動する前にシェル／コンソールプロンプトで以下のコマンドを実行する（ご自身の JIRA ホームディレクトリを指定して）
      
      • export JIRA_HOME=/path/to/jira/home
    • JIRA を起動するときに使うスクリプトに上記のコマンドを追加する

Please Note: If you have specified different values for a 'jira.home' property in the jira-application.properties file and a JIRA_HOME environment variable, the value of the JIRA_HOME environment variable takes precedence.

代替方法

代わりに、JIRA Home Directory の場所をアプリケーション サーバー内のプロパティとして指定することができます:

• Configure a new web context property called 'jira.home' for your application server. To do this, you need to define this web context property inside a <parameter/> element (as a child of the <context/> element) in your server.xml file (or jira.xml file for JIRA WAR).
  The server.xml file is located within the conf subdirectory of your JIRA Installation Directory and for JIRA WAR, the jira.xml file is typically located within the conf/Catalina/localhost subdirectory of the Apache Tomcat installation running JIRA:

  <Context ...>
  ...
    <Parameter name="jira.home" value="c:/jira/home"/>
  ...
  </Context>
  

Please Note: A 'jira.home' web context property defined in your application server overrides the value of the 'jira.home' property defined in your jira-application.properties file. However, a JIRA_HOME environment variable defining your JIRA Home Directory will override either of these 'jira.home' values.

Jira ホームに指定すべき場所

Jira ホームの変更方法

JIRA ホーム ディレクトリを変更するには、

1. 「Jira ホームの設定方法」 (上記) で説明されている方法を 1 つ選び、Jira ホームに新しい場所を設定します。
2. Jira を再起動します。

メモ:

• Windows インストーラー を使用している場合、別作業で JIRA Home Directory を設定する必要はありません。インストール過程でこの場所を指定する指示が出ます。
• JIRA の '推奨する' ディストリビューション をインストールした場合、この作業は必要ありません — 代わりに JIRA 設定ツール をご覧ください。
• JIRA WAR を使用している場合、JIRA をビルドする前に JIRA ホームを設定する必要があります。