JIRA 主目录包含可帮助定义 JIRA 工作方式的关键数据。本文档概要介绍 JIRA 主目录中各种文件和子目录的用途。

如果 JIRA 是使用自动的 Windows 或 Linux 安装程序安装的,则 JIRA 主目录的默认位置为:

  • C:\Program Files\Atlassian\Application Data\JIRA(在 Windows 上)
  • /var/atlassian/application-data/jira(在 Linux 上)

如果您从归档文件安装 JIRA,则 JIRA 主目录可以位于 JIRA 安装可访问的任何合适的位置。常见的位置有:

  • C:\jira\home(在 Windows 上)
  • /var/jira-home(在 Linux 或 Solaris 上)

(warning) 但是,请避免将 JIRA 主目录置于 JIRA 应用安装目录中。

(tick) 有关指定 JIRA 主目录位置的信息,请参见设置 JIRA 应用主目录

重要文件

dbconfig.xml

该文件(位于 JIRA 主目录的根级别)定义 JIRA 数据库连接的所有详细信息。该文件通常通过两种方式创建:在新的 JIRA 安装过程中运行 JIRA 安装向导;使用 JIRA 配置工具配置数据库连接。

您也可以创建自己的 dbconfig.xml 文件。如果您需要为特定的数据库配置(不是由安装向导或 JIRA 配置工具生成)指定更多参数,这非常有用。有关更多信息,请参见将 JIRA 连接到数据库中相应数据库配置指南的手动连接说明。

jira-config.properties

该文件(也位于 JIRA 主目录的根级别)存储大部分JIRA 的高级配置设置的自定义值。该文件中定义的属性覆盖 jpm.xml 文件(位于您的 JIRA 应用安装目录中)中定义的默认值。请参见高级 JIRA 配置,以了解更多信息。

(info) 在新的 JIRA 安装过程中,该文件最初可能不存在,如果是这样,则需要手动创建。请参见 更改 jira-config.properties 文件,了解更多信息。该文件通常存在于从 4.3 版本或更低版本进行升级的 JIRA 安装中(高级配置选项 已自定义,不再是默认值)。

重要子目录

data

该目录包含 JIRA 实例的应用数据,包括附件(存储在 JIRA 中的每个附件的每个版本)。

export

JIRA 将其自动备份档案放置在此目录中。

log

JIRA 将其日志放置在此目录中。(注意:如果未配置 JIRA 主目录,则日志会置于当前正在使用的目录中)。

只有首条日志消息写入后,日志才会开始显示。例如,内部访问日志只有在 JIRA 开始向该日志中写入时才会创建。

您可以按照 Logging and profiling 上的文档所述,使用 log4j.properties 更改日志文件的位置。

plugins

该目录是存储 Atlassian Plugin Framework 2 上构建的插件(即“Plugins 2”插件)的位置。如果您要安装新的“Plugins 2”插件,则需要将此插件部署到此目录的 installed-plugins 子目录中。

“Plugins 1”插件应该存储在 JIRA 应用安装目录中。

如果该目录不存在,则会在 JIRA 启动时创建。

caches

该目录可供 JIRA 存储以下缓存:

这些文件对 JIRA 性能至关重要,一定不能在 JIRA 运行时从外部修改或移除这些文件。

请参见搜索索引,进一步了解详细信息。

tmp

针对各种运行时功能(如导出、导入、文件上传和索引)创建的临时内容均存储在此目录中。

您可以在 JIRA 运行过程中删除此目录的文件,但我们建议在更改此目录的内容之前先关闭 JIRA。