Jira アプリケーションのホーム ディレクトリの設定

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

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

1 つの Jira インスタンスに 1 つの Jira ホーム

1 つの Jira インストールは 1 つの Jira ホーム ディレクトリを持ちます。Jira インストールが複数ある場合、各インストールに対して Jira ホーム ディレクトリを 1 つセットアップする必要があります。Jira ホーム ディレクトリが作成されると、1 つの Jira インストールのみがそれを使用できるように、その Jira ホーム ディレクトリのルートにロックが設定されます。

On this page:

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

Jira ホームの設定方法

Jira で Jira アプリケーションのホーム ディレクトリの場所を指定する方法は複数あります。いずれの方法を使用する場合でも、場所を指定する前に、以下の注意点を確認してください。

推奨方法

Jira で Jira ホーム ディレクトリの場所を指定するため推奨されている方法には、以下のものがあります。

  • Jira 設定ツールを使用して、 Jira ホーム ディレクトリの場所を変更します。
  • 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.
    (info)If you define an UNC path in Microsoft Windows, be sure to double escape the leading backslash: \\\\machinename\\path\\to\\JIRA\\home
    (info) See the JIRA installation directory page to find where this file is located.
  • ご使用のオペレーティング システムに JIRA_HOME という名前の環境変数を設定します。この値が Jira ホームディレクトリの場所になります。この操作を行うには、次のように実行します。
    • Windows の場合は、次のいずれかを実行してください
      • Windows ユーザー インターフェイス(一般的に「マイコンピュータ」または「コンピュータ」)からこの環境変数を設定します。
      • コマンド プロンプト画面で、以下のコマンドを入力(自分の JIRA Home パスを使用する)した後、コマンド プロンプトから JIRA を実行します。
        • set JIRA_HOME=X:\path\to\JIRA\Home
          (warning) この形式を使用して JIRA_HOME 環境変数の値を設定します。次の点にご注意ください。
          • X は Jira ホーム ディレクトリが格納されているドライブの文字
          • イコール ("=") の前後にスペースは不要
      • JIRA の起動に使用したバッチ ファイルで上記のコマンドを設定します。
    • Linux/Solaris では、以下のいずれかを実行してください。
      • JIRA を起動する前にシェル/コンソールプロンプトで以下のコマンドを実行する(ご自身の JIRA ホームディレクトリを指定して)
        • export JIRA_HOME=/path/to/jira/home
      • JIRA を起動するときに使うスクリプトに上記のコマンドを追加する

(warning): "jira.home"、jira-application.properties ファイルのプロパティ、JIRA_HOME 環境変数に異なる値を指定した場合、JIRA_HOME 環境変数が優先されます。

代替方法

Jira ホーム ディレクトリの場所をアプリケーション サーバー内のプロパティとして指定することもできます。

  • 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.
    (info) The server.xml file is located within the conf subdirectory of your JIRA application installation directory.

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

(warning) 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 ホーム ディレクトリを Jira の複数のインスタンス用に使用することはできない点にご注意ください。Jira ホーム ディレクトリは Jira インストール ディレクトリ と完全に独立して配置する (一方を他方にネストしない) ことを推奨します。これにより、重要な操作 (例: インスタンスのバックアップとリストア) での情報喪失を最小限に抑えることができます。

Jira ホームの変更方法

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

Jira ホーム ディレクトリに格納されるもの

Jira ホーム ディレクトリに格納される情報については、次のページをご参照ください。「Jira アプリケーションのホーム ディレクトリ

注意

  • Windows インストーラー を使用している場合、別作業で 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.
Last modified on Mar 23, 2017

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.