別のサーバーへの Jira アプリケーションの移行

このドキュメントでは、異なるサーバー ハードウェアまたは次の 1 つ以上を必要とする別のサーバー環境で、Jira アプリケーションを移行してアップグレードする方法を説明します。

• オペレーティング システムの変更

• インデックスや添付ファイルの保存場所が jira-config.properties に変わります

• データベースやデータベース システムの変更

Jira を新しいサーバーまたは場所へ移行するには、新しい Jira インスタンスをインストールする必要があります。インストールが完了したら、データベース間で既存のデータを移行してから、ホーム ディレクトリとすべての既存設定を移動します。 

移行前チェックを実行する

• ライセンスを確認します。お客様のライセンス サポート期間が有効期間内であることを確認します。

• 既知の問題を確認します。Jira ナレッジ ベースによって、影響を与える新しいバージョンの問題点を検索します。

• 次の互換性を確認します。

  • ご利用のオペレーティング システム、データベース、その他の適用可能なプラットフォーム、ハードウェアが、Jira アプリケーションの要件を引き続き満たしていることを確認します。

  • ソースとターゲットの各インスタンスが移行前に同じタイムゾーンに設定されていることをご確認のうえ、日時の各フィールドに関する問題を避けます。

  • Jira アプリケーションに含まれていないアプリをインストールした場合は、それらのアプリに互換性があることを確認します。アプリの互換性情報は、Atlassian Marketplace にあるアプリのホームページで確認できます。また「アプリ更新に伴うアプリの互換性を確認する」で説明されている手順に従って、ユニバーサル アプリ マネージャーによって確認できます。

ウイルス対策やインターネット セキュリティの各ツールの中には、移行を妨げてプロセスが正常に終了できなくするツールがある可能性が生じることをご検討ください。ご利用のウイルス対策またはインターネット セキュリティの各ツールでこのような問題が発生した、または発生が見込まれる場合は、Jira アプリの移行を進める前にまずこのツールを無効にしてください。

データのバックアップ

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

これらのガイドにある手順に従って、データベースのバックアップを作成します。

• ユーザーがデータを Jira で更新できないようにする
• データをバックアップする

Jira ホーム ディレクトリをバックアップする

1. Jira をシャットダウンします。

2. Jira ホーム ディレクトリを見つけます。このディレクトリの場所に関する情報は、Jira アプリケーション インストール ディレクトリで <jira-application-dir>/WEB-INF/classes/jira-application.properties ファイルに移動することによって確認できます。または、Jira 設定ツールを開いて Jira ホームとして設定されているディレクトリを確認できます。

3. 設定ファイルで指定されたディレクトリに移動して、そのバックアップを別のディレクトリに作成します。移行後、この新しいディレクトリは Jira ホーム ディレクトリとして使用されます。

4. バックアップが完了したら、<home-directory>/dbconfig.xml ファイルを既存のホーム ディレクトリから削除します。これによって Jira とデータベース間の既存の接続が削除されて、新しいデータベースに接続できるようになります。

Jira インストール ディレクトリをバックアップする

インストール ディレクトリには、Jira のインストール時に解凍された Jira アプリケーションのファイルとライブラリが含まれています。

Jira ホーム ディレクトリの外部にある場合は、添付ファイルとインデックスの各ディレクトリをバックアップする

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

• 添付ファイル ディレクトリ。ご利用の Jira バージョンのドキュメントにある [添付ファイルの設定] ページをご参照ください。

• インデックス ディレクトリ。ご利用の Jira バージョンの「検索インデックス」をご参照ください。

Jira における添付ファイルのバックアップに関する詳細は「データのバックアップ」をご参照ください。

Jira を新しいサーバーに移行する

Jira のダウンロード

いずれかの Jira アプリケーションをアトラシアンの Web サイトからダウンロードします。zip または tar.gz アーカイブのいずれかを選択します。

• Jira Core
• Jira Software

移行を開始する

1. 既存の Jira インスタンスを停止します。

2. 既存の Jira ホーム ディレクトリのバックアップを、古いサーバーから新しいサーバーにコピーします。

3. ダウンロードしたアーカイブを、移行先の新しいサーバー上に新規作成したディレクトリに展開 (解凍) します。これは新しいインストール ディレクトリであり、既存のインストール ディレクトリとは異なる必要があります。 

4. 新しいサーバー上の新しい Jira インストールの場所がわかったら、次のファイルを編集します。

   <installation-directory>\atlassian-Jira\WEB-INF\classes\Jira-application.properties

   
   

   新しいサーバー上の Jira ホーム ディレクトリを指している必要があります。新しいデータベース サーバーに移動している場合は、必ず接続パラメーターを変更することによって新しいサーバー上の  dbconfig.xml  ファイルを変更してください。そうしないと、Jira は既存のデータベースへの接続を試みます。

   
   

5. (オプション) ユーザー管理に Crowd を使用している場合は、この追加手順を完了します。

   Crowd 設定

   Crowd をユーザー管理に使用している場合は、既存のインストール ディレクトリにある次のファイルの修正を新しいファイルに再適用します。ファイルは Jira の新しいバージョンでは異なる場合があるため、コピーしないでください。

   • <Installation-Directory>/atlassian-Jira/WEB-INF/classes/crowd.properties

   • <Installation-Directory>/atlassian-Jira/WEB-INF/classes/seraph-config.xml

