アップグレード チェックリスト

このチェックリストを Jira Software Server アップグレードの準備ガイドとしてご利用いただけます。インスタンスはそれぞれ異なり、このガイドにはインスタンスに固有のタスクやカスタマイズを補完する必要がある点にご注意ください。

このテンプレートを使用し、お使いの Jira Software インスタンスに合わせて追記することをおすすめします。

チェックリストを Trello ボードで確認 

段階タスク注意

ステータス / コメント

調査と決定

アップグレード後のバージョンを決定する


アップグレードのステークホルダーを大まかに決定する (任意)
  • 役割、責任範囲、および連絡先を一覧化して、関係者と常に情報を共有し、すべての依存関係を把握できるようにします。

準備とテスト


メンテナンス ステータスを確認する
  • You need to have a valid licence to upgrade Jira. Check and renew at my.atlassian.com.

サポート対象プラットフォームを確認する
テスト環境のセットアップ
インスタンス ヘルス チェックの実行
  • インスタンスがアップグレード可能かどうかを確認します。ヘルス チェックは Support Tools Plugin に含まれています。詳細はこちら

アプリの互換性の確認
  1. Jira の更新チェックでアプリの互換性を確認します。
  2. Jira 8.0 Jira 8.0 では大規模な変更が加えられたため、アップグレードの前に、互換性のないアプリをすべて無効化する必要があります。また、次のステータスのアプリも無効化することをお勧めします。
    • Incompatible
    • Compatible if both upgraded
    • Unknown
  3. "Compatible if upgraded" ステータスのアプリをアップグレードします。

    互換性のないアプリ」を参照してください。

最適なアップグレード方法を決定する

Jira のアップグレード方法を選択します。

Jira 6.4 以前から開始している場合、8.x にアップグレードする前に Jira 7.x (例: 7.13) にアップグレードする必要があります。

tip/resting Created with Sketch. ヒント: お使いの OS や、DC とスタンドアロンの Jira Server のどちらを使用しているかによって、選択できるアップグレード方法に制約が生じる場合があります。「アップグレード方法」を参照してください。

アップグレードの実行

クラスタ アップグレードを行う際は、アップグレード前の手順をすべて実行し、1 つのノードでアップグレードを実行してアップグレード後の手順を実行します。次にテンプレートを作成し、他のすべてのノードをアップグレードします。これが完了するまでは、DC 全体でアップグレード後の手順を実行することはできません。


Jira 8.0 再インデックスのタイミングの決定

Jira 8.0 は互換性のない古いインデックスを自動的に削除し、起動時に完全な再インデックスを開始します。一部のアプリでは追加の再インデックスが必要になるため、アプリをアップグレードするまで再インデックスを延期することもできます。詳細は、「自動的な再インデックスの無効化」を参照してください。
Jira の起動

アプリのアップグレードこれで、"Compatible if both upgraded" ステータスのアプリをアップグレードできます。
任意の変更を再適用して pool-max-size を増やす

アップグレード中の変更によって Jira Software のカスタマイズが使用できなくなる可能性があるため、本番インスタンスでアップグレードを実施する前にステージング環境でカスタマイズのテストを実施することを強く推奨します。

詳細

変更が行われた可能性のあるファイルが不明な場合、Jira インストール ディレクトリの重要なファイルの一覧をご確認ください。

また、変更セクションでログを確認することもできます。

インストーラーを使用している場合、既存の Jira Software インストールから次のパラメーターが移行されます。

  • 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

その他のすべてのカスタマイズは手動で再適用する必要があります。手動アップグレードを行っている場合、すべてのカスタマイズを手動で再適用します (上記に一覧表示された情報を含む)。これを行うには、次の手順に従います。

  1. アップグレードされた Jira インスタンスを停止します。
  2. 関連するファイルへのカスタマイズを、アップグレードされた Jira インストール ディレクトリ に再適用します。
  3. If you're upgrading from Jira 7.x to Jira 8.x we recommend changing the pool-max-size parameter to 40 in your dbconfig.xml before the upgrade. Leaving the default of 20 can sometimes lead to “ResultSet Closed” errors during re-indexing on 8.x. For information on implementing the change, see Tuning database connections

  4. アップグレードした Jira インスタンスを再起動します。

ユーザーによるアップグレード テスト
  • Jira ユーザーに、アップグレード後に Jira を正常に利用できているかどうかを確認します。これは、メジャー バージョン (例: 8.0) を越えるアップグレードを行う場合に非常に便利です。Jira Software の異なる機能を活用するサンプル グループを選択します。

確認事項の記録 (任意)
  • アップグレード中に気付いた点を文書化します。これは将来のアップグレードに役立ちます。
  • 必要に応じてタイムラインとステークホルダーを更新します。

タイムラインの作成とコミュニケーション
  • アップグレードに十分な時間を確保するようにします。ある程度の猶予時間も必要です。
  • 変更をエンドユーザーに通知します。

準備と実施



メンテナンス ステータスを確認する
  • You need to have a valid licence to upgrade Jira. Check and renew at my.atlassian.com.

サポート対象プラットフォームを確認する
インスタンス ヘルス チェックの実行
  • インスタンスがアップグレード可能かどうかを確認します。ヘルス チェックは Support Tools Plugin に含まれています。詳細はこちら

