JIRA使用教程：連接數據庫—Oracle

---

本文主要介紹連接JIRA到Oracle數據庫。

首先

• 檢查Oracle的版本是否支持，詳見。
• 如果是轉移JIRA到另一臺服務器，先導出數據為XML備份，然后將舊數據庫中的數據傳輸到新的數據庫。
• 在開始前關閉JIRA，除非你正在運行Setup Wizard。

1.配置Oracle

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

2.將Oracle JDBC驅動程序復制到應用服務器（僅JIRA WAR）

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

1. 下載Oracle JDBC驅動（從）。
2. 添加適當的Oracle JDBC驅動jar（ojdbc6.jar for JDK 1.6）到lib/目錄。

注意一些Oracle JDBC驅動版本不能與JIRA一起使用或內在不穩定。已知的Oracle驅動有關的問題如下：

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

3.配置JIRA服務器來連接Oracle數據庫

三種連接Oracle數據庫的方法：

• 使用JIRA安裝向導（不適用于JIRA WAR）-如果你已經安裝JIRA并且是第一次設置，你的設置將被保存到JIRA主目錄的dbconfig.xml文件里。
• 使用JIRA配置工具（不適用于JIRA WAR）-如果有已存在的JIRA實例，你的設置將被保存到JIRA主目錄的dbconfig.xml文件里。
• 手動配置-只有當你有JIRA WAR實例或控制臺時使用這種方法鏈接到JIRA服務器。你需要手動更新JIRA主目錄里的dbconfig.xml文件。

每種配置方法的說明：

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

數據庫連接字段：

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

dbconfig.xml文件示例：

 

4.啟動JIRA

現在JIRA連接到Oracle數據庫就配置好了。下一步就是啟動JIRA。

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

安裝注意事項

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

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

相關產品購買請咨詢""。