Jira インストーラーを使用した Jira アプリケーションのアップグレード

このガイドでは、インストーラーを使用して JIRA インスタンス Windows または Linux の最新の JIRA バージョンへアップグレードする手順について説明します。

現在のソフトウェアのメンテナンスがある場合、新しいバージョンへのアップグレードは無料です。詳細は、「ライセンスの FAQ」を参照してください。

はじめる前に

JIRA をアップグレードする前に、いくつかの質問に答える必要があります。 

インストーラーは適切なアップグレード方法ですか?

詳細を読む...

アップグレードの方法として、インストーラを使用する方法と、zip または tar.gz ファイルを使用して手動で実施する方法があります。ほとんどの場合、JIRA インスタンスのアップグレードの最も簡単な方法は、インストーラを使用する方法です。

以下の場合は手動でアップグレードする必要があります。

  • このアップグレードの一部として、別のオペレーティング システムまたはデータベース ソフトウェアへ移動することになります。
  • Jira 4.3 以前のバージョンからアップグレードする


アップグレードの資格がありますか?

詳細を読む...

To check if software maintenance is current for your license, go to > Applications > Versions and licenses, and make sure the license support period has not expired.

サポート期間が失効しいる場合、プロンプトに従ってライセンスを更新し、再適用してからアップグレードを行います。

アトラシアンのサポート対象プラットフォームに変更はありますか?
詳細を読む...

サポート対象プラットフォーム ページでアップグレード後の JIRA のバージョンを確認してください。このページでは、サポート対象のオペレーティングシステム、データベースおよびブラウザーに関する情報を提供しています。

参考情報

  • JIRA インストーラーには Java (JRE) および Tomcat が含まれているため、これらを別途アップグレードする必要はありません。
  • データベースをアップグレードする必要がある場合は、アップグレードを計画している Jira バージョン (およびその間) のアップグレード ノートを読み、必要となるデータベース構成の変更を確認してください。
環境に変更を加える必要はありますか?
詳細を読む...

新しい JIRA バージョンには、メモリの増強やリバース プロキシ サーバーの調整など、環境の変更が必要な場合があります。

参考情報

ユーザーに影響する変更についてはアップグレードの注意事項で通知します。例:

  • 環境に影響を与える、サポート対象データベース、メモリ要件またはその他の変更。
  • このリリースで大きく変更または削除された機能。
  • インスタンスまたは環境でアップグレード後すぐに実施する必要があるアクション。

アップグレード後のバージョンとその間のバージョンに関する注意事項をお読みください。たとえば、7.1 から 7.3 へアップグレードする場合は、7.2 と 7.3 のアップグレード ノートを読む必要があります。

既知の問題をチェックする
詳細を読む...

Linux でのアップグレードの後、特定のシステム テキストを表示するアプリケーション (CAPTCHA およびガジェット) で問題が発生する場合があります。テキストが文字化けし、標準的な英数字ではなく、記号のように表示されます。この問題を回避するため、Jira で必要な複数のフォントをインストールする必要があります。詳細は、「Jira UI に読み取り不可能なテキストが表示される」を参照してください。

アップグレードを計画する

1. アップグレード パスを決定する

以下の表を使用して、現在のバージョンから最新バージョンの JIRA への最も効率的なアップグレード パスを決定します。 

JIRA Core (JIRA) を表示...
ご利用のバージョン推奨のアップグレード パス
4.4.5 より前4.4.5 にアップグレードした後、以下のパスに従います (4.3.0 より前のバージョンを 手動でアップグレード する必要はありません)。
4.4.5 から 5.15.2/6.4 のバージョンにアップグレードしてから、以下のパスに従います。
5.2 から 6.47.0.11* にアップグレードしてから、以降のバージョンにアップグレードします。
7.0 以降新しいバージョンの JIRA Core へ移行します。

*7.0 バージョンでは、ユーザー管理、アプリケーションへのアクセス、および Jira インストールの設定に影響する重大な変更が加えられています。アップグレード前に移行ハブをご確認ください。

