アップグレード チェックリスト
このチェックリストを Jira Software Server アップグレードの準備ガイドとしてご利用いただけます。インスタンスはそれぞれ異なり、このガイドにはインスタンスに固有のタスクやカスタマイズを補完する必要がある点にご注意ください。
このテンプレートを使用し、お使いの Jira Software インスタンスに合わせて追記することをおすすめします。
| 段階 | タスク | 注意 | ステータス / コメント |
|---|---|---|---|
| 調査と決定 | アップグレード後のバージョンを決定する |
| |
| アップグレードのステークホルダーを大まかに決定する (任意) |
| ||
| 準備とテスト | メンテナンス ステータスを確認する |
| |
| カスタム変更を含むファイルの一覧を取得 | Jira をカスタマイズするためにファイルを変更した場合、その変更を保持するには、どのファイルを変更したかを把握する必要があります。
| ||
| サポート対象プラットフォームを確認する |
| ||
| テスト環境のセットアップ |
| ||
| インスタンス ヘルス チェックの実行 |
| ||
| アプリの互換性の確認 |
| ||
| 最適なアップグレード方法を決定する | Jira のアップグレード方法を選択します。 SERVER DATA CENTER 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.
| ||
| アップグレードの実行 | DATA CENTER アップグレードを行う際は、アップグレード前の手順をすべて実行し、1 つのノードでアップグレードを実行してアップグレード後の手順を実行します。次にテンプレートを作成し、他のすべてのノードをアップグレードします。これが完了するまでは、DC 全体でアップグレード後の手順を実行することはできません。 | ||
| 変更の再適用 | If you have made changes any of the files copy them over to your upgraded instance. These changes might include:
アップグレード中の変更によって Jira Software のカスタマイズが使用できなくなる可能性があるため、本番インスタンスでアップグレードを実施する前にステージング環境でカスタマイズのテストを実施することを強く推奨します。
Which files did I change?
If you're unsure which files you might have modified, go to Alternatively, take a look at the list of important files in the Jira installation directory. Also, you might want to look in the logs for the Modifications section:
インストーラーを使用している場合、既存の Jira Software インストールから次のパラメーターが移行されます。
| ||
再インデックスのタイミングの決定 | 7.x から 8.x へのアップグレード Jira は起動時に、互換性のない古いインデックスを自動的に削除し、完全な再インデックスを開始します。一部のアプリでは追加の再インデックスが必要になるため、アプリをアップグレードするまで再インデックスを延期することもできます。詳細は、「自動的な再インデックスの無効化」を参照してください。 | ||
| Jira の起動 | |||
| アプリのアップグレード | これで、"Compatible if both upgraded" ステータスのアプリをアップグレードできます。 | ||
| Re-apply any modifications (if you haven't done it already) | If you're upgrading to Jira 8.6 and later and running the ATST version 1.20.0 or later, you can see a list the files whose modifications have not been copied over on Jira startup. Then, you can just click to copy the changes automatically. Note that when checking for changes, we're only looking at the files/folders below: - <jira-home-directory>/atlassian-jira/ directory 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. You'll be prompted to restart Jira after copying is completed. | ||
| ユーザーによるアップグレード テスト |
| ||
| 確認事項の記録 (任意) |
| ||
| タイムラインの作成とコミュニケーション |
| ||
| 準備と実施 | メンテナンス ステータスを確認する |
| |
| サポート対象プラットフォームを確認する |
| ||
| インスタンス ヘルス チェックの実行 |
| ||
| アプリの互換性の確認 |
| ||
| インスタンス データのバックアップ |
| ||
| ディレクトリのバックアップ |
| ||
7.x から 8.x へのアップグレード 再インデックスのタイミングの決定 | Jira 8.0 は互換性のない古いインデックスを自動的に削除し、起動時に完全な再インデックスを開始します。一部のアプリでは追加の再インデックスが必要になるため、アプリをアップグレードするまで再インデックスを延期することもできます。詳細については、「自動的な再インデックスの無効化」をご確認ください。 | ||
| 本番環境でのアップグレードの実行 | 次のアップグレード方法を使用できます。 SERVER DATA CENTER 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.
DATA CENTER アップグレードを行う際は、アップグレード前の手順をすべて実行し、1 つのノードでアップグレードを実行してアップグレード後の手順を実行します。次にテンプレートを作成し、他のすべてのノードをアップグレードします。これが完了するまでは、DC 全体でアップグレード後の手順を実行することはできません。 | ||
| データベース ドライバーのアップグレード (Oracle または MySQL を使用している場合) | Jira を正常に起動するには、次の手順を実行します。 | ||
| 変更の再適用 | If you have made changes any of the files copy them over to your upgraded instance. These changes might include:
Which files did I change?
If you're unsure which files you might have modified, go to Alternatively, take a look at the list of important files in the Jira installation directory. Also, you might want to look in the logs for the Modifications section:
インストーラーを使用している場合、既存の Jira Software インストールから次のパラメーターが移行されます。
| ||
7.x から 8.x へのアップグレード 再インデックスのタイミングの決定 | Jira 8.0 は互換性のない古いインデックスを自動的に削除し、起動時に完全な再インデックスを開始します。一部のアプリでは追加の再インデックスが必要になるため、アプリをアップグレードするまで再インデックスを延期することもできます。詳細は、「自動的な再インデックスの無効化」を参照してください。 | ||
| Jira の起動 | |||
| アプリのアップグレード | これで、"Compatible if both upgraded" ステータスのアプリをアップグレードできます。 | ||
| Re-apply any modifications (if you haven't done it already) | If you're upgrading to Jira 8.6 and later and running the ATST version 1.20.0 or later, you can see a list the files whose modifications have not been copied over on Jira startup. Then, you can just click to copy the changes automatically. Note that when checking for changes, we're only looking at the files/folders below: - <jira-home-directory>/atlassian-jira/ directory 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. You'll be prompted to restart Jira after copying is completed. | ||
| アップグレード後 | ユーザーによるアップグレード テスト |
| |
| エンドユーザーへの通知 | 主要な機能追加や、問い合わせ用の連絡先情報を含めます。 | ||
| アップグレードのふりかえり (任意) | 想定どおりに進んだ点、進まなかった点、次回に変更すべき点を文書化します。この作業は、次回のアップグレードをさらにスムーズに実行するために役立ちます。 |
リソース
問題が発生した場合、次のリソースを利用できます。記載順で確認することをおすすめします。
- Jira Software ドキュメント サイトおよび Jira Software Server ナレッジベースを参照または検索します (ドロップダウンで適切なバージョンを選択するようにします)。
- アトラシアン コミュニティ サイト で、トピックに関する記事やディスカッションを検索します。または、アトラシアン内外のコミュニティ エキスパートに質問します。
- サポート エンジニアがサポートできるようサポート サイトで課題を作成します。
- 認定ソリューション パートナーを通じてライセンスを購入した場合は、インスタンスのトラブルシューティングについてのパートナーに問い合わせてください。
- さらにサポートが必要な場合、24 時間/週 7 日のサポート、ヘルス チェック、専任のシニア サポート エンジニアが含まれるプレミアム サポートも提供しています。詳細は、「プレミアム サポートについて」をご覧ください。
おつかれさまでした