手動による JIRA アプリケーションのアップグレード

• 新しいバージョンについて読む - アップグレードしようとしている JIRA バージョンのリリースノートやアップグレードに関する注意事項を確認します。JIRA サーバーのリリースノートを参照してください。アップグレード中にいくつかの JIRA バージョンをスキップする予定がある場合は、現在のバージョンから目的のアップグレードバージョンの間のすべてのメジャーバージョンに関するアップグレードガイドを読むことを強くお勧めします。
• ライセンスの確認 – お客様の ライセンスサポート期間 が有効期間内であることを確認します。
• 既知の問題の確認 - 影響を与える新しいバージョンの問題点を検索するには、JIRA ナレッジベースを利用します。
• 互換性の確認:
  
  • Confirm that your operating system, database, other applicable platforms and hardware still comply with the requirements for JIRA 7.2. The End of Support Announcements page also has important information regarding platform support for future versions of JIRA.
  • Jira のプラグイン (Jira にデフォルトで含まれない機能) をインストールした場合は、アップグレード先の Jira のバージョンとの互換性を確認する必要があります。プラグインの互換性の情報については、Atlassian Marketplace のプラグインのホームページをご参照ください。
  • ウィルス対策ツールやインターネットセキュリティーツールの中には JIRA アップグレードの障害となるものがあり、アップグレードが成功しないことがあります。ウィルス対策ツールやインターネットセキュリティーツールに関して、お客様がそのような経験をお持ちであるか、またはそのような事態に陥る恐れがある場合は、JIRA のアップグレード作業に入る前にまずこれらのツールを無効にしてください。
• JIRA の新しいバージョンの事前ステージングとテスト - 最初に、テスト環境でアップグレードを実行することを強くお勧めします。 テスト環境におけるアップグレードが成功しない限り、本番環境の JIRA サーバをアップグレードしないでください。
  • テスト環境におけるアップグレードで解決できない問題がある場合、弊社サポートサイトで課題を作成してサポートを受けてください。
  • 本番環境の JIRA サーバのアップグレード中に問題が発生した場合は、サーバをユーザに利用させてはいけません。代わりに、以下を行って下さい:
    
    • 古い JIRA サーバを引き続き使用して下さい。これによって、本番環境のデータが失われずに済みます。
    • また、サポートサイトで課題を作成していただくことで、弊社はアップグレードに伴う様々な問題をお客様が解決できるよう支援できます。
    事前ステージングとテストに関する説明

    1. アップグレード後の JIRA システムのテストを行う際に本番環境用データのコピーを利用する場合は、お客様のシステムにネイティブに備えられているデータベースバックアップツールを使用してコピーを作成しておきます。「データのバックアップ」を参照してください。また、データベースのコピー作成を省略して新しいデータベースをテストに使用することもできます。

    2. アップグレードする JIRA のバージョンを、テスト用システム (テスト用サーバーか、または既存システムの別のディレクトリ) にインストールします。これは、アップグレードプロセスが完了すると新たな本番環境システムとなります。JIRA の新しいバージョンのインストールは、「 JIRA アプリケーションのインストール」の説明に従ってください。

    3. カスタム設定を行っている場合は、それを本番システムに移行します。「別のサーバーへの JIRA の移行」ページの手順 3.4 (既存の JIRA の設定を新しい JIRA インストールに移行) の説明に従ってください。
    4. JIRA の新しいバーションを本番環境用データベースのコピー (既存の本番環境用データベースではありません) または新しいテスト用データベースに接続します。詳細は、「JIRA のデータベース接続 」を参照してください。
    5. 新しいバーションの JIRA を起動します。テストシステムから意図しない電子メールをユーザーに送信することなく電子メール関連の設定のテストを行う方法については次のナレッジベースドキュメント をご覧ください : How to Prepare a Development Server's Mail Configuration。
    6. 元のバージョンの JIRA で使用しているプラグインをインストールします。プラグインによっては、JIRA のバージョンが変わると互換性が失われるものがありますので、この手順では新しい JIRA のバージョンに対応してプラグインがアップデートされていることを確認する必要があります。
    7. JIRA のインデックス再構築 を行って新しいプラグインの情報をインデックスに反映します。
    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 application installation directory, or by stopping the JIRA service).

2.1 ユーザーに JIRA のデータ更新を中断させる

アップグレード プロセスで、JIRA のデータベースを既存の JIRA インストールから (XML バックアップ経由で) エクスポートし、このバックアップを新しい JIRA インストールに復元します。XML バックアップ内のデータと、システムの最新データとの整合性を確保するため、JIRA へのアクセスを一時的に制限してユーザーがデータを更新できないようにする必要があります。詳細は、「バックアップ中の JIRA アプリケーションへのユーザー アクセスを防止する」ページを参照してください。

 注意してください！整合性のない XML バックアップを使って復元することはできません！

2.2 データベースのバックアップ

既存の JIRA インストールの外部データベースに対する XML バックアップを実行します。大規模な JIRA インストール環境では、このプロセスの完了まで数時間を要する場合もあります。

2.3 JIRA ホームディレクトリのバックアップ

1. Jira をシャットダウンします。
2. 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 application installation directory. Alternatively, you can open the JIRA configuration tool to see the directory that is set as your JIRA Home.
3. 設定ファイルに記録されているディレクトリに移動して、別のディレクトリにそのバックアップを作成します。
4. バックアップの完了直後に元のフォルダーから <jira-home>/dbconfig.xml ファイルを削除します。

2.4 添付ファイルおよびインデックスのディレクトリのバックアップ (JIRA ホームディレクトリ外にある場合)

