フォールバック手段を備えた JIRA のアップグレード

JIRA のアップグレード

このページの内容

関連コンテンツ

  • 関連コンテンツがありません

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

このページではバージョン 4.4.x 以降の JIRA を、アップグレード所要時間が予想以上に長引いたり問題が発生したりした場合に安全に元のシステムにロールバックする手段を確保しながらアップグレードす る方法について説明します。この方法は、特にエンタープライズ環境において、さらに言えば JIRA を事業上のミッションクリティカルな用途に使用している企業において極めて有用な方法です。この方法はオプションとしてフォールバックが可能であり、 JIRA を実行するオペレーティングシステムの変更、JIRA のデータを格納するデータベースの変更、JIRA のインデックス/添付ファイルのパスの変更など、大掛かりなシステム変更を行う場合にも有用です。

ここで説明する手順は、極めて安全なアップグレード手法を提供するべく設計されており、従ってデータベース管理業務に関する高度な知識が必要です。当社では、アップグレードに際しては以下の分野のリソースおよび専門知識を活用できるようにしておくことを推奨します:

  • データベース管理者 – 本番環境レベルでのデータベース管理全般 (即ち、データベースのバックアップ、新規作成、削除、リストアなど)
  • JIRA アプリケーション管理者 – アプリケーション管理とアップグレードの管理全般 (即ち、JIRA SME、システム管理者権限を有しアプリケーションやそれに付随する依存関係に関する深い知識を有する組織内ユーザー)
  • システム/ネットワーク管理者 – システムおよびネットワークの管理 (即ち、プロキシサーバー、DNSの変更、モニタリング、仮想マシン、ハードウェアなど)

ここで説明するアップグレードの手順ではデータベースのバックアップの作成が必要ですが、この作業には時間がかかることがあります。お客様が大規模 な JIRA 環境を利用している場合は、4 時間のダウンタイムを予定してください。お客様のシステムがインデックスの再構築に何時間かを要することが分かっている場合は、4 時間を超えるアップグレード所要時間を見込んでください。

See Upgrading JIRA for more information on the methods you can use to upgrade JIRA.

 

この図は、本ドキュメントで説明する手順を示したものです。シンプルにするために、図で は２台のサーバーハードウェアを使用してアップグレードを行う場合を示していますが、テストおよびアップグレード実行用の JIRA を同一サーバーの異なるディレクトリにインストールする場合も同様な作業が可能です。その場合は、元の本番環境とは別の JIRA アプリケーションとデータベースをテストに使用していることを確認すれば問題ありません。

Upgrade_SafeMethod

はじめる前に

  1. Read about the new version - Review the release notes and upgrade notes for the version of JIRA that you are upgrading to. See Production Releases. If you plan to skip a few JIRA versions during your upgrade, we strongly recommend that you read the upgrade guides for all major versions between your current version and the version to which you are upgrading. Refer to Important Version-Specific Upgrade Notes for quick links to these guides.
  2. Check your license - Verify that your license support period is still valid. Upgrading to a version prior to JIRA 6.2.4 on an expired license could lead to the error described in After upgrade JIRA shows 500 error page with message User has no unique key mapping.
  3. Check for known issues - Use the JIRA Knowledge Base to search for any issues in the new version that will affect you.
  4. 互換性の確認:
    • Confirm that your operating system, database, other applicable platforms and hardware still comply with the requirements for JIRA 6.4. The End of Support Announcements for JIRA page also has important information regarding platform support for future versions of JIRA.
    • If you have installed JIRA plugins (i.e. not included with JIRA), verify that they will be compatible with the version of JIRA you are upgrading to. You can find a plugin's compatibility information using Checking app compatibility with application updates or from the plugin's home page on the Atlassian Plugin Exchange.
    • ウィルス対策ツールやインターネットセキュリティーツールの中には JIRA アップグレードの障害となるものがあり、アップグレードが成功しないことがあります。ウィルス対策ツールやインターネットセキュリティーツールに関して、お客様がそのような経験をお持ちであるか、またはそのような事態に陥る恐れがある場合は、JIRA のアップグレード作業に入る前にまずこれらのツールを無効にしてください。

