安装程序会将 JIRA 应用和库提取到一个目录,此目录即为 JIRA 安装目录。安装程序为以下一种程序:
JIRA 不会在此目录中修改或存储任何数据。
以下描述的目录/文件可能出现在“JIRA 安装目录”的不同子目录下,具体取决于您是否安装了建议的 Windows、Linux 或 Archive JIRA。请用以下目录替换
占位符(在本节其余部分一直使用),如下所述:
atlassian-jira
子目录,来自压缩文件(分别为 .zip 和 tar.gz)的相关安装内容也在此处。Linux 上的默认安装目录为:
/opt/atlassian/jira/
/atlassian-jira/WEB-INF/classes/jira-application.properties
JIRA 通过此文件获知 JIRA 应用主目录的位置。
请注意,在此文件中定义的 JIRA 主目录可能会被覆盖。请参见设置 JIRA 应用主目录,以了解更多信息。
/atlassian-jira/
WEB-INF/classes/jpm.xml
此文件存储的是 JIRA 高级配置设置的默认值,不能修改。通过在 jira-config.properties
文件(位于您的 JIRA 应用主目录中)或 JIRA 数据库(通过 JIRA 管理区访问)中重新定义此文件中属性的默认值,可以自定义(即覆盖)这些值。请参见高级 JIRA 配置,以了解更多信息。
/atlassian-jira/
WEB-INF/lib/
此目录用于存储 Atlassian 的 Plugin Framework 1 的内置插件(即“Plugins 1”插件)。如果要安装新的“Plugins 1”插件,您需要将其部署到此目录中。
“Plugins 2”插件应存储在 JIRA 应用主目录中。
/atlassian-jira/
WEB-INF/classes/log4j.properties
JIRA 的日志记录配置文件。请参见日志记录和性能跟踪。
可以在以下位置找到 JIRA 生成的实际日志文件:
bin/atlassian-jira.log
logs
目录下找到应用服务器日志文件。但也可能是其他位置,具体取决于您所运行的应用服务器。/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 是使用自动的 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 存储以下缓存:
这些文件对 JIRA 性能至关重要,一定不能在 JIRA 运行时从外部修改或移除这些文件。
请参见搜索索引,进一步了解详细信息。
tmp
针对各种运行时功能(如导出、导入、文件上传和索引)创建的临时内容均存储在此目录中。
您可以在 JIRA 运行过程中删除此目录的文件,但我们建议在更改此目录的内容之前先关闭 JIRA。