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

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

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

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

段階 タスク 注意

ステータス / コメント

調査と決定

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

  • Jira Software アップグレード マトリクスを使用してバージョンを比較し、ニーズに最適なバージョンを選択します。次に、アップグレード ノートでアップグレードの技術的な側面を確認します。

    tip/resting Created with Sketch. ヒント: アップグレードを頻繁に実行しない場合、エンタープライズ リリースをご検討ください。

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

準備とテスト


メンテナンス ステータスを確認する
  • Jira をアップグレードするための有効なライセンスが必要です。my.atlassian.com で確認および更新を行います。

カスタム変更を含むファイルの一覧を取得 Jira をカスタマイズするためにファイルを変更した場合、その変更を保持するには、どのファイルを変更したかを把握する必要があります。 
  • If you're on the latest version of the ASTS plugin, go to Cog icon > Applications > Plan your upgrade to see the list of files in which you introduced custom changes. If you want to keep these changes in your upgraded instance, you need to copy the changes (not entire files!) to the respective files during upgrade. Have this list handy, it will save you time during the upgrade process. 
  • If you cannot pull up the Plan your upgrade page, compile the list of files you've modified. For some suggestions regarding files that get modified most frequently, see here
For more info, see Pre-upgrade planning tool.

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

アプリの互換性の確認
  1. Jira の更新チェックでアプリの互換性を確認します。
  2. Because of major changes we've introduced in Jira 8.0, you need to disable all incompatible apps before the upgrade. We also recommend disabling the apps with the status:
    • Incompatible
    • Compatible if both upgraded
    • 不明
  3. "Compatible if upgraded" ステータスのアプリをアップグレードします。

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

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

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

SERVER

DATA CENTER

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

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

アップグレードの実行

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


Decide when to reindex

7.X TO 8.X UPGRADEJira will automatically remove the old incompatible index and start a full re-index on startup.  You might want to postpone reindexing to upgrade your apps first, as some apps will require an additional reindexing. For more information, see Disabling automatic reindexing .


Jira の起動

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

アップグレード中の変更によって 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. アップグレードした Jira インスタンスを再起動します。

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

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

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

準備と実施



メンテナンス ステータスを確認する
  • Jira をアップグレードするための有効なライセンスが必要です。my.atlassian.com で確認および更新を行います。

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

アプリの互換性の確認
  1. Jira の更新チェックでアプリの互換性を確認します。
  2. 7.X TO 8.X UPGRADEBecause of major changes we've introduced in Jira 8.0, you need to disable all incompatible apps before the upgrade. We also recommend disabling the apps with the status:
    • Incompatible
    • Compatible if both upgraded
    • 不明
  3. "Compatible if upgraded" ステータスのアプリをアップグレードします。

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

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

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

7.X TO 8.X UPGRADEDecide when to reindex

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


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

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

SERVER

DATA CENTER

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

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

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


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

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

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

7.X TO 8.X UPGRADEDecide when to reindex

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 日のサポート、ヘルス チェック、専任のシニア サポート エンジニアが含まれるプレミアム サポートも提供しています。詳細は、「プレミアム サポートについて」をご覧ください。


おつかれさまでした

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

最終更新日: 2019 年 9 月 8 日

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

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