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

始める前に

1. カスタマイズの確認

高速アップグレード手法では、インストーラーが自動的に多くのアップグレード作業を実行してくれます。しかし、JIRA アプリケーション インストールがカスタマイズされている場合、カスタマイズしたファイルをアップグレードしたインストールに手動で移行する必要があります。インストー ラーが自動で確認し、移行するものは次のとおりです。

• アプリケーションサーバー内のデータソースとして定義されているレガシーデータベース設定 (JIRA 4.3.x 以前で使用) をプラットフォーム バージョン 4.4 以降で使用されている新しいデータベース設定に移行。詳細は、JIRA 4.4 アップグレードノートを参照してください。
• TCP port values in your existing JIRA application installation's server.xml file. Other configurations or customizations in this file are not migrated.
• Custom values in your existing JIRA application installation's jira-application.properties and setenv.sh / setenv.bat files.
  In the setenv.sh / setenv.bat file, only the following values are migrated:
  
  • JVM_SUPPORT_RECOMMENDED_ARGS
  • JVM_MINIMUM_MEMORY
  • JVM_MAXIMUM_MEMORY
  • JIRA_MAX_PERM_SIZE
• If JIRA is running as a service on Windows, the Java startup options configured for the service (as described in Setting properties and options on startup - Windows service) will be reset to the defaults. If you've changed memory allocation settings or added any non-default parameters, make sure to save that information before proceeding with the upgrade. If not manually saved, these settings will be lost.

During the upgrade process, the installer detects and notifies you of any files (other than jira-application.properties and setenv.sh / setenv.bat) in the atlassian-jira subdirectory of your existing JIRA application installation directory, which had been deleted, added or modified from a 'default' JIRA application installation. If you have made customizations to your seraph-config.xml file or any other file customizations in your JIRA application installation directory which are not handled by the upgrade wizard, you must migrate these to the upgraded JIRA application installation manually.

このアップグレード フィーチャーは、既存のJIRA アプリケーションのホームディレクトリも再使用するため、前の JIRA アプリケーション インストールのこのディレクトリに保存されている重要なデータはすべて JIRA アプリケーションのアップグレード後も保持されます。

注意:

• アップグレードプロセスでは、ご使用のデータベースのバックアップユーティリティを使用して、データベースのバックアップを実行するよう要求されます。ご使用のデータベースがオンラインバックアップに対応していない場合、アップグレードプロセスを停止して JIRA アプリケーションをシャットダウンし、データベースバックアップを実行してから、アップグレードプロセスを再開して続行できます。
• インストーラーは、既存の JIRA アプリケーションインストールのインストールディレクトリおよびホームディレクトリを自動でバックアップします。JIRA アプリケーション ホームディレクトリ以外の場所に添付ファイルやインデックス ファイルがある場合、それらのファイルは手動でバックアップする必要があります。ご使用の環境でこれらのディレクトリの場所を見つけるには、次のページを参照してくだ さい。
  • 添付ファイル ディレクトリ — ご使用の JIRA アプリケーションバージョンの 「ファイル添付の設定」ページを参照してください。
  • インデックスディレクトリ — ご使用の JIRA アプリケーションバージョンの「 インデックス作成の検索」ページを参照してください。

2. 外部データベースのバックアップ

アップグレード ウィザード起動後、アップグレードを開始する前に、外部データベースをバックアップするように指示が出ます。データベースのネイティブ バックアップ ツールを使用してデータベースをバックアップできますが、次の点に注意してください:

• ご使用のデータベースのネイティブ バックアップ ツールがオンライン バックアップ (通常、データベース使用中に JIRA アプリケーション データベースの「スナップショット」を作成するバックアップ) に対応している場合、アップグレード ウィザードを起動したまま、データベースのバックアップを実行できます。その後、データベースのバックアップが正しく作成されたことを確認してから、アップグ レード ウィザードを続行できます。
• ご使用のデータベースのネイティブ バックアップ ツールで JIRA アプリケーション データベースのオンライン バックアップを実行できない場合は、以下を実行してください。
  
  1. データベースをバックアップするように指示が出たら、アップグレード ウィザードを終了します。
  2. 一時的に JIRA アプリケーションへのアクセスを制限し、ユーザーが既存の JIRA アプリケーション データを更新できないようにします (データベース バックアップの構造上の一貫性を確保するため)。詳細は、「バックアップ中の JIRA アプリケーションへのユーザー アクセスを防止する」ページを参照してください。
  3. ご使用のデータベースのネイティブ バックアップ ツールを使用して、JIRA アプリケーション データベースの「オフライン バックアップ」を実行し、バックアップが正しく作成されたことを確認します。
  4. Linux / Windows インストーラーを再起動し、中断地点からアップグレード ウィザードを再開します。