添付ファイルおよびインデックスのディレクトリがJIRA ホームディレクトリ外にある場合は、この２つのディレクトリのバックアップをそれぞれ作成する必要があります。ご使用の実装でこれらのディレクトリの場所を見つける方法については、次のページで説明しています。

• 添付ファイル ディレクトリ — ご使用の JIRA バージョンのドキュメントで、 「ファイル添付の設定」ページを参照してください。
• インデックスディレクトリ — ご使用の JIRA バージョンのドキュメントで、「インデックス作成の検索」ページを参照してください。

JIRA の添付ファイルのバックアップに関する詳細は、「データのバックアップ」もご覧ください。

2.5 JIRA インストール ディレクトリのバックアップ

「JIRA インストールディレクトリ」 は、JIRA がインストールされた時に、JIRA アプリケーション ファイルとライブラリが展開されたディレクトリです。

ディストリビューションのセットアップ方法

1. JIRA 設定ツールを開きます。
2. JIRA ホーム タブをクリックします。
3. JIRA ホーム ディレクトリ フィールドを更新します：
   
   • If your JIRA 7.2 installation is on a new server, update the JIRA Home Directory field to the path of your copied JIRA Home directory.
   • If your JIRA 7.2 installation is on the same server, update the JIRA Home Directory field to the path of your existing JIRA Home directory.
     For more information about this directory, see JIRA home directory.

Jira ホーム ディレクトリの場所を設定するには、OS 環境変数 JIRA_HOME を定義します。この変数の値は、Jira インストール ディレクトリにある jira-application.properties ファイルの jira.home プロパティの値より優先されます。詳細については、「Jira ホーム ディレクトリの設定」を参照してください。

ステージ 2 にある、ご利用のデータベースに対応した「Jira の ... (データベース名) への接続」の説明に従ます。ただし、ステップ 4 以降については次の黄色の注意事項をご確認ください。

組み込み H2 データベースを使用中の場合は、新しいデータベースを作成する必要はありません。

既存の Jira インストール内で変更した各ファイルについて、新しい Jira インストール内の対応する各ファイルを手動で編集して変更を再適用する必要があります。新しい Jira インストール内にファイルが存在しない場合 (最近の Jira バージョンの osuser.xml など)、該当ファイルを単純に新しい Jira インストールにコピーします。

以下の表は、最もよく変更されるファイルと、JIRA インストールディレクトリ内の各ファイルの場所を示しています。

バージョン固有のアップグレードに関する注意事項には、一般的に変更されるファイルで変更された可能性のあるプロパティに関する詳細も含まれます。

上記のファイル以外にも、アップグレードのプロセスにて以下の設定を考慮・実行する必要があります。

• JIRA をアトラシアンの Crowd と併用する場合 — Crowd と JIRA を併用する場合、「JIRA と Crowd の統合」に記載されているとおり、新しい JIRA が Crowd と通信するように設定します。
  • JIRA の新しいホスト名/IP アクセスを許可するように Crowd を設定します。
• 追加メモリを JIRA に割り当てる — 過去に追加メモリを JIRA に割り当てたことがある場合は、新しい JIRA インスタンスに対しても同様に実行します。 詳細は、「JIRA のメモリ容量を増やす」を参照してください。
• プラグイン — 古い Jira にインストールしたプラグインについては、http://plugins.atlassian.com から新しいバージョンの Jira 用のプラグインをダウンロードします。
• 文字エンコード — 文字エンコード (ロケール) が新しい場所と古い場所で同じであることを確認します。 エンコードの互換性がない２つのシステム間で添付ファイルを移動した場合、新しいバージョンの JIRA が正常に動作しない場合があります。
• カスタマイズ — カスタマイズを行った場合（コード、テンプレート、設定ファイルなど）は、これらの変更の互換バージョンを新しい JIRA へコピーします。(ユーザーの古いバージョンをカスタマイズした組織内の開発者は、新しいバージョンに対しても同等の変更のビルドとテストを行って、アップグレード後の JIRA インストールへコピーするファイルをユーザーに提供する必要があります。)
• (オプション) 別のポートで JIRA を実行する— 新しい JIRA が古い JIRA と同一マシン上にインストールされている場合、(古い JIRA の再起動が必要になった場合に備えて) 別々のポートで実行していることを確認することができます。詳細は、「JIRA の TCP ポートの変更」を参照してください。

1. 古い JIRA がシャットダウンされていることを確認する ： JIRA サーバーが動作中の場合はシャットダウンします。
2. 「JIRA の起動」の説明に従って、JIRA の新しいバージョンを起動します。

古い JIRA のデータを、新しい JIRA にインポートします。

1. バックアップしてあった添付ファイル ディレクトリを、新しい Jira の添付ファイル ディレクトリに復元します。(「データの復元」を参照。)
2. Jira を起動します。
3. セットアップ ウィザードで [Import existing data (既存のデータをインポート)] を選択します。
4. [ファイル名] フィールドではエクスポート時 (上記) に取得した XML バックアップファイルを指定します。ZIP ファイルには、activeobjects.xml と entities.xml の 2 つの XML ファイルが含まれています。インポートを成功させるにはこの両方のファイルが入った ZIP ファイルが必要になります。
    特に Jira インスタンスが非常に大きい場合は、プロキシ サーバー経由で XML ファイルの復元を実行しないようにしてください。プロキシ サーバーを使うと、タイムアウト エラーが発生する場合があります。
5. JIRA に Web ブラウザでアクセスして、古い JIRA のときと同じユーザー名でログインします。
6. すべてのプロジェクトと課題がインポートされていて、すべての機能が正常に動いていることをさっと確認します。ページのフッター部分で新しい JIRA のバージョンを確認します。