Jira Data Center のアップグレード (インストーラー)
Jira 10 以降では、手動でのアップグレード方法のみがサポートされています。
このページでは、インストーラーを使用した Jira Data Center (クラスタ) のアップグレードについて説明します。
別のアップグレード方法をお探しの場合は、「Jira アプリケーションのアップグレード」を参照してください。
次のセクションにジャンプ
最初に Jira を .zip アーカイブから手動でインストールした場合は、このアップグレード方法を使用しないでください。バイナリ インストーラーによる手動インストールのアップグレードはサポート対象外で、起動時に問題が発生することが知られています。
はじめる前に
ステップ 1: Jira ホーム ディレクトリを検索して初期インストール方法を決定する
初めてインストールしたときと同じ方法で Jira をアップグレードすることをお勧めします。方法かわからない場合は、Jira ホーム ディレクトリの場所を検索してください。通常は、これによって Jira を手動でインストールしたか、バイナリ インストーラーからインストールしたかがわかります。詳細については「Jira アプリケーション ホームディレクトリ」をご参照ください。
ステップ 2: アップグレードの準備
アップグレードの準備の手順が完了したことを確認します。これらは必須の前提条件であり、アップグレードをスムーズに進めるためには不可欠です。
ステップ 3: バージョンの選択
最適なバージョンの選択にお悩みの場合、アップグレード マトリクスですべての Jira バージョンの機能、サポート対象のプラットフォーム、およびアップグレードに関する技術的な注意事項を確認できます。
ステップ 4: クラスタの停止
ゼロ ダウンタイムで Jira Data Center をアップグレードする場合、この手順を省略します。
クラスタのすべてのノードで Jira を停止します。アップグレードがすべてのノードで完了するまでは、ロード バランサで Jira からトラフィックをリダイレクトするように設定しておくことをおすすめします。
最初のノードで Jira をアップグレードする
各ノードを個別にアップグレードするのを避けるため、1 つのみをアップグレードしてから、そのインストール ディレクトリをテンプレートにします。次に、このテンプレートを残りのノードにコピーします。ここでは任意のノードを選択できます。
ステップ 1. Jira をダウンロード
- アトラシアンの Web サイトからいずれかの Jira アプリケーションをダウンロードします。Windows または Linux バイナリを選択します。
Jira Software と Jira Service Management の両方をアップグレードする場合、Jira Software のみをアップグレードします。Jira Service Management は、個別のインストーラーは使用せず、後ほど Jira で直接アップグレードします。
ステップ 2. インストール ウィザードの開始
インストール ウィザードにしたがってアップグレードを実施します。
ダウンロードしたインストーラーを実行します。
- ウィザードの指示に従います。
- プロンプトが表示されたら、[Upgrade an existing Jira installation] を選択します。
- ウィザードが表示した既存の Jira インストール ディレクトリが正しいことを確認します (同一マシンに複数の Jira インストールがある場合は特に重要です)。
- Jira ホーム ディレクトリのバックアップを作成済みの場合は、さらにバックアップが作成されるのを防ぐため、[Jira ホーム ディレクトリのバックアップを作成する] チェックボックスを選択解除します。
このウィザードは Jira インストール ディレクトリのカスタマイズを通知します。これらは後から再適用する必要があるため、記録しておきます。
現在のカスタマイズは上書きされますが、バックアップから後でコピーすることができます。
- プロンプトが表示されたら、[Upgrade an existing Jira installation] を選択します。
アップグレード ウィザードの最後の画面では、Jira インスタンスを起動してアップグレードを完了するよう求められます。このステップで一度止まり、このページの残りのステップを完了してから Jira の初回起動を行うことをおすすめします。
ここで Jira を起動してもアップグレードには影響しませんが、残りのステップを完了させるためには Jira をシャットダウンする必要があります。ステップを完了したら、ウィザードに戻って Jira を起動できます。
ステップ 3. データベース ドライバのインストール
Oracle または MySQL データベースを使用している場合、新しい JDBC ドライバをダウンロードします。それ以外のデータベースの場合、この手順を省略できます。
ドライバが最新の場合、以前のバージョンからコピーすることもできます。
- 次のドライバのいずれかをダウンロードします。
- Oracle: JDBC ドライバ 19.3 (ojdbc8)
- MySQL: MySQL Connector/J 5.1 ドライバ。
<installation-directory>/libに配置します。
ステップ 4. 変更を再適用して pool-max-size を増やす
Jira を使用する際、Jira ファイルにカスタム変更を行う場合があります。このような変更には、接続の詳細、メモリ割り当てに関する設定や、他の JVM 引数などが含まれます。このステップでは、バックアップからコピーすることで新しいファイルに同じ変更を再適用する必要があります。
古いファイルに含まれる "ネイティブ" 設定が Jira バージョン間で変更されている可能性があるため、単純に古いファイルをコピーしないようにしてください。
移行される変更
アップグレードの実行中に、ウィザードは既存の Jira インストールから下記のファイルを移行しています。
server.xmlファイルの TCP 値。jira-application.propertiesファイルに記載された Jira ホーム ディレクトリの場所。setenv.sh/setenv.batファイルの次の値:JVM_SUPPORT_RECOMMENDED_ARGSJVM_MINIMUM_MEMORYJVM_MAXIMUM_MEMORYJIRA_MAX_PERM_SIZE
その他の変更
上記に加えて、他のすべての変更を再適用する必要があります。最も重要なファイルは次のとおりです。
server.xmldbconfig.xmljira-config.propertiesweb.xmlsetenv.sh/setenv.bat(メモリ割り当ておよびその他の JVM 引数)
詳細については、「Jira の重要なファイル」をご参照ください。
Jira を SSL 経由で実行している場合は、これらのファイルに加えて証明書をトラスト ストアに再インポートする必要があります。手順については、「JVM にパブリック SSL 証明書をインポートする方法」をご参照ください。
Jira の起動時に再度確認が行われ、ユーザーがスキップした可能性があるすべてのファイルのうち、まだコピーされていない変更が含まれるものが表示されます。これをクリックして変更を自動的にコピーできます。
確認は、次の設定ファイルに対してのみ実行される点にご注意ください。
- <jira-home-directory>/atlassian-jira/ directory
- <jira-home-directory>/conf/server.xml
- <jira-home-directory>/bin/setenv.sh
自動転送は ATST プラグイン 1.20.0 以降でのみサポートされます。
変更を自動的に転送するには、変更されたファイルのインストーラーのコピーがアップグレード後のバージョンと同じである必要があります。
pool-max-size
Jira 7.x を Jira 8.x にアップグレードする場合は、アップグレードの前に dbconfig.xml で pool-max-size パラメーターを 40 に変更することをおすすめします。デフォルトの 20 のままにしておくと、8.x でインデックスの再作成を実行する際に “ResultSet Closed” エラーが発生することがあります。変更の実装の詳細については「データベース接続のチューニング」を参照してください。
ステップ 5. 自動再インデックスの無効化
このステップは、プラットフォーム バージョン間でアップグレードする際に推奨されます。たとえば、Jira 7.x から 9.x に、または Jira 7.x から 8.x に切り替える際などです。
Jira の機能リリース間ですでにアップグレードしている場合 (たとえば 8.13 から 8.20 に)、このステップを省略できます。
Jira プラットフォームのバージョン 8.x と 9.x 間に導入されたインデックスの変更によって、古い Jira バージョンのインデックスはアップグレード後に互換性がなくなります。
新しいインデックスを作成するために、Jira は起動後に自動再インデックスをトリガーします。自動再インデックスを無効にして準備が整い次第 2 つ目の再インデックスを実行することで、二重に再インデックス (起動後とアプリのアップグレード後) されるのを回避できます。
自動再インデックスを無効にするには、次の手順に従います。
次のファイルを編集または作成 (存在しない場合) します。
<jira-home-directory>/jira-config.properties次の行をこのファイルに追加して変更を保存します。
upgrade.reindex.allowed=false
最初のノードでのアップグレード後の手順
最初のノード (先ほどアップグレードしたもの) でのみ、次のアップグレード後の手順を完了します。残りのノードでは後ほど、共有ディレクトリからアップグレード後のアプリとインデックスをダウンロードします。
ステップ 1. Jira の初回起動
新しい Jira バージョンを起動してデータベースに接続します。
- (インストーラー) アップグレード ウィザードに戻って、Jira を起動します。
(インストーラーおよび手動)<installation-directory>/binに進み、以下のファイルのいずれかを実行して Jira を起動することもできます。- Windows:
start-jira.bat - Linux:
start-jira.sh
- Windows:
- ブラウザで Jira を開きます。
- 画面の指示に従い、セットアップを完了します。
カスタム変更を加えたファイルで、まだコピーされていないものがある場合、ここで変更を自動的にコピーできます。
ファイルの変更の確認は次の設定ファイルに対してのみ実行される点にご注意ください。
- atlassian-jira/ directory
- conf/server.xml
- bin/setenv.sh自動転送は ATST プラグイン 1.20.0 以降でのみサポートされます。
変更を自動的に転送するには、変更されたファイルのインストーラーのコピーがアップグレード後のバージョンと同じである必要があります。変更のコピー後、Jira を再起動するように求められます。
アップグレード後のランディング ページ
アップグレードが完了したら、アップグレード後のランディング ページが表示されます。以下のように、新しいバージョンについての便利な情報も記載されています。
- Need to know: 管理者としての作業に影響を与える可能性がある、新機能の一覧。
- User apps: アップグレード後のアプリのステータス。
- Application links: アプリケーション リンクのステータス。
- Release notes: アップグレード先のバージョンに関する詳細な情報を確認できるリリース ノートへのリンク。
ステップ 2. (オプション) Jira Service Management を更新
Jira Service Management を使用している場合、個別のインストーラをダウンロードせずに UI で直接更新できます。
- [管理] (
) > [アプリケーション] > [バージョンとライセンス] に移動します。 - Jira Service Management を更新します。これによって、Jira Service Management は自動的に互換性のあるバージョンに更新されます。
ステップ 3. アプリ (アドオン) のアップグレード
これで、"Compatible if both upgraded" ステータスのアプリをアップグレードできます。これらのステータスおよびアプリ全般に関する詳細情報が必要な場合、「アップグレードの準備」を参照してください。
- [管理] () > [アプリの管理] > [アプリの管理] に進みます。
- アプリをサポート対象バージョンにアップグレードします。
- アプリがアップグレードされたら、それを有効化できます。
DC クラスタでのアプリのアップグレード
アプリをアップグレードする際に、各ノードは再起動時に共有ホームから最後に変更されたアプリ jar ファイルをプルします。
ファイル バージョンを確認するために、Jira は atlassian-plugin.xml. 内の <version> 値を使用します。複数の <version> 値がある場合、Jira は java.lang.String#compareTo を使用してこの異なる値を比較します。
ステップ 4. インデックスの再構築
インデックスを再作成するために Jira を再インデックスします。課題とアプリの数に応じて、このステップには時間がかかる可能性があります。
- [管理] () > [インデックス] に移動して、Jira をロックしてインデックスを再構築を実行します。
ステップ 5. アップグレード済みの Jira をテンプレートとしてコピー
このステップでは、これまでに実行したすべての変更を含む新しいインストール ディレクトリをコピーします。これによりテンプレートが作成され、後で他のノードにコピーすることができます。
- 新しいインストール ディレクトリを別の場所にコピーします。これがテンプレートになります。
残りのノードをアップグレードする
Jira テンプレートの準備が整い、共有ディレクトリでアップグレード済みのアドオンとインデックス データが利用できるようになりました。このステップでは、テンプレートを別のノードにコピーし、1 つずつ起動します。
- テンプレートのインストール ディレクトリを新しいノードにコピーします。
- このノードでローカル ホーム ディレクトリへのパスが異なる場合、
setenv.bat/setenv.shファイルでそれを更新します。 - このノードで Jira を起動します。
- 繰り返し: 次のノードでこれらのステップを繰り返します。
クラスタへの参加
[管理] () > [システム] > [システム情報] に移動し、[クラスタ ノード] セクションにスクロールして、アップグレード後のノードがクラスタに参加しているかどうかを確認できます。
おつかれさまでした
Jira が新しいバージョンにアップグレードされました。