アプリの互換性の確認
  1. Jira の更新チェックでアプリの互換性を確認します。
  2. Jira 8.0 Jira 8.0 では大規模な変更が加えられたため、アップグレードの前に、互換性のないアプリをすべて無効化する必要があります。また、次のステータスのアプリも無効化することをお勧めします。
    • Incompatible
    • Compatible if both upgraded
    • Unknown
  3. "Compatible if upgraded" ステータスのアプリをアップグレードします。

    互換性のないアプリ」を参照してください。

インスタンス データのバックアップ
  • ネイティブのデータベース バックアップ ツールを使用します。ただし、環境の一部 (例: データベース ソフトウェア) を変更した場合は、Jira の XML バックアップ ユーティリティを使用する必要があります。
  • 2 つのプロセスの詳細な内容については、こちらをご確認ください。 

ディレクトリのバックアップ
  • インストール ディレクトリとホーム ディレクトリのバックアップを作成します。詳細についてはこちらをご参照ください。
    クラスタ すべてのノードでバックアップを実行し、共有ディレクトリのバックアップも作成します。

Jira 8.0 再インデックスのタイミングの決定

Jira 8.0 は互換性のない古いインデックスを自動的に削除し、起動時に完全な再インデックスを開始します。一部のアプリでは追加の再インデックスが必要になるため、アプリをアップグレードするまで再インデックスを延期することもできます。詳細については、「自動的な再インデックスの無効化」をご確認ください。


本番環境でのアップグレードの実行

次のアップグレード方法を使用できます。

Jira 6.4 以前から開始している場合、8.x にアップグレードする前に Jira 7.x にアップグレードする必要があります。

tip/resting Created with Sketch. ヒント: お使いの OS や、DC とスタンドアロンの Jira Server のどちらを使用しているかによって、選択できるアップグレード方法に制約が生じる場合があります。「アップグレード方法」を参照してください。

クラスタ アップグレードを行う際は、アップグレード前の手順をすべて実行し、1 つのノードでアップグレードを実行してアップグレード後の手順を実行します。次にテンプレートを作成し、他のすべてのノードをアップグレードします。これが完了するまでは、DC 全体でアップグレード後の手順を実行することはできません。


データベース ドライバーのアップグレード (Oracle または MySQL を使用している場合)

Jira を正常に起動するには、次の手順を実行します。

  • 最新の JDBC ドライバ (Oracle または MySQL) をダウンロードします。
  • <Jira-installation-directory>/lib に配置します。

Jira 8.0 再インデックスのタイミングの決定

Jira 8.0 は互換性のない古いインデックスを自動的に削除し、起動時に完全な再インデックスを開始します。一部のアプリでは追加の再インデックスが必要になるため、アプリをアップグレードするまで再インデックスを延期することもできます。詳細は、「自動的な再インデックスの無効化」を参照してください。
Jira の起動

アプリのアップグレードこれで、"Compatible if both upgraded" ステータスのアプリをアップグレードできます。
変更の再適用

変更が行われた可能性のあるファイルが不明な場合、Jira インストール ディレクトリの重要なファイルの一覧をご確認ください。

また、変更セクションでログを確認することもできます。

インストーラーを使用している場合、既存の Jira Software インストールから次のパラメーターが移行されます。

  • 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

その他のすべてのカスタマイズは手動で再適用する必要があります。手動アップグレードを行っている場合、すべてのカスタマイズを手動で再適用します (上記に一覧表示された情報を含む)。これを行うには、次の手順に従います。

  1. アップグレードされた Jira インスタンスを停止します。
  2. 関連するファイルへのカスタマイズを、アップグレードされた Jira インストール ディレクトリ に再適用します。
  3. アップグレードした Jira インスタンスを再起動します。

アップグレード後ユーザーによるアップグレード テスト
  • アップグレード後に Jira を正常に利用できているかどうかをユーザーに確認します。
  • テスト アップグレードと同じサンプル グループを使用します。
  • アップグレードを完了する前に課題を解決します。

エンドユーザーへの通知

主要な機能追加や、問い合わせ用の連絡先情報を含めます。


アップグレードのふりかえり (任意)

想定どおりに進んだ点、進まなかった点、次回に変更すべき点を文書化します。この作業は、次回のアップグレードをさらにスムーズに実行するために役立ちます。



リソース

問題が発生した場合、次のリソースを利用できます。記載順で確認することをおすすめします。 

  • Jira Software ドキュメント サイトおよび Jira Software Server ナレッジベースを参照または検索します (ドロップダウンで適切なバージョンを選択するようにします)。
  • アトラシアン コミュニティ サイト で、トピックに関する記事やディスカッションを検索します。または、アトラシアン内外のコミュニティ エキスパートに質問します。 
  • サポート エンジニアがサポートできるようサポート サイトで課題を作成します。
  • 認定ソリューション パートナーを通じてライセンスを購入した場合は、インスタンスのトラブルシューティングについてのパートナーに問い合わせてください。
  • さらにサポートが必要な場合、24 時間/週 7 日のサポート、ヘルス チェック、専任のシニア サポート エンジニアが含まれるプレミアム サポートも提供しています。詳細は、「プレミアム サポートについて」をご覧ください。


おつかれさまでした

ランディング ページに移動

最終更新日 2020 年 6 月 8 日

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

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