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驅動（從Oracle網站）。
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設置嚮導就會出現。
1.在最開始頁面的'Configure Language and Database'設置Database Connection爲My own database。
2.設置Database Type爲Oracle。
3.按照下面描述的數據庫鏈接字段填寫字段。
4.測試鏈接並保存。

JIRA configuration tool
1.根據下面運行JIRA配置工具：

• Windows:打開命令提示符，運行JIRA安裝目錄的bin子目錄文件config.bat。

• Linux/Unix:打開控制檯，運行JIRA安裝目錄的bin子目錄文件config.sh。
  2.導航到Database選項卡設置Database type爲Oracle。
  3.按照下面描述的數據庫鏈接字段填寫字段。
  4.測試鏈接並保存。當手動在JIRA配置Oracle時任何自定義設置（如adding the < connection-properties>SetBigStringTryClob=true< /connection-properties>）都會被刪掉，所以須要手動恢復它們。
  5.重啓JIRA。

Manually
1.找到JIRA主目錄根目錄下的dbconfig.xml文件。

若是該文件不存在，建立該文件，將XML示例代碼（以下）複製粘貼到該文件。

2.根據下面數據庫鏈接字段描述更新該文件。經過在每個末端添加'amp;'轉義全部'&'字符。

注意：元素必須指定數據庫類型，如：oracle10g。若是你忘記指定數據庫類型就啓動JIRA，那麼數據庫表將不會被正確建立。

3.保存文件並重啓JIRA。

---

數據庫鏈接字段：

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>元素的子元素。添加此鏈接屬性就可解決這一問題。注意你須要重啓來使這一設置產生做用。

點擊查看>>更多JIRA中文教程