JIRA PostgreSQL 连接配置

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

这些说明将帮助您将 JIRA 连接到 PostgreSQL 数据库。

开始之前

检查您的 PostgreSQL 版本是否受支持。请参见Jira安装环境要求。
如果您要将 JIRA 迁移至另一服务器，请以 XML 备份的形式将数据导出。然后，可以按照切换数据库中所述，将数据从旧数据库转移到新数据库。
除非您要运行安装向导，否则请在开始之前关闭 JIRA。

本页内容：

1.创建和配置 PostgreSQL 数据库

要了解如何为您的 PostgreSQL 版本创建用户和数据库，可以在 PostgreSQL 网站上找到相关信息。

创建 JIRA 连接数据库所用的用户（登录角色，例如 jiradbuser）。
请记住此数据库用户名，因为后续步骤中配置与此数据库的 JIRA 连接时要使用它。
创建供 JIRA 存储事务的数据库（例如，jiradb），并使用 Unicode 排序规则。
请记住此数据库名称，因为后续步骤中配置与此数据库的 JIRA 连接时要使用它。
```
CREATE DATABASE jiradb WITH ENCODING 'UNICODE' LC_COLLATE 'C' LC_CTYPE 'C' TEMPLATE template0;
```
CODE
或使用以下命令行：
```
$ createdb -E UNICODE -l C -T template0 jiradb
```
CODE
确保用户具有连接到数据库以及在数据库中创建和填写关系表的权限。

2.将 JIRA 服务器配置为连接到 PostgreSQL 数据库

有两种方法将 JIRA 服务器配置为连接到 PostgreSQL 数据库：

使用 JIRA 安装向导 — 如果您已经安装了 JIRA，并且是首次进行设置，则可以使用此方法。您的设置将被保存到 JIRA 主目录的 dbconfig.xml 文件中。
使用 JIRA 配置工具 — 如果您有现成的 JIRA 实例，则可以使用此方法。您的设置将被保存到 JIRA 主目录的 dbconfig.xml 文件中。

每种配置方法的说明

JIRA 安装向导

JIRA 安装向导将在您第一次在浏览器中访问 JIRA 时显示。

在第一个屏幕“Configure Language and Database”上，将 Database Connection 设置为 My own database。
将 Database Type 设置为 PostgreSQL。
按照以下数据库连接字段部分所示填写字段。
测试连接并保存。

JIRA 配置工具

按以下方法运行 JIRA 配置工具：
- Windows：打开命令提示符，并在 JIRA 安装目录的 bin 子目录中运行 config.bat。
- Linux/Unix：打开控制台，并在 JIRA 安装目录的 bin 子目录中执行 config.sh。
  这可能会失败，并产生错误，如我们的“因 No X11 DISPLAY 变量设置错误而无法启动 JIRA 应用配置工具”知识库文章中所述。请参见该文章，了解解决方法。
导航至 Database 选项卡，然后将 Database type 设置为 PostgreSQL。
按照以下数据库连接字段部分所示填写字段。
测试连接并保存。
重新启动 JIRA。

数据库连接字段

安装向导/配置工具	dbconfig.xml	说明
Hostname	位于 `<url>` 标签中（以下示例中的粗体文本）： `<url>jdbc:postgresql://`dbserver`:5432/jiradb</url>`	安装 PostgreSQL 服务器的机器的名称或 IP 地址。
Port	位于 `<url>` 标签中（以下示例中的粗体文本）： `<url>jdbc:postgresql://dbserver:`5432`/jiradb</url>`	PostgreSQL 服务器将侦听的 TCP/IP 端口。您可以将此字段留空，以使用默认端口。
Database	位于 `<url>` 标签中（以下示例中的粗体文本）： `<url>jdbc:postgresql://dbserver:5432/`jiradb`</url>`	您的 PostgreSQL 数据库的名称（JIRA 会将数据保存在其中）。您应该在上述的步骤 1 中已经创建过了。
Username	位于 `<username>` 标签中（以下示例中的粗体文本）： `<username>`jiradbuser`</username>`	JIRA 用来连接 PostgreSQL 服务器的用户。您应该在上述的步骤 1 中已经创建过了。
Password	位于 `<password>` 标签中（以下示例中的粗体文本）： `<password>`jiradbuser`</password>`	用户密码 — 用于与 PostgreSQL 服务器进行身份验证。
Schema	位于 `<schema-name>` 标签中（以下示例中的粗体文本）： `<schema-name>`public`</schema-name>`	您的 PostgreSQL 数据库使用的模式名称。 PostgreSQL 7.2 及以上版本需要在 `<schema-name/>` 元素中指定模式。如果您的 PostgreSQL 数据库使用默认的“`public`”模式，应该在 `<schema-name/>` 元素中进行指定，如下所示。请确保数据库模式名称是小写的，因为 JIRA 无法使用模式名称中包含大写字符的 PostgreSQL 数据库。

示例 dbconfig.xml 文件

有关以下 dbconfig.xml 文件中以 pool 开头的 <jdbc-datasource/> 子元素的更多信息，请参阅调整数据库连接。

<?xml version="1.0" encoding="UTF-8"?><jira-database-config>  <name>defaultDS</name>  <delegator-name>default</delegator-name>  <database-type>postgres72</database-type>  <schema-name>public</schema-name>  <jdbc-datasource>    <url>jdbc:postgresql://dbserver:5432/jiradb</url>    <driver-class>org.postgresql.Driver</driver-class>    <username>jiradbuser</username>    <password>password</password>    <pool-min-size>20</pool-min-size>    <pool-max-size>20</pool-max-size>    <pool-max-wait>30000</pool-max-wait>    <pool-max-idle>20</pool-max-idle>    <pool-remove-abandoned>true</pool-remove-abandoned>    <pool-remove-abandoned-timeout>300</pool-remove-abandoned-timeout>     <validation-query>select version();</validation-query>    <min-evictable-idle-time-millis>60000</min-evictable-idle-time-millis>    <time-between-eviction-runs-millis>300000</time-between-eviction-runs-millis>      <pool-test-on-borrow>false</pool-test-on-borrow>	<pool-test-while-idle>true</pool-test-while-idle>  </jdbc-datasource></jira-database-config>

XML

3.启动 JIRA

现在，您应该已经将 JIRA 配置为连接到 PostgreSQL 数据库。下一步就是启动它！

恭喜，您现在已经将 JIRA 连接到了 PostgreSQL 数据库。