If you have any problems during the upgrade process, create an issue at our support site so that we can help you resolve the problems with your upgrade. We strongly recommend that you perform the below procedure first as a test only. This will allow you to note any complications (e.g. with customized settings or add-ons) ahead of time so that you can minimize the downtime of the system.

1. 本番環境のインスタンスにおけるアップグレード準備作業

アップグレード準備作業に入る際は、本番環境のシステムに対して重要な変更 (プラグインのアップグレード、カスタム設定の追加など) を行う処理をすべて停止するべきです。本番環境システムを可能な限り安定化することにより、新しいバージョンのテストが簡単になります。

It's also a good idea to let your users know about planned downtime, either through email or by using JIRA's announcement banner.

2. Set Up a Proxy Server

アップグレードを開始する前に、ロードバランサーなどのリバースプロキシの設定を行います。プロキシサーバーは、DNS を変更することなくユーザーを別の JIRA サーバーにリダイレクトする機能を有し、これはエンドユーザーからは不可視です。アップグレード作業中に解決不能な問題が発生し、元の JIRA インスタンスにロールバックする必要が生じた場合は、単に元の JIRA インスタンスを再起動してからプロキシサーバーが元のサーバーをポイントするように設定し直すだけで元に戻ります。

本番環境用サーバーに関連して、モニタリング、API 呼び出し (SOAP、REST、CLI 等)、スクリプトなどを使用している場合は、それらをアップデートして新たに設定したプロキシ情報を反映させます。

Apache の設定に関する詳細情報は以下のドキュメントをご覧ください :

3. 新しいバージョンの JIRA 導入手順とテスト

  1. If you want to use a copy of your production data when you test the upgraded JIRA system, make a copy of your production database using your native database backup tools. See Backing Up Data. You can alternatively skip this step and use a new database for testing.

  2. Install the version of JIRA you want to upgrade to onto a system you can use for testing (use either a test server or a separate directory on an existing system). This will become your new production system after you complete the upgrade process. Follow the instructions here to install a new version of JIRA: Installing JIRA.

  3. Migrate any customisations you use in your production system. Follow the instructions in step 3.4 (Migrate your existing JIRA configurations over to your new JIRA installation) in the "Migrating JIRA to Another Server" page.
  4. Connect the new version of JIRA to the copy of the production database (not the existing production database) or a new testing database. See Connecting JIRA to a Database.
  5. Start the new version of JIRA. See this Knowledge Base article about how to test mail settings without accidentally sending notifications to users from the test system: Prepare a Jira development server's mail configuration.
  6. 元のバージョンの JIRA で使用しているプラグインをインストールします。プラグインによっては、JIRA のバージョンが変わると互換性が失われるものがありますので、この手順では新しい JIRA のバージョンに対応してプラグインがアップデートされていることを確認する必要があります。
  7. Re-index JIRA  so the new plugin information is captured in the index.
  8. Check out the features and functionality you use in the new version to understand how they behave and how any changes will impact your team. It can be very helpful to have a group of users look at the new system and carry out their usual tasks to make sure they won't run into any issues when the new version is in production.
    When you are ready to begin the process of migrating your production data to this new version, shut down JIRA (for example, by executing either the /bin/stop-jira.sh or \bin\stop-jira.bat file in your JIRA Installation Directory, or by stopping the JIRA service).

4. 元の本番環境用 JIRA インスタンスの停止と新しいインスタンスの起動

Before disabling your old JIRA production instance, identify the location of your attachments and index directories. If they are located outside of your JIRA Home Directory, you will back them up manually later during the upgrade process. These pages describe how to find out where these directories are located in your environment:

添付ファイルおよびインデックスの保存ディレクトリが JIRA Home ディレクトリ外にある場合は、後でそれらを容易に見つけられるように場所をメモしておきます。

