Jira Data Center のアップグレード
This page describes how to upgrade JIRA Data Center. During the upgrade, you'll shut down your JIRA instances, and then copy the new version to each node, upgrading them one by one. If you'd rather have your JIRA working during the upgrade, we recommend that you use Managing zero downtime upgrades instead.
If you're currently using JIRA Software Server, learn more about upgrading to Data Center here.
はじめる前に
JIRA をアップグレードする前に、いくつかの質問に答える必要があります。
これは正しいアップグレード方法ですか? | |
アップグレードの資格がありますか? |
詳細を読む...
To check if software maintenance is current for your license, go to サポート期間が失効しいる場合、プロンプトに従ってライセンスを更新し、再適用してからアップグレードを行います。 |
| アトラシアンのサポート対象プラットフォームに変更はありますか? | |
| 環境に変更を加える必要はありますか? |
アップグレードを計画する
1. アップグレード前のチェックを完了する
- アップグレードを計画しているバージョン (およびその間のバージョン) のアップグレードに関する注意事項をお読みください。
Go to
> System > Support Tools, and check the results of the health check. Fix any detected problems.ライセンスが期限切れの場合お使いのライセンスに含まれるソフトウェア メンテナンスの期限が切れても引き続き JIRA を使用できますが、アップグレード前に更新する必要があります。
Go to
> Applications > Versions and licenses, and follow the prompts to renew your license.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 をアップグレードする
- Create a staging copy of your current production environment.
See Establishing staging server environments for help creating an environment to test your upgrade in. - 以下の手順に従って、テスト環境をアップグレードします。
- 本番環境でアップグレードを進める前に、非サポート対象のカスタマイズをテストします。
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.gazor ZIP archive to speed up the process.- ディレクトリ (新しいインストールディレクトリ。既存のインストール ディレクトリとは異なる必要があります) にファイルを抽出する
Go to
<installation-directory>/bin, and edit thesetenv.bat / setenv.shfile. InJIRA_HOME, enter the path to the existing local home directory on that node.ファイルの一番上に
JIRA_HOMEパラメーターがあります。この部分のコメントを解除する必要があります。- MySQL データベースを使用している場合、最新の jdbc ドライバをダウンロードして、
<installation-directory>/libに配置します。 - JVM プロパティなどのカスタマイズを、古いバージョンから新しいバージョンに再適用します。
- 新しいインストール ディレクトリをコピーします。これは後で Jira を別のノードに複製するためのテンプレートとして使用します。
- JIRA を起動します。この手順の間に、データベースがアップグレードされます。
- 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 を起動した後、最初のノードからインデックスが自動的にコピーされていることを検証します。そうでない場合は、手動でコピーする必要があります。
- Go to > Add-ons > Manage add-ons, and upgrade your add-ons to the supported versions.
- JIRA でインデックスを再構築します。詳細は、「検索インデックス」を参照してください。
残りの各ノードに対し、同様のプロセスを繰り返します。
8. (オプション) Jira Service Desk
Jira Service Desk を使用している場合、個別のインストーラをダウンロードせずに UI で直接更新できます。
- Go to
> Applications > Versions and licenses. - Jira Service Desk を更新します。これによって、Service Desk は互換性のあるバージョンに自動的に更新されます。
トラブルシューティング
問題が発生した場合
サポート ページのリソースを確認するか、問題解決をお手伝いできるよう、課題を起票してください。
If you need to retry the upgrade, you must roll back to your previous setup first. Do not attempt to run an upgrade again, or start the older version of JIRA again after an upgrade has failed.