JIRA の手動アップグレード

JIRA のアップグレード

このページの内容

関連コンテンツ

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

お困りですか?

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

コミュニティに質問

このページでは、迅速なアップグレード手法やフォールバック方法に対応していない JIRA インストールのアップグレード方法を解説します。以下のいずれかの条件に該当する場合は、この方法を利用して JIRA のアップグレードを行います:

  • JIRA バージョン 4.0.0 以降の WAR ディストリビューションを利用している
  • Solaris で、JIRA 4.0.0 以降を使用している
  • Windows または Linux で、JIRA 4.0.0 – 4.2.x を使用している
  • 4 以前の JIRA を使用しています。 これらのバージョンは、新しいバージョンへ移動する前に JIRA 4.4.5 へアップグレードする必要があります。

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

On this page:

 

1. 始める前に

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

最初に、テスト環境におけるアップグレードの実行を強くお勧めします。テスト環境におけるアップグレードが成功しない限り、本番環境の JIRA サーバをアップグレードしてはいけません。

  • If you have any problems with your test environment upgrade which you cannot resolve, create an issue at our support site so that we can assist you.
  • 本番環境の JIRA サーバのアップグレード中に問題が発生した場合は、サーバをユーザに利用させてはいけません。代わりに、以下を行って下さい:
    • 古い JIRA サーバを引き続き使用して下さい。これによって、本番環境のデータが失われずに済みます。
    • Also create an issue at our support site so that we can help you resolve the problems with your upgrade.

2. バックアップ

JIRA のアップグレードを開始する前に、既存の JIRA インストールをバックアップする事を強くお勧めします。

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

During the upgrade process, you'll export JIRA's database from your existing JIRA installation (via an XML backup) and then restore this backup into a new JIRA installation. To ensure that the data in the XML backup is consistent with the latest data in the system, you must temporarily restrict access to JIRA so users can't update the data. Refer to the Preventing users from accessing JIRA during backups page for more information.

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

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

Perform an XML backup of your existing JIRA installation's external database. For large JIRA installations, this process may require several hours to complete.

tip/resting Created with Sketch.

「組み込みのデータベース」は、JIRA が提供する評価専用の HSQLDB データベースです。誤って HSQLDB データベースを本番環境で使用してしまった場合は、このデータベースの XML バックアップを作成してから、以下の手順を続行します。

2.3 JIRA Home ディレクトリのバックアップ

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

2.4 添付ファイルおよびインデックスの保存ディレクトリが JIRA Home ディレクトリの外にある場合、この二つのディレクトリのバックアップを作成する

If the attachments and index directories are located outside of your JIRA Home Directory, you must back them up separately. These pages describe how to find out where these directories are located in your implementation:

  • Your attachments directory — Refer to Configuring File Attachments page in the documentation for your version of JIRA.
  • Your index directory — Refer to Search Indexing page in the documentation for your version of JIRA.

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

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

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

3. 新規 JIRA インストールのセットアップ

「ミッションクリティカル」な JIRA サーバーを実行中であれば、本番環境でアップグレードを行う前に、本ガイドの残りのステップをテスト環境で行う事を強くお勧めします (例えば、別のテスト用 JIRA データベースと、お使いの JIRA ホームディレクトリのコピーの利用)。  

3.1 JIRA の新バージョンをインストール

新規ディレクトリに必要な JIRA のディストリビューションをダウンロードして、抽出します。既存の JIRA インストールに上書きしてはいけません。これが終了している事を確認した後、新しい JIRA インストールを新たなロケーションにインストールします。

以下のいずれかのインストール解説に従います:

(info) If you are using JIRA WAR, remember to build your new JIRA web application and deploy it to your server. For specific instructions, refer to the JIRA WAR installation page for your application server within the Installing JIRA WAR section.

3.2 新しい JIRA に既存の JIRA ホームディレクトリ(のコピー)を参照させる

