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

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

首先

• 查看SQL Server的版本是否支持，查閱支持的平臺(tái)。
  注意SQL Server Express是不支持的，但可以設(shè)置JIRA來(lái)使之與該數(shù)據(jù)庫(kù)一起工作。正因?yàn)樗恢С?，因此沒(mé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。

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

1. 創(chuàng)建一個(gè)JIRA用于存儲(chǔ)問(wèn)題的數(shù)據(jù)庫(kù)，如：jiradb。
   • 排序規(guī)則類型必須是case-insensitive, accent-insensitive以及language neutral，例如：'SQL_Latin1_General_CP437_CI_AI'。如果你的SQL Server安裝的默認(rèn)排序規(guī)則沒(méi)有被修改，檢查排序規(guī)則類型設(shè)置進(jìn)行修改。
   • SQL Server使用Unicode編碼存儲(chǔ)字符，這足以防止任何可能的問(wèn)題。
2. 創(chuàng)建一個(gè)與JIRA連接的數(shù)據(jù)庫(kù)用戶，如：jiradbuser。
   • 這個(gè)數(shù)據(jù)庫(kù)用戶不能是該數(shù)據(jù)庫(kù)的擁有者，但應(yīng)該在db_owner角色中。
3. 在數(shù)據(jù)庫(kù)中為JIRA表創(chuàng)建一個(gè)空的'schema'，如：jiraschema。
   • 在SQL Server中的'schema'是用來(lái)包含對(duì)象的命名空間，并且不同于傳統(tǒng)的數(shù)據(jù)庫(kù)模式。你不需要?jiǎng)?chuàng)建任何JIRA表、字段或關(guān)系（JIRA會(huì)在首次啟動(dòng)這個(gè)空模式時(shí)創(chuàng)建這些對(duì)象）?？蓞⒖糓icrosoft documentation查看更多SQL Server模式信息。
4. 確保該用戶在新創(chuàng)建的模式中有連接數(shù)據(jù)庫(kù)以及創(chuàng)建和寫入表的權(quán)限。
   • 如果在JIRA設(shè)置SQL Server數(shù)據(jù)庫(kù)還有問(wèn)題可參考Setting Up a SQL Server database for JIRA。
5. 確保TCP/IP 可用于SQL Server并且正在監(jiān)聽(tīng)正確的端口（SQL Server安裝默認(rèn)端口為1433）。
   • 閱讀Microsoft documentation查看更多如何啟用網(wǎng)絡(luò)協(xié)議（TCP/IP）以及如何配置SQL Server來(lái)監(jiān)聽(tīng)特定的端口。
6. 確保SQL Server在適當(dāng)?shù)纳矸蒡?yàn)證模式下運(yùn)行。
   • 默認(rèn)情況下，SQL Server在'Windows Authentication Mode'下運(yùn)行。但如果你的用戶沒(méi)有與受信任的SQL連接關(guān)聯(lián)，如'Microsoft SQL Server, Error: 18452'就是在啟動(dòng)JIRA時(shí)出現(xiàn)的錯(cuò)誤，這時(shí)你需要修改身份驗(yàn)證模式為'Mixed Authentication Mode'。閱讀Microsoft documentation了解身份驗(yàn)證模式并修改身份驗(yàn)證模式為'Mixed Authentication Mode'。
7. 取消SET NOCOUNT選項(xiàng)（查看由SET NOCOUNT引起的MS SQL Server錯(cuò)誤），方法如下：
   • 打開(kāi)SQL Server Management Studio并導(dǎo)航到Tools > Options > Query Execution > SQL Server > Advanced。下面的截屏顯示的就是MSSQL Server中此設(shè)置的配置面板。確保SET NOCOUNT選項(xiàng)不被選上：
     
     
     *當(dāng)連接SQL Server 2008時(shí)還需要在Server > Properties > Connections > Default Connections屬性框中清除no count選項(xiàng)。截屏如下：
     
   • 通過(guò)選中新建的數(shù)據(jù)庫(kù)點(diǎn)擊右鍵連接Query Console并選擇'New Query'。執(zhí)行以下命令來(lái)設(shè)置隔離級(jí)別。
     ALTER DATABASE THE-NEW-DATABASE-CREATED-FOR-JIRA SET READ_COMMITTED_SNAPSHOT ON

