JIRA 应用主目录包含可帮助定义 JIRA 工作方式的关键数据。您必须先为 JIRA 实例指定一个 JIRA 主目录，然后才能启动它。本文档介绍了如何为 JIRA 实例指定 JIRA 主目录的位置。

每个 JIRA 实例一个 JIRA 主目录

每个 JIRA 安装只能有一个 JIRA 主目录。如果您有多个 JIRA 安装，则需要分别为每个安装设置一个 JIRA 主目录。创建 JIRA 主目录时，会在其根级放置一个锁，以确保它只能由一个 JIRA 安装使用。

本页内容：

您只需指定 JIRA 主目录的根目录的位置。当 JIRA 启动时或您在 JIRA 中使用需要特定子目录的功能时，系统将自动创建子目录。

如何设置 JIRA 主目录？

有几种方法可以在 JIRA 中指定 JIRA 应用主目录的位置。但在指定该位置之前，请注意以下注意事项。

推荐方法

在 JIRA 中指定 JIRA 主目录位置的推荐方法包括：

  • 使用 JIRA 配置工具更改 JIRA 主目录的位置。
  • 编辑 jira-application.properties 文件，并将“jira.home”属性的值设置为 JIRA 主目录所在的位置（此位置应不同于应用程序目录，否则以后可能会遇到问题）。如果您正在 Windows 上指定此位置的路径，那么请在子目录之间使用两个反斜杠（“\”）。例如，X:\\path\\to\\JIRA\‌\Home。
    (info)如果在 Microsoft Windows 中定义 UNC 路径，请确保双重转义前导反斜杠：\\\\machinename\\path\\to\\JIRA\\home
    (info) 请参见 JIRA 安装目录页面，以查找此文件所在的位置。
  • 在操作系统中设置一个名为 JIRA_HOME 的环境变量，其值为您的 JIRA 主目录所在的位置。为此：
    • 在 Windows 上，执行以下操作之一：
      • 通过 Windows 用户界面（通常通过“我的电脑”或“计算机”）配置此环境变量
      • 在命令提示符处，输入以下命令（使用您自己的 JIRA 主目录路径），然后从命令提示符运行 JIRA：
        • set JIRA_HOME=X:\path\to\JIRA\Home
          (warning) 请使用此格式设置您的 JIRA_HOME  环境变量值，其中：
          • X 是 JIRA 主目录所在的驱动器盘符，并且
          • 等号（“=”）周围不加空格
      • 在用于启动 JIRA 的批处理文件中指定上述命令。
    • 在 Linux/Solaris 上，执行以下操作之一：
      • 在 Shell/控制台提示符处，输入以下命令（使用您自己的 JIRA 主目录路径），然后运行 JIRA：
        • export JIRA_HOME=/path/to/jira/home
      • 在用于启动 JIRA 的脚本中指定上述命令。

(warning)请注意：如果您已经在 jira-application.properties 文件和 JIRA_HOME 环境变量中为“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)请注意：应用服务器中定义的“jira.home”Web 上下文属性将覆盖 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 因无法创建必要的子目录而无法启动。
  • No labels