JIRA连接PostgreSQL数据库的详细步骤

本文主要介绍如何连接JIRA到PostgreSQL数据库。

首先

  • 检查是否支持你的PostgreSQL版本。请参见支持的平台
  • 如果是转移JIRA到另一台服务器,先导出数据为XML备份,然后将旧数据库中的数据传输到新的数据库。
  • 在开始前关闭JIRA,除非你正在运行Setup Wizard。

1.创建并配置PostgreSQL数据库

  1. 创建与JIRA连接的数据库用户(登录角色)例如:jiradbuser
  2. 使用Unicode排序规则创建一个存储JIRA问题的数据库,如:jiradb
    CREATE DATABASE jiradb WITH ENCODING 'UNICODE' LC_COLLATE 'C' LC_CTYPE 'C' TEMPLATE template0;
    或通过命令行:
    $ createdb -E UNICODE -l C -T template0 jiradb
  3. 确保该用户拥有连接数据库以及创建和编辑表的权限。

2.将PostgreSQL JDBC驱动程序复制到你的应用服务器(仅供JIRA WAR)

JIRA连接PostgreSQL数据库的详细步骤如果你安装了包含PostgreSQL JDBC 驱动的JIRA'Recommended'分布可跳过此步。JIRA WAR分布不包含该驱动。

  1. http://jdbc.postgresql.org/download.html下载PostgreSQL JDBC驱动。
  2. 添加PostgreSQL JDBC驱动程序jar到应用服务器的lib/目录下。

3.配置JIRA服务器来连接到PostgreSQL数据库

三种配置JIRA服务器链接到PostgreSQL数据库的方法:

  • 使用JIRA安装向导(不适用于JIRA WAR)-如果你已经安装JIRA并且是第一次设置,设置将被保存到JIRA主目录的dbconfig.xml文件里。
  • 使用JIRA配置工具(不适用于JIRA WAR)-如果有已存在的JIRA实例,设置将被保存到JIRA主目录的dbconfig.xml文件里。
  • 手动配置-只有当你有JIRA WAR实例或控制台时使用这种方法链接到JIRA服务器。需要手动更新JIRA主目录里的dbconfig.xml文件。

每种配置方法的说明:

JIRA setup wizard当你首次在浏览器上访问JIRA时,JIRA setup wizard才会显示。
  1. 在最开始页面的'Configure Language and Database'设置Database Connection为My own database。
  2. 设置Database Type为PostgreSQL。
  3. 按照下面介绍的数据库连接字段部分描述填写字段。
  4. 测试连接并保存。
JIRA configuration tool
  1. 按如下指示运行JIRA配置工具:
    • Windows:打开命令提示符,运行JIRA安装目录的bin子目录文件config.bat。
    • Linux/Unix:打开控制台,运行JIRA安装目录的bin子目录文件config.sh。
    JIRA连接PostgreSQL数据库的详细步骤可能会出现失败的错误,参照此文章的解决方法。
  2. 导航到Database选项卡,设置Database type为PostgreSQL。
  3. 按下面描述的数据库连接字段填写字段。
  4. 测试连接并保存。
  5. 重启JIRA。
Manually
  1. 找到JIRA主目录根目录下的dbconfig.xml文件。
    • 如果该文件不存在,创建该文件,将XML示例代码(如下)复制粘贴到该文件。
  2. 根据下面数据库连接字段描述更新该文件。通过在每一个末端添加'amp;'转义所有'&'字符。
    • 注意:<database-type/>元素必须指定数据库类型。例:如果你正在使用PostgreSQL 9.2。如果你忘记指定数据库类型就启动JIRA,那么数据库表将不会被正确创建。若遇到类似问题,参见指定不正确的数据库类型进行解决。
  3. 保存文件并重启JIRA。


数据库连接字段:

setup wizard/configuration tool 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数据将保存的数据库)的名称。应该在上面第一步时创建。
Username 位于< username>标记(例如下面的粗体字):
< username>jiradbuser< /username>
JIRA用于连接PostgreSQL服务器的用户。应在上面第一步时创建。
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文件示例

JIRA连接PostgreSQL数据库的详细步骤

4.启动JIRA

现在JIRA连接到PostgreSQL数据库就配置好了。下一步就是启动JIRA。

  • 如果正在使用JIRA的'recommended'分配,启动它,并观察日志中是否存在错误。
  • 如果使用的是JIRA WAR分配,重建并重新部署在应用服务器的Web应用程序。

 点击查看>>更多JIRA中文教程

相关推荐