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

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

开始之前

本页内容:

1.创建和配置 PostgreSQL 数据库

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

  1. 创建 JIRA 连接数据库所用的用户(登录角色,例如 jiradbuser)。
    请记住此数据库用户名,因为后续步骤中配置与此数据库的 JIRA 连接时要使用它。
  2. 创建供 JIRA 存储事务的数据库(例如,jiradb),并使用 Unicode 排序规则。
    请记住此数据库名称,因为后续步骤中配置与此数据库的 JIRA 连接时要使用它。

    CREATE DATABASE jiradb WITH ENCODING 'UNICODE' LC_COLLATE 'C' LC_CTYPE 'C' TEMPLATE template0;

    或使用以下命令行:

    $ createdb -E UNICODE -l C -T template0 jiradb
  3. 确保用户具有连接到数据库以及在数据库中创建和填写关系表的权限。

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

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

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

每种配置方法的说明

JIRA 安装向导

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

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

JIRA 配置工具

  1. 按以下方法运行 JIRA 配置工具:
  2. 导航至 Database 选项卡,然后将 Database type 设置为 PostgreSQL
  3. 按照以下数据库连接字段部分所示填写字段。
  4. 测试连接并保存。
  5. 重新启动 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>

 

3.启动 JIRA

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

(tick) 恭喜,您现在已经将 JIRA 连接到了 PostgreSQL 数据库。