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

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

首先

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

1.配置Oracle

1. 確保有適合JIRA的數(shù)據(jù)庫實例（新建或使用已存在的）。
2. 在這個數(shù)據(jù)庫實例里創(chuàng)建一個將與JIRA連接的用戶如：jiradbuser。
   create user < user> identified by < user_pass> default tablespace < tablespace_name> quota unlimited on < tablespace_name>;
   注意：
   • 當你在Oracle中創(chuàng)建一個用戶時，Oracle會自動創(chuàng)建一個'schema'。
   • 當創(chuàng)建用戶時，表對象的空間必須被指定。
   • 當創(chuàng)建用戶時，只能用Oracle支持的不帶引號的字符。至少已有一個已知的使用不支持的字符時出現(xiàn)的問題（Cannot Create XML Backup Due to "Could not get unique fields for table"）。
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實例可能不會正常工作，參考JIRA XML Backup and Restore fails with error: Could not find column <column_name> in previously parsed query里的描述。所以只分配上面提到的權(quán)限。
4. 確保數(shù)據(jù)庫與JIRA配置為使用相同的字符編碼，推薦使用AL32UTF8（Oracle等效的為Unicode UTF-8）。

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

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

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

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

• 建議使用11.2.x版本的Oracle驅(qū)動（是向后兼容的）。許多其他版本的驅(qū)動已出現(xiàn)以下問題：
  • 10g版本10.2.0.3.0發(fā)布的2JDBC驅(qū)動產(chǎn)生ORA-01461的錯誤，詳見Oracle Support網(wǎng)站。
  • 10g版本10.2.0.1.0發(fā)布的2JDBC驅(qū)動出現(xiàn)有一些數(shù)據(jù)庫掛斷的問題。
  • 10g版本10.1.0.4發(fā)布的1JDBC驅(qū)動雖不掛斷，但會拋出ArrayIndexOutOfBoundsExceptions異常。
• 注意：JDK 1.6不支持JIRA6.0及以后的版本。但可以使用Oracle JDBC驅(qū)動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è)置將被保存到JIRA主目錄的dbconfig.xml文件里。
• 手動配置-只有當你有JIRA WAR實例或控制臺時使用這種方法鏈接到JIRA服務(wù)器。你需要手動更新JIRA主目錄里的dbconfig.xml文件。

每種配置方法的說明：

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

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

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

dbconfig.xml文件示例：

 

4.啟動JIRA

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

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

安裝注意事項

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

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

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