手動による JIRA アプリケーションのアップグレード
このガイドでは、お客様のインストールがインストーラーの使用をサポートしていない場合、JIRA の手動アップグレードを通じて実行します。現在のソフトウェアのメンテナンスがある場合、新しいバージョンへのアップグレードは無料です。詳細は、「ライセンスの FAQ」を参照してください。
以下のいずれかの条件に該当する場合は、この方法を利用して JIRA のアップグレードを行います:
はじめる前に
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. バックアップ
データベースの XML バックアップを作成します 。
インストール ディレクトリとホーム ディレクトリのバックアップを作成します。
As soon as the backup is complete, delete the
<home-directory>/dbconfig.xml
file from your existing home directory. This will allow you to connect JIRA to a new database.
5.JIRA のダウンロード
Download the zip
or tar.gz
archive – JIRA Core or JIRA Software.
6.ファイルの抽出と JIRA のアップグレード
- JIRA アプリケーションを停止します。
- ディレクトリ (新しいインストールディレクトリ。既存のインストール ディレクトリとは異なる必要があります) にファイルを抽出 (解凍) する
- Edit the
<installation-directory>\atlassian-jira\WEB-INF\classes\jira-application.properties
file to point to your existing JIRA home directory. Make sure that you deleted thedbconfig.xml
file, otherwise JIRA will try to connect to your existing database. - Copy your jdbc driver jar file from your existing JIRA installation directory to
/lib
in your new installation directory.
- 以下のような場合は追加ステップを実施する必要があります:
ユーザーの管理にCrowdを使用している場合
バージョン 4.3.0 以前からアップグレードする場合
7.JIRA を起動してデータベースに接続する
- Start JIRA to launch the setup wizard. Go to
<installation-directory>/bin
, and run thestart-jira.sh
/start-jira.bat
file. - ブラウザーから JIRA にアクセスして、自分でセットアップする を選択し、セットアップ オプションにアクセスします。
- 独自のデータベース を選択し、新しい空のデータベースの詳細を入力します。
データのインポート をクリックして、XML バックアップでファイルを選択します。
特に JIRA インスタンスが非常に大きい場合は、プロキシサーバー経由で XML ファイルの復元を実行しないようにしてください。プロキシ サーバーを使うと、タイムアウト エラーが起こる場合があります。- 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.
- すべてのプロジェクトと課題がインポートされていて、すべての機能が正常に動いていることをさっと確認します。ページのフッター部分で新しい JIRA のバージョンを確認します。
アップグレード後
8. 変更の再適用
If you have customized JIRA (such as an SSL configuration in the server.xml
file, or additional memory allocation in the setenv.sh / setenv.bat file ), you'll need to reapply the customizations to the relevant files in the newly upgraded JIRA installation directory.
9. (オプション) Jira Service Desk
Jira Service Desk を使用している場合、個別のインストーラをダウンロードせずに UI で直接更新できます。
- Go to > Applications > Versions and licenses.
- Jira Service Desk を更新します。これによって、Service Desk は互換性のあるバージョンに自動的に更新されます。