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 上)
但是,请避免将 JIRA 主目录置于 JIRA 应用安装目录中。
有关指定 JIRA 主目录位置的信息,请参见设置 JIRA 应用主目录。
重要文件
dbconfig.xml
该文件(位于 JIRA 主目录的根级别)定义 JIRA 数据库连接的所有详细信息。该文件通常通过两种方式创建:在新的 JIRA 安装过程中运行 JIRA 安装向导;使用 JIRA 配置工具配置数据库连接。
您也可以创建自己的 dbconfig.xml
文件。如果您需要为特定的数据库配置(不是由安装向导或 JIRA 配置工具生成)指定更多参数,这非常有用。有关更多信息,请参见将 JIRA 连接到数据库中相应数据库配置指南的手动连接说明。
jira-config.properties
该文件(也位于 JIRA 主目录的根级别)存储大部分JIRA 的高级配置设置的自定义值。该文件中定义的属性覆盖 jpm.xml
文件(位于您的 JIRA 应用安装目录中)中定义的默认值。请参见高级 JIRA 配置,以了解更多信息。
在新的 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 存储以下缓存:
- Lucene 索引 - 请参见搜索、索引和过滤器故障排除
- OSGi 框架缓存
这些文件对 JIRA 性能至关重要,一定不能在 JIRA 运行时从外部修改或移除这些文件。
请参见搜索索引,进一步了解详细信息。
tmp
针对各种运行时功能(如导出、导入、文件上传和索引)创建的临时内容均存储在此目录中。
您可以在 JIRA 运行过程中删除此目录的文件,但我们建议在更改此目录的内容之前先关闭 JIRA。