Jira Data Center のアップグレード (手動)

アーカイブを使用して Jira Data Center をアップグレードすることを選択しました。

はじめる前に

ステップ 1: アップグレードの準備

アップグレードの準備の手順が完了したことを確認します。これらは必須の前提条件であり、アップグレードをスムーズに進めるためには不可欠です。

ステップ 2: バージョンの選択

最適なバージョンの選択にお悩みの場合、アップグレード マトリクスですべての Jira バージョンの機能、サポート対象のプラットフォーム、およびアップグレードに関する技術的な注意事項を確認できます。

ステップ 3: クラスタの停止

クラスタのすべてのノードで Jira を停止します。アップグレードがすべてのノードで完了するまでは、ロード バランサで Jira からトラフィックをリダイレクトするように設定しておくことをおすすめします。

最初のノードで Jira をアップグレードする

各ノードを個別にアップグレードするのを避けるため、1 つのみをアップグレードしてから、それをテンプレートにします。次に、このテンプレートを残りのノードにコピーします。ここでは任意のノードを選択できます。

ステップ 1. Jira のダウンロード

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

Jira Software と Jira Service Desk の両方をアップグレードする場合、Jira Software のみをアップグレードします。Service Desk については個別のインストーラは使用せず、後ほど Jira で直接アップグレードします。

ステップ 2. ファイルの展開

ダウンロードしたファイルを展開し、アップグレードを開始します。

  1. ディレクトリ (新しいインストールディレクトリ。既存のインストール ディレクトリとは異なる必要があります) にファイルを展開 (解凍) します。 
  2. Jira が 既存の Jira ホーム ディレクトリを指すようにします。

    JIRA_HOME 環境変数の設定で行うことをおすすめします。この方法の詳細については、「Jira ホーム ディレクトリの設定」を参照してください。

ステップ 3. データベース ドライバのインストール

Oracle または MySQL データベースを使用している場合、新しい JDBC ドライバをダウンロードします。それ以外のデータベースの場合、この手順を省略できます。

tip/resting Created with Sketch.

ドライバが最新の場合、以前のバージョンからコピーすることもできます。


  1. 次のドライバのいずれかをダウンロードします。

  2. <installation-directory>/lib に配置します。

ステップ 4: カスタム変更の再適用

Jira を使用する際、Jira ファイルにカスタム変更を行う場合があります。このような変更には、接続の詳細、メモリ割り当てに関する設定や、他の JVM 引数などが含まれます。通常、次のファイルがカスタム変更を含みます。 

  1. バックアップからカスタム変更をそれぞれの新しい Jira ファイルにコピーすることで、それらを再適用します。

    古いファイルに含まれる "ネイティブ" 設定が Jira バージョン間で変更されている可能性があるため、単純に古いファイルをコピーしないようにしてください。

    We'll make another check on Jira startup and will show you all the files you might have skipped that still contain changes that have not been copied over. Then you'll be able to click to automatically copy the changes over.

    Note that the check will only be run on the following configuration files:

    - <jira-home-directory>/atlassian-jira/ directory
    - <jira-home-directory>/conf/server.xml
    - <jira-home-directory>/bin/setenv.sh

    and the automatic transfer will only be supported for ATST plugin 1.20.0 and later.

    To automatically transfer the changes, the installer copy of the modified file needs to be the same as in the version you're upgrading to.


ステップ 5. 自動再インデックスの無効化

このステップは、Jira 7.x から Jira 8.x へアップグレードする場合にお勧めします。すでに Jira 8.x を使用している場合、このステップをスキップしてかまいません。

Jira 8.0 でのインデックスの変更により、古い Jira バージョンのインデックスはアップグレード後には互換性がなくなります。新しいインデックスを作成するため、Jira は起動後に自動再インデックスをトリガーします。再インデックスが 2 回行われる (起動後とアプリのアップグレード後) のを避けるため、自動再インデックスを無効化し、準備が整ったら後で 2 つ目の再インデックスを実行することができます。

  1. 次のファイルを編集または作成します。

    <jira-home-directory>/jira-config.properties
  2. 次の行を追加してファイルを保存します。

    upgrade.reindex.allowed=false


最初のノードでのアップグレード後の手順