添付ファイルおよびインデックスの保存ディレクトリの場所を確認した後、元の本番環境用インスタンスを停止して、データベースのバックアップを開始します :

  1. Shut down your old production JIRA instance (for example, by executing either the /bin/stop-jira.sh or \bin\stop-jira.bat file in your JIRA Installation Directory, or by stopping the JIRA service).
  2. Using your database's native backup tools, perform a backup of the data in your old production JIRA instance. See Backing Up Data.

  3. 本番環境用データベースの最新のコピーを、新しい本番環境用のデータベースに設定します。

    新しい本番環境における JIRA で使用されるデータベースは、元の本番環境における JIRA の通常のデータベースバックアップファイルとは明確に区別しなければならず、また新しい本番環境のデータベース設定が元の本番環境用データベースに接続す る設定になってはいないことを確認する必要があります。

  4. JIRA の添付ファイルの保存ディレクトリを同期します :
    1. Locate the JIRA Home directory. You can find information about the location of the directory by navigating to the <jira-application-dir>/WEB-INF/classes/jira-application.properties file in your JIRA Installation Directory. Alternatively, you can open the JIRA Configuration Tool to see the directory that is set as your JIRA Home.
    2. 設定ファイルに記録されているディレクトリに移動して、別のディレクトリにそのバックアップを作成します。

    3. If the attachments and index directories are located outside of your JIRA Home Directory, you must back them up separately. (See the beginning of this task for information on how to find these files.)

      Also refer to Backing Up Data for more information about backing up attachments in JIRA.

    4. 新しい JIRA 本番環境の JIRA Home ディレクトリ (添付ファイルおよびインデックスの保存ディレクトリが JIRA Home ディレクトリ外にあった場合はそれらも) を、上で作成した元の JIRA 本番環境のディレクトリのバックアップで置き換えます。

  5. 新しい本番環境における新しいバージョンの JIRA を起動します。起動すると JIRA はデータをアップグレードし、必要ならばインデックスの再構築を行います。再構築完了後、データが存在し、システムに何の問題もないことを確認します。

     

    JIRA インスタンスのサイズによっては、インデックスの再構築に数時間かかることがあります。お客様のインスタンスにおいてインデックス構築時間が長いことが分かっている場合は、ダウンタイムの予定にそれを反映させてください。

  6. Reconfigure the proxy server you set up in step 2 so that the new version of JIRA becomes your production instance. Make sure to let your users know about the new instance (including the new domain name) and any changes that might affect them.

新しい本番環境において何らかの問題が発生した場合は、それが解決されるまで、プロキシサーバーを元に戻して元の本番環境のインスタンスを再度使用します。

9. アップグレードの事後確認項目と事後作業

新しい JIRA を起動したあとに以下の確認をすることを推奨します。
  1. Check your server logs for error messages, even if JIRA appears to be running correctly. If there are any errors there that you cannot resolve, create a support case in https://support.atlassian.com/ja, attach your log file and we will advise you on the errors.
  2. If you were previously using External User Management, enable it in the new JIRA instance.
  3. アップグレード時にサーバーも変更した場合は、 JIRA 管理画面でインデックス、添付ファイル、バックアップのディレクトリのパスを変更します。
  4. テストの間に E メール機能を無効にしていた場合は、これを有効に戻します。
  5. 古い JIRA から新しい JIRA へカスタマイズしたものを移行した場合は、それを入念にテストします。
    1. If you had downloaded plugins for the new version of JIRA, install the downloaded JAR file(s) in your new JIRA version and carry out any other required installation for the plugin.
    2. もしプラグインにプロパティファイルがある場合は、古い JIRA で実施したものと同じ変更を適用します（古いプロパティファイルをコピーしないようにしてください）。

Once you have confirmed the availability of compatible versions, you should upgrade your plugins after successfully upgrading JIRA. This can be done via the 'Plugin Repository' in your Administration Console. It is recommended that you re-index JIRA after upgrading your plugins.

おめでとうございます！JIRA の移行／アップグレードが完了しました。

 

最終更新日 2016 年 7 月 10 日

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

はい
いいえ
この記事についてのフィードバックを送信する

関連コンテンツ

  • 関連コンテンツがありません
Powered by Confluence and Scroll Viewport.