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

JIRA 7.0 より前のバージョンからアップグレードする場合、「 移行ハブ」を参照してください。JIRA 7.0 のリリースではユーザー管理、アプリケーション アクセスとログイン権限、および JIRA インストールセットアップに影響を与える機能が含まれていました。したがって、アップグレード前に要件と影響について理解しておくことが非常に重要です。移行ハブには、このすべての情報が便利な1つのスペースにまとめられています。

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

  • Solaris で、JIRA 4.0.0 以降を使用している
  • Windows または Linux で、JIRA 4.0.0 – 4.2.x を使用している

JIRA のアップグレードに使用できる方法について詳細は、「JIRA アプリケーションのアップグレード」を参照してください。

このページの内容:

1. 始める前に

  • 新しいバージョンについて読む - アップグレードしようとしている JIRA バージョンのリリースノートやアップグレードに関する注意事項を確認します。JIRA サーバーのリリースノートを参照してください。アップグレード中にいくつかの JIRA バージョンをスキップする予定がある場合は、現在のバージョンから目的のアップグレードバージョンの間のすべてのメジャーバージョンに関するアップグレードガイドを読むことを強くお勧めします。
  • ライセンスの確認 – お客様の ライセンスサポート期間 が有効期間内であることを確認します。
  • 既知の問題の確認 - 影響を与える新しいバージョンの問題点を検索するには、JIRA ナレッジベースを利用します。
  • 互換性の確認:
    • お客様のオペレーティングシステム、データベース、その他の利用可能なプラットフォームおよびハードウェアが JIRA 7.2 の 要件 を満たしていることを確認します。サポート終了のお知らせのページにも、今後リリースする 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 from the plugin's home page on the Atlassian Marketplace.
    • ウィルス対策ツールやインターネットセキュリティーツールの中には JIRA アップグレードの障害となるものがあり、アップグレードが成功しないことがあります。ウィルス対策ツールやインターネットセキュリティーツールに関して、お客様がそのような経験をお持ちであるか、またはそのような事態に陥る恐れがある場合は、JIRA のアップグレード作業に入る前にまずこれらのツールを無効にしてください。
  • JIRA の新しいバージョンの事前ステージングとテスト - 最初に、テスト環境でアップグレードを実行することを強くお勧めします。 テスト環境におけるアップグレードが成功しない限り、本番環境の JIRA サーバをアップグレードしないでください。
    • テスト環境におけるアップグレードで解決できない問題がある場合、弊社サポートサイトで課題を作成してサポートを受けてください。
    • 本番環境の JIRA サーバのアップグレード中に問題が発生した場合は、サーバをユーザに利用させてはいけません。代わりに、以下を行って下さい:
      • 古い JIRA サーバを引き続き使用して下さい。これによって、本番環境のデータが失われずに済みます。
      • また、サポートサイトで課題を作成していただくことで、弊社はアップグレードに伴う様々な問題をお客様が解決できるよう支援できます。
      事前ステージングとテストに関する説明
      1. アップグレード後の JIRA システムのテストを行う際に本番環境用データのコピーを利用する場合は、お客様のシステムにネイティブに備えられているデータベースバックアップツールを使用してコピーを作成しておきます。「データのバックアップ」を参照してください。また、データベースのコピー作成を省略して新しいデータベースをテストに使用することもできます。
      2. アップグレードする JIRA のバージョンを、テスト用システム (テスト用サーバーか、または既存システムの別のディレクトリ) にインストールします。これは、アップグレードプロセスが完了すると新たな本番環境システムとなります。JIRA の新しいバージョンのインストールは、「 JIRA アプリケーションのインストール」の説明に従ってください。

      3. カスタム設定を行っている場合は、それを本番システムに移行します。「別のサーバーへの JIRA の移行」ページの手順 3.4 (既存の JIRA の設定を新しい JIRA インストールに移行) の説明に従ってください。
      4. JIRA の新しいバーションを本番環境用データベースのコピー (既存の本番環境用データベースではありません) または新しいテスト用データベースに接続します。詳細は、「JIRA のデータベース接続 」を参照してください。
      5. Start the new version of JIRA. See this Knowledge Base article about how to test mail settings without accidentally sending notifications to users from the test system: 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. バックアップ

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

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

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

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

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

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

