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。

  • No labels