JIRA使用教程:連接數據庫—PostgreSQL
本文主要介紹如何連接JIRA到PostgreSQL數據庫。
首先
- 檢查是否支持你的PostgreSQL版本。請參見。
- 如果是轉移JIRA到另一臺服務器,先導出數據為XML備份,然后將舊數據庫中的數據傳輸到新的數據庫。
- 在開始前關閉JIRA,除非你正在運行Setup Wizard。
1.創建并配置PostgreSQL數據庫
- 創建與JIRA連接的數據庫用戶(登錄角色)例如:jiradbuser。
- 使用Unicode排序規則創建一個存儲JIRA問題的數據庫,如:jiradb。
CREATE DATABASE jiradb WITH ENCODING 'UNICODE' LC_COLLATE 'C' LC_CTYPE 'C' TEMPLATE template0;
或通過命令行:
$ createdb -E UNICODE -l C -T template0 jiradb
- 確保該用戶擁有連接數據庫以及創建和編輯表的權限。
2.將PostgreSQL JDBC驅動程序復制到你的應用服務器(僅供JIRA WAR)
如果你安裝了包含PostgreSQL JDBC 驅動的JIRA'Recommended'分布可跳過此步。JIRA WAR分布不包含該驅動。
- 從下載PostgreSQL JDBC驅動。
- 添加PostgreSQL JDBC驅動程序jar到應用服務器的lib/目錄下。
3.配置JIRA服務器來連接到PostgreSQL數據庫
三種配置JIRA服務器鏈接到PostgreSQL數據庫的方法:
- 使用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才會顯示。
|
JIRA configuration tool |
|
Manually |
|
數據庫連接字段:
setup wizard/configuration tool | dbconfig.xml | 描述 |
Hostname | 位于< url>標記(例如下面的粗體文字): < url>jdbc:postgresql://dbserver:5432/jiradb< /url> |
安裝PostgreSQL服務器的機器名稱或IP地址。 |
Port | 位于< url>標記(例如下面的粗體字): < url>jdbc:postgresql://dbserver:5432/jiradb< /url> |
PostgreSQL服務器正在監聽的TCP/IP端口。也可以留空來使用默認端口。 |
Database | 位于< url>標記(例如下面的粗體字): < url>jdbc:postgresql://dbserver:5432/jiradb< /url> |
PostgreSQL數據庫(JIRA數據將保存的數據庫)的名稱。應該在上面第一步時創建。 |
Username | 位于< username>標記(例如下面的粗體字): < username>jiradbuser< /username> |
JIRA用于連接PostgreSQL服務器的用戶。應在上面第一步時創建。 |
Password | 位于< password>標記(例如下面的粗體字): < password>jiradbuser< /password> |
用于與PostgreSQL服務器身份驗證的用戶密碼。 |
Schema | 位于< schema-name>標記(例如下面的粗體字): < schema-name>public< /schema-name> |
PostgreSQL數據庫使用的模式名稱。 PostgreSQL 7.2及以后的版本要求在<schema-name/>中指定模式。如果你的PostgreSQL使用默認'public'模式,這需要在<schema-name/>元素中指定。 確保你的數據庫模式名稱是小寫,因為JIRA不支持PostgreSQL數據庫中的模式名稱包含大寫字符。 |
dbconfig.xml文件示例

4.啟動JIRA
現在JIRA連接到PostgreSQL數據庫就配置好了。下一步就是啟動JIRA。
- 如果正在使用JIRA的'recommended'分配,啟動它,并觀察日志中是否存在錯誤。
- 如果使用的是JIRA WAR分配,重建并重新部署在應用服務器的Web應用程序。
相關產品購買請咨詢""。