Jira Server のアップグレード (インストーラー)

Jira Server インストーラーを使用したアップグレードを選択しました。

はじめる前に

アップグレードの準備

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

バージョンの選択

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

Jira のダウンロード

  1. アトラシアンの Web サイトからいずれかの Jira アプリケーションをダウンロードします。Windows または Linux 用インストーラーを選択します。

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

インストール ウィザードの開始

インストール ウィザードにしたがってアップグレードを実施します。

  1. ダウンロードしたインストーラーを実行します。

    Windows を使用している場合

    a) .exeファイルを実行します。Windows 管理者アカウントを使用することをおすすめします。

    b) アップグレード ウィザードによるコンピュータへの変更の許可を求められたら [はい] を選択します。[はい] を選択しない場合、ご利用の OS へのインストール ウィザードのアクセスや、以降のインスト―ル オプションが制限されます。

    Linux を使用している場合

    a) Jira をダウンロードしたディレクトリに移動し、次のコマンドを実行してインストーラーを実行可能にします。

    $ chmod a+x atlassian-jira-X.X.X-x64.bin

    ここで、X.X.X はダウンロードした Jira のバージョンです。

    b) 次にインストーラーを実行します。インストーラーの実行には sudo を使用することをお勧めします。

    $ sudo ./atlassian-jira-X.X.X-x64.bin

    root ユーザー権限でインストーラーを実行することもできます。

  2. ウィザードの指示に従います。 

    1. プロンプトが表示されたら、[Upgrade an existing Jira installation] を選択します。

    2. ウィザードが表示した既存の Jira インストール ディレクトリが正しいことを確認します (同一マシンに複数の Jira インストールがある場合は特に重要です)。

    3. Jira ホーム ディレクトリのバックアップを作成済みの場合は、さらにバックアップが作成されるのを防ぐため、[Jira ホーム ディレクトリのバックアップを作成する] チェックボックスを選択解除します。

    4. このウィザードは Jira インストール ディレクトリのカスタマイズを通知します。これらは後から再適用する必要があるため、記録しておきます。 

      現在のカスタマイズは上書きされますが、バックアップから後でコピーすることができます。

  3. アップグレード ウィザードの最後の画面では、Jira インスタンスを起動してアップグレードを完了するよう求められます。このステップで一度止まり、このページの残りのステップを完了してから Jira の初回起動を行うことをおすすめします。

    ここで Jira を起動してもアップグレードには影響しませんが、残りのステップを完了させるためには Jira をシャットダウンする必要があります。ステップを完了したら、ウィザードに戻って Jira を起動できます。

  4. (オプション) ユーザー管理に Crowd を使用している場合は、この追加手順を完了します。

    ここをクリックして展開...

    ユーザーの管理に Crowd を使用している場合、既存のインストール ディレクトリから新しいインストール ディレクトリに、下記のファイルへの変更を再適用する必要があります。Jira の新しいバージョンではファイルが異なる可能性があるため、ファイルのコピーは行わないでください。

    • <Installation-Directory>/atlassian-jira/WEB-INF/classes/crowd.properties
    • <Installation-Directory>/atlassian-jira/WEB-INF/classes/seraph-config.xml

データベース ドライバのインストール

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

tip/resting Created with Sketch.

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


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

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

カスタム変更の再適用

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

  • server.xml
  • dbconfig.xml
  • jira-config.properties
  • setenv.sh / setenv.bat (メモリ割り当ておよびその他の JVM 引数)

Jira の起動時に、古い Jira から新しい Jira にコピーされていないカスタム変更を含むファイルが表示されます。新しい Jira でカスタム変更を保持するには、以下の手順を実施します。

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

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

自動再インデックスの無効化

この手順は、7.x から 8.x へのアップグレードであるプラットフォーム アップグレードにおすすめです。

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

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

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

    upgrade.reindex.allowed=false

Jira の初回起動

新しい Jira バージョンを開始します。

  1. アップグレード ウィザードに戻ってアップグレードを完了し、Jira を起動します。

    <installation-directory>/bin に移動して次のいずれかのファイルを実行することで Jira を起動することもできます。

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

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


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

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

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

あともう一歩です!

お客様の Jira インスタンスはアップグレードされました。Service Desk をお持ちの場合のアップグレード方法と、アプリのアップグレード方法について、以降で説明します。

(オプション) Jira Service Desk の更新

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

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

アプリ (アドオン) のアップグレード

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

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

インデックスの再構築

古いインデックスには互換性がないため、Jira で再インデックスを実行して再構築します。課題とアプリの数に応じて、このステップには時間がかかる可能性があります。

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

おつかれさまでした

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

最終更新日 2019 年 8 月 22 日

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

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