アップグレードの計画 planning-your-upgrade
AEM プロジェクトの概要 aem-project-overview
AEM は、何百万人ものユーザーにサービスを提供するような、影響の大きいデプロイメントで使用されることがよくあります。通常、インスタンスにカスタムアプリケーションがデプロイされ、さらに複雑な構成になっています。このようなデプロイメントをアップグレードするときには、入念な計画が必要です。
このガイドでは、アップグレードの計画で明確な目標、フェーズ、成果物を定める際に役立つ情報を示します。全体的なプロジェクトの実行とガイドラインに重点を置きます。実際のアップグレード手順の概要を示しますが、入手可能な技術リソースを参照するよう指示する場合もあります。このドキュメントで参照されている入手可能な技術リソースを併せて使用してください。
AEM アップグレードプロセスでは、プランニング、分析および実行のフェーズと、各フェーズで定義される主要成果物を慎重に扱う必要があります。
AEM バージョン 6.0 から 6.5 までのバージョンでは、直接アップグレードすることが可能です。5.6.x 以下のバージョンを実行しているお客様は、まずバージョン 6.0 以上にアップグレードする必要があります（6.0（SP3）を推奨）。また、6.3 以降では新しい OAK Segment Tar 形式がセグメントノードストアに使用されるようになり、この新しい形式へのリポジトリ移行は 6.0、6.1 および 6.2 でも必須です。
アップグレードの範囲と要件 upgrade-scope-requirements
一般的な AEM アップグレードプロジェクトで影響を受ける領域の一覧を以下に示します。
サポート対象のオペレーティングシステム、Java™ ランタイム、httpd および Dispatcher バージョンを実行していることを確認することが重要です。詳しくは、AEM 6.5 の技術要件ページを参照してください。これらのコンポーネントのアップグレードは、プロジェクト計画で考慮する必要があり、AEM をアップグレードする前に実行する必要があります。
プロジェクトフェーズ project-phases
AEM のアップグレードの計画と実行には、多くの作業が必要になります。このプロセスに含まれる様々な作業を明確にするために、計画と実行に伴う作業を個別のフェーズに分割しました。以下の節では、各フェーズで成果物が生成され、それらは多くの場合プロジェクトのその後のフェーズで使用されます。
作成者トレーニングの計画 planning-for-author-training
新しいリリースでは、UI およびユーザーワークフローの変更が導入される可能性があります。また、新しいリリースには新機能が導入されており、ビジネスで使用すると役に立つことがあります。導入された機能変更を確認し、それらが効果的に使用されるようにユーザーをトレーニングする計画を立てることをお勧めします。
AEM 6.5 の新機能は、adobe.com の AEM セクションに記載されています。組織内で一般的に使用されている UI または製品機能の変更に注意してください。新機能を調べて、組織にとって役立つ可能性がある機能にも注意してください。AEM 6.5 での変更内容を確認したら、作成者向けのトレーニング計画を作成します。ヘルプ機能のビデオのような無料で使用できるリソースや、アドビデジタルラーニングサービスで提供される公式トレーニングを使用することもできます。
テスト計画の作成 creating-a-test-plan
顧客の AEM の実装はそれぞれ固有のものであり、ビジネス要件に合うようにカスタマイズされています。そのため、システムに対して行われたすべてのカスタマイズを特定し、それらがテスト計画に含まれるようにすることが重要です。このテスト計画により、アップグレードされたインスタンスに対して実行する QA プロセスが強化されます。
すべてのアプリケーションとカスタムコードが引き続き想定どおりに動作することを確認するには、実稼動環境を正確に複製し、アップグレード後にその環境でテストを実行する必要があります。すべてのカスタマイズを元に戻し、パフォーマンス、負荷およびセキュリティのテストを実行します。テスト計画を立てるときは、日々の運用で使用されている標準の UI およびワークフローに加えて、システムに対して行われたすべてのカスタマイズを対象にします。これには、カスタム OSGI サービスとサーブレット、Adobe Experience Cloud への統合、AEM コネクタによるサードパーティとの統合、サードパーティとのカスタム統合、カスタムコンポーネントとテンプレート、AEM でのカスタム UI オーバーレイ、およびカスタムワークフローが含まれる場合があります。AEM 6 よりも前のバージョンから移行するお客様の場合、カスタムクエリにインデックスの作成が必要な場合があるので、カスタムクエリを分析する必要があります。既に AEM 6.x バージョンを使用しているお客様も、これらのクエリをテストして、アップグレード後にインデックスが引き続き機能することを確認する必要があります。
アーキテクチャおよびインフラストラクチャで必要な変更の特定 determining-architectural-and-infrastructure-changes-needed
アップグレード時に、オペレーティングシステムや JVM など、技術スタックの他のコンポーネントのアップグレードも必要になる可能性があります。また、リポジトリ構成の変更により、追加のハードウェアが必要になる場合もあります。これは 6.x よりも前のインスタンスから移行する顧客にのみ発生しますが、考慮しておくことが重要です。最後に、監視、メンテナンスなどの運用作業やバックアップおよび障害回復プロセスに対する変更が必要になる場合があります。
AEM 6.5 の技術要件を確認し、現在のハードウェアおよびソフトウェアで十分であることを確認します。運用プロセスに関して考えられる変更については、以下のドキュメントを参照してください。
監視およびメンテナンス：
バックアップ／復元および障害回復：
コンテンツの再構築に関する考慮事項 content-restructuring-considerations
AEM では、よりシームレスなアップグレードを可能にするために、リポジトリの構造が変更されました。この変更の一環として、コンテンツが /etc フォルダーから /libs、/apps、/content などのフォルダーに移動されます。Adobe の所有コンテンツとお客様の所有コンテンツが分けて管理されるようになるので、リリース中にコンテンツを上書きしてしまう危険が低減します。リポジトリの再構築は、6.5 へのアップグレード時にコードを変更する必要がないように行われていますが、アップグレードを計画する際は、AEM でのリポジトリの再構築で詳細を確認することをお勧めします。
アップグレードの複雑性の評価 assessing-upgrade-complexity
アドビの顧客が AEM 環境に適用するカスタマイズの量および性質は様々なので、あらかじめ時間をかけて、アップグレードで予期される全体的な作業量を判断することが重要です。
アップグレードの複雑性の評価には、2 つの方法があります。予備的な段階では、新たに導入されたパターン検出の機能を使用できます。これは、AEM 6.1、6.2 および 6.3 インスタンスで実行できます。パターン検出は、アップグレードの全体的な複雑性を最も簡単に評価できる方法です。レポートされたパターンを使用して複雑性を予測できます。パターン検出レポートには、カスタムコードベースで使用されている、利用できない API を特定するためのパターンが含まれています（6.3 では、アップグレード前の互換性チェックを使用して行われていました）。
初期評価後、より包括的な次の手順として、テストインスタンスでアップグレードを実行し、基本的なスモークテストを行うことができます。アドビは一部も提供しています。また、アップグレード先のバージョンだけでなくソースバージョンとターゲットバージョンの間のバージョンについても、廃止および削除された機能のリストを確認する必要があります。例えば、AEM 6.2 から 6.5 にアップグレードする場合、AEM 6.5 以外に AEM 6.3 の廃止および削除された機能を確認することが重要です。
最近導入されたパターン検出は、ほとんどの場合に、アップグレード中に予想される作業について非常に正確な予測を提供します。ただし、互換性のない変更点が存在する、より複雑なカスタマイズやデプロイメントの場合は、インプレースアップグレードの実行の手順に従い開発インスタンスを AEM 6.5 にアップグレードできます。完了したら、この環境で全体的なスモークテストを実行します。これを実施する目的は、テストケース一覧をすべて完了して不具合の正式な一覧を生成することではなく、6.5 と互換性が保たれるようにコードをアップグレードするために必要となる作業量の大まかな見積もりを示すことです。プロジェクト管理チームは、パターン検出と、前の節で特定したアーキテクチャの変更を組み合わせることで、アップグレード計画のためのおおよその見積もりを得ることができます。
アップグレードおよびロールバックのランブックの作成 building-the-upgrade-and-rollback-runbook
アドビは AEM インスタンスをアップグレードするためのプロセスを文書化していますが、それぞれの顧客のネットワークレイアウト、デプロイメントアーキテクチャおよびカスタマイズに合わせて、このアプローチの調整が必要になります。このため、アドビでは、提供されているドキュメントをすべて確認し、それを使用して、環境内で実行する具体的なアップグレードおよびロールバック手順の概要を示すプロジェクト固有のランブックを通知します。CRX2 からアップグレードする場合は、CRX2 から Oak への移行時にコンテンツ移行にかかる時間を評価してください。大きいリポジトリの場合は、かなり時間がかかります。
アップグレードおよびロールバック手順についてはアップグレード手順で、アップグレードを適用するためのステップごとの手順についてはインプレースアップグレードの実行で説明しています。これらの手順を確認し、システムアーキテクチャ、カスタマイズおよびダウンタイム許容度とともに考慮して、アップグレード時に実行する適切な切り替え手順およびロールバック手順を決定する必要があります。カスタマイズしたランブックのドラフト作成時には、アーキテクチャまたはサーバーサイズの変更を含める必要があります。これを最初のドラフトとして扱う必要があることに注意することが重要です。チームが QA と開発のサイクルを完了してアップグレードをステージング環境にデプロイするときに、追加手順が必要になることがよくあります。理想的には、このドキュメントが運用スタッフのメンバーに渡された場合に、含まれている情報によってアップグレードを完全に完了できるくらいに、このドキュメントに十分な情報が含まれている必要があります。
プロジェクト計画の作成 developing-a-project-plan
これまでの作業の成果物を使用して、テスト作業または開発作業の予期されるタイムライン、トレーニングおよび実際のアップグレード実行を含むプロジェクト計画を作成できます。
包括的なプロジェクト計画には、以下が含まれています。
- 開発計画およびテスト計画の確定
- 開発環境および QA 環境のアップグレード
- AEM 6.5 のカスタムコードベースの更新
- QA テストおよび修正サイクル
- ステージング環境のアップグレード
- 統合、パフォーマンスおよび負荷テスト
- 環境認定
- 実稼動
開発および QA の実行 performing-development-and-qa
アドビでは、AEM 6.5 と互換性を確保するためにコードのアップグレードとカスタマイズ手順を提供します。この反復プロセスが実行されると、必要に応じてランブックに変更を加える必要があります。通常、アップグレード後にすぐに開発作業を行うことなく、カスタマイズの後方互換性を保つ方法について詳しくは、AEM 6.5 における後方互換性も参照してください。
通常、開発とテストのプロセスは繰り返されます。カスタマイズが原因となり、アップグレード時に行われる変更によって製品のセクション全体が使用できなくなることがあります。開発者が問題の根本原因に対処してから、テストチームがこれらの機能にアクセスしてテストすると、別の問題が見つかる可能性があります。アップグレードプロセスの調整が必要な問題が見つかった場合は、それをカスタムアップグレードランブックに追加してください。テストと修正を何回か繰り返すと、コードベースは完全に検証され、ステージング環境へのデプロイメントの準備が整います。
最終テスト final-testing
アドビでは、コードベースが組織の QA チームによって認定された後に、最後のテストを実施することをお勧めします。このテストには、ステージング環境でのランブックの検証と、それに続くユーザー受け入れ、パフォーマンスおよびセキュリティのテストが含まれます。
この手順は、ランブックの手順を実稼動に近い環境で検証できる唯一の機会なので重要です。環境がアップグレードされたら、エンドユーザーがログインし、日常業務でシステムを使用する際のアクティビティを一通り行う時間を設けることが重要です。これまで考慮されなかったシステムの一部をユーザーが利用することもあります。このような領域で実稼動の前に問題を見つけて修正することは、損害が大きくなる実稼働での停止を防ぐために役立ちます。新しいバージョンの AEM では基盤となるプラットフォームが大きく変更されているので、初めて導入する場合と同様に、パフォーマンス、負荷およびセキュリティのテストをシステムで実行することも重要です。
アップグレードの実行 performing-the-upgrade
すべての関係者から最終承認を受けたら、定義されたランブック手順に基づいて実行します。アップグレードおよびロールバックの手順はアップグレード手順で、インストール手順はインプレースアップグレードの実行を参照してください。
アップグレード手順では、環境を検証するためのいくつかの手順が提供されています。これらの手順には、アップグレードログの調査やすべての OSGi バンドルが正しく起動することの確認のような基本的なチェックが含まれていますが、ビジネスプロセスに基づいて独自のテストケースを検証することもお勧めします。また、AEM のオンラインリビジョンクリーンアップおよび関連する定期的な作業のスケジュールをチェックして、それらが処理の少ない時間帯に実行されることを確認することもお勧めします。これらの定期的な作業は、AEM の長期的なパフォーマンスにとって重要です。