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

---

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

首先

• 查看SQL Server的版本是否支持，查閱。
  注意SQL Server Express是不支持的，但可以設置JIRA來使之與該數據庫一起工作。正因為它不支持，因此沒有該配置的文檔。
• 如果是轉移JIRA到另一臺服務器，先導出數據為XML備份，然后將舊數據庫中的數據傳輸到新的數據庫。
• 在開始前關閉JIRA，除非你正在運行Setup Wizard。

1.創建并配置SQL Server數據庫

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

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

如果你安裝了包含SQL Server JDBC 驅動的JIRA'Recommended'分布可跳過此步。JIRA WAR分布不包含該驅動。

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

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

三中配置JIRA服務器來連接SQL Server數據庫的方法：

• 使用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 setup wizard才會顯示。 在最開始頁面的'Configure Language and Database'設置Database Connection為My own database。 設置Database Type為SQL Server。 按照下面介紹的數據庫連接字段部分描述填寫字段。 測試連接并保存。
JIRA configuration tool	按如下指示運行JIRA配置工具： Windows:打開命令提示符，運行JIRA安裝目錄的bin子目錄文件config.bat。 Linux/Unix:打開控制臺，運行JIRA安裝目錄的bin子目錄文件config.sh。 可能會出現失敗的錯誤，參照此的解決方法。 導航到Database選項卡，設置Database type為SQL Server。 按下面描述的數據庫連接字段填寫字段。 測試連接并保存。 重啟JIRA。
Manually	找到JIRA主目錄根目錄下的dbconfig.xml文件。 如果該文件不存在，創建該文件，將XML示例代碼（如下）復制粘貼到該文件。 根據下面數據庫連接字段描述更新該文件。通過在每一個末端添加'amp;'轉義所有'&'字符。 注意：<database-type/>元素必須指定數據庫類型，如：mssql。如果你忘記指定數據庫類型就啟動JIRA，那么數據庫表將不會被正確創建。若遇到類似問題，參見指進行解決 保存文件并重啟JIRA。

數據庫連接字段:

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

dbconfig.xml文件示例:

 

4.啟動JIRA

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

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

 

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