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

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

首先

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

1.配置Oracle

1. 確保有適合JIRA的數(shù)據(jù)庫實(shí)例（新建或使用已存在的）。
2. 在這個(gè)數(shù)據(jù)庫實(shí)例里創(chuàng)建一個(gè)將與JIRA連接的用戶如：jiradbuser。
   create user < user> identified by < user_pass> default tablespace < tablespace_name> quota unlimited on < tablespace_name>;
   注意：
   • 當(dāng)你在Oracle中創(chuàng)建一個(gè)用戶時(shí)，Oracle會(huì)自動(dòng)創(chuàng)建一個(gè)'schema'。
   • 當(dāng)創(chuàng)建用戶時(shí)，表對(duì)象的空間必須被指定。
   • 當(dāng)創(chuàng)建用戶時(shí)，只能用Oracle支持的不帶引號(hào)的字符。至少已有一個(gè)已知的使用不支持的字符時(shí)出現(xiàn)的問題（）。
3. 確保創(chuàng)建的用戶有下列權(quán)限：
   • grant connect to < user>;
   • grant create table to < user>;
   • grant create sequence to < user>;
   • grant create trigger to < user>;
   如果權(quán)限分配不正確，JIRA實(shí)例可能不會(huì)正常工作，參考里的描述。所以只分配上面提到的權(quán)限。
4. 確保數(shù)據(jù)庫與JIRA配置為使用相同的字符編碼，推薦使用AL32UTF8（Oracle等效的為Unicode UTF-8）。

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

如果安裝的JIRA'Recommended'分布可跳過此步，其中包含Oracle JDBC驅(qū)動(dòng)。而JIRA WAR分布不包含該驅(qū)動(dòng)。

1. 下載Oracle JDBC驅(qū)動(dòng)（從）。
2. 添加適當(dāng)?shù)腛racle JDBC驅(qū)動(dòng)jar（ojdbc6.jar for JDK 1.6）到lib/目錄。

注意一些Oracle JDBC驅(qū)動(dòng)版本不能與JIRA一起使用或內(nèi)在不穩(wěn)定。已知的Oracle驅(qū)動(dòng)有關(guān)的問題如下：

• 建議使用11.2.x版本的Oracle驅(qū)動(dòng)（是向后兼容的）。許多其他版本的驅(qū)動(dòng)已出現(xiàn)以下問題：
  • 10g版本10.2.0.3.0發(fā)布的2JDBC驅(qū)動(dòng)產(chǎn)生ORA-01461的錯(cuò)誤，詳見網(wǎng)站。
  • 10g版本10.2.0.1.0發(fā)布的2JDBC驅(qū)動(dòng)出現(xiàn)有一些數(shù)據(jù)庫掛斷的問題。
  • 10g版本10.1.0.4發(fā)布的1JDBC驅(qū)動(dòng)雖不掛斷，但會(huì)拋出ArrayIndexOutOfBoundsExceptions異常。
• 注意：JDK 1.6不支持JIRA6.0及以后的版本。但可以使用Oracle JDBC驅(qū)動(dòng)JDK 1.7替代JDK 1.6。

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

三種連接Oracle數(shù)據(jù)庫的方法：

• 使用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文件。

每種配置方法的說明：

JIRA setup wizard	當(dāng)首次在瀏覽器連接JIRA時(shí)，JIRA設(shè)置向?qū)Ь蜁?huì)出現(xiàn)。 在最開始頁面的'Configure Language and Database'設(shè)置Database Connection為My own database。 設(shè)置Database Type為Oracle。 按照下面描述的數(shù)據(jù)庫連接字段填寫字段。 測(cè)試連接并保存。
JIRA configuration tool	根據(jù)下面運(yùn)行JIRA配置工具： Windows:打開命令提示符，運(yùn)行JIRA安裝目錄的bin子目錄文件config.bat。 Linux/Unix:打開控制臺(tái)，運(yùn)行JIRA安裝目錄的bin子目錄文件config.sh。 可能會(huì)出現(xiàn)失敗的錯(cuò)誤，參照此的解決方法。 導(dǎo)航到Database選項(xiàng)卡設(shè)置Database type為Oracle。 按照下面描述的數(shù)據(jù)庫連接字段填寫字段。 測(cè)試連接并保存。當(dāng)手動(dòng)在JIRA配置Oracle時(shí)任何自定義設(shè)置（如adding the < connection-properties>SetBigStringTryClob=true< /connection-properties>）都會(huì)被刪掉，因此需要手動(dòng)恢復(fù)它們。 重啟JIRA。
Manually	找到JIRA主目錄根目錄下的dbconfig.xml文件。 如果該文件不存在，創(chuàng)建該文件，將XML示例代碼（如下）復(fù)制粘貼到該文件。 根據(jù)下面數(shù)據(jù)庫連接字段描述更新該文件。通過在每一個(gè)末端添加'amp;'轉(zhuǎn)義所有'&'字符。 注意：<database-type/>元素必須指定數(shù)據(jù)庫類型，如：oracle10g。如果你忘記指定數(shù)據(jù)庫類型就啟動(dòng)JIRA，那么數(shù)據(jù)庫表將不會(huì)被正確創(chuàng)建。若遇到類似問題，參見進(jìn)行解決。 保存文件并重啟JIRA。

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

setup wizard/configuration tool	dbconfig.xml	描述
Hostname	位于< url>標(biāo)記（例如下面的粗體文字）： < url>jdbc:oracle:thin:@dbserver:1521:ORCL< /url>	安裝Oracle服務(wù)器的機(jī)器名稱或IP地址。
Port	位于< url>標(biāo)記（例如下面的粗體文字）： < url>jdbc:oracle:thin:@dbserver:1521:ORCL< /url>	MySQL服務(wù)器正在監(jiān)聽的TCP/IP端口。默認(rèn)端口號(hào)是'1521'。
SID	位于< url>標(biāo)記（例如下面的粗體文字）： < url>jdbc:oracle:thin:@dbserver:1521:ORCL< /url>	Oracle "System Identifier"。大多數(shù)Oracle服務(wù)器默認(rèn)值是'ORCL'。如果使用的是Oracle Express Edition，默認(rèn)的將會(huì)是'XE'。
Username	位于< username>標(biāo)記（例如下面的粗體字）： < username>jiradbuser< /username>	JIRA用于連接Oracle服務(wù)器的用戶。應(yīng)在上面第一步時(shí)創(chuàng)建。
Password	位于< password>標(biāo)記（例如下面的粗體字）： < password>jiradbuser< /password>	用于與Oracle服務(wù)器身份驗(yàn)證的用戶密碼。

dbconfig.xml文件示例：

 

4.啟動(dòng)JIRA

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

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

安裝注意事項(xiàng)

詳見。
已知的問題和解決方案：

• 當(dāng)處理自定義工作流或擁有長(zhǎng)描述、評(píng)論、或自定義字段值的問題時(shí)，如果遇到問題，試著在dbconfig.xml文件里添加< connection-properties>SetBigStringTryClob=true< /connection-properties>作為< /jdbc-datasource>元素的子元素。添加此連接屬性就可解決這一問題。注意你需要重啟來使這一設(shè)置產(chǎn)生作用。

相關(guān)產(chǎn)品購買請(qǐng)咨詢""。