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. バックアップ
- Back up your database and confirm the backup was created properly.
You can use the database native tools to create the backup. If your database does not support online backups, you'll need to stop JIRA first. インストール ディレクトリとホーム ディレクトリのバックアップを作成します。
インストール ウィザードは、JIRA ディレクトリのバックアップをインストールの一環で実施しますが、アップグレードの開始前に手動でバックアップを実施する必要があります。
5.JIRA のダウンロード
お使いのオペレーティング システム – JIRA Core、 JIRA Software、または JIRA Service Desk のインストーラーをダウンロードします。
6. インストーラーを実行する
インストーラーを実行します。
- プロンプトに従って JIRA をアップグレードします。
- When prompted, choose Upgrade an existing JIRA installation.
- Make sure the Existing JIRA installation directory suggested by the wizard is correct (especially important if you have multiple JIRA installations on the same machine.)
- Back up these directories is strongly recommended. This will create a .zip backup of the JIRA home and installation directories.
- このウィザードは JIRA インストール ディレクトリのカスタマイズを通知します。後で再適用する必要があるため、これらをメモしてください。現在のカスタマイズは上書きされます。
- When prompted, choose Upgrade an existing JIRA installation.
以下のような場合は追加ステップを実施する必要があります:
ユーザーの管理に Crowd を使用している場合
アップグレード後
7.データベース ドライバーの更新
If you're using an Oracle or MySQL database, download the latest jdbc driver and place it in <JIRA-installation-directory>/lib
.
Microsoft SQL および Postgres ユーザーはこの手順をスキップすることができます。
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.プラグインのアップグレード
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.
トラブルシューティング
問題が発生した場合
サポート ページのリソースを確認するか、問題解決をお手伝いできるよう、課題を起票してください。
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.