Jira中重要的目录和文件

本文翻译自官方文档：https://confluence.atlassian.com/pages/viewpage.action?pageId=933888121

本页内容：

JIRA 安装目录

本文翻译自官方文档：https://confluence.atlassian.com/pages/viewpage.action?pageId=933888132

安装程序会将 JIRA 应用和库提取到一个目录，此目录即为 JIRA 安装目录。安装程序为以下一种程序：

Windows 版安装程序，或者
Linux 版安装程序

JIRA 不会在此目录中修改或存储任何数据。

重要文件和目录

以下描述的目录/文件可能出现在“JIRA 安装目录”的不同子目录下，具体取决于您是否安装了建议的 Windows、Linux 或 Archive JIRA。请用以下目录替换 <jira-application-dir> 占位符（在本节其余部分一直使用），如下所述：

“建议的”分发目录 — 使用“Windows 版安装程序”和“Linux 版安装程序”安装的“JIRA 安装目录”的 atlassian-jira 子目录，来自压缩文件（分别为 .zip 和 tar.gz）的相关安装内容也在此处。
Linux 上的默认安装目录为：
/opt/atlassian/jira/

`<jira-application-dir>/atlassian-jira/WEB-INF/classes/jira-application.properties`

JIRA 通过此文件获知 JIRA 应用主目录的位置。
请注意，在此文件中定义的 JIRA 主目录可能会被覆盖。请参见设置 JIRA 应用主目录，以了解更多信息。

`<jira-application-dir>/atlassian-jira/WEB-INF/classes/jpm.xml`

此文件存储的是 JIRA 高级配置设置的默认值，不能修改。通过在 jira-config.properties 文件（位于您的 JIRA 应用主目录中）或 JIRA 数据库（通过 JIRA 管理区访问）中重新定义此文件中属性的默认值，可以自定义（即覆盖）这些值。请参见高级 JIRA 配置，以了解更多信息。

`<jira-application-dir>/atlassian-jira/WEB-INF/lib/`

此目录用于存储 Atlassian 的 Plugin Framework 1 的内置插件（即“Plugins 1”插件）。如果要安装新的“Plugins 1”插件，您需要将其部署到此目录中。
“Plugins 2”插件应存储在 JIRA 应用主目录中。

`<jira-application-dir>/atlassian-jira/WEB-INF/classes/log4j.properties`

JIRA 的日志记录配置文件。请参见日志记录和性能跟踪。

可以在以下位置找到 JIRA 生成的实际日志文件：

JIRA 应用日志 — bin/atlassian-jira.log
应用服务器日志 — 通常可以在 logs 目录下找到应用服务器日志文件。但也可能是其他位置，具体取决于您所运行的应用服务器。

`<jira-application-dir>/atlassian-jira/WEB-INF/classes/entityengine.xml`

此文件用于配置 OFBiz Entity Engine，JIRA 用其在数据源中存储持久性数据。

以下所述的子目录/文件位于 JIRA 应用安装目录的根目录下。

`conf/server.xml`

此文件用于 JIRA SSL 配置。请参见通过 SSL 或 HTTPS 运行 JIRA 应用。

内存设置

用于编辑 JAVA_OPTS 内存设置的文件将取决于安装 JIRA 所使用的方法，以及用于安装的操作系统。

例如，如果在 Windows 中的 Tomcat 上运行 JIRA（手动启动），将更新以下文件：
bin\setenv.bat
而对于 Linux/Unix 中 Tomcat 上运行的 JIRA，将更新此文件：
bin/setenv.sh

请参见增加 JIRA 内存，以了解详细信息。

JIRA 主目录

本文翻译自官方文档：https://confluence.atlassian.com/pages/viewpage.action?pageId=933888116

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。