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

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

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

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

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) 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 を起動するときに使うスクリプトに上記のコマンドを追加する

(warning) 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 ホームディレクトリの場所をアプリケーション サーバー内のプロパティとして指定することができます。

  • 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ホームの設定方法" (上記) で説明されている方法からひとつ選び、Jira ホームに新しい場所を設定します。
  2. Jira を再起動します。

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

次のページにJira ホームディレクトリに格納されたデータの説明があります: Jira アプリケーション・ホームディレクトリ

注意

  • Windows インストーラー を使用している場合、別作業で Jira ホームディレクトリを設定する必要はありません。インストール過程でこの場所を指定する指示が出ます。
  • 許可の問題で、Jira インストーラーがホームを作成できない場合があります。このような場合は、「必要なサブディレクトリが作成できないため、 Jira を開始できない」を参照して下さい。
最終更新日 2018 年 7 月 5 日

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

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