tip/resting Created with Sketch.

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

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. (error) バックアップの完了直後に元のフォルダーから <jira-home>/dbconfig.xml ファイルを削除します。

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

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

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

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

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

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

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

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

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

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

JIRA アプリケーションのインストール」の説明に従います。

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

JIRA 7.2 を新しいサーバーにインストールする場合、事前に古いサーバーから新しいサーバーに 既存の JIRA ホームディレクトリのバックアップをコピーしてください 。

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

  1. JIRA 設定ツールを開きます。
  2. JIRA ホーム タブをクリックします。
  3. JIRA ホーム ディレクトリ フィールドを更新します:
    • JIRA 7.2 インストールが新しいサーバー上にある場合は、JIRA ホームディレクトリ フィールドを、コピーした JIRA ホームディレクトリのパスに更新します。
    • JIRA 7.2 インストールが同一サーバー上にある場合、JIRA ホーム ディレクトリ フィールドを既存の JIRA ホームディレクトリのパスに更新します。
      (info) このディレクトリに関する詳細は、「JIRA ホームディレクトリ」を参照してください。

(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 インストールがデータの保存に使用する、空の新規データベースを作成します。

Follow the appropriate 'Connecting JIRA to...' instructions for your database from stage 2, although from stage 4 of that procedure, be aware of the yellow note below:

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

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

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.

以下の表は、最もよく変更されるファイルと、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.2 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

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

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

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

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

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

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

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

新しい JIRA 7.2 インストールと古い JIRA が同じサーバー上にある場合、新しい JIRA インストールと同じ JIRA Home ディレクトリが使用されるように設定されている場合があります。共通の JIRA Home ディレクトリを共有する 2 つの JIRA インストールを実行すると、深刻なデータ破壊が発生する可能性があります。

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

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

After you start your new JIRA installation, JIRA launches its setup wizard. This happens any time JIRA starts with an empty database. From here, you can import your backup file and populate the database with your XML backup data. You will need the backup of your previous version of JIRA that you created in the backing up step

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

  1. Restore the attachments directory that you backed up previously into the attachments directory of your new JIRA. (See Restoring data.)
  2. Jira を起動します。
  3. In the setup wizard, select Import existing data.
  4. In the File name field, specify the XML backup file you created previously during the export process (above). The 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.
    (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. JIRA が正常に稼働しているように見えても、 サーバー ログにエラーメッセージがないか確認します。自己解決できないエラーがある場合、サポート ケースを作成し、ログファイルを添付してください。当社がエラーの対処方法をご案内致します。
  2. 前に外部ユーザー管理機能を使用していた場合は、新しい JIRA インスタンスでも有効にします。
  3. アップグレード時にマシンも変更した場合は、JIRA の管理セクション内でインデックス、添付ファイル、バックアップのディレクトリのパスを変更します。
  4. テストの間に E メール機能を無効にしていた場合は、これを有効に戻します。
  5. 古い JIRA から新しい JIRA へカスタマイズしたものを移行した場合は、それを入念にテストします。
    1. 新しい JIRA バージョンのためにプラグインをダウンロードした場合は、新しい JIRA バージョンにダウンロードした JAR ファイルをインストールして、そのプラグインが必要とするその他のすべてのインストールを実行します。
    2. もしプラグインにプロパティファイルがある場合は、古い JIRA で実施したものと同じ変更を適用します(古いプロパティファイルをコピーしないようにしてください)。
  6. 新しい JIRA が正しく動いていることが確認できたら、以下の方法で新しいサーバーIDをライセンスに登録します。
    1. https://my.atlassian.com にログインします。
    2. 利用したいライセンスを選択します。
    3. 新しいサーバー ID に変更して、保存します。
    4. 新しいサーバー上でライセンスを更新します。

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

以下も参照して下さい

自動エクスポートの無効化
データの復元
JIRA アプリケーションのアップグレード
データベースの切り替え

最終更新日 2016 年 3 月 4 日

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

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.