高速アップグレード手法による JIRA のアップグレード

はじめる前に

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 のアップグレード作業に入る前にまずこれらのツールを無効にしてください。

1. カスタマイズの確認

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

• Legacy database configurations defined as a datasource within the application server (used in JIRA 4.3.x and earlier) to the new database configuration used in JIRA 4.4 and later. See JIRA 4.4 Upgrade Notes for details.
• TCP port values in your existing JIRA installation's server.xml file. Other configurations or customizations in this file are not migrated.
• Custom values in your existing JIRA 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

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 Installation Directory, which had been deleted, added or modified from a 'default' JIRA installation. If you have made customizations to your seraph-config.xml file or any other file customizations in your JIRA installation directory which are not handled by the upgrade wizard, you must migrate these to the upgraded JIRA installation manually.

The upgrade feature also re-uses your existing JIRA Home Directory so that any key data stored in this directory from your previous JIRA installation will be retained after the JIRA upgrade.

注意:

• このアップグレード処理では、データベースのバックアップ ユーティリティを使用してデータベースのバックアップを実行することが必要となります 。お使いのデータベースがオンライン バックアップに対応していない場合、アップグレード処理を中断し、JIRA をシャットダウンし、データベースのバックアップを実行後、アップグレード処理を続行してください。
• The installer automatically backs up the Installation and Home directories of the existing JIRA installation. If your attachments and index files are located outside your JIRA Home Directory, you must manually back up these files. These pages describe how to find out where these directories are located in your environment: 
  • Your attachments directory — Refer to the Configuring File Attachments page for your version of JIRA.
  • Your index directory — Refer to the Search Indexing page for your version of JIRA. 

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

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

• お使いのデータベースのネイティブ バックアップ ツールがオンライン バックアップ (通常、データベース使用中に JIRA データベースの「スナップショット」を作成するバックアップ) に対応している場合、アップグレード ウィザードを起動したまま、データベースのバックアップを実行できます。そして、データベースのバックアップが正しく作成されたことを確認後に、アップグ レード ウィザードを続行できます。
• お使いのデータベースのネイティブ バックアップ ツールで JIRA データベースのオンライン バックアップが実行できない場合は:
  
  1. データベースをバックアップするように指示が出たら、アップグレード ウィザードを終了します。
  2. Prevent users from updating your existing JIRA data (to ensure structural consistency of your database backup) by temporarily restricting access to JIRA. Refer to the Preventing users from accessing JIRA during backups page for more information.
  3. お使いのデータベースのネイティブ バックアップ ツールを使用して、データベースの「オフライン バックアップ」を実行し、バックアップが正しく作成されたことを確認します。
  4. Linux / Windows インストーラーを再起動し、中断地点からアップグレード ウィザードを再開します。
• JIRA's 'internal' database is HSQLDB, which should be used for evaluating JIRA only. If you happen to accidentally use the HSQLDB database for a production system, quit the upgrade wizard when it prompts you about the backup and use the Migrating JIRA to Another Server procedure to upgrade 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

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

1. Download the 'JIRA Windows Installer' (.exe) file (for the new version of JIRA) from the JIRA Download page.
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 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. One relatively common customization that the upgrade wizard cannot automatically migrate is an SSL configuration defined in the conf/server.xml file of the JIRA Installation Directory.
   2. At the 'Upgrade Check List' step, back up your external database and check that any non-bundled plugins will be compatible with your upgraded JIRA version. You may have already backed up your database (in step 2: Backing Up Your External Database).
   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. Migrate the customizations from these files into the upgraded JIRA Installation Directory.
         3. アップグレードした JIRA インストールを再起動します。
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. One relatively common customization that the upgrade wizard cannot automatically migrate is an SSL configuration defined in the conf/server.xml file of the JIRA Installation Directory.
   2. At the 'Upgrade Check List' step, back up your external database. You may have already backed up your database (in step 2 Backing Up Your External Database).
   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. Migrate the customizations from these files into the upgraded JIRA Installation Directory.
         3. アップグレードした JIRA インストールを再起動します。
8. アップグレード ウィザードの最終ステップで、アップグレードを確認するために、アップグレードした JIRA インストールをブラウザーで起動するオプションを選択します。

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

4. アップグレード後の確認と作業

JIRA のアップグレードを完了後、バージョン間の互換性を確認してからプラグインのアップグレードを実行してください。Administration Console にある Plugin Repository で実行できます。

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