Jira のアップグレード (インストーラー)
このページでは、Jira Server または Data Center (非クラスタ) をインストーラーでアップグレードする方法について説明します。
Looking for a different upgrade method? See Upgrading Jira applications.
次のセクションにジャンプ
はじめる前に
アップグレードの準備
アップグレードの準備の手順が完了したことを確認します。これらは必須の前提条件であり、アップグレードをスムーズに進めるためには不可欠です。
バージョンの選択
最適なバージョンの選択にお悩みの場合、アップグレード マトリクスですべての Jira バージョンの機能、サポート対象のプラットフォーム、およびアップグレードに関する技術的な注意事項を確認できます。
Jira のダウンロード
- アトラシアンの Web サイトからいずれかの Jira アプリケーションをダウンロードします。Windows または Linux 用インストーラーを選択します。
Jira Core / Software と Jira Service Desk の両方をアップグレードする場合、Jira Core / Software のみをアップグレードします。Service Desk については個別のインストーラは使用せず、後ほど Jira で直接アップグレードします。
インストール ウィザードの開始
インストール ウィザードにしたがってアップグレードを実施します。
ダウンロードしたインストーラーを実行します。
- ウィザードの指示に従います。
- プロンプトが表示されたら、[Upgrade an existing Jira installation] を選択します。
- ウィザードが表示した既存の Jira インストール ディレクトリが正しいことを確認します (同一マシンに複数の Jira インストールがある場合は特に重要です)。
- Jira ホーム ディレクトリのバックアップを作成済みの場合は、さらにバックアップが作成されるのを防ぐため、[Jira ホーム ディレクトリのバックアップを作成する] チェックボックスを選択解除します。
このウィザードは Jira インストール ディレクトリのカスタマイズを通知します。これらは後から再適用する必要があるため、記録しておきます。
現在のカスタマイズは上書きされますが、バックアップから後でコピーすることができます。
- プロンプトが表示されたら、[Upgrade an existing Jira installation] を選択します。
アップグレード ウィザードの最後の画面では、Jira インスタンスを起動してアップグレードを完了するよう求められます。このステップで一度止まり、このページの残りのステップを完了してから Jira の初回起動を行うことをおすすめします。
ここで Jira を起動してもアップグレードには影響しませんが、残りのステップを完了させるためには Jira をシャットダウンする必要があります。ステップを完了したら、ウィザードに戻って Jira を起動できます。
(オプション) ユーザー管理に Crowd を使用している場合は、この追加手順を完了します。
データベース ドライバのインストール
Oracle または MySQL データベースを使用している場合、新しい JDBC ドライバをダウンロードします。それ以外のデータベースの場合、この手順を省略できます。
ドライバが最新の場合、以前のバージョンからコピーすることもできます。
- 次のドライバのいずれかをダウンロードします。
- Oracle: JDBC ドライバ 12.2.0.1
- MySQL: MySQL Connector/J 5.1 ドライバ
<installation-directory>/lib
に配置します。
任意の変更を再適用して pool-max-size を増やす
Jira を使用する際、Jira ファイルにカスタム変更を行う場合があります。このような変更には、接続の詳細、メモリ割り当てに関する設定や、他の JVM 引数などが含まれます。このステップでは、バックアップからコピーすることで新しいファイルに同じ変更を再適用する必要があります。
古いファイルに含まれる "ネイティブ" 設定が Jira バージョン間で変更されている可能性があるため、単純に古いファイルをコピーしないようにしてください。
移行される変更
アップグレードの実行中に、ウィザードは既存の Jira インストールから下記のファイルを移行しています。
server.xml
ファイルの TCP 値。jira-application.properties
ファイルに記載された Jira ホーム ディレクトリの場所。setenv.sh
/setenv.bat
ファイルの次の値:JVM_SUPPORT_RECOMMENDED_ARGS
JVM_MINIMUM_MEMORY
JVM_MAXIMUM_MEMORY
JIRA_MAX_PERM_SIZE
その他の変更
上記に加えて、他のすべての変更を再適用する必要があります。最も重要なファイルは次のとおりです。
server.xml
dbconfig.xml
jira-config.properties
web.xml
setenv.sh
/setenv.bat
(メモリ割り当ておよびその他の JVM 引数)
詳細は、「Jira の重要なファイル」を参照してください。
pool-max-size
Jira 7.x を Jira 8.x にアップグレードする場合は、アップグレードの前に dbconfig.xml で pool-max-size パラメーターを 40 に変更することをおすすめします。デフォルトの 20 のままにしておくと、8.x でインデックスの再作成を実行する際に “ResultSet Closed” エラーが発生することがあります。変更の実装の詳細については「データベース接続のチューニング」を参照してください。
自動再インデックスの無効化
この手順は、7.x から 8.x へのアップグレードであるプラットフォーム アップグレードにおすすめです。
Jira 8.0 でのインデックスの変更により、古いインデックスには新しいバージョンとの互換性がありません。新しいインデックスを作成するため、Jira は起動後に自動再インデックスをトリガーします。再インデックスが 2 回行われる (起動後とアプリのアップグレード後) のを避けるため、自動再インデックスを無効化し、準備が整ったら後で 2 つ目の再インデックスを実行することができます。
次のファイルを編集または作成します。
<jira-home-directory>/jira-config.properties
次の行を追加してファイルを保存します。
upgrade.reindex.allowed=false
Jira の初回起動
新しい Jira バージョンを開始します。
- アップグレード ウィザードに戻ってアップグレードを完了し、Jira を起動します。
<installation-directory>/bin
に移動して次のいずれかのファイルを実行することで Jira を起動することもできます。- Windows:
start-jira.bat
- Linux:
start-jira.sh
- Windows:
- ブラウザで Jira を開きます。
- 画面の指示に従い、セットアップを完了します。
アップグレード後のランディング ページ
アップグレードが完了したら、アップグレード後のランディング ページが表示されます。以下のように、新しいバージョンについての便利な情報も記載されています。
- Need to know: 管理者としての作業に影響を与える可能性がある、新機能の一覧。
- User apps: アップグレード後のアプリのステータス。
- Application links: アプリケーション リンクのステータス。
- Release notes: アップグレード先のバージョンに関する詳細な情報を確認できるリリース ノートへのリンク。
あともう一歩です!
お客様の Jira インスタンスはアップグレードされました。Service Desk をお持ちの場合のアップグレード方法と、アプリのアップグレード方法について、以降で説明します。
(オプション) Jira Service Desk の更新
Jira Service Desk を使用している場合、個別のインストーラをダウンロードせずに UI で直接更新できます。
- > [アプリケーション] > [バージョンとライセンス] に移動します。
- Jira Service Desk を更新します。これによって、Service Desk は自動的に互換性のあるバージョンに更新されます。
アプリ (アドオン) のアップグレード
これで、"Compatible if both upgraded" ステータスのアプリをアップグレードできます。これらのステータスおよびアプリ全般に関する詳細情報が必要な場合、「アップグレードの準備」を参照してください。
- > [アプリの管理] > [アプリの管理] に進みます。
- アプリをサポート対象バージョンにアップグレードします。
- アプリがアップグレードされたら、それを有効化できます。
インデックスの再構築
古いインデックスには互換性がないため、Jira で再インデックスを実行して再構築します。課題とアプリの数に応じて、このステップには時間がかかる可能性があります。
- > [インデックス作成] に移動して、Jira のロックと再インデックスの再構築を実行します。
おつかれさまでした
Jira が新しいバージョンにアップグレードされました。