您只需指定 JIRA 主目录的根目录的位置。当 JIRA 启动时或您在 JIRA 中使用需要特定子目录的功能时,系统将自动创建子目录。
如何设置 JIRA 主目录?
有几种方法可以在 JIRA 中指定 JIRA 应用主目录的位置。但在指定该位置之前,请注意以下注意事项。
推荐方法
在 JIRA 中指定 JIRA 主目录位置的推荐方法包括:
- 使用 JIRA 配置工具更改 JIRA 主目录的位置。
- 在操作系统中设置一个名为
JIRA_HOME
的环境变量,其值为您的 JIRA 主目录所在的位置。为此:- 在 Windows 上,执行以下操作之一:
- 通过 Windows 用户界面(通常通过“我的电脑”或“计算机”)配置此环境变量
- 在命令提示符处,输入以下命令(使用您自己的 JIRA 主目录路径),然后从命令提示符运行 JIRA:
set JIRA_HOME=X:\path\to\JIRA\Home
请使用此格式设置您的JIRA_HOME
环境变量值,其中:X
是 JIRA 主目录所在的驱动器盘符,并且- 等号(“
=
”)周围不加空格
- 在用于启动 JIRA 的批处理文件中指定上述命令。
- 在 Linux/Solaris 上,执行以下操作之一:
- 在 Shell/控制台提示符处,输入以下命令(使用您自己的 JIRA 主目录路径),然后运行 JIRA:
export JIRA_HOME=/path/to/jira/home
- 在用于启动 JIRA 的脚本中指定上述命令。
- 在 Shell/控制台提示符处,输入以下命令(使用您自己的 JIRA 主目录路径),然后运行 JIRA:
- 在 Windows 上,执行以下操作之一:
请注意:如果您已经在 jira-application.properties
文件和 JIRA_HOME
环境变量中为“jira.home
”属性指定了不同的值,则 JIRA_HOME
环境变量中的值优先。
其他方法
或者,您可以将 JIRA 主目录的位置指定为应用服务器中的属性:
为您的应用服务器配置一个名为“
jira.home
”的新 Web 上下文属性。为此,您需要在server.xml
文件的<parameter/>
元素(作为<context/>
元素的子元素)内定义此 Web 上下文属性。
server.xml
文件位于 JIRA 应用安装目录的conf
子目录中。<Context ...>... <Parameter name="jira.home" value="c:/jira/home"/>...</Context>
请注意:应用服务器中定义的“jira.home
”Web 上下文属性将覆盖 jira-application.properties
文件中定义的“jira.home
”属性的值。但是,定义 JIRA 主目录的 JIRA_HOME
环境变量将覆盖这两个“jira.home
”值。
应该为 JIRA 主目录指定什么位置?
您可以为 JIRA 主目录指定磁盘上的任何位置。请务必指定一条绝对路径。
请注意,对于 JIRA 的多个实例,您不能使用同一 JIRA 主目录。我们建议您将 JIRA 主目录放置在与 JIRA 安装目录 完全独立的位置(即,不相互嵌套),因为这样可以尽量缓解重大操作(如备份和还原实例)时丢失信息的情况。
如何变更 JIRA 主目录?
- 使用“如何设置 JIRA 主目录?”(如上所述)中介绍的首选方法将 JIRA 主目录设置到新位置。
- 重新启动 JIRA。
JIRA 主目录中存储了哪些内容?
以下页面介绍了 JIRA 主目录中存储的数据:JIRA 应用主目录。
注意
- 如果您使用的是 Windows 安装程序,则不需要单独配置 JIRA 主目录,因为系统将在安装过程中提示您指定此位置。
- 由于权限问题,JIRA 安装程序可能无法创建主目录。如果遇到这种情况,请参见 JIRA 因无法创建必要的子目录而无法启动。