• JIRA アプリケーションの「内蔵」データベースは H2 です。これは、JIRA アプリケーションの評価目的限定で使用されるものです。この H2 データベースを誤って本番システムで使用している場合、バックアップの指示が出された時にアップグレード ウィザードを終了し、「別のサーバーへの JIRA アプリケーションの移行 」手順に従って JIRA アプリケーションをアップグレードします。

Inconsistent database backups may not restore correctly! If you are unfamiliar with your database's native backup/restore facilities, then before proceeding, test your database backup's integrity by:

• データベースのバックアップを別の (テスト) システムで復元する
• 現在の JIRA アプリケーション バージョンのテスト インスタンスをこの復元したデータベースに接続する

3. アップグレードの実行

お使いの OS のアップグレード説明を参照してください:

• Windows
• Linux

Upgrading JIRA applications on Windows

1. JIRA アプリケーション ダウンロードページから、「JIRA Windows インストーラー」 (.exe) ファイル (新しい JIRA アプリケーション バージョン用) をダウンロードします。
2. ご使用の JIRA アプリケーションをシャットダウンします。
3. Run the '.exe' file to start the upgrade wizard.
   If a Windows 7 (or Vista) 'User Account Control' dialog box asks you to allow the upgrade wizard to make changes to your computer, specify Yes. If you do not, the installation wizard will have restricted access to your operating system and any subsequent installation options will be limited.
4. “Upgrading JIRA?” のステップで、 Upgrade an existing JIRA installation (既存 JIRA インストールをアップグレードする) のオプションを選びます。
5. In the Existing JIRA installation directory field, specify the JIRA application installation directory of your JIRA installation to be upgraded.
   The upgrade wizard will attempt to find an existing JIRA installation and use its location to pre-populate this field. However, always verify this location, particularly if you have multiple JIRA installations running on the same machine.
