?

首先 查看MySQL的版本是否支持，查阅 支持的平台 。 如果是转移JIRA到另一台服务器，先导出数据为XML备份，然后将旧数据库中的数据传输到新的数据库。 如果你打算用同一个MySQL服务器安装Confluence和JIRA，请阅读 Confluence MySQL安装指南 ，配置你的MySQL服务器来适应Confluence以及JIRA。注意Confluence要求比JIRA要严格，因此应该配置MySQL来适应Confluence，这种配置同样也适用于JIRA。 在开始前关闭JIRA，除非你正在运行Setup Wizard。 1.创建并配置MySQL数据库 创建与JIRA连接的数据库用户（登录角色）例如： jiradbuser 。?

?

mysql> CREATE USER '< USERNAME>'@'< JIRA_SERVER_HOSTNAME>' IDENTIFIED BY '< PASSWORD>'; 创建一个数据库（如 jiradb ）来存储JIRA的问题，数据库必须有一个UTF8的字符集。在MySQL命令客户端输入以下命令：?

CREATE DATABASE jiradb CHARACTER SET utf8 COLLATE utf8_bin; 确保该用户拥有连接数据库以及创建和写入表的权限。授权命令如下：?

GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,ALTER,INDEX on < JIRADB>.* TO

'< USERNAME>'@'< JIRA_SERVER_HOSTNAME>' IDENTIFIED BY '';

flush privileges;

Tip:

?

为了确认权限是否被授予成功，用JIRA DB用户登录到DB服务器并运行一下命令：

?

SHOW GRANTS FOR < USERNAME>@< JIRA_SERVER_HOSTNAME>; 2.将MySQL JDBC驱动程序复制到应用服务器

如果是 升级JIRA并且使用的是推荐的MySQL驱动器 (Connector/J JDBC driver v5.1)，可跳过此步。JIRA更新会自动复制已存在的驱动到升级后的安装。

?

将MySQL JDBC驱动程序复制到你的应用服务器

?

获得MySQL驱动程序： 如果是 安装JIRA ， 下载推荐的MySQL驱动器Connector/J JDBC driver v5.1。?

?

可通过选择'Platform Independent'选项下载.tar.gz或.zip文件。从存档中为驱动提取jar（例如：mysql-connector-java-5.x.x-bin.jar）。 如果是 升级JIRA并且没有使用推荐的MySQL驱动 (JDBC Connector/J 5.1)，在更新前先从JIRA备份驱动程序。驱动程序将存储在/lib/ 目录。 复制MySQL JDBC驱动程序到/lib/ 目录来更新JIRA。如果使用windows installer安装JIRA，你需要在运行Windows installer后，但要在运行Setup Wizard之前做这一步。 重启JIRA/JIRA服务器。 如果正在安装JIRA，跳过该页面的其他指示，通过 浏览器连接JIRA来运行Setup Wizard。 注意： 上面推荐的MySQL Connector/J驱动，有用户报告遇到Resin JDBC driver for MySQL的问题。 3.配置JIRA服务器来连接MySQL 数据库

?

三种配置JIRA服务器连接MySQL数据库的方法：

?

使用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 为 MySQL 。 按照下面描述的数据库连接字段填写字段。 测试连接并保存。 JIRA configuration tool 根据下面运行JIRA配置工具： Windows: 打开命令提示符，运行JIRA安装目录的bin子目录文件config.bat。 linux/Unix: 打开控制台，运行JIRA安装目录的bin子目录文件config.sh。?

?

JIRA使用教程：连接数据库—MySQL

?

可能会出现失败的错误，参照此 文章 的解决方法。 导航到 Database 选项卡设置 Database type 为 MySQL 。 按照下面描述的数据库连接字段填写字段。 测试连接并保存。 重启JIRA。 Manually 找到JIRA主目录根目录下的dbconfig.xml文件。 如果该文件不存在，创建该文件，将XML示例代码（如下）复制粘贴到该文件。 根据下面数据库连接字段描述更新该文件。通过在每一个末端添加'amp;'转义所有'&'字符。 注意：元素必须指定数据库类型，如：mysql。如果你忘记指定数据库类型就启动JIRA，那么数据库表将不会被正确创建。若遇到类似问题，参见指定不正确的数据库类型进行解决。 保存文件并重启JIRA。

数据库连接字段：

?

setup wizard/configuration tool dbconfig.xml Description Hostname 位于< url>标记（例如下面的粗体文字）：?

< url>jdbc:mysql:// dbserver :3306/jiradb?useUnicode=true&characterEncoding=UTF8&sessionVariables=storage_engine=InnoDB< /url> 安装MySQL服务器的机器名称或IP地址。 Port 位于< url>标记（例如下面的粗体文字）：?

< url>jdbc:mysql://dbserver: 3306 /jiradb?useUnicode=true&characterEncoding=UTF8&sessionVariables=storage_engine=InnoDB < /url> MySQL服务器正在监听的TCP/IP端口。也可以留空来使用默认端口。 Database 位于< ;url>标记（例如下面的粗体文字）：?

< url>jdbc:mysql://dbserver:3306/ jiradb ?useUnicode=true&characterEncoding=UTF8&sessionVariables=storage_engine=InnoDB < /url> MySQL数据库（JIRA数据将保存的数据库）的名称。应该在上面第一步时创建。 Username 位于< username>标记（例如下面的粗体字）：?

< username> jiradbuser < /username> JIRA用于连接MySQL服务器的用户。应在上面第一步时创建。 Password 位于< password>标记（例如下面的粗体字）：?

< password> jiradbuser < /password> 用于与MySQL服务器身份验证的用户密码。

dbconfig.xml文件示例