If your new JIRA 6.4 installation is on a new server, copy the backup of your existing JIRA Home Directory from the old server to the new server before proceeding.

To set up a "recommended" (not WAR) distribution:

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

WAR ディストリビューションの設定方法

  1. Edit the jira-application.properties file located within the <jira-application-dir>/WEB-INF/classes subdirectory of your new JIRA 6.4 Installation Directory JIRA Installation Directory.
  2. Update the jira.home property in this file to the path of the new JIRA Home Directory:
    • If your JIRA 6.4 installation is on a new server, update the jira.home property to the path of your copied JIRA Home directory.
    • If your JIRA 6.4 installation is on the same server, update the jira.home property to the path of your existing JIRA Home directory.
      (info) For more information about this directory, see JIRA Home Directory.
  3. Remove the '#' at the beginning of the jira.home line (so that JIRA no longer regards this line as a comment).
  4. Save your updated jira-application.properties file.

(tick) You can also set your JIRA Home Directory's location by defining an operating system environment variable JIRA_HOME. This value of this variable takes precedence over the value of the jira.home property in the jira-application.properties file in your JIRA Installation Directory. See Setting your JIRA Home Directory for details.

3.3 JIRA の新しいバージョンを、新しい空のデータベースに接続させる

JIRA インストールがデータの保存に使用する、空の新規データベースを作成します。

お使いのデータベースに対応した以下の「JIRA の ... (データベース名) への接続」の説明に従い、そしてステップ 4 からは以下の黄色の内容に注意してください。

データベース（jiradb など）は、既存の JIRA インストールを使用しており、新しい JIRA インストール用のデータベースがデータベースサーバーと同一のコンピュータで実行中の場合、別の名前の（JIRA 4.4.0 には jiradb_440 などが直感的で分かりやすい）新しいデータベースを作成してください。ただし、新しいデータベースと古い JIRA データベースのアクセス権限は同一にしてください。この件に関してサポートが必要な場合は、データベース管理者に相談してください。

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

3.4 既存の JIRA の設定を、新しい JIRA インストールへ移行する

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

For each file you have modified in your existing JIRA installation, you need to manually edit each equivalent file in your new JIRA installation and re-apply your modifications. If a file is not present in your new JIRA installation (for example, osuser.xml in recent JIRA versions), then simply copy that file over to your new JIRA installation.

The table below lists the most commonly modified files and their locations within your JIRA Installation Directory:

ファイル

「おすすめ」（以前の「スタンドアロン」の JIRA ディストリビューションの保存場所

JIRA WAR 内の保存場所

説明

jira-application.properties

atlassian-jira/WEB-INF/classes

webapp/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 6.4 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

Application server's bin directory

JIRA メモリの容量を増やす

osuser.xml
(JIRA 4.3.0 以降からのアップグレードの場合は不要)

atlassian-jira/WEB-INF/classes

webapp/WEB-INF/classes

LDAP を JIRA 統合、Crowd と JIRA を統合、外部のユーザー管理またはユーザー認証のカスタム フォームを使用している場合に修正します。

seraph-config.xml

atlassian-jira/WEB-INF/classes

webapp/WEB-INF/classes

Crowd を JIRA と統合した場合に修正します。

server.xml

conf

Application server's conf directory

次のような場合に修正します。