JIRA Software (JIRA + Agile) を表示...
ご利用のバージョン推奨のアップグレード パス
4.4.5 より前4.4.5 にアップグレードした後、以下のパスに従います (4.3.0 より前のバージョンを 手動でアップグレード する必要はありません)。
4.4.5 から 5.15.2/6.4 のバージョンにアップグレードしてから、以下のパスに従います。
5.2 から 6.47.0.11* にアップグレードしてから、以降のバージョンにアップグレードします。
7.0 以降新しいバージョンの JIRA Software へ移行します。

*7.0 バージョンでは、ユーザー管理、アプリケーションへのアクセス、および Jira インストールの設定に影響する重大な変更が加えられています。アップグレード前に移行ハブをご確認ください。

JIRA Service Desk を表示...
ご利用のバージョン推奨されるアップグレード
2.5.x より前3.0 にアップグレードしてから最新バージョンにアップグレードします。
3.0最新バージョンに直接アップグレードします。

2. アップグレード前のチェックを完了する

  1. アップグレードを計画しているバージョン (およびその間のバージョン) のアップグレードに関する注意事項をお読みください。
  2. Go to  > System > Support Tools, and check the results of the health check. Fix any detected problems.

    ライセンスが期限切れの場合

    お使いのライセンスに含まれるソフトウェア メンテナンスの期限が切れても引き続き JIRA を使用できますが、アップグレード前に更新する必要があります。

    Go to > Applications > Versions and licenses, and follow the prompts to renew your license.

    組み込みのデータベースを引き続き使用している場合

    組み込み (トライアル用) データベース を使用している場合は、アップグレードの前に別のデータベースに移行する必要があります。

    このデータベースは評価用であるため、本番環境での利用は推奨できません。

  3. 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.

    互換性のないアドオンがある場合...

    ユーザーが特定のアドオンに依存している場合、JIRA のアップグレード前に互換性がサポートされるまで待つことをお勧めします。アドオン ベンダーは一般的に、メジャー リリースの後、すぐにアドオンをアップグレードします。アドオン ベンダーは一般的に、メジャー リリースの後、すぐにアドオンをアップグレードします。

    参考情報

    • 互換性情報は、新しいリリース後すぐには利用できない場合があります。多くの場合、アドオンは引き続き機能するため、本番サイトをアップグレードする前にテスト環境で試してください。

3. テスト環境で JIRA をアップグレードする

  1. 現在の本番環境のステージング コピーを作成します。
    アップグレードをテストする環境の作成に役立つ「ステージング環境の構築」を参照してください。
  2. 以下の手順に従って、テスト環境をアップグレードします。
  3. 本番環境でアップグレードを進める前に、非サポート対象のカスタマイズをテストします。


JIRA のアップグレード

4. バックアップ

  1. データベースのバックアップを作成し、バックアップが正しく作成されていることを確認します。
    データベースのネイティブ ツールを使用してバックアップを作成できます。データベースがオンライン バックアップをサポートしていない場合は、最初に Jira を停止する必要があります。
  2. インストール ディレクトリホーム ディレクトリのバックアップを作成します。
    インストール ウィザードは、JIRA ディレクトリのバックアップをインストールの一環で実施しますが、アップグレードの開始前に手動でバックアップを実施する必要があります。

    ホーム ディレクトリの場所が不明な場合

    ホーム ディレクトリの場所は <installation-directory>/atlassian-jira/WEB-INF/classes/jira-application.properties ファイルに記載されています。


    既定のパス:

    Windows: C:\Program Files\Atlassian\Application Data\JIRA

    Linux: /var/atlassian/application-data/jira

5.JIRA のダウンロード

お使いのオペレーティング システム – JIRA CoreJIRA Software、または JIRA Service Desk のインストーラーをダウンロードします。 

知っておくとよいポイント...
  • Jira Software と Jira Service Desk には既に Jira Core インストーラーが含まれています。
  • Jira Core/Software と Jira Service Desk の両方をアップグレードする場合、Jira Core/Software のみをアップグレードします。Service Desk は、個別のインストーラを使用せずに、後ほど JIRA で直接更新します。