6. この後のアップグレード ウィザードのステップでのオプション指定や実行は次の通りです:
   
   1. At the 'Back up JIRA directories' step, ensure the Back up these directories option is selected. This creates 'zip' archive file backups of your existing JIRA installation and JIRA home directories in their respective parent directory locations.
      Please Note:
      
      • このオプションの選択を強く推奨します!

      • At this point, the upgrade wizard notes any customizations in your existing JIRA installation directory which it cannot automatically migrate to your upgraded JIRA installation. If you are informed of any files containing such customizations, please make a note of these files as you will need to manually migrate their customizations (which are not mentioned in the overview above) to your upgraded JIRA installation.

        SSL configuration

        - The upgrade wizard cannot automatically migrate the SSL configuration defined in the conf/server.xml file of the JIRA installation directory.

         

        - If you're using the bundled JRE for JIRA (located in the JRE folder of the JIRA installation directory), then the upgrade wizard cannot import the SSL certs into the new JRE after the upgrade as well. You will need to import the SSL certs into the new JRE. For more information on importing SSL certs, see Running JIRA applications over SSL or HTTPS.

         

        - If you're using the system JRE, you won't have to import the SSL certs into the new JRE after the upgrade, since the JRE would already have the SSL certs after the upgrade. You just need to ensure that JIRA is using the system JRE. To do this, you will need to perform the changes in catalina.bat, as discussed in How to Use System JRE Instead of Embedded JRE.

         

         

   2. 「アップグレードチェックリスト」ステップで、外部データベースをバックアップし、非バンドル プラグインがアップグレードされた JIRA バージョンと互換性があることを確認します。データベースのバックアップは既に実行済みかもしれません (ステップ 2: 外部データベースのバックアップ)。
   3. “Upgrade Check List” ステップの後、既存 JIRA インストールが起動中の場合はシャットダウンされます。その後、アップグレード ウィザードで:
      
      1. 既存 JIRA インストールをバックアップします。
      2. 既存 JIRA Installation Directory のコンテンツを削除します。
      3. 既存 JIRA Installation Directory に新しい JIRA バージョンをインストールします。
      4. Start your new (upgraded) JIRA installation.
         If you noted any files that contain customizations which must be migrated manually to your upgraded JIRA installation (above), then:
         
         1. アップグレードした JIRA インストールを終了します。
         2. アップグレードした JIRA アプリケーション インストールディレクトリ にこれらのファイルからカスタマイズを移行します。

         3. アップグレードした JIRA インストールを再起動します。

            既存の設定の移行に関する説明

            既存の JIRA インストールの設定ファイルを修正した場合は、新しい JIRA インストールにも同様の修正を適用してください。ただし、設定ファイル内のプロパティはバージョンによって異なるため、既存のインストールから設定ファイルを単純にコピーして、新しいインストールの該当するファイルを置き換えることはできません。

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

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

            ファイル	「おすすめ」（以前の「スタンドアロン」の JIRA ディストリビューションの保存場所	説明
            jira-application.properties	atlassian-jira/WEB-INF/classes	Location of the JIRA Home Directory and Advanced JIRA Configuration in JIRA 4.3.x and earlier. Any custom property values defined in the jira-application.properties file of your existing JIRA 4.3.x (or earlier) installation must be migrated across to the jira-application.properties file of your new JIRA 7.3 installation before you start your new JIRA installation. Upon starting your new JIRA installation, any custom property values in the jira-application.properties file will automatically be migrated across to either the JIRA database or jira-config.properties file. jira.home is the only property of the jira-application.properties file subsequently used by JIRA.
            setenv.bat (Windows) または setenv.sh (Linux)	bin	JIRA メモリの容量を増やす
            osuser.xml (JIRA 4.3.0 以降からのアップグレードの場合は不要)	atlassian-jira/WEB-INF/classes	LDAP を JIRA 統合、Crowd と JIRA を統合、外部のユーザー管理またはユーザー認証のカスタム フォームを使用している場合に修正します。
            seraph-config.xml	atlassian-jira/WEB-INF/classes	Crowd を JIRA と統合した場合に修正します。
            server.xml	conf	次のような場合に修正します。 JIRA の TCP ポートをデフォルトとは異なる設定にしたことがある場合 SSLを実装したことがある場合 JIRA をJIRA 4.3 x 以前のデータベースに接続する場合。

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

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

            • 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 ポートの変更」を参照してください。

7. アップグレード ウィザードの最終ステップで、アップグレードを確認するために、アップグレードしたJIRA インストールをブラウザーで起動するオプションを選択します。

以上で、Windows 上の JIRA インストールのアップグレードは完了です!

JIRA のアップグレード (Linux)

1. ご使用の OS に適した、新しいバージョンの JIRA 向けの JIRA Linux 64 ビッド/32 ビットインストーラー (.bin) ファイルを JIRA ダウンロードページ からダウンロードします。
2. Jira をシャットダウンします。
3. Open a Linux console and change directory (cd) to the '.bin' file's directory.
   If the '.bin' file is not executable after downloading it, make it executable, for example:
   chmod a+x atlassian-jira-X.Y.bin
   (where X.Y represents your version of JIRA)
4. “.bin” ファイルを実行し、アップグレード ウィザードを起動します。
5. 新規 JIRA インストールを作成するか、既存 JIRA インストールをアップグレードするかを選ぶ指示が表示されたら、Upgrade an existing JIRA installation (既存 JIRA インストールをアップグレードする) オプションを選びます。
6. Specify the JIRA installation directory of your JIRA installation to be upgraded.
   The upgrade wizard will attempt to find an existing JIRA installation and will provide its location as a choice. However, always verify this location, particularly if you have multiple JIRA installations running on the same machine.
