はじめる前に

ステップ 1: Jira ホーム ディレクトリを検索して初期インストール方法を決定する

初めてインストールしたときと同じ方法で Jira をアップグレードすることをお勧めします。方法かわからない場合は、Jira ホーム ディレクトリの場所を検索してください。通常は、これによって Jira を手動でインストールしたか、バイナリ インストーラーからインストールしたかがわかります。詳細については「Jira アプリケーション ホームディレクトリ」をご参照ください。

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

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

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

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

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

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

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

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

• • Jira Software
  • Jira Service Management
    
    

ステップ 2. インストール ウィザードの開始

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

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 を起動できます。

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

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

1. 次のドライバのいずれかをダウンロードします。
   
   
   • Oracle: JDBC ドライバ 19.3 (ojdbc8)
   • MySQL: MySQL Connector/J 5.1 ドライバ。
     
     
2. <installation-directory>/lib に配置します。

ステップ 4. 変更を再適用して pool-max-size を増やす

Jira を使用する際、Jira ファイルにカスタム変更を行う場合があります。このような変更には、接続の詳細、メモリ割り当てに関する設定や、他の JVM 引数などが含まれます。このステップでは、バックアップからコピーすることで新しいファイルに同じ変更を再適用する必要があります。

移行される変更

アップグレードの実行中に、ウィザードは既存の Jira インストールから下記のファイルを移行しています。

• server.xml ファイルの TCP 値。
• jira-application.properties ファイルに記載された Jira ホーム ディレクトリの場所。
• setenv.sh / setenv.bat ファイルの次の値:
  
  • JVM_SUPPORT_RECOMMENDED_ARGS
  • JVM_MINIMUM_MEMORY
  • JVM_MAXIMUM_MEMORY
  • JIRA_MAX_PERM_SIZE 


その他の変更 

上記に加えて、他のすべての変更を再適用する必要があります。最も重要なファイルは次のとおりです。 

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

詳細については、「Jira の重要なファイル」をご参照ください。 

Jira を SSL 経由で実行している場合は、これらのファイルに加えて証明書をトラスト ストアに再インポートする必要があります。手順については、「JVM にパブリック SSL 証明書をインポートする方法」をご参照ください。

pool-max-size

Jira 7.x を Jira 8.x にアップグレードする場合は、アップグレードの前に dbconfig.xml で pool-max-size パラメーターを 40 に変更することをおすすめします。デフォルトの 20 のままにしておくと、8.x でインデックスの再作成を実行する際に “ResultSet Closed” エラーが発生することがあります。変更の実装の詳細については「データベース接続のチューニング」を参照してください。

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

Jira プラットフォームのバージョン 8.x と 9.x 間に導入されたインデックスの変更によって、古い Jira バージョンのインデックスはアップグレード後に互換性がなくなります。
新しいインデックスを作成するために、Jira は起動後に自動再インデックスをトリガーします。自動再インデックスを無効にして準備が整い次第 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. カスタム変更を加えたファイルで、まだコピーされていないものがある場合、ここで変更を自動的にコピーできます。 

   ファイルの変更の確認は次の設定ファイルに対してのみ実行される点にご注意ください。

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

   自動転送は ATST プラグイン 1.20.0 以降でのみサポートされます。

   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.

   変更のコピー後、Jira を再起動するように求められます。

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

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

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

Step 2. (Optional) Update Jira Service Management

If you're using Jira Service Management, you can update it directly in the UI, without downloading a separate installer.

1. [管理] ( ) > [アプリケーション] > [バージョンとライセンス] に移動します。
2. Update Jira Service Management. This will automatically update Jira Service Management to a compatible version.

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

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

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

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

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

1. [管理] () > [インデックス] に移動して、Jira をロックしてインデックスを再構築を実行します。

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

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

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

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

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

1. テンプレートのインストール ディレクトリを新しいノードにコピーします。
   
   
2. このノードでローカル ホーム ディレクトリへのパスが異なる場合、setenv.bat/setenv.sh ファイルでそれを更新します。
   
   
3. このノードで Jira を起動します。
   
   
4. 繰り返し: 次のノードでこれらのステップを繰り返します。