Jira のアップグレード (インストーラー)
このページでは、Jira Server または Data Center (非クラスタ) をインストーラーでアップグレードする方法について説明します。
別のアップグレード方法をお探しの場合は、「Jira アプリケーションのアップグレード」を参照してください。
次のセクションにジャンプ
はじめる前に
アップグレードの準備
アップグレードの準備の手順が完了したことを確認します。これらは必須の前提条件であり、アップグレードをスムーズに進めるためには不可欠です。
バージョンの選択
最適なバージョンの選択にお悩みの場合、アップグレード マトリクスですべての 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 ドライバ 19.3 (ojdbc8)
- MySQL: MySQL Connector/J 5.1 ドライバ
<installation-directory>/libに配置します。
ステップ 4: 任意のカスタム変更を再適用して pool-max-size を増やす
Jira を使用する際、Jira ファイルにカスタム変更を行う場合があります。このような変更には、接続の詳細、メモリ割り当てに関する設定や、他の JVM 引数などが含まれます。
移行される変更
アップグレードの実行中に、ウィザードは既存の 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 ファイルにコピーすることで、それらを再適用します。
古いファイルに含まれる "ネイティブ" 設定が Jira バージョン間で変更されている可能性があるため、単純に古いファイルをコピーしないようにしてください。
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-sizeJira 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 を開きます。
カスタム変更を加えたファイルで、まだコピーされていないものがある場合、ここで変更を自動的にコピーできます。
ファイルの変更の確認は次の設定ファイルに対してのみ実行される点にご注意ください。
- atlassian-jira/ directory
- conf/server.xml
- bin/setenv.sh自動転送は ATST プラグイン 1.20.0 以降でのみサポートされます。
変更を自動的に転送するには、変更されたファイルのインストーラーのコピーがアップグレード後のバージョンと同じである必要があります。変更のコピー後、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 Server または Data Center (非クラスタ) をインストーラーでアップグレードする方法について説明します。
別のアップグレード方法をお探しの場合は、「Jira アプリケーションのアップグレード」を参照してください。
次のセクションにジャンプ
はじめる前に
アップグレードの準備
アップグレードの準備の手順が完了したことを確認します。これらは必須の前提条件であり、アップグレードをスムーズに進めるためには不可欠です。
バージョンの選択
最適なバージョンの選択にお悩みの場合、アップグレード マトリクスですべての 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 ドライバ 19.3 (ojdbc8)
- MySQL: MySQL Connector/J 5.1 ドライバ
<installation-directory>/libに配置します。
Jira の起動時に再度確認が行われ、ユーザーがスキップした可能性があるすべてのファイルのうち、まだコピーされていない変更が含まれるものが表示されます。これをクリックして変更を自動的にコピーできます。
確認は、次の設定ファイルに対してのみ実行される点にご注意ください。
- <jira-home-directory>/atlassian-jira/ directory
- <jira-home-directory>/conf/server.xml
- <jira-home-directory>/bin/setenv.sh
自動転送は ATST プラグイン 1.20.0 以降でのみサポートされます。
To automatically transfer the changes, the installer copy of the modified file needs to be the same as in the version you're upgrading to.
自動再インデックスの無効化
この手順は、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 を開きます。
カスタム変更を加えたファイルで、まだコピーされていないものがある場合、ここで変更を自動的にコピーできます。
ファイルの変更の確認は次の設定ファイルに対してのみ実行される点にご注意ください。
- atlassian-jira/ directory
- conf/server.xml
- bin/setenv.sh自動転送は ATST プラグイン 1.20.0 以降でのみサポートされます。
変更を自動的に転送するには、変更されたファイルのインストーラーのコピーがアップグレード後のバージョンと同じである必要があります。変更のコピー後、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 が新しいバージョンにアップグレードされました。