アップグレード チェックリスト
このチェックリストを Jira Software Server アップグレードの準備ガイドとしてご利用いただけます。インスタンスはそれぞれ異なり、このガイドにはインスタンスに固有のタスクやカスタマイズを補完する必要がある点にご注意ください。
このテンプレートを使用し、お使いの Jira Software インスタンスに合わせて追記することをおすすめします。
| 段階 | タスク | 注意 | ステータス / コメント |
|---|---|---|---|
| 調査と決定 | アップグレード後のバージョンを決定する |
| |
| アップグレードのステークホルダーを大まかに決定する (任意) |
| ||
| 準備とテスト | メンテナンス ステータスを確認する |
| |
| サポート対象プラットフォームを確認する |
| ||
| テスト環境のセットアップ |
| ||
| インスタンス ヘルス チェックの実行 |
| ||
| アプリの互換性の確認 |
| ||
| 最適なアップグレード方法を決定する | Jira のアップグレード方法を選択します。 Jira 6.4 以前から開始している場合、8.x にアップグレードする前に Jira 7.x (例: 7.13) にアップグレードする必要があります。
Pro Tip: Depending on your OS or whether you are running a DC or a standalone Jira Server, there might be some restrictions to the upgrade method you can choose. See Upgrade methods.
| ||
| アップグレードの実行 | クラスタ アップグレードを行う際は、アップグレード前の手順をすべて実行し、1 つのノードでアップグレードを実行してアップグレード後の手順を実行します。次にテンプレートを作成し、他のすべてのノードをアップグレードします。これが完了するまでは、DC 全体でアップグレード後の手順を実行することはできません。 | ||
Jira 8.0 再インデックスのタイミングの決定 | Jira 8.0 は互換性のない古いインデックスを自動的に削除し、起動時に完全な再インデックスを開始します。一部のアプリでは追加の再インデックスが必要になるため、アプリをアップグレードするまで再インデックスを延期することもできます。詳細は、「自動的な再インデックスの無効化」を参照してください。 | ||
| Jira の起動 | |||
| アプリのアップグレード | これで、"Compatible if both upgraded" ステータスのアプリをアップグレードできます。 | ||
| 任意の変更を再適用して pool-max-size を増やす | アップグレード中の変更によって Jira Software のカスタマイズが使用できなくなる可能性があるため、本番インスタンスでアップグレードを実施する前にステージング環境でカスタマイズのテストを実施することを強く推奨します。
詳細
変更が行われた可能性のあるファイルが不明な場合、Jira インストール ディレクトリの重要なファイルの一覧をご確認ください。 また、変更セクションでログを確認することもできます。
インストーラーを使用している場合、既存の Jira Software インストールから次のパラメーターが移行されます。
その他のすべてのカスタマイズは手動で再適用する必要があります。手動アップグレードを行っている場合、すべてのカスタマイズを手動で再適用します (上記に一覧表示された情報を含む)。これを行うには、次の手順に従います。
| ||
| ユーザーによるアップグレード テスト |
| ||
| 確認事項の記録 (任意) |
| ||
| タイムラインの作成とコミュニケーション |
| ||
| 準備と実施 | メンテナンス ステータスを確認する |
| |
| サポート対象プラットフォームを確認する |
| ||
| インスタンス ヘルス チェックの実行 |
| ||
| アプリの互換性の確認 |
| ||
| インスタンス データのバックアップ |
| ||
| ディレクトリのバックアップ |
| ||
Jira 8.0 再インデックスのタイミングの決定 | Jira 8.0 は互換性のない古いインデックスを自動的に削除し、起動時に完全な再インデックスを開始します。一部のアプリでは追加の再インデックスが必要になるため、アプリをアップグレードするまで再インデックスを延期することもできます。詳細については、「自動的な再インデックスの無効化」をご確認ください。 | ||
| 本番環境でのアップグレードの実行 | 次のアップグレード方法を使用できます。 Jira 6.4 以前から開始している場合、8.x にアップグレードする前に Jira 7.x にアップグレードする必要があります。
Pro Tip: Depending on your OS or whether you are running a DC or a standalone Jira Server, there might be some restrictions to the upgrade method you can choose. See Upgrade methods.
クラスタ アップグレードを行う際は、アップグレード前の手順をすべて実行し、1 つのノードでアップグレードを実行してアップグレード後の手順を実行します。次にテンプレートを作成し、他のすべてのノードをアップグレードします。これが完了するまでは、DC 全体でアップグレード後の手順を実行することはできません。 | ||
| データベース ドライバーのアップグレード (Oracle または MySQL を使用している場合) | Jira を正常に起動するには、次の手順を実行します。 | ||
Jira 8.0 再インデックスのタイミングの決定 | Jira 8.0 は互換性のない古いインデックスを自動的に削除し、起動時に完全な再インデックスを開始します。一部のアプリでは追加の再インデックスが必要になるため、アプリをアップグレードするまで再インデックスを延期することもできます。詳細は、「自動的な再インデックスの無効化」を参照してください。 | ||
| Jira の起動 | |||
| アプリのアップグレード | これで、"Compatible if both upgraded" ステータスのアプリをアップグレードできます。 | ||
| 変更の再適用 | 変更が行われた可能性のあるファイルが不明な場合、Jira インストール ディレクトリの重要なファイルの一覧をご確認ください。 また、変更セクションでログを確認することもできます。
インストーラーを使用している場合、既存の Jira Software インストールから次のパラメーターが移行されます。
その他のすべてのカスタマイズは手動で再適用する必要があります。手動アップグレードを行っている場合、すべてのカスタマイズを手動で再適用します (上記に一覧表示された情報を含む)。これを行うには、次の手順に従います。
| ||
| アップグレード後 | ユーザーによるアップグレード テスト |
| |
| エンドユーザーへの通知 | 主要な機能追加や、問い合わせ用の連絡先情報を含めます。 | ||
| アップグレードのふりかえり (任意) | 想定どおりに進んだ点、進まなかった点、次回に変更すべき点を文書化します。この作業は、次回のアップグレードをさらにスムーズに実行するために役立ちます。 |
リソース
問題が発生した場合、次のリソースを利用できます。記載順で確認することをおすすめします。
- Jira Software ドキュメント サイトおよび Jira Software Server ナレッジベースを参照または検索します (ドロップダウンで適切なバージョンを選択するようにします)。
- アトラシアン コミュニティ サイト で、トピックに関する記事やディスカッションを検索します。または、アトラシアン内外のコミュニティ エキスパートに質問します。
- サポート エンジニアがサポートできるようサポート サイトで課題を作成します。
- 認定ソリューション パートナーを通じてライセンスを購入した場合は、インスタンスのトラブルシューティングについてのパートナーに問い合わせてください。
- さらにサポートが必要な場合、24 時間/週 7 日のサポート、ヘルス チェック、専任のシニア サポート エンジニアが含まれるプレミアム サポートも提供しています。詳細は、「プレミアム サポートについて」をご覧ください。
おつかれさまでした