Jira Data Center のアップグレード
このページでは、Jira Data Center のアップグレード方法について説明します。アップグレード中は、Jira インスタンスをシャットダウンし、新しいバージョンを各ノードにコピーして、1 つずつアップグレードします。アップグレード中も Jira を実行したい場合、「ゼロ ダウンタイム アップグレードの管理」を使用することをお勧めします。
現在 Jira Software Server を使用している場合、Data Center へのアップグレードについてこちらをご確認ください。
はじめる前に
Jira をアップグレードする前に、いくつかの質問に答える必要があります。
これは正しいアップグレード方法ですか? | |
アップグレードの資格がありますか? | |
アトラシアンのサポート対象プラットフォームに変更はありますか? | |
環境に変更を加える必要はありますか? |
アップグレードを計画する
1. アップグレード前のチェックを完了する
- アップグレードを計画しているバージョン (およびその間のバージョン) のアップグレードに関する注意事項をお読みください。
> [システム] > [サポート ツール] へ移動してから、ヘルス チェックの結果を確認します。検出された問題を修正します。
> [アドオン] に移動して下にスクロールし、[Jira の更新チェック] でお使いのアドオンの互換性を確認します。アップグレード予定のバージョンを選択し、[チェック] をクリックします。
2. テスト環境で Jira をアップグレードする
- 現在の本番環境のステージング コピーを作成します。
アップグレードをテストする環境の作成に役立つ「ステージング環境の構築」を参照してください。 - 以下の手順に従って、テスト環境をアップグレードします。
- 本番環境でアップグレードを進める前に、非サポート対象のカスタマイズをテストします。
Jira のアップグレード
3. クラスタの停止
クラスタのすべてのノードで Jira を停止する必要があります。アップグレードがすべてのノードで完了するまでは、ロード バランサで Jira へのトラフィックをリダイレクトするようにしておくことをお勧めします。
4. バックアップ
次のコンポーネントのバックアップを作成します。
- Jira データベース。データベースのネイティブ ツールを使用してバックアップを作成できます。
- Jira インストール ディレクトリ。クラスタのいずれか 1 つからバックアップを作成します。
- Jira 共有ディレクトリ。クラスタ内のすべてのノードからアクセス可能なホーム ディレクトリのサブディレクトリ。
- 各ノードの Jira ホーム ディレクトリ。
5. 古いアドオン キャッシュの削除
新しいバージョンに影響しないよう、クラスタ内の各ノードの古いアドオン キャッシュを削除します。各ノードの <home-directory>/plugins/
に移動して、このディレクトリのコンテンツを削除します。
メジャー アップグレードの場合、plugins
ディレクトリ全体を削除できます。プラグインなしでのアップグレードのほうが速度と信頼性が高い傾向にあることが確認されています。
6.1 つ目のノードをアップグレードする
1 つ目のノードをアップグレードするには:
Jira Software または Jira Service Desk Data Center をダウンロードします。迅速なプロセスのため、
tar.gaz
または ZIP アーカイブを選択します。- ディレクトリ (新しいインストールディレクトリ。既存のインストール ディレクトリとは異なる必要があります) にファイルを抽出する
<installation-directory>/bin
に移動し、setenv.bat / setenv.sh
ファイルを編集します。JIRA_HOME に、そのノードの既存のローカル ホーム ディレクトリへのパスを入力します。ファイルの一番上に
JIRA_HOME
パラメーターがあります。この部分のコメントを解除する必要があります。Oracle または MySQL データベースを使用している場合、JDBC ドライバをダウンロードして、
<JIRA-installation-directory>/lib
に配置します。- Oracle: JDBC driver 12.2.0.1
- MySQL: MySQL Connector/J 5.1 driver
<installation-directory>/lib
.- JVM プロパティなどのカスタマイズを、古いバージョンから新しいバージョンに再適用します。
- 新しいインストール ディレクトリをコピーします。これは後で Jira を別のノードに複製するためのテンプレートとして使用します。
- Jira を起動します。この手順の間に、データベースがアップグレードされます。
- アップグレード後に Jira を起動すると、アップグレードの概要が表示されます。このページは、アップグレード後に Jira にログインした最初の 10 人の管理者に 14 日間のみ表示されます。この概要には、Jira インスタンスの重要な更新に関する情報が含まれます。また、アドオンやアプリケーション リンクの動的な概要も提供します。> [最新のアップグレード レポート] を選択して、いつでもこの情報にアクセスできます。
- > [アドオン] > [アドオンの管理] へ移動して、アドオンをサポートされるバージョンにアップグレードします。
- Jira でインデックスを再構築します。詳細は、「検索インデックス」を参照してください。
7. Jira を残りのノードにコピーする
Jira をほかのノードに複製するには、次の手順を実行します。
- インストール ディレクトリ (以前作成したテンプレート) を新しいノードにコピーします。
- このノードでホーム ディレクトリへのパスが異なる場合は、
setenv.bat / setenv.sh
ファイルでそれを更新します。 - 新しいノードのインデックスを変更します。
<home-directory>/caches/indexes
に移動して、このディレクトリのコンテンツを削除します。- 新しいノードで Jira を起動します。
- Jira を起動した後、最初のノードからインデックスが自動的にコピーされていることを検証します。自動コピーが行われていない場合、手動でコピーする必要があります。
残りの各ノードに対し、同様のプロセスを繰り返します。
8. (オプション) Jira Service Desk の更新
Jira Service Desk を使用している場合、個別のインストーラをダウンロードせずに UI で直接更新できます。
- > [アプリケーション] > [バージョンとライセンス] に移動します。
- Jira Service Desk を更新します。これによって、Service Desk は自動的に互換性のあるバージョンに更新されます。
トラブルシューティング
問題が発生した場合
サポート ページのリソースを確認するか、問題解決をお手伝いできるよう、課題を起票してください。
アップグレードを再度実施する必要がある場合、最初に必ず元のセットアップへのロールバックを行います。アップグレードに失敗した場合に、アップグレードの再実行、および、Jira の旧バージョンの起動は行わないでください。