7. この後のアップグレード ウィザードのステップでのオプション指定や実行は次の通りです:
   
   1. Choose the option to back up JIRA's directories. This creates 'zip' archive file backups of your existing JIRA installation and JIRA home directories in their respective parent directory locations.
      Please Note:
      
      • このオプションの選択を強く推奨します!

      • At this point, the upgrade wizard notes any customizations in your existing JIRA installation directory which it cannot automatically migrate to your upgraded JIRA installation. If you are informed of any files containing such customizations, please make a note of these files as you will need to manually migrate their customizations (which are not mentioned in the overview above) to your upgraded JIRA installation.

        SSL configuration

        - The upgrade wizard cannot automatically migrate the SSL configuration defined in the conf/server.xml file of the JIRA installation directory.

         

        - If you're using the bundled JRE for JIRA (located in the JRE folder of the JIRA installation directory), then the upgrade wizard cannot import the SSL certs into the new JRE after the upgrade as well. You will need to import the SSL certs into the new JRE. For more information on importing SSL certs, see Running JIRA applications over SSL or HTTPS.

         

        - If you're using the system JRE, you won't have to import the SSL certs into the new JRE after the upgrade, since the JRE would already have the SSL certs after the upgrade. You just need to ensure that JIRA is using the system JRE. To do this, you will need to perform the changes in catalina.sh, as discussed in How to Use System JRE Instead of Embedded JRE.

         

         

   2. 「アップグレードチェックリスト」ステップ で、外部データベースをバックアップします。データベースのバックアップは既に実行済みかもしれません (ステップ 2: 外部データベースのバックアップ)。
   3. “Upgrade Check List” ステップの後、既存 JIRA インストールが起動中の場合はシャットダウンされます。その後、アップグレード ウィザードで:
      
      1. 既存 JIRA インストールをバックアップします。
      2. 既存 JIRA Installation Directory のコンテンツを削除します。
      3. 既存 JIRA Installation Directory に新しい JIRA バージョンをインストールします。
      4. Starts your new (upgraded) JIRA installation.
         If you noted any files that contain customizations which must be migrated manually to your upgraded JIRA installation (above), then:
         
         1. アップグレードした JIRA インストールを終了します。
         2. アップグレードした JIRA アプリケーション インストールディレクトリ にこれらのファイルからカスタマイズを移行します。

         3. アップグレードした JIRA インストールを再起動します。

            既存の設定の移行に関する説明

            既存の JIRA インストールの設定ファイルを修正した場合は、新しい JIRA インストールにも同様の修正を適用してください。ただし、設定ファイル内のプロパティはバージョンによって異なるため、既存のインストールから設定ファイルを単純にコピーして、新しいインストールの該当するファイルを置き換えることはできません。

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

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

            ファイル	「おすすめ」（以前の「スタンドアロン」の JIRA ディストリビューションの保存場所	説明
            jira-application.properties	atlassian-jira/WEB-INF/classes	Location of the JIRA Home Directory and Advanced JIRA Configuration in JIRA 4.3.x and earlier. Any custom property values defined in the jira-application.properties file of your existing JIRA 4.3.x (or earlier) installation must be migrated across to the jira-application.properties file of your new JIRA 7.3 installation before you start your new JIRA installation. Upon starting your new JIRA installation, any custom property values in the jira-application.properties file will automatically be migrated across to either the JIRA database or jira-config.properties file. jira.home is the only property of the jira-application.properties file subsequently used by JIRA.
            setenv.bat (Windows) または setenv.sh (Linux)	bin	JIRA メモリの容量を増やす
            osuser.xml (JIRA 4.3.0 以降からのアップグレードの場合は不要)	atlassian-jira/WEB-INF/classes	LDAP を JIRA 統合、Crowd と JIRA を統合、外部のユーザー管理またはユーザー認証のカスタム フォームを使用している場合に修正します。
            seraph-config.xml	atlassian-jira/WEB-INF/classes	Crowd を JIRA と統合した場合に修正します。
            server.xml	conf	次のような場合に修正します。 JIRA の TCP ポートをデフォルトとは異なる設定にしたことがある場合 SSLを実装したことがある場合 JIRA をJIRA 4.3 x 以前のデータベースに接続する場合。

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

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

            • 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 ポートの変更」を参照してください。

8. アップグレード ウィザードの最終ステップで、アップグレードを確認するために、アップグレードした JIRA インストールをブラウザーで起動するオプションを選択します。

以上で、Linux 上の JIRA インストールのアップグレードは完了です!

4. ポストアップグレードのチェックおよびタスク

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. If JIRA is running as a service in Windows, remember to update your Java settings to match your previous configuration.

以上で、JIRA のアップグレードは完了です!