JEEとOSGiのサービスパック間のAEM Forms 6.5のアップグレード
AEM Formsのお客様は、AEM 6.5 サービスパック間を移行する際に、正しいアップグレードパスが不明になる可能性があります。これは、Forms コンポーネントがメインのAEM サービスパックとは別に出荷され、JEEおよびOSGi デプロイメントが異なるインストールフローを使用するからです。 Adobeでは、サービスパックごとに複数のパッケージ（JEE累積インストーラー、OSGi アドオン、ホットフィックス、互換性パッケージ）が配布されるため、特定の環境に適用されるパッケージを簡単に特定できます。 これは構成に関する質問であり、ソフトウェアの欠陥ではありません。 ランタイムタイプを特定し、現在のバージョンを確認し、適切なパッケージを適切な順序でインストールすると、クリーンなアップグレードが生成されます。
説明 description
問題：JEEおよびOSGiの正しいAEM Forms 6.5 サービスパックのアップグレードパスを選択する
説明
あるAEM 6.5 サービスパックから別のサービスパック（SP18からSP24、SP20からSP23、SP24のホットフィックス付きSP23など）に移行すると、適用されるパッケージとインストール手順について質問が発生します。 よくある質問では、直接アップグレードがサポートされているかどうか、既存のホットフィックスを最初に削除する必要があるかどうか、どのForms アドオンをインストールするか、どのJEE パッチインストーラーが必要か、およびWebSphere、JBoss、Windows、Linuxなどのプラットフォーム要件の処理方法について説明します。
環境：
- AEM Forms 6.5 （オンプレミス）
- OSGi ランタイム
- JEE ランタイム （WebSphere、WebLogic、JBoss）
- WindowsおよびLinux プラットフォーム
問題/症状：
- 同じサービスパックに対する複数のアドオンビルドなど、インストールするAEM Forms サービスパックまたはアドオンに関する不確実性
- 直接アップグレードパスがサポートされているかどうかに関する混乱（SP18→SP24またはSP20→SP23など）
- 新しいサービスパックを適用する前に、既存のホットフィックスを削除する必要があるかどうかについての質問
- JEE パッチが必要な場合とOSGi アドオンパッケージの場合のガイダンスが明確でない
根本原因：
AEM Formsのアップグレードでは、Forms コンポーネントはメインのAEM サービスパックとは別に配信され、JEEとOSGiのデプロイメントでは異なるパッチフローとインストールフローが使用されるため、プラットフォームに依存する手順が必要です。 Adobeでは、サービスパックごとに複数のパッケージ（JEE累積インストーラー、OSGi アドオン、ホットフィックス、互換性パッケージ）が配布されるため、特定の環境に適用されるパッケージを誤って解釈しやすくなります。 問題は構成の不確実性であり、ソフトウェアの欠陥ではありません。
確認方法
- ランタイムタイプを特定します。 AEMにログインし、
/lcが存在するかどうかを確認します。/lc/loginが読み込まれる場合はJEEです。/aem/start.htmlのみが読み込まれる場合はOSGiです。 JEE環境では、EAR/WAR ファイルとConfiguration Managerを使用します。 - 現在のサービスパックのバージョンを確認します。
/system/console/productinfoに移動し、「インストール済み製品」セクション （例：Adobe Experience Manager (6.5.23.0)）を確認します。 - プラットフォームの互換性を確認。 アップグレードする前に、OS、Java、アプリケーションサーバー、データベースのバージョンを、サポートされているプラットフォームのマトリックスと比較します。
解決策 resolution
-
開始サービスパックに基づいて、正しいアップグレードパスを選択してください：
- SP18またはSP20では、SP24またはSP23への直接アップグレードがサポートされています。
- SP11から、基盤となるプラットフォーム コンポーネントをまずアップグレードしてから、SP24に移行します。
- SP23でホットフィックスを使用している場合は、正常に続行し、ホットフィックスを削除しないでください。サービスパックは累積的です。
-
OSGi — メインのAEM 6.5 サービスパックをインストールします：
aem-service-pkg-6.5.xx.x.zipをCRX Package Managerにアップロードし、 インストール をクリックします。/system/console/productinfoにアクセスして、SP バージョンの更新を確認し、すべてのバンドルがACTIVEまたはFRAGMENTであることを確認してください。 インストールが失敗した場合は、error.logで依存関係エラーを確認してください。 -
OSGi – 正しいForms アドオンパッケージをインストールします： サービスパックとプラットフォームに一致するアドオンビルドを特定してインストールします。
/system/console/bundlesを確認して、AEM Forms バンドルがACTIVE状態であることを確認します。 インストールに失敗した場合は、AEMを再起動して再試行してください。 -
OSGi – 関連する場合にのみ追加のホットフィックスをインストールします。 Granite セキュリティホットフィックスなどの必要な修正を適用します。
/system/console/productinfoで更新されたコンポーネントを確認し、ソフトウェア配布の詳細ページでホットフィックスの前提条件を確認します。 -
JEE – 関連するJEE パッチインストーラーをインストールします。 ターゲットサービスパックのJEE パッチインストーラーを実行します。 Configuration Managerが更新されたバージョンを認識することを確認します。 失敗した場合は、Configuration Manager ログを収集します。
-
JEE — アプリケーションサーバーを再起動： ネイティブアプリケーションサーバースクリプトを使用して、WebSphere、WebLogic、またはJBossのクリーンな再起動を実行します。 アプリケーションサーバーのログにデプロイメントエラーがないことを確認します。 EARのデプロイに失敗した場合は、欠落しているJNDI エントリ、データソースまたはリポジトリパスを確認します。
-
完全なアップグレード（JEEおよびOSGi）の検証： AEMにログインし、アダプティブ Forms、ワークフロー、およびその他のForms機能の読み込みを確認します。 バンドルと製品情報のページを確認し、
error.logでパッケージが見つからないか、依存エラーがないか確認します。
検証
/system/console/productinfoに移動し、SP バージョンが正しく表示されることを確認します（例：Adobe Experience Manager (6.5.24.0)）。- すべてのOSGi バンドルが
/system/console/bundles経由でACTIVEまたはFRAGMENTであることを確認してください。 - JEEの場合、再起動後にアプリケーションサーバーのログを確認して、エラーなしでデプロイされたすべてのEARを確認します。
- 基本的なForms ワークフローを実行するか、アダプティブフォームをレンダリングして、ランタイムの安定性を確認します。