JIRA使用教程：連接數(shù)據(jù)庫—PostgreSQL

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

首先

• 檢查是否支持你的PostgreSQL版本。請參見支持的平臺。
• 如果是轉(zhuǎn)移JIRA到另一臺服務(wù)器，先導(dǎo)出數(shù)據(jù)為XML備份，然后將舊數(shù)據(jù)庫中的數(shù)據(jù)傳輸?shù)叫碌臄?shù)據(jù)庫。
• 在開始前關(guān)閉JIRA，除非你正在運行Setup Wizard。

1.創(chuàng)建并配置PostgreSQL數(shù)據(jù)庫

1. 創(chuàng)建與JIRA連接的數(shù)據(jù)庫用戶（登錄角色）例如：jiradbuser。
2. 使用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
3. 確保該用戶擁有連接數(shù)據(jù)庫以及創(chuàng)建和編輯表的權(quán)限。

2.將PostgreSQL JDBC驅(qū)動程序復(fù)制到你的應(yīng)用服務(wù)器（僅供JIRA WAR）

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

1. 從http://jdbc.postgresql.org/download.html下載PostgreSQL JDBC驅(qū)動。
2. 添加PostgreSQL JDBC驅(qū)動程序jar到應(yīng)用服務(wù)器的lib/目錄下。

3.配置JIRA服務(wù)器來連接到PostgreSQL數(shù)據(jù)庫

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

• 使用JIRA安裝向?qū)?/strong>(不適用于JIRA WAR)-如果你已經(jīng)安裝JIRA并且是第一次設(shè)置，設(shè)置將被保存到JIRA主目錄的dbconfig.xml文件里。
• 使用JIRA配置工具(不適用于JIRA WAR)-如果有已存在的JIRA實例，設(shè)置將被保存到JIRA主目錄的dbconfig.xml文件里。
• 手動配置-只有當(dāng)你有JIRA WAR實例或控制臺時使用這種方法鏈接到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	按如下指示運行JIRA配置工具： Windows:打開命令提示符，運行JIRA安裝目錄的bin子目錄文件config.bat。 Linux/Unix:打開控制臺，運行JIRA安裝目錄的bin子目錄文件config.sh。 可能會出現(xiàn)失敗的錯誤，參照此文章的解決方法。 導(dǎo)航到Database選項卡，設(shè)置Database type為PostgreSQL。 按下面描述的數(shù)據(jù)庫連接字段填寫字段。 測試連接并保存。 重啟JIRA。
Manually	找到JIRA主目錄根目錄下的dbconfig.xml文件。 如果該文件不存在，創(chuàng)建該文件，將XML示例代碼（如下）復(fù)制粘貼到該文件。 根據(jù)下面數(shù)據(jù)庫連接字段描述更新該文件。通過在每一個末端添加'amp;'轉(zhuǎn)義所有'&'字符。 注意：<database-type/>元素必須指定數(shù)據(jù)庫類型。例：如果你正在使用PostgreSQL 9.2。如果你忘記指定數(shù)據(jù)庫類型就啟動JIRA，那么數(shù)據(jù)庫表將不會被正確創(chuàng)建。若遇到類似問題，參見指定不正確的數(shù)據(jù)庫類型進(jìn)行解決。 保存文件并重啟JIRA。

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

setup wizard/configuration tool	dbconfig.xml	描述
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ù)器身份驗證的用戶密碼。
Schema	位于< schema-name>標(biāo)記(例如下面的粗體字)： < schema-name>public< /schema-name>	PostgreSQL數(shù)據(jù)庫使用的模式名稱。 PostgreSQL 7.2及以后的版本要求在<schema-name/>中指定模式。如果你的PostgreSQL使用默認(rèn)'public'模式，這需要在<schema-name/>元素中指定。 確保你的數(shù)據(jù)庫模式名稱是小寫，因為JIRA不支持PostgreSQL數(shù)據(jù)庫中的模式名稱包含大寫字符。

dbconfig.xml文件示例

4.啟動JIRA

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

• 如果正在使用JIRA的'recommended'分配，啟動它，并觀察日志中是否存在錯誤。
• 如果使用的是JIRA WAR分配，重建并重新部署在應(yīng)用服務(wù)器的Web應(yīng)用程序。

 

相關(guān)產(chǎn)品購買請咨詢"在線客服"。