Jira アプリケーションを MySQL 8.0 に接続する
ここでは、サポート対象の MySQL データベースに Jira を接続する方法を解説します。
はじめる前に
前提条件として次の情報を確認しておくことをおすすめします。
- 既知の問題を確認します。
- Jira を他のサーバーに移行する場合は、データのエクスポートを XML バックアップとして作成します。その後、データベースの切替で説明されているように、元のデータベースから新しいデータベースにデータを移行できます。
- Confluence と Jira を同じ MySQL サーバーでセットアップする場合は、「Confluence MySQL セットアップ ガイド」をお読みください。Confluence の要件は Jira の要件よりも厳格であるため、MySQL は Confluence に適するように構成します。この構成は Jira にも適用できます。
- セットアップ ウィザードを実行中の場合を除き、開始する前に Jira をシャットダウンします。
- このガイドでは
utf8mb4_bin
照合の使用を推奨していますが、MySQL 8.0 のデフォルトの照合であるutf8mb4_0900_ai_ci
もサポートされます。Amazon RDS で MySQL を使用している場合、具体的に変更した場合を除き、デフォルトの照合が表示されます。
1. MySQL データベースの作成および設定
あとから Jira をデータベースに接続する際に必要になるため、データベースを作成するときに、データベース名、ユーザー名、およびポート番号を記録しておきます。
Jira が接続時に使用するデータベース ユーザーを作成します (例: jiradbuser)。
CREATE USER '<USERNAME>'@'<JIRA_SERVER_HOSTNAME>' IDENTIFIED BY '<PASSWORD>';
課題を格納するための Jira 用データベースを作成します (例: jiradb)。
このデータベースでは UTF8 の文字セットが設定されている必要があります。設定するには、MySQL コマンド クライアントから以下のコマンドを入力します。CREATE DATABASE jiradb CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
データベースへの接続権限とテーブルの作成および更新権限がユーザーに割り当てられていることを確認します。これらの権限は次のコマンドで付与できます。
GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,REFERENCES,ALTER,INDEX on <JIRADB>.* TO '<USERNAME>'@'<JIRA_SERVER_HOSTNAME>'; flush privileges;
- MySQL Server の
my.cnf
またはmy.ini
(Windows) ファイルを編集します (ファイルの編集の詳細な手順については MySQL オプション ファイル を参照してください)。 - ファイルで
[mysqld]
セクションを見つけ、次のパラメータを追加あるいは修正します。デフォルトのストレージエンジンを InnoDB に設定します:
[mysqld] ... default-storage-engine=INNODB ...
データベース サーバーが使用する文字セットを指定します。
[mysqld] ... character_set_server=utf8mb4 ...
初期設定の行形式を
DYNAMIC
に設定します。[mysqld] ... innodb_default_row_format=DYNAMIC ...
innodb_redo_log_capacity
の値が 4G 以上になるように指定します。[mysqld] ... innodb_redo_log_capacity=4G ...
innodb_redo_log_capacity
パラメーターはinnodb_log_file_size
とinnodb_log_files_in_group
の各パラメーターを置き換えています。詳細は MySQL ドキュメントをご確認ください。sql_mode パラメーターが NO_AUTO_VALUE_ON_ZERO に指定されていないことを確認します。
// remove this if it exists sql_mode = NO_AUTO_VALUE_ON_ZERO
MySQL サーバーを再起動して変更内容を反映します。
2. MySQL JDBC ドライバのコピー
MySQL の JDBC ドライバを Jira インストール ディレクトリにコピーします。
- 推奨される MySQL ドライバ、JDBC Connector/J 8.0 をダウンロードします。
ドライバを次のディレクトリにコピーします。
<Jira-installation-directory>/lib
Windows インストーラーを利用して Jira をインストールしている場合、このステップを、Windows インストーラーの実行後、セットアップ ウィザードの実行前に行う必要があります。
- Jira サービスを再起動します。
- Jira をインストールする場合、このページの残りの説明をスキップし、ブラウザで Jira にアクセスしてセットアップ ウィザードを実行します。
3. Jira を構成してデータベースに接続する
ご使用の MySQL データベースに接続するために Jira サーバーを設定する方法は 2 つあります。
セットアップ ウィザード
Jira をインストールした直後で、初めて Jira をセットアップする場合はセットアップ ウィザードを使用します。設定は、Jira ホーム ディレクトリの dbconfig.xml
ファイルに保存されます。
設定ツール
既存の Jira インスタンスがある場合は、設定ツールを使用します。設定は、Jira ホーム ディレクトリの dbconfig.xml
ファイルに保存されます。
4. Jira の起動
これで、MySQL データベースに接続するための Jira の設定が完了しました。次のステップでは、これを起動させます。
データベース接続フィールド
次の表では、セットアップ ウィザード、Jira 設定ツール、または dbconfig.xml
ファイルにある "データベース接続" フィールドについて説明しています。MySQL コネクタ 8.0 以降をご利用の場合は、次に記載されている必須パラメーターを追加してください。
既知の問題
以下は、このデータベースに関する既知の問題の一覧です。詳細については、それぞれを展開してください。