データベース ドライバのインストール

Oracle または MySQL データベースをご利用の場合は、新しい JDBC ドライバーをダウンロードします。それ以外のデータベースの場合は、このステップを省略できます。Jira を新しいデータベースに接続する方法は「Jira アプリケーションをデータベースに接続」をご参照ください。

1. 次のドライバのいずれかをダウンロードします。
   
   • Oracle: JDBC ドライバ 12.2.0.1
   • MySQL: 最新の JDBC ドライバー。
2. <installation-directory>/lib に配置します。

修正を Jira ファイルに再適用する 

Jira を使用する際、Jira ファイルにカスタム変更を行う場合があります。このような変更には、接続の詳細、メモリ割り当てに関する設定や、他の JVM 引数などが含まれます。このステップでは、バックアップからコピーすることで新しいファイルに同じ変更を再適用する必要があります。

通常は次のようなファイルを変更します。

• server.xml
• dbconfig.xml
• jira-config.properties
• setenv.sh / setenv.bat (メモリ割り当ておよびその他の JVM 引数)
• 詳細は「Jira の重要なファイル」をご参照ください。
  

よく修正されるファイルと Jira インストール ディレクトリ内にあるそれらの場所の完全なリストは「Jira の重要なファイル」をご参照ください。

Jira の初回起動

新しい Jira バージョンを起動して、データベースに接続します。

1. <installation-directory>/bin に移動して、次のファイルのいずれかを実行します。
   
   • Windows:  start-Jira.bat
   • Linux: start-Jira.sh

2. Jira をブラウザーで開きます。
3. プロンプトが表示されたら [自分でセットアップ] を選択し、次のセクションで概説するその他のセットアップ オプションにアクセスします。

バックアップしたデータと添付ファイルを復元する

1. 古いデータベースを再利用しない場合は、Jira を新しいデータベースに接続します。[アプリケーション プロパティをセットアップ] ダイアログで、[自身のデータベース] を選択して新しい空のデータベースの詳細を入力します。

2. 次の画面で、[データをインポート] > データ バックアップを含むファイルの順に選択します。特に Jira インスタンスが大きい場合は、データのインポート時にプロキシを経由しないでください。プロキシによってタイムアウト エラーが発生する可能性があります。

3. 画面の指示に従い、セットアップを完了します。 
   

4. ここで、バックアップした添付ファイルを解凍します。手順は次のガイドをご確認ください。

   • データの復元

   • 添付ファイルを添付ファイル ディレクトリに復元する

移行後の確認事項とタスクを実行する

新しい Jira アプリケーションのインスタンスを起動したあと、次の確認と作業を行うことを強くお勧めします。 

1. Jira アプリケーションが正常に動作しているように見えても、サーバー ログにエラー メッセージがないかを確認します。解決できないエラーがある場合は、サポート ケースを作成してログ ファイルを添付してください。エラーの対処方法をご案内します。

2. 外部ユーザー管理を以前使用していた場合は、新しい Jira アプリケーションのインスタンスでそれを有効にします。

3. アップグレード時にマシンを変更した場合は、インデックス、添付ファイル、バックアップ ディレクトリへのパスを、アプリケーションの Jira 管理セクションから変更します。

4. テストの間に E メール機能を無効にしていた場合は、これを有効に戻します。

5. カスタマイズを古い Jira から新しい Jira に移行した場合は、そのカスタマイズを十分にテストしてください。

   1. 新しい Jira アプリ バージョンのプラグインをダウンロードした場合は、新バージョンにダウンロードした JAR ファイルをインストールして、プラグインに必要なその他のインストールを実行します。

   2. もしプラグインにプロパティファイルがある場合は、古い JIRA で実施したものと同じ変更を適用します（古いプロパティファイルをコピーしないようにしてください）。

あともう一歩です!

お客様の Jira インスタンスは移行されました。Service Desk をお持ちの場合のアップグレード方法と、アプリのアップグレード方法は以下で確認できます。

(オプション) Jira Service Management を更新する

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

1. 画面右上で [管理] > [アプリ] の順に選択します。
   
   
2. [バージョンとライセンス] ページで [Jira Service Management を更新] を選択します。これによって、Jira Service Management は互換性のあるバージョンに自動で更新されます。

アプリ (アドオン) のアップグレード

新しいバージョンとの互換性を持つよう、アプリをアップグレードします。

1. 画面右上で [管理] > [アプリ] の順に選択します。
2. [アプリを管理] に移動して、[Atlassian Marketplace] (左側のパネル) で [アプリを管理] を選択します。
3. アプリをサポート対象バージョンにアップグレードします。

インデックスの再構築

古いインデックスは新しいバージョンとの互換性がないため、Jira によって削除されます。インデックスの再作成を実行して一から再構築します。課題とアプリの数に応じて、このステップには時間がかかる可能性があります。

1. 画面右上で [管理] > [システム] の順に選択します。
   
   
2. [詳細] (左側のパネル) で [インデックス作成] を選択します。
3. [全インデックスを再作成] を実行します。