Jira インストーラーを使用した Jira アプリケーションのアップグレード
このガイドでは、インストーラーを使用して Jira インスタンスを Windows または Linux の最新の Jira バージョンにアップグレードする手順について説明します。
現在のソフトウェアのメンテナンスがある場合、新しいバージョンへのアップグレードは無料です。詳細は、「ライセンスの FAQ」を参照してください。
はじめる前に
Jira をアップグレードする前に、いくつかの質問に答える必要があります。
インストーラーは適切なアップグレード方法ですか? | |
アップグレードの資格がありますか? |
詳細を読む...
ライセンスでソフトウェア メンテナンスが有効かどうかを確認するには、 サポート期間が失効しいる場合、プロンプトに従ってライセンスを更新し、再適用してからアップグレードを行います。 |
| アトラシアンのサポート対象プラットフォームに変更はありますか? | |
| 環境に変更を加える必要はありますか? | |
| 既知の問題をチェックする |
アップグレードを計画する
1. アップグレード パスを決定する
以下の表を使用して、現在のバージョンから最新バージョンの Jira への最も効率的なアップグレード パスを決定します。
2. アップグレード前のチェックを完了する
- アップグレードを計画しているバージョン (およびその間のバージョン) のアップグレードに関する注意事項をお読みください。
> [システム] > [サポート ツール] へ移動してから、ヘルス チェックの結果を確認します。検出された問題を修正します。ライセンスが期限切れの場合ご利用のライセンスに含まれるソフトウェア メンテナンスの期限が切れている場合、引き続き Jira を使用できますが、アップグレードするには更新が必要です。
> [アプリケーション] > [バージョンとライセンス] へ移動して、プロンプトに従い、ライセンスを更新します。- > [アドオン] に移動して下にスクロールし、[Jira の更新チェック] でお使いのアドオンの互換性を確認します。アップグレード予定のバージョンを選択し、[チェック] をクリックします。
3. テスト環境で Jira をアップグレードする
- 現在の本番環境のステージング コピーを作成します。
アップグレードをテストする環境の作成に役立つ「ステージング環境の構築」を参照してください。 - 以下の手順に従って、テスト環境をアップグレードします。
- 本番環境でアップグレードを進める前に、非サポート対象のカスタマイズをテストします。
Jira のアップグレード
4. バックアップ
- データベースのバックアップを作成し、バックアップが正しく作成されていることを確認します。
データベースのネイティブ ツールを使用してバックアップを作成できます。データベースがオンライン バックアップをサポートしていない場合は、最初に Jira を停止する必要があります。 インストール ディレクトリとホーム ディレクトリのバックアップを作成します。
インストール ウィザードはインストールの一環として Jira ディレクトリのバックアップを実施しますが、アップグレードの開始前に手動でバックアップを実施することをおすすめします。
5. Jira のダウンロード
お使いのオペレーティング システムのインストーラーをダウンロードします – Jira Core、Jira Software、または Jira Service Desk。
6. インストーラーを実行する
インストーラーを実行します。
- プロンプトに従って Jira をアップグレードします。
- プロンプトが表示されたら、[既存の Jira インストールをアップグレードする] を選択します。
- ウィザードが提示した既存の Jira インストール ディレクトリが正しいことを確認します (同一マシンに複数の Jira インストールがある場合は特に重要です)。
- [これらのディレクトリのバックアップ] を強くお勧めします。これにより、Jira ホーム ディレクトリとインストール ディレクトリのバックアップの .zip が作成されます。
- このウィザードは Jira インストール ディレクトリのカスタマイズを通知します。後で再適用する必要があるため、これらを記録しておくことをおすすめします。現在のカスタマイズは上書きされます。
- アップグレード後に Jira を起動すると、アップグレードの概要が表示されます。このページは、アップグレード後に Jira にログインした最初の 10 人の管理者に 14 日間のみ表示されます。この概要には、Jira インスタンスの重要な更新に関する情報が含まれます。また、アドオンやアプリケーション リンクの動的な概要も提供します。> [最新のアップグレード レポート] を選択して、いつでもこの情報にアクセスできます。
以下のような場合は追加ステップを実施する必要があります:
ユーザーの管理に Crowd を使用している場合
アップグレード後
7.データベース ドライバーの更新
Oracle または MySQL データベースを使用している場合、JDBC ドライバをダウンロードして、<Jira-installation-directory>/lib に配置します。
- Oracle: JDBC driver 12.2.0.1
- MySQL: MySQL Connector/J 5.1 driver
8. 変更の再適用
アップグレードの実行中に、ウィザードは既存の Jira インストールから下記のファイルを移行します。
server.xmlファイルの TCP 値。jira-application.propertiesファイルに記載された Jira ホーム ディレクトリの場所。setenv.sh/setenv.batファイルの次の値:JVM_SUPPORT_RECOMMENDED_ARGSJVM_MINIMUM_MEMORYJVM_MAXIMUM_MEMORYJIRA_MAX_PERM_SIZE
その他のカスタマイズはすべて手動で再適用されます。
9. (オプション) Jira Service Desk の更新
Jira Service Desk を使用している場合、個別のインストーラをダウンロードせずに UI で直接更新できます。
- > [アプリケーション] > [バージョンとライセンス] に移動します。
- Jira Service Desk を更新します。これによって、Service Desk は自動的に互換性のあるバージョンに更新されます。
10.プラグインのアップグレード
バージョン間の互換性を確認したら、Jira のアップグレードの完了後、プラグインのアップグレードを実行します。この操作は、 > [アドオン] > [アドオンの管理] で実行できます。
トラブルシューティング
問題が発生した場合
サポート ページのリソースを確認するか、問題解決をお手伝いできるよう、課題を起票してください。
アップグレードを再度実施する必要がある場合、最初に必ず元のセットアップへのロールバックを行います。アップグレードに失敗した場合に、アップグレードの再実行、および、Jira の旧バージョンの起動は行わないでください。