JIRA Home Directory の設定

Jira ホームの設定方法

There are a few methods available for specifying the location of your JIRA Home Directory in JIRA. However, please be aware of the notes below before your specify this location.

推奨方法

The recommended methods for specifying the location of your JIRA Home Directory in JIRA are to:

• 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 (this location should be something different than the application directory, or you may run into problems later). If you are specifying this location's path on Windows, use double back-slashes ("\") between subdirectories. For example, X:\\path\\to\\JIRA\‌\Home.
  If you define an UNC path in Microsoft Windows, be sure to double escape the leading backslash: \\\\machinename\\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.

代替方法

Alternatively, you can specify the location of your JIRA Home Directory as property within your application server:

• 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 を再起動します。

JIRA Home Directory に格納されているもの

The following page describes the data stored in the JIRA Home Directory: JIRA Home Directory.

注意

• If you are using the Windows installer, you do not need to configure the JIRA Home Directory separately as you will be prompted to specify this location during the installation process.
• If you installed a 'Recommended' distribution of JIRA, you do not need to do this — please see the JIRA Configuration Tool instead.
• JIRA WAR を使用している場合、JIRA をビルドする前に JIRA ホームを設定する必要があります。
• The JIRA installer may not be able to create the home due to permission problems, if this is the case please see Jira server fails to start with Could not create necessary subdirectory error.
• If you are using a custom path for your indexes and attachments (upgraded JIRA with an XML backup from a JIRA version prior to 4.2) you will have to manually configure these paths to use the default path based on the JIRA Home Directory. Otherwise, your indexes and attachments will continue to use the custom path defined previously. Configure these in their respective pages (Configuring File Attachments and Search Indexing page)
• If configuring the JIRA Home Directory in jira-application.properties doesn't work, refer to Changing JIRA Home Directory in jira-application.properties doesn't work and make sure all other configurations which takes precedence are not configured