最初のノード (先ほどアップグレードしたもの) でのみ、次のアップグレード後の手順を完了します。残りのノードでは後ほど、共有ディレクトリからアップグレード後のアプリとインデックスをダウンロードします。

ステップ 1. Jira の初回起動

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

  1. (インストーラー) アップグレード ウィザードに戻って、Jira を起動します。

    (インストーラーおよび手動) <installation-directory>/bin に進み、以下のファイルのいずれかを実行して Jira を起動することもできます。

    • Windows:  start-jira.bat
    • Linux:  start-jira.sh 

  2. ブラウザで Jira を開きます。

  3. 画面の指示に従い、セットアップを完了します。 
  4. If you've missed any file with custom changes that have not been copied over, you can automatically copy the changes over now. 

    Note that the check for file changes is only be run on the following configuration files:

    - atlassian-jira/ directory
    - conf/server.xml
    - bin/setenv.sh

    and the automatic transfer is only be supported for ATST plugin 1.20.0 and later.

    To automatically transfer the changes, the installer copy of the modified file needs to be the same as in the version you're upgrading to.

    After the changes have been copied over, you'll be prompted to restart Jira.

アップグレード後のランディング ページ

アップグレードが完了したら、アップグレード後のランディング ページが表示されます。以下のように、新しいバージョンについての便利な情報も記載されています。

  1. Need to know: 管理者としての作業に影響を与える可能性がある、新機能の一覧。
  2. User apps: アップグレード後のアプリのステータス。
  3. Application links: アプリケーション リンクのステータス。
  4. Release notes: アップグレード先のバージョンに関する詳細な情報を確認できるリリース ノートへのリンク。

ステップ 2. (オプション) Jira Service Desk の更新

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

  1. > [アプリケーション] > [バージョンとライセンス] に移動します。
  2. Jira Service Desk を更新します。これによって、Service Desk は自動的に互換性のあるバージョンに更新されます。

ステップ 3. アプリ (アドオン) のアップグレード

これで、"Compatible if both upgraded" ステータスのアプリをアップグレードできます。これらのステータスおよびアプリ全般に関する詳細情報が必要な場合、「アップグレードの準備」を参照してください。

  1. > [アプリの管理] > [アプリの管理] に進みます。
  2. アプリをサポート対象バージョンにアップグレードします。
  3. アプリがアップグレードされたら、それを有効化できます。

DC クラスタでのアプリのアップグレード

アプリをアップグレードする際に、各ノードは再起動時に共有ホームから最後に変更されたアプリ jar ファイルをプルします。

ファイル バージョンを確認するために、Jira は atlassian-plugin.xml. 内の <version> 値を使用します。複数の <version> 値がある場合、Jira は java.lang.String#compareTo を使用してこの異なる値を比較します。


ステップ 4. インデックスの再構築

インデックスを再作成するために Jira を再インデックスします。課題とアプリの数に応じて、このステップには時間がかかる可能性があります。

  1.  > [インデックス作成] に移動して、Jira のロックと再インデックスの再構築を実行します。

ステップ 5. アップグレード済みの Jira をテンプレートとしてコピー

このステップでは、これまでに実行したすべての変更を含む新しいインストール ディレクトリをコピーします。これによりテンプレートが作成され、後で他のノードにコピーすることができます。

  1. 新しいインストール ディレクトリを別の場所にコピーします。これがテンプレートになります。


残りのノードをアップグレードする

Jira テンプレートの準備が整い、共有ディレクトリでアップグレード済みのアドオンとインデックス データが利用できるようになりました。このステップでは、テンプレートを別のノードにコピーし、1 つずつ起動します。

  1. テンプレートのインストール ディレクトリを新しいノードにコピーします。

  2. このノードでローカル ホーム ディレクトリへのパスが異なる場合、setenv.bat/setenv.sh ファイルでそれを更新します。

  3. このノードで Jira を起動します。

  4. 繰り返し: 次のノードでこれらのステップを繰り返します。
tip/resting Created with Sketch.

クラスタへの参加

> [システム] > [システム情報] に移動し、[クラスタ ノード] セクションにスクロールして、アップグレード後のノードがクラスタに参加しているかどうかを確認できます。

おつかれさまでした

Jira が新しいバージョンにアップグレードされました。

最終更新日 2019 年 8 月 22 日

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

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