Jira を MySQL 8.0 に接続する

ここでは、サポート対象の MySQL データベースに Jira を接続する方法を解説します。

はじめる前に

前提条件として次の情報を確認しておくことをおすすめします。

• 既知の問題を確認します。
• If you are migrating Jira to another server, create an export of your data as an XML backup. You will then be able to transfer data from your old database to your new database, as described in Switching databases.
• If you plan to set up Confluence and Jira on the same MySQL server, read the Confluence MySQL setup guide. Confluence requirements are more strict than Jira's, so you should configure MySQL to suit Confluence. This configuration will work for Jira, too.
• セットアップ ウィザードを実行中の場合を除き、開始する前に Jira をシャットダウンします。

1. MySQL データベースの作成および設定

1. Create a database user which Jira will connect as, for example jiradbuser. 

   CREATE USER '<USERNAME>' IDENTIFIED BY '<PASSWORD>';

2. Create a database for Jira to store issues in, for example jiradb.
   
   The database must have a character set of UTF8. To set it, enter the following command from within the MySQL command client:

   CREATE DATABASE jiradb CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;

3. データベースへの接続権限とテーブルの作成および更新権限がユーザーに割り当てられていることを確認します。これらの権限は次のコマンドで付与できます。
   

   GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,REFERENCES,ALTER,INDEX on <JIRADB>.* TO '<USERNAME>'@'<JIRA_SERVER_HOSTNAME>';
   flush privileges;

4. Edit the my.cnf or my.ini (Windows) file in your MySQL Server (for detailed instructions on editing these files, see MySQL Option Files).
   
   
5. ファイルで [mysqld]  セクションを見つけ、次のパラメータを追加あるいは修正します。
   
   

   • デフォルトのストレージエンジンを InnoDB に設定します:

     [mysqld]
     ...
     default-storage-engine=INNODB
     ...

   • データベース サーバーが使用する文字セットを指定します。

     [mysqld]
     ...
     character_set_server=utf8mb4
     ...

   • 初期設定の行形式を DYNAMIC に設定します。

     [mysqld]
     ...
     innodb_default_row_format=DYNAMIC
     ...

   • innodb_log_file_size の値が 2 GB 以上になるように指定します。

     [mysqld]
     ...
     innodb_log_file_size=2G
     ...

   • sql_mode パラメーターが NO_AUTO_VALUE_ON_ZERO に指定されていないことを確認します。

     // remove this if it exists
     sql_mode = NO_AUTO_VALUE_ON_ZERO

6. MySQL サーバーを再起動して変更内容を反映します。

   Windows...

   Windows サービス マネージャーを利用してサービスを再起動します。

   Linux...

   お使いのセットアップに応じて、以下のいずれかのコマンドを実行します:

   /etc/init.d/mysqld stop

   /etc/init.d/mysql stop

   service mysqld stop

   
   

   次に "stop" を "start" に置き替えて同じコマンドを実行します。

2. MySQL JDBC ドライバのコピー

MySQL の JDBC ドライバを Jira インストール ディレクトリにコピーします。

1. 推奨される MySQL ドライバ、JDBC Connector/J 8.0 をダウンロードします。 
   
   

2. ドライバを次のディレクトリにコピーします。

   <Jira-installation-directory>/lib

   If you are installing Jira using the Windows installer, you will need to do this step after running the Windows installer, but  before  running the setup wizard.

3. Jira サービスを再起動します。
   
   
4. If you are installing Jira, skip the rest of the instructions on this page and access Jira in your browser to run the setup wizard instead.

3. Jira を構成してデータベースに接続する

ご使用の MySQL データベースに接続するために Jira サーバーを設定する方法は 2 つあります。

セットアップ ウィザード

Use the setup wizard if you have just installed Jira, and are setting it up for the first time. Your settings will be saved to the dbconfig.xml file in your Jira home directory.

設定ツール

Use the configuration tool if you have an existing Jira instance. Your settings will be saved to the dbconfig.xml file in your Jira home directory.

4. Jira の起動

これで、MySQL データベースに接続するための Jira の設定が完了しました。次のステップでは、これを起動させます。

データベース接続フィールド

The table below explains database connection fields that you can find in the setup wizard, Jira configuration tool, or the dbconfig.xml file.

<url>jdbc:mysql:/dbserver:3306/jiradb?useUnicode=true&amp;characterEncoding=UTF8&amp;sessionVariables=default_storage_engine=InnoDB</url>

<url>jdbc:mysql://address=(protocol=tcp)(host=dbserver)(port=3306)/jiradb?useUnicode=true&amp;characterEncoding=UTF8&amp;sessionVariables=default_storage_engine=InnoDB</url>

<url>jdbc:mysql://dbserver:3306/jiradb?useUnicode=true&amp;characterEncoding=UTF8&amp;sessionVariables=default_storage_engine=InnoDB</url>

<url>jdbc:mysql://dbserver:3306/jiradb ?useUnicode=true&amp;characterEncoding=UTF8&amp;sessionVariables=default_storage_engine=InnoDB</url>

<username>jiradbuser</username>

<password>jiradbuser</password>

<jira-database-config>
  <name>defaultDS</name>
  <delegator-name>default</delegator-name>
  <database-type>mysql8</database-type>
  <jdbc-datasource>
    <url>jdbc:mysql://dbserver:3306/jiradb?useUnicode=true&amp;characterEncoding=UTF8&amp;sessionVariables=default_storage_engine=InnoDB</url>
    <driver-class>com.mysql.cj.jdbc.Driver</driver-class>
    <username>jiradbuser</username>
    <password>password</password>
    <pool-min-size>20</pool-min-size>
    <pool-max-size>20</pool-max-size>
    <pool-max-wait>30000</pool-max-wait>
    <pool-max-idle>20</pool-max-idle>
    <pool-remove-abandoned>true</pool-remove-abandoned>
    <pool-remove-abandoned-timeout>300</pool-remove-abandoned-timeout>
  
    <validation-query>select 1</validation-query>
    <min-evictable-idle-time-millis>60000</min-evictable-idle-time-millis>
    <time-between-eviction-runs-millis>300000</time-between-eviction-runs-millis>
   
    <pool-test-while-idle>true</pool-test-while-idle>
    <pool-test-on-borrow>false</pool-test-on-borrow>
    <validation-query-timeout>3</validation-query-timeout>
  </jdbc-datasource>
</jira-database-config>

既知の問題

以下は、このデータベースに関する既知の問題の一覧です。詳細については、それぞれを展開してください。

Your mysql database is currently using an unsupported collation: <collation>. You should change this to a supported collation: utf8mb4_bin

<url>jdbc:mysql://address=(protocol=tcp)(host=0.0.0.0)(port=3306)/jiradb?sessionVariables=default_storage_engine=InnoDB&amp;serverTimezone=UTC</url>