Jira Data Center のアップグレード

このページでは、JIRA Data Center のアップグレード方法について説明します。アップグレードの際、JIRA インスタンスをシャットダウンし、新しいバージョンを各ノードにコピーして 1 つずつアップグレードします。アップグレード中も JIRA を作動させたい場合は、代わりに ゼロ ダウンタイム アップグレードの管理 を使用することをお勧めします。

If you're currently using JIRA Software Server, learn more about upgrading to Data Center here.

はじめる前に

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

これは正しいアップグレード方法ですか?

詳細を読む...

この方法では、各ノードで JIRA をシャットダウンする必要があります。1 つのノードのアップグレードとほぼ同じです。次に、アップグレードしたディレクトリを残りのノードへコピーします。

お使いの環境でいかなるダウンタイムも許容できない場合は、別の方法「ゼロ ダウンタイム更新の管理」を使用する必要があります。

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

詳細を読む...

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 バージョン (およびその間) のアップグレード ノートを読み、必要となるデータベース構成の変更を確認してください。
環境に変更を加える必要はありますか?
詳細を読む...

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

参考情報

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

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

アップグレード後のバージョンとその間のバージョンに関する注意事項をお読みください。

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

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

  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 のアップグレード前に互換性がサポートされるまで待つことをお勧めします。アドオン ベンダーは一般的に、メジャー リリースの後、すぐにアドオンをアップグレードします。アドオン ベンダーは一般的に、メジャー リリースの後、すぐにアドオンをアップグレードします。

    参考情報

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

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

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

JIRA のアップグレード

3. クラスタの停止

クラスターのすべてのノードで JIRA を停止する必要があります。アップグレードがすべてのノードで完了するまでは、ロードバランサーの設定を JIRA からトラフィックをリダイレクトするようにしておくことをお勧めします。

4. バックアップ

次のコンポーネントのバックアップを作成します。

  • JIRA データベース。データベースのネイティブ ツールを使用してバックアップを作成できます。
  • JIRA インストール ディレクトリ。クラスター全体のうちいずれか 1 つのみのバックアップを作成すると十分です。
  • JIRA 共有ディレクトリ。クラスター内のすべてのノードでアクセスっ可能なホーム ディレクトリのサブディレクトリ。
  • 各ノードの JIRA ホーム ディレクトリ

5. 古いアドオン キャッシュの削除

新しいバージョンに影響しないよう、クラスタ内の各ノードの古いアドオン キャッシュを削除します。各ノードの <home-directory>/plugins/ に移動して、このディレクトリのコンテンツを削除します。

tip/resting Created with Sketch.

メジャー アップグレードの場合、plugins ディレクトリ全体を削除できます。プラグインなしでのアップグレードのほうが速度と信頼性が高い傾向にあることが確認されています。

6.1 つ目のノードをアップグレードする

1 つ目のノードをアップグレードするには:

  1. Download JIRA Software or JIRA Service Desk Data Center. Choose the tar.gaz or ZIP archive to speed up the process.

    知っておくとよいポイント...

    Jira Software と Jira Service Desk の両方を使用している場合、Jira Software のみをアップグレードします。Service Desk は、個別のインストーラを使用せずに、後ほど JIRA で直接更新します。

  2. ディレクトリ (新しいインストールディレクトリ。既存のインストール ディレクトリとは異なる必要があります) にファイルを抽出する
  3. Go to <installation-directory>/bin, and edit the setenv.bat / setenv.sh file. In JIRA_HOME, enter the path to the existing local home directory on that node.

    tip/resting Created with Sketch.

    ファイルの一番上に JIRA_HOME パラメーターがあります。この部分のコメントを解除する必要があります。

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

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

  5. JVM プロパティなどのカスタマイズを、古いバージョンから新しいバージョンに再適用します。
  6. 新しいインストール ディレクトリをコピーします。これは後で Jira を別のノードに複製するためのテンプレートとして使用します。
  7. JIRA を起動します。この手順の間に、データベースがアップグレードされます。
  8. 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.
  9. Go to  > Add-ons > Manage add-ons, and upgrade your add-ons to the supported versions.
  10. JIRA でインデックスを再構築します。詳細は、「検索インデックス」を参照してください。

7. JIRA を残りのノードにコピーする

JIRA を残りのノードにレプリケートするには:

  1. インストール ディレクトリ (以前作成したテンプレート) を新しいノードにコピーします。
  2. このノードでホーム ディレクトリへのパスが異なる場合は、setenv.bat / setenv.sh ファイルでそれを更新します。
  3. 新しいノードのインデックスを変更します。
    1. <home-directory>/caches/indexes に移動して、このディレクトリのコンテンツを削除します。
    2. 新しいノードで JIRA を起動します。
    3. JIRA を起動した後、最初のノードからインデックスが自動的にコピーされていることを検証します。そうでない場合は、手動でコピーする必要があります。

残りの各ノードに対し、同様のプロセスを繰り返します。

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

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

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

トラブルシューティング

問題が発生した場合

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

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

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

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

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