(tick) The version-specific upgrade notes contain details on properties which may have changed in these commonly modified files.

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

  • Using JIRA with Atlassian's Crowd? — If you are using Crowd with JIRA, configure your new JIRA to talk to Crowd as described in Integrating Crowd with JIRA.
  • Allocating additional memory to JIRA — If you had previously allocated additional memory to JIRA, do the same for your new JIRA instance. For more information refer to Increasing JIRA memory.
  • Plugins — For any plugins that you had installed in your old JIRA, download the plugin version for your new version of JIRA from the http://plugins.atlassian.com site.
  • 文字エンコード ： 新しい場所と同じ場所の文字エンコード（ロケールなど）が同じであることを確認します。 エンコードの互換性がない 2 つのシステム間で添付ファイルを移動した場合、新しいバージョンの JIRA が正常に動作しない場合があります。
  • カスタマイズ ： カスタマイズを行った場合（コード、テンプレート、構成ファイルなど）は、これらの変更の互換バージョンを新しい JIRA へコピーします。（所属組織内の開発者が使用しているバージョンをカスタマイズした場合、開発者は新しいバージョンに対しても同等の変更を構築・テストし、アップグレード後の JIRA インストールへコピーするためのファイルを制作する必要があります。）
  • (Optional) Running JIRA on a different port — If your new JIRA is installed on the same machine as your old JIRA, you may wish to make sure it runs on a different port (in case you ever need to restart your old JIRA). See Changing JIRA's TCP Ports for details.

3.5 JIRA の新しいバージョンを起動させる

  1. 古い JIRA がシャットダウンされていることを確認する ： JIRA サーバーが動作中の場合はシャットダウンします。
  2. JIRA WAR ディストリビューションを Tomcat 内にインストールした場合、JIRA を再起動する前に Tomcat 作業ディレクトリを削除します。この操作を実行しない場合、JIRA ページを表示した際にエラーが発生する可能性があります。
  3. 以下に対する JIRA の新しいバージョンを起動します。
    • 'Recommended' distributions — follow the Starting JIRA instructions.
    • WAR distributions — follow the instructions for starting JIRA for your application server within the Installing JIRA WAR section.
      (info) During the startup process, your new JIRA installation will create any required database indexes. If you created any custom database indexes, please check them afterwards and remove any that duplicate the indexes added by JIRA.

古い JIRA インストールを再起動しないでください...

If your new JIRA 6.4 installation is on the same server as your old one, it may still be configured to use the same JIRA Home directory as your new JIRA installation. Running two separate JIRA installations which share a common JIRA Home directory can lead to serious data corruption.

しかし、アップグレード後の JIRA インストールが期待通りに動作していることを確認するまでは、古い JIRA インストールのすべてのファイル（またはバックアップ コンポーネント）も削除しないことをおすすめします。

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

新しい JIRA インストールを開始した後、JIRA アプリケーションにログインして、古いインスタンスから新しいインスタンスへデータをインポートする準備をします。本説明書 (上記) で前に作成した古い JIRA からデータのバックアップ ファイルが必要となります。

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

  1. 「JIRA システム管理者」グローバル権限を持つユーザーとしてログインします。
  2. Select Administration > System > Import & Export > Restore System (tab) to open the 'Restore JIRA data from Backup' page.
    (tick) Keyboard shortcut: 'g' + 'g' + type 'rest'
  3. In the File name field, specify the XML backup file you created previously during the export process (above). That zipped file should contain two xml files: activeobjects.xml and entities.xml. Both of these files must be included in the zipped file for the import process to work.
  4. Restore the attachments directory that you backed up previously, into the attachments directory of your new JIRA. (See Restoring Data.)
    (info) Avoid passing through a proxy when performing an XML restore, especially if your JIRA instance is very large. Using a proxy may cause timeout errors.
  5. JIRA に Web ブラウザでアクセスして、古い JIRA のときと同じユーザー名でログインします。
  6. すべてのプロジェクトと課題がインポートされていて、すべての機能が正常に動いていることをさっと確認します。ページのフッター部分で新しい JIRA のバージョンを確認します。

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

新しい 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 で実施したものと同じ変更を適用します（古いプロパティファイルをコピーしないようにしてください）。

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

参考情報

Disabling Auto-Export
Restoring Data
Upgrading JIRA
Switching Application Servers to Apache Tomcat
Switching Databases

 

最終更新日 2015 年 11 月 29 日

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

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

関連コンテンツ

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