Jira Data Center のアップグレード
このページでは、JIRA Data Center のアップグレード方法について説明します。アップグレードの際、JIRA インスタンスをシャットダウンし、新しいバージョンを各ノードにコピーして 1 つずつアップグレードします。アップグレード中も JIRA を作動させたい場合は、代わりに ゼロ ダウンタイム アップグレードの管理 を使用することをお勧めします。
If you're currently using JIRA Software Server, learn more about upgrading to Data Center here.
はじめる前に
JIRA をアップグレードする前に、いくつかの質問に答える必要があります。
これは正しいアップグレード方法ですか? | |
アップグレードの資格がありますか? | |
アトラシアンのサポート対象プラットフォームに変更はありますか? | |
環境に変更を加える必要はありますか? |
アップグレードを計画する
1. アップグレード前のチェックを完了する
- アップグレードを計画しているバージョン (およびその間のバージョン) のアップグレードに関する注意事項をお読みください。
Go to > System > Support Tools, and check the results of the health check. Fix any detected problems.
Go to > Add-ons, and scroll down to JIRA update check to check the compatibility of your add-ons. Choose the version you plan to upgrade to, then hit Check.
2. テスト環境で JIRA をアップグレードする
- 現在の本番環境のステージング コピーを作成します。
アップグレードをテストする環境の作成に役立つ「ステージング環境の構築」を参照してください。 - 以下の手順に従って、テスト環境をアップグレードします。
- 本番環境でアップグレードを進める前に、非サポート対象のカスタマイズをテストします。
JIRA のアップグレード
3. クラスタの停止
クラスターのすべてのノードで JIRA を停止する必要があります。アップグレードがすべてのノードで完了するまでは、ロードバランサーの設定を JIRA からトラフィックをリダイレクトするようにしておくことをお勧めします。
4. バックアップ
次のコンポーネントのバックアップを作成します。
- JIRA データベース。データベースのネイティブ ツールを使用してバックアップを作成できます。
- JIRA インストール ディレクトリ。クラスター全体のうちいずれか 1 つのみのバックアップを作成すると十分です。
- JIRA 共有ディレクトリ。クラスター内のすべてのノードでアクセスっ可能なホーム ディレクトリのサブディレクトリ。
- 各ノードの JIRA ホーム ディレクトリ。
5. 古いアドオン キャッシュの削除
新しいバージョンに影響しないよう、クラスタ内の各ノードの古いアドオン キャッシュを削除します。各ノードの <home-directory>/plugins/
に移動して、このディレクトリのコンテンツを削除します。
メジャー アップグレードの場合、plugins
ディレクトリ全体を削除できます。プラグインなしでのアップグレードのほうが速度と信頼性が高い傾向にあることが確認されています。
6.1 つ目のノードをアップグレードする
1 つ目のノードをアップグレードするには:
Download JIRA Software or JIRA Service Desk Data Center. Choose the
tar.gaz
or ZIP archive to speed up the process.- ディレクトリ (新しいインストールディレクトリ。既存のインストール ディレクトリとは異なる必要があります) にファイルを抽出する
Go to
<installation-directory>/bin
, and edit thesetenv.bat / setenv.sh
file. InJIRA_HOME
, enter the path to the existing local home directory on that node.ファイルの一番上に
JIRA_HOME
パラメーターがあります。この部分のコメントを解除する必要があります。- MySQL データベースを使用している場合、最新の jdbc ドライバをダウンロードして、
<installation-directory>/lib
に配置します。 - JVM プロパティなどのカスタマイズを、古いバージョンから新しいバージョンに再適用します。
- 新しいインストール ディレクトリをコピーします。これは後で Jira を別のノードに複製するためのテンプレートとして使用します。
- JIRA を起動します。この手順の間に、データベースがアップグレードされます。
- When JIRA starts for the first time after an upgrade, you'll be presented with an overview of the upgrade. This page will show to the first 10 admins who log in to JIRA post upgrade, and only for 14 days. This overview contains information on critical updates to your JIRA instance, and it also gives you a dynamic overview of your add-ons and application links. You can access this information at any time by selecting > Latest upgrade report.
- Go to > Add-ons > Manage add-ons, and upgrade your add-ons to the supported versions.
- JIRA でインデックスを再構築します。詳細は、「検索インデックス」を参照してください。
7. JIRA を残りのノードにコピーする
JIRA を残りのノードにレプリケートするには:
- インストール ディレクトリ (以前作成したテンプレート) を新しいノードにコピーします。
- このノードでホーム ディレクトリへのパスが異なる場合は、
setenv.bat / setenv.sh
ファイルでそれを更新します。 - 新しいノードのインデックスを変更します。
<home-directory>/caches/indexes
に移動して、このディレクトリのコンテンツを削除します。- 新しいノードで JIRA を起動します。
- JIRA を起動した後、最初のノードからインデックスが自動的にコピーされていることを検証します。そうでない場合は、手動でコピーする必要があります。
- JIRA でインデックスを再構築します。詳細は、「検索インデックス」を参照してください。
残りの各ノードに対し、同様のプロセスを繰り返します。
8. (オプション) Jira Service Desk
Jira Service Desk を使用している場合、個別のインストーラをダウンロードせずに UI で直接更新できます。
- Go to > Applications > Versions and licenses.
- Jira Service Desk を更新します。これによって、Service Desk は互換性のあるバージョンに自動的に更新されます。