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

摘要：本文主要介绍如何连接到数据库。创建并配置数据库创建与连接的数据库用户登录角色例如。或通过命令行确保该用户拥有连接数据库以及创建和编辑表的权限。测试连接并保存。注意元素必须指定数据库类型。文件示例启动现在连接到数据库就配置好了。

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

检查是否支持你的PostgreSQL版本。请参见支持的平台。

如果是转移JIRA到另一台服务器，先导出数据为XML备份，然后将旧数据库中的数据传输到新的数据库。

在开始前关闭JIRA，除非你正在运行Setup Wizard。

创建与JIRA连接的数据库用户（登录角色）例如：jiradbuser。

使用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

确保该用户拥有连接数据库以及创建和编辑表的权限。

如果你安装了包含PostgreSQL JDBC 驱动的JIRA"Recommended"分布可跳过此步。JIRA WAR分布不包含该驱动。

从http://jdbc.postgresql.org/download.html下载PostgreSQL JDBC驱动。

添加PostgreSQL JDBC驱动程序jar到应用服务器的lib/目录下。

三种配置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才会显示。

在最开始页面的"Configure Language and Database"设置Database Connection为My own
database。

设置Database Type为PostgreSQL。

按照下面介绍的数据库连接字段部分描述填写字段。

测试连接并保存。

JIRA configuration tool

按如下指示运行JIRA配置工具：

           Windows:打开命令提示符，运行JIRA安装目录的bin子目录文件config.bat。
           Linux/Unix:打开控制台，运行JIRA安装目录的bin子目录文件config.sh。
       可能会出现失败的错误，参照文末的解决方案一进行解决。

导航到Database选项卡，设置Database type为PostgreSQL。

按下面描述的数据库连接字段填写字段。

测试连接并保存。

重启JIRA。

Manually

找到JIRA主目录根目录下的dbconfig.xml文件。

       如果该文件不存在，创建该文件，将XML示例代码（如下）复制粘贴到该文件。

根据下面数据库连接字段描述更新该文件。通过在每一个末端添加"amp;"转义所有"&"字符。

       注意：元素必须指定数据库类型。例：如果你正在使用PostgreSQL 9.2。如果你忘记指定数据库类型就启动JIRA，那么数据库表将不会被正确创建。若遇到类似问题，参见文末的解决方案二进行参考解决。

保存文件并重启JIRA。

数据库连接字段：

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及以后的版本要求在中指定模式。如果你的PostgreSQL使用默认"public"模式，这需要在元素中指定。
确保你的数据库模式名称是小写，因为JIRA不支持PostgreSQL数据库中的模式名称包含大写字符。

dbconfig.xml文件示例

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

如果正在使用JIRA的"recommended"分配，启动它，并观察日志中是否存在错误。

如果使用的是JIRA WAR分配，重建并重新部署在应用服务器的Web应用程序。

点击查看>>更多JIRA中文教程
解决方案一：https://confluence.atlassian.com/display/JIRAKB/Unable+to+Start+JIRA+Config+Tool+due+to+No+X11+DISPLAY+variable+was+set+error
解决方案二：https://confluence.atlassian.com/display/JIRAKB/Incorrect+database+type+specified