ドキュメントExperience Cloud KCS

Red Hat JBossからAdobe バンドル JBossへのAEM Formsの移行

最終更新日： 2026年10月30日

この記事では、Adobe Experience Manager（AEM）FormsをRed Hat JBoss インストールからAdobe バンドル JBoss環境に移行し、一般的な移行の問題を解決する方法について説明します。

説明 description

環境

Adobe Experience Manager（AEM）Forms（すべてのバージョン）

問題/症状

Red Hat JBossでAEM Formsを使用している組織は、AdobeにバンドルされたJBoss環境に移行する必要がある場合があります。 移行すると、構成の不一致やデプロイメントの問題、特にデータソース設定、資格情報ストアのエイリアス、アプリケーションのデプロイメントが発生する可能性があります。

Red Hat JBossからAdobe バンドル JBossへの移行中に、次の問題が発生する可能性があります。

  • 資格情報ストアのエイリアスが一致しないため、データソース設定エラーが発生しました。
  • :1433ではなく::1433を使用するなど、SQL Server接続URLの構文が正しくありません。
  • 必要なEAR ファイルのデプロイメントステータスの問題。
  • Configuration Managerの サーバー接続の確認手順は、Configuration Managerの起動URLにアクセスする際にHTTP 401またはHTTP 404 エラーで失敗します。
  • 起動後に、RMServiceEJBHelper ClassNotFoundExceptionまたはDSC呼び出しエラーなどのエラーが発生します。

原因

移行では、資格情報ストアのエイリアスや接続URL構文などの設定の不一致を公開したり、Configuration Managerで必要なリソースが欠落したりする可能性があります。 移行と運用環境を成功させるために、これらの問題に対処します。

解決策 resolution

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

  1. 既存のRed Hat JBoss環境とすべての関連する設定ファイルをバックアップし、すべてのカスタム設定、データソース、デプロイ済みアプリケーションを文書化して、移行に備えます。
  2. お使いのバージョンのAdobeの公式ドキュメントに従って、AEM Forms用のAdobe バンドル JBoss環境をインストールします。
  3. データソース設定ファイルを更新して、正しい資格情報ストアのエイリアスを参照することで、データソース設定を移行します。 Adobe移行スクリプトで新しいエイリアスが作成された場合は、データソースがこれらのエイリアスを参照することを確認するか、正しいデータベースパスワードを使用して必要なエイリアスを資格情報ストアに追加します。 SQL Server接続URLの構文エラーを修正し、ポートが::1433ではなく:1433として指定されていることを確認します。
  4. 設定ファイルと環境に適したコマンドを使用してJBossを起動し、アプリケーションコンポーネントをデプロイします。 必要なEAR ファイルを手動でデプロイし、すべてのデプロイメントにステータス OKが表示されていることを確認します。
  5. 設定されたすべてのデータソースをテストし、接続が成功したことを確認することで、データベースの接続を検証します。
  6. AEM Forms管理UIにアクセスし、すべてのバンドルが/lc/system/console/bundles ページでアクティブであることを確認して、サーバーとアプリケーションのステータスを確認します。 Configuration Managerを使用して、サーバー接続の検証手順を実行します。 Configuration Managerのスタートアップ URLでHTTP 401またはHTTP 404 エラーが発生した場合は、リソースが存在し、リポジトリパスが正しいことを確認します。 リソースが見つからないが、DSC コンポーネントが既にデプロイされ、アクティブになっている場合、現在の実装には影響しない可能性があります。 この問題は、次のパッチのインストールとConfiguration Managerの完全な実行後に解決する可能性があります。
  7. 残りのエラーに対処するには、ClassNotFoundExceptionまたはDSC呼び出しエラーを調査し、ログを確認し、必要なすべてのコンポーネントがデプロイされていることを確認します。

すべてのサービスが実行され、バンドルがアクティブであり、データベース接続が成功していることを確認して、移行の成功を確認します。

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