2.將SQL Server JDBC驅(qū)動(dòng)程序復(fù)制到應(yīng)用服務(wù)器（僅JIRA WAR）

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

1. 從JTDS下載SQL Server JDBC驅(qū)動(dòng)(v1.2.4)。
   微軟有他們自己的JDBC驅(qū)動(dòng)，但在收到多次的間歇性斷開(kāi)(JRA-5760 and JRA-6872)，工作流問(wèn)題(JRA-8443)以及漢語(yǔ)字符問(wèn)題(JRA-5054)報(bào)告后，強(qiáng)烈建議不要使用這個(gè)。
2. 將SQL Server JDBC驅(qū)動(dòng)jar (jtds-1.2.4.jar)添加到<Tomcat install>/lib/目錄。

3.配置JIRA服務(wù)器來(lái)連接SQL Server數(shù)據(jù)庫(kù)

三中配置JIRA服務(wù)器來(lái)連接SQL Server數(shù)據(jù)庫(kù)的方法：

• 使用JIRA安裝向?qū)?/strong>（不適用于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為SQL Server。 按照下面介紹的數(shù)據(jù)庫(kù)連接字段部分描述填寫字段。 測(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ò)誤，參照此文章的解決方法。 導(dǎo)航到Database選項(xiàng)卡，設(shè)置Database type為SQL Server。 按下面描述的數(shù)據(jù)庫(kù)連接字段填寫字段。 測(cè)試連接并保存。 重啟JIRA。
Manually	找到JIRA主目錄根目錄下的dbconfig.xml文件。 如果該文件不存在，創(chuàng)建該文件，將XML示例代碼（如下）復(fù)制粘貼到該文件。 根據(jù)下面數(shù)據(jù)庫(kù)連接字段描述更新該文件。通過(guò)在每一個(gè)末端添加'amp;'轉(zhuǎn)義所有'&'字符。 注意：<database-type/>元素必須指定數(shù)據(jù)庫(kù)類型，如：mssql。如果你忘記指定數(shù)據(jù)庫(kù)類型就啟動(dòng)JIRA，那么數(shù)據(jù)庫(kù)表將不會(huì)被正確創(chuàng)建。若遇到類似問(wèn)題，參見(jiàn)指定不正確的數(shù)據(jù)庫(kù)類型進(jìn)行解決 保存文件并重啟JIRA。

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

setup wizard/configuration tool	dbconfig.xml	描述
Hostname	位于< url>標(biāo)記（例如下面的粗體文字）： < url>jdbc:jtds:sqlserver://dbserver:1433/jiradb< /url>	安裝SQL Server服務(wù)器的機(jī)器名稱或IP地址。
Port	位于< url>標(biāo)記（例如下面的粗體文字）： < url>jdbc:jtds:sqlserver://dbserver:1433/jiradb< /url>	SQL Server服務(wù)器正在監(jiān)聽(tīng)的TCP/IP端口。也可留空使用默認(rèn)的端口。
Database	位于< url>標(biāo)記（例如下面的粗體文字）： < url>jdbc:jtds:sqlserver://dbserver:1433/jiradb< /url>	SQL Server 數(shù)據(jù)庫(kù)（用于存儲(chǔ)JIRA數(shù)據(jù)）的名稱。
Username	位于< username>標(biāo)記（例如下面的粗體字）： < username>jiradbuser< /username>	JIRA用于連接SQL Server服務(wù)器的用戶。
Password	位于< password>標(biāo)記（例如下面的粗體字）： < password>jiradbuser< /password>	用于與SQL Server服務(wù)器身份驗(yàn)證的用戶密碼。
Schema	位于< schema-name>標(biāo)記（例如下面的粗體字）： < schema-name>dbo< /schema-name>	SQL Server數(shù)據(jù)庫(kù)使用的模式的名稱。

dbconfig.xml文件示例:

 

4.啟動(dòng)JIRA

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

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

 

相關(guān)產(chǎn)品購(gòu)買請(qǐng)咨詢"在線客服"。