将AEM Forms从Red Hat JBoss迁移到Adobe捆绑的JBoss

本文介绍了如何将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期间,可能会出现以下问题:

  • 由于凭据存储别名不匹配,出现数据源配置错误。
  • SQL Server连接URL语法不正确,例如使用::1433而不是:1433。
  • 所需EAR文件的部署状态问题。
  • 访问Configuration Manager启动URL时,Configuration Manager的 验证服务器连接 步骤失败,出现HTTP 401或HTTP 404错误。
  • 启动后出现RMServiceEJBHelper ClassNotFoundException或DSC调用错误。

原因

迁移可能会显示配置不匹配,如凭据存储别名和连接URL语法,以及缺少配置管理器所需的资源。 解决这些问题以确保成功迁移和运行环境。

解决方法 resolution

请按照以下步骤解决问题:

  1. 通过备份现有Red Hat JBoss环境和所有相关配置文件,并记录所有自定义配置、数据源和已部署的应用程序,为迁移做好准备。
  2. 按照适用于您版本的官方Adobe文档,安装AEM Forms的Adobe捆绑式JBoss环境。
  3. 通过更新数据源配置文件以引用正确的凭据存储别名,迁移数据源配置。 如果Adobe迁移脚本创建新的别名,请确保数据源引用这些别名,或使用正确的数据库密码将所需的别名添加到凭据存储区。 更正所有SQL Server连接URL语法错误,并确保端口指定为:1433,而不是::1433。
  4. 使用适用于您的配置文件和环境的相应命令启动JBoss以部署应用程序组件。 手动部署所需的EAR文件,并验证所有部署均显示“正常”状态。
  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