Page tree
Skip to end of metadata
Go to start of metadata

本页内容:

JIRA 安装目录

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

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 应用主目录的位置。
(warning)请注意,在此文件中定义的 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 主目录

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。