バージョン、OS、JBoss、プラットフォームの互換性に関するAEM Forms JEE アップグレードガイダンス

JEE上のAEM Formsをアップグレードするお客様(新しいサービスパックへの移行、RHEL バージョン間の移行、6.5.xと6.5 LTSの選択)は、続行する前に、サポートされているプラットフォームの確実な確認が必要です。 AEM Forms on JEEでは、OS、JBoss、Java、データベースの各レイヤーに厳密な互換性が適用されます。また、サポートされている組み合わせは、Adobeのプラットフォームマトリックスに含まれていますが、特定の環境にマッピングする必要があります。 この検証をスキップすると、サポートされていないバイナリをインストールしたり、成功しないアップグレードパスにコミットしたりするリスクがあります。 OS、JBoss、Javaの組み合わせをマトリックスに対して確認し、適切なインストーラーを取得し、サービスパックまたはLTS アップグレードを順番に適用すると、不確実性が解決されます。

説明 description

環境:

  • JEE上のAdobe Experience Manager Forms
  • Adobe Experience Manager 6.5 (オンプレミス)
  • Adobe Experience Manager 6.5 LTS
  • JBoss EAP 7.4.xおよびJBoss EAP 8
  • Red Hat Enterprise LinuxおよびWindows Server

問題/症状:

  • どのAEM Forms バージョンがRHEL 8、RHEL 9、Windows Server 2022などの特定のOS プラットフォームをサポートしているかについては不明です。
  • 特定のAEM Forms リリースの互換性のあるJBoss EAPまたはJava バージョン(JBoss 7.4.22 SP22、Java 17、21 LTSなど)については、不確かです。
  • このリクエストは、ブレイク/フィックストラブルシューティングではなく、サポートされているプラットフォーム、インストーラーの可用性、前提条件、アップグレードシーケンスを確実に確認するためのものです。

根本原因:

JEE上のAEM Formsでは、OS、JBoss、Java、およびデータベースのレイヤー間で厳密な互換性が適用されるため、組み合わせは、サービスパックをアップグレードまたは適用する前に検証する必要があります。 Adobeでは、サポートされている組み合わせをプラットフォームマトリックスで文書化していますが、環境への適切な解釈とマッピングが必要です。 サポートされている組み合わせを確認しないと、サポートされていないバイナリをインストールしたり、アップグレードパスを計画したりするリスクがあります。

解決策 resolution

問題を解決するには、次の手順に従います。

  1. 現在のAEM Forms JEE バージョンとプラットフォームコンポーネントを特定します。 OS バージョン、JBoss EAP バージョン、Java バージョン、およびデータベースタイプを収集します。 java -versionを実行し、JBoss EAP コンソールのバージョンを確認し、RHELでcat /etc/redhat-releaseなどのOS リリースコマンドを実行して確認します。
  2. ターゲットがサービスパックのアップグレードかLTSの移行かを判断します。 6.5 LTSにはJava 17または21とJBoss EAP 8が必要ですが、6.5.x サービスパックのアップグレードはJava 8または11とJBoss 7.4.xに残ります。 これは、ターゲットが6.5.24 (SP24)か6.5 LTSかを示します。
  3. 公式のサポート対象プラットフォームのマトリックスを使用して、プラットフォームサポートを検証します。 OS (RHEL 8、RHEL 9、またはWindows Server 2022)とJBoss バージョンがターゲットバージョンのマトリックスに表示されることを確認します。 プラットフォームが表示されない場合は、アップグレードする前に明示的にサポートされているOSおよびJBoss バージョンを選択します。
  4. OSの移行(RHEL 7からRHEL 8またはRHEL 8からRHEL 9)の場合、実現可能性を確認します。 RHEL 8はSP11以降を必要とし、RHEL 9はSP23およびSP24をサポートしています。 マトリックスでサポートされているバージョンにターゲット OSを一致させます。 お使いのバージョンがターゲット OSをサポートしていない場合は、新しいサーバーを使用して、その場での移行を計画します。
  5. SP23 フルインストーラー、SP24 パッチ、Forms アドオンなど、Adobe Software Distributionから正しいフルインストーラーとサービスパックをダウンロードします。 ファイル名がaemforms_server_6_5_0_jboss_all_unix.tar.gzadobe-aem-forms-jee-servicepack-6.5.24.0-win-jboss.zipなどのパターンと一致します。 ソフトウェア配布にファイルが表示されない場合は、Admin ConsoleでAdobe IDの使用権限が正しいことを確認してください。
  6. アップグレードの準備。 CRXのディレクトリ、GDS、TEMP、データベースをバックアップし、バックアップが存在することを確認してから続行します。
  7. 新しいAEM Forms JEE フルインストーラーをインストールします。 JBossを起動し、/lcが読み込まれることを確認します。 デプロイメントに失敗した場合は、JBoss ログでデプロイメントエラーを確認し、OS ライブラリを検証します。
  8. 最新のサービスパック(SP24)とForms アドオンを適用します。 LinuxまたはWindowsにJBoss用SP24 パッチをインストールし、SP24 OSGi コンポーネント(サーブレットフラグメント、サービスパック、Forms アドオン)をインストールします。 バンドルがローリングエラーの発生を停止することを確認するには、/lc/system/console/bundlesを確認してください。 正しくない場合は、サーブレットフラグメントを再インストールするか、error.logで依存関係が欠落していないかどうかを確認します。
  9. JBoss アップグレードの場合は、必要な環境変数を確認します。 JBoss EAP 7.4.xのアップグレード時にDISABLE_JDK_SERIAL_FILTER = true​を設定し、シリアル化エラーなしでJBossが開始することを確認します。 シリアル化エラーが解決しない場合は、JBoss起動スクリプトで変数が正しく書き出されていることを確認します。
  10. アップグレードされた環境を検証します。 JBossを起動して/adminuiにアクセスし、PDF Generator、Workbench接続、Reader Extensionsなどの主要モジュールをテストします。 新しいスタックトレースまたはローリングメッセージについては、error.logを確認してください。

関連トピックス

recommendation-more-help
experience-cloud-kcs-help-kbarticles