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 ホームディレクトリの場所を変更します。
  • jira-application.properties ファイルを編集し、"jira.home" プロパティの値をご使用の Jira ホーム ディレクトリの場所に設定します (問題の発生を防ぐため、この場所はアプリケーション ディレクトリと異なる場所にする必要があります)。この場所のパス Windows で指定する場合、バックスラッシュ ("\") を 2 つ使用してサブディレクトリを区切ります。例: X:\\path\\to\\JIRA\‌\Home
    (info) Microsoft Windows で UNC パスを定義する場合は、バックスラッシュの後にエスケープを 2 回使用します。\\\\machinename\\path\\to\\JIRA\\home
    (info) ファイルの保存場所については、「Jira インストール ディレクトリ」ページを参照してください。
  • ご使用のオペレーティング システムに 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 ホームディレクトリの場所をアプリケーション サーバー内のプロパティとして指定することができます。

  • アプリケーション サーバーに "jira.home" という新しい Web コンテキスト プロパティを設定します。これを行うには、server.xml ファイルの <parameter/> 要素の中で、(<context/> の子要素として) この Web コンテキスト プロパティを定義する必要があります。
    (info)server.xml ファイルは、Jira アプリケーション インストール ディレクトリconf サブディレクトリに保存されます。

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

(warning)注意: アプリケーション サーバーで定義された Web コンテキスト プロパティ "jira.home" は、jira-application.propertiesファイルの "jira.home" の値よりも優先されます。ただし、Jira ホーム ディレクトリで定義されている JIRA_HOME 環境変数は、この両方の ”jira.home” よりも優先されます。

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

Jira ホーム ディレクトリにはディスク上の任意の場所を指定できます。絶対パスを指定するようにします。

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

Jira ホームを変更する方法

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

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

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

注意

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

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

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