Jira インストーラーを使用した Jira アプリケーションのアップグレード
このガイドでは、インストーラーを使用して JIRA インスタンス Windows または Linux の最新の JIRA バージョンへアップグレードする手順について説明します。
現在のソフトウェアのメンテナンスがある場合、新しいバージョンへのアップグレードは無料です。詳細は、「ライセンスの FAQ」を参照してください。
はじめる前に
JIRA をアップグレードする前に、いくつかの質問に答える必要があります。
インストーラーは適切なアップグレード方法ですか? | |
アップグレードの資格がありますか? | |
アトラシアンのサポート対象プラットフォームに変更はありますか? | |
環境に変更を加える必要はありますか? | |
既知の問題をチェックする |
アップグレードを計画する
1. アップグレード パスを決定する
以下の表を使用して、現在のバージョンから最新バージョンの JIRA への最も効率的なアップグレード パスを決定します。
2. アップグレード前のチェックを完了する
- アップグレードを計画しているバージョン (およびその間のバージョン) のアップグレードに関する注意事項をお読みください。
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.
3. テスト環境で JIRA をアップグレードする
- 現在の本番環境のステージング コピーを作成します。
アップグレードをテストする環境の作成に役立つ「ステージング環境の構築」を参照してください。 - 以下の手順に従って、テスト環境をアップグレードします。
- 本番環境でアップグレードを進める前に、非サポート対象のカスタマイズをテストします。
JIRA のアップグレード
4. バックアップ
- データベースのバックアップを作成し、バックアップが正しく作成されていることを確認します。
データベースのネイティブ ツールを使用してバックアップを作成できます。データベースがオンライン バックアップをサポートしていない場合は、最初に Jira を停止する必要があります。 インストール ディレクトリとホーム ディレクトリのバックアップを作成します。
インストール ウィザードは、JIRA ディレクトリのバックアップをインストールの一環で実施しますが、アップグレードの開始前に手動でバックアップを実施する必要があります。
5.JIRA のダウンロード
お使いのオペレーティング システム – JIRA Core、 JIRA Software、または JIRA Service Desk のインストーラーをダウンロードします。
6. インストーラーを実行する
インストーラーを実行します。
- プロンプトに従って JIRA をアップグレードします。
- プロンプトが表示されたら、既存 JIRA インストールをアップグレードする を選択します。
- ウィザードが提示した既存の JIRA インストール ディレクトリが正しいことを確認してください(同一マシンで複数に JIRA インストールがある場合は、特に重要です)。
- これらのディレクトリをバックアップすることを強くお勧めします。JIRA ホームディレクトリとインストールディレクトリのバックアップの .zip を作成します。
- このウィザードは 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.
以下のような場合は追加ステップを実施する必要があります:
ユーザーの管理に Crowd を使用している場合
アップグレード後
7.データベース ドライバーの更新
Oracle または MySQL データベースを使用している場合、JDBC ドライバをダウンロードして、<JIRA-installation-directory>/lib
に配置します。
- Oracle: JDBC ドライバ 12.2.0.1
- MySQL: 最新の JDBC ドライバ
8. 変更の再適用
アップグレードの実行中に、ウィザードは既存の JIRA インストールから下記のファイルを移行します:
server.xml
ファイルの TCP 値。- Location of your JIRA home directory in the
jira-application.properties
file. setenv.sh
/setenv.bat
ファイルの次の値:JVM_SUPPORT_RECOMMENDED_ARGS
JVM_MINIMUM_MEMORY
JVM_MAXIMUM_MEMORY
JIRA_MAX_PERM_SIZE
その他のカスタマイズはすべて手動で再適用されます。
9. (オプション) Jira Service Desk
Jira Service Desk を使用している場合、個別のインストーラをダウンロードせずに UI で直接更新できます。
- Go to > Applications > Versions and licenses.
- Jira Service Desk を更新します。これによって、Service Desk は互換性のあるバージョンに自動的に更新されます。
10.プラグインのアップグレード
Once you have confirmed the availability of compatible versions, you should upgrade your plugins after successfully upgrading JIRA. This can be done via > Add-ons > Manage add-ons.
トラブルシューティング