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

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

檢查是否支持你的PostgreSQL版本。請(qǐng)參見(jiàn)支持的平臺(tái)。

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

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

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

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

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

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

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

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

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

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

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

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

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

每種配置方法的說(shuō)明：

JIRA setup wizard
當(dāng)你首次在瀏覽器上訪問(wèn)JIRA時(shí)，JIRA setup wizard才會(huì)顯示。

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

設(shè)置Database Type為PostgreSQL。

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

測(cè)試連接并保存。

JIRA configuration tool

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

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

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

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

測(cè)試連接并保存。

重啟JIRA。

Manually

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

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

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

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

保存文件并重啟JIRA。

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

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)聽(tīng)的TCP/IP端口。也可以留空來(lái)使用默認(rèn)端口。

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

Username
位于< username>標(biāo)記(例如下面加*的文字)：
< username>*jiradbuser*< /username>
JIRA用于連接PostgreSQL服務(wù)器的用戶。應(yīng)在上面第一步時(shí)創(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ù)庫(kù)使用的模式名稱。
PostgreSQL 7.2及以后的版本要求在中指定模式。如果你的PostgreSQL使用默認(rèn)"public"模式，這需要在元素中指定。
確保你的數(shù)據(jù)庫(kù)模式名稱是小寫(xiě)，因?yàn)镴IRA不支持PostgreSQL數(shù)據(jù)庫(kù)中的模式名稱包含大寫(xiě)字符。

dbconfig.xml文件示例

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

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

如果使用的是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