logo 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会在首次启动这个空模式时创建这些对象)。可参考Microsoft documentation查看更多SQL Server模式信息。
  4. 确保该用户在新创建的模式中有连接数据库以及创建和写入表的权限。
  5. 确保TCP/IP 可用于SQL Server并且正在监听正确的端口(SQL Server安装默认端口为1433)。
    • 阅读Microsoft documentation查看更多如何启用网络协议(TCP/IP)以及如何配置SQL Server来监听特定的端口。
  6. 确保SQL Server在适当的身份验证模式下运行。
    • 默认情况下,SQL Server在'Windows Authentication Mode'下运行。但如果你的用户没有与受信任的SQL连接关联,如'Microsoft SQL Server, Error: 18452'就是在启动JIRA时出现的错误,这时你需要修改身份验证模式为'Mixed Authentication Mode'。阅读Microsoft documentation了解身份验证模式并修改身份验证模式为'Mixed Authentication Mode'。
  7. 取消SET NOCOUNT选项(查看由SET NOCOUNT引起的MS SQL Server错误),方法如下:
    • 打开SQL Server Management Studio并导航到Tools > Options > Query Execution > SQL Server > Advanced。下面的截屏显示的就是MSSQL Server中此设置的配置面板。确保SET NOCOUNT选项不被选上
      SQLServer设置版面

      *当连接SQL Server 2008时还需要在Server > Properties > Connections > Default Connections属性框中清除no count选项。截屏如下:
      SQLServer设置版面
    • 通过选中新建的数据库点击右键连接Query Console并选择'New Query'。执行以下命令来设置隔离级别。
      ALTER DATABASE THE-NEW-DATABASE-CREATED-FOR-JIRA SET READ_COMMITTED_SNAPSHOT ON

2.将SQL Server JDBC驱动程序复制到应用服务器(仅JIRA WAR)

(warning)如果你安装了包含SQL Server JDBC 驱动的JIRA'Recommended'分布可跳过此步。JIRA WAR分布不包含该驱动。

  1. 从JTDS下载SQL Server JDBC驱动(v1.2.4)。
    (info)微软有他们自己的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才会显示。
  1. 在最开始页面的'Configure Language and Database'设置Database ConnectionMy own database
  2. 设置Database TypeSQL Server
  3. 按照下面介绍的数据库连接字段部分描述填写字段。
  4. 测试连接并保存。
JIRA configuration tool
  1. 按如下指示运行JIRA配置工具:
    • Windows:打开命令提示符,运行JIRA安装目录的bin子目录文件config.bat。
    • Linux/Unix:打开控制台,运行JIRA安装目录的bin子目录文件config.sh。
    (info)可能会出现失败的错误,参照此文章的解决方法。
  2. 导航到Database选项卡,设置Database typeSQL Server
  3. 按下面描述的数据库连接字段填写字段。
  4. 测试连接并保存。
  5. 重启JIRA。
Manually
  1. 找到JIRA主目录根目录下的dbconfig.xml文件。
    • 如果该文件不存在,创建该文件,将XML示例代码(如下)复制粘贴到该文件。
  2. 根据下面数据库连接字段描述更新该文件。通过在每一个末端添加'amp;'转义所有'&'字符。
    • 注意:<database-type/>元素必须指定数据库类型,如:mssql。如果你忘记指定数据库类型就启动JIRA,那么数据库表将不会被正确创建。若遇到类似问题,参见指定不正确的数据库类型进行解决
  3. 保存文件并重启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文件示例:

JIRA.xml文件

 

4.启动JIRA

现在JIRA连接到SQL Server数据库就配置好了。下一步就是启动JIRA。

  • 如果正在使用JIRA的'recommended'分配,启动它,并观察日志中是否存在错误。
  • 如果使用的是JIRA WAR分配,重建并重新部署在应用服务器的Web应用程序。

 

相关产品购买请咨询"在线客服"。

 

在线咨询
联系我们

客服热线
023-68661681

QQ客服

意见反馈


添加微信获专业服务

TOP