摘要：本文主要介紹如何連接到數(shù)據(jù)庫。創(chuàng)建并配置數(shù)據(jù)庫創(chuàng)建與連接的數(shù)據(jù)庫用戶登錄角色例如。或通過命令行確保該用戶擁有連接數(shù)據(jù)庫以及創(chuàng)建和編輯表的權(quán)限。測試連接并保存。注意元素必須指定數(shù)據(jù)庫類型。文件示例啟動現(xiàn)在連接到數(shù)據(jù)庫就配置好了。

本文主要介紹如何連接JIRA到PostgreSQL數(shù)據(jù)庫。

檢查是否支持你的PostgreSQL版本。請參見支持的平臺。

如果是轉(zhuǎn)移JIRA到另一臺服務(wù)器，先導(dǎo)出數(shù)據(jù)為XML備份，然后將舊數(shù)據(jù)庫中的數(shù)據(jù)傳輸?shù)叫碌臄?shù)據(jù)庫。

在開始前關(guān)閉JIRA，除非你正在運(yùn)行Setup Wizard。

創(chuàng)建與JIRA連接的數(shù)據(jù)庫用戶（登錄角色）例如：jiradbuser。

使用Unicode排序規(guī)則創(chuàng)建一個存儲JIRA問題的數(shù)據(jù)庫，如：jiradb。

   CREATE DATABASE jiradb WITH ENCODING "UNICODE" LC_COLLATE "C" LC_CTYPE "C" TEMPLATE template0;
   或通過命令行：
   $ createdb -E UNICODE -l C -T template0 jiradb

確保該用戶擁有連接數(shù)據(jù)庫以及創(chuàng)建和編輯表的權(quán)限。

如果你安裝了包含PostgreSQL JDBC 驅(qū)動的JIRA"Recommended"分布可跳過此步。JIRA WAR分布不包含該驅(qū)動。

從http://jdbc.postgresql.org/download.html下載PostgreSQL JDBC驅(qū)動。

添加PostgreSQL JDBC驅(qū)動程序jar到應(yīng)用服務(wù)器的lib/目錄下。

三種配置JIRA服務(wù)器鏈接到PostgreSQL數(shù)據(jù)庫的方法：

使用JIRA安裝向?qū)?不適用于JIRA WAR)——如果你已經(jīng)安裝JIRA并且是第一次設(shè)置，設(shè)置將被保存到JIRA主目錄的dbconfig.xml文件里。

使用JIRA配置工具(不適用于JIRA WAR)——如果有已存在的JIRA實(shí)例，設(shè)置將被保存到JIRA主目錄的dbconfig.xml文件里。

手動配置——只有當(dāng)你有JIRA WAR實(shí)例或控制臺時使用這種方法鏈接到JIRA服務(wù)器。需要手動更新JIRA主目錄里的dbconfig.xml文件。

每種配置方法的說明：

JIRA setup wizard
當(dāng)你首次在瀏覽器上訪問JIRA時，JIRA setup wizard才會顯示。

在最開始頁面的"Configure Language and Database"設(shè)置Database Connection為My own
database。

設(shè)置Database Type為PostgreSQL。

按照下面介紹的數(shù)據(jù)庫連接字段部分描述填寫字段。

測試連接并保存。

JIRA configuration tool

按如下指示運(yùn)行JIRA配置工具：

           Windows:打開命令提示符，運(yùn)行JIRA安裝目錄的bin子目錄文件config.bat。
           Linux/Unix:打開控制臺，運(yùn)行JIRA安裝目錄的bin子目錄文件config.sh。
       可能會出現(xiàn)失敗的錯誤，參照文末的解決方案一進(jìn)行解決。

導(dǎo)航到Database選項(xiàng)卡，設(shè)置Database type為PostgreSQL。

按下面描述的數(shù)據(jù)庫連接字段填寫字段。

測試連接并保存。

重啟JIRA。

Manually

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

       如果該文件不存在，創(chuàng)建該文件，將XML示例代碼（如下）復(fù)制粘貼到該文件。

根據(jù)下面數(shù)據(jù)庫連接字段描述更新該文件。通過在每一個末端添加"amp;"轉(zhuǎn)義所有"&"字符。

       注意：元素必須指定數(shù)據(jù)庫類型。例：如果你正在使用PostgreSQL 9.2。如果你忘記指定數(shù)據(jù)庫類型就啟動JIRA，那么數(shù)據(jù)庫表將不會被正確創(chuàng)建。若遇到類似問題，參見文末的解決方案二進(jìn)行參考解決。

保存文件并重啟JIRA。

數(shù)據(jù)庫連接字段：

Hostname
位于< url>標(biāo)記(例如下面加*的文字)：
< url>jdbc:postgresql://*dbserver*:5432/jiradb< /url>
安裝PostgreSQL服務(wù)器的機(jī)器名稱或IP地址。

Port
位于< url>標(biāo)記(例如下面加*的文字)：
< url>jdbc:postgresql://dbserver:*5432*/jiradb< /url>
PostgreSQL服務(wù)器正在監(jiān)聽的TCP/IP端口。也可以留空來使用默認(rèn)端口。

Database
位于< url>標(biāo)記(例如下面加*的文字)：
< url>jdbc:postgresql://dbserver:5432/*jiradb*< /url>
PostgreSQL數(shù)據(jù)庫（JIRA數(shù)據(jù)將保存的數(shù)據(jù)庫）的名稱。應(yīng)該在上面第一步時創(chuàng)建。

Username
位于< username>標(biāo)記(例如下面加*的文字)：
< username>*jiradbuser*< /username>
JIRA用于連接PostgreSQL服務(wù)器的用戶。應(yīng)在上面第一步時創(chuàng)建。

Password
位于< password>標(biāo)記(例如下面加*的文字)：
< password>*jiradbuser*< /password>
用于與PostgreSQL服務(wù)器身份驗(yàn)證的用戶密碼。

Schema
位于< schema-name>標(biāo)記(例如下面加*的文字)：
< schema-name>*public*< /schema-name>
PostgreSQL數(shù)據(jù)庫使用的模式名稱。
PostgreSQL 7.2及以后的版本要求在中指定模式。如果你的PostgreSQL使用默認(rèn)"public"模式，這需要在元素中指定。
確保你的數(shù)據(jù)庫模式名稱是小寫，因?yàn)镴IRA不支持PostgreSQL數(shù)據(jù)庫中的模式名稱包含大寫字符。

dbconfig.xml文件示例

現(xiàn)在JIRA連接到PostgreSQL數(shù)據(jù)庫就配置好了。下一步就是啟動JIRA。

如果正在使用JIRA的"recommended"分配，啟動它，并觀察日志中是否存在錯誤。

如果使用的是JIRA WAR分配，重建并重新部署在應(yīng)用服務(wù)器的Web應(yīng)用程序。

點(diǎn)擊查看>>更多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