6. インストーラーを実行する

  1. インストーラーを実行します。

    Windows で実行する場合...

    .exe ファイルを実行します。Windows 管理者アカウントを使用することをおすすめします。

    アップグレード ウィザードでコンピュータへの変更の許可を求められたら「はい」を選択します。これを指定しない場合、OS に対するインストール ウィザードのアクセスが制限され、以降のインスト―ル オプションも制限されます。

    Linux で実行する場合...

    ダウンロードした JIRA があるディレクトリに移動し、次のコマンドを実行してインストーラを実行可能にします。

    $ chmod a+x atlassian-jira-X.X.X-x64.bin

    Where X.X.X is the JIRA version you downloaded.

    次にインストーラーを実行します。インストーラーの実行には sudo を使用することをお勧めします。

    $ sudo ./atlassian-jira-X.X.X-x64.bin

    root ユーザー権限でインストーラーを実行することもできます。

  2. プロンプトに従って JIRA をアップグレードします。
    1. プロンプトが表示されたら、既存 JIRA インストールをアップグレードする を選択します。
    2. ウィザードが提示した既存の JIRA インストール ディレクトリが正しいことを確認してください(同一マシンで複数に JIRA インストールがある場合は、特に重要です)。
    3. これらのディレクトリをバックアップすることを強くお勧めします。JIRA ホームディレクトリとインストールディレクトリのバックアップの .zip を作成します。
    4. このウィザードは JIRA インストール ディレクトリのカスタマイズを通知します。後で再適用する必要があるため、これらをメモしてください。現在のカスタマイズは上書きされます。

  3. 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.

  4. 以下のような場合は追加ステップを実施する必要があります:

    • ユーザーの管理に Crowd を使用している場合

      ここをクリックして展開...

      ユーザーの管理に Crowd を使用している場合、下記のファイルを既存のインストール ディレクトリから新しいインストール ディレクトリにコピーする必要があります。ファイルをコピーしないでください (ファイルは JIRA の新しいバージョンでは異なる場合があります)。

      • <Installation-Directory>/atlassian-jira/WEB-INF/classes/crowd.properties
      • <Installation-Directory>/atlassian-jira/WEB-INF/classes/seraph-config.xml

アップグレード後

7.データベース ドライバーの更新

Oracle または MySQL データベースを使用している場合、JDBC ドライバをダウンロードして、<JIRA-installation-directory>/lib に配置します。 

  • Oracle: JDBC ドライバ 12.2.0.1
  • MySQL: 最新の JDBC ドライバ

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

その他のカスタマイズはすべて手動で再適用されます。

手順について

その他の設定やカスタマイズ (server.xml ファイル内のその他の変更を含む) はアップグレード時に移行されないため、手動で再適用する必要があります。

  1. アップグレードされた JIRA インスタンスを停止します。
  2. 関連するファイルのカスタマイズを、アップグレードされた JIRA インストール ディレクトリ に再適用します。
  3. アップグレードした JIRAインスタンスを再起動します。

JIRA に変更があり、それによりカスタマイズが使用できない可能性もあるため、本番インスタスでアップグレードを実施する前に、テスト インスタンスでカスタマイズのテストを実施することを強く推奨します

重要なファイルのリストを表示する...

変更が行ったファイルが不明な場合は、Jira インストール ディレクトリの重要なファイルのリストをご覧ください。

9. (オプション) Jira Service Desk

Jira Service Desk を使用している場合、個別のインストーラをダウンロードせずに UI で直接更新できます。

  1. Go to  > Applications > Versions and licenses.
  2. Jira Service Desk を更新します。これによって、Service Desk は互換性のあるバージョンに自動的に更新されます。

10.プラグインのアップグレード

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.

トラブルシューティング

問題が発生した場合

サポート ページのリソースを確認するか、問題解決をお手伝いできるよう、課題を起票してください。

再度アップグレードを実施する必要がある場合は、まず、前の設定に戻す必要があります。アップグレードが失敗した後は、アップグレードの再実行、および、JIRA の旧バージョンの起動をしないでください。


最終更新日: 2019 年 2 月 22 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.