将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
请按照以下步骤解决问题:
- 通过备份现有Red Hat JBoss环境和所有相关配置文件,并记录所有自定义配置、数据源和已部署的应用程序,为迁移做好准备。
- 按照适用于您版本的官方Adobe文档,安装AEM Forms的Adobe捆绑式JBoss环境。
- 通过更新数据源配置文件以引用正确的凭据存储别名,迁移数据源配置。 如果Adobe迁移脚本创建新的别名,请确保数据源引用这些别名,或使用正确的数据库密码将所需的别名添加到凭据存储区。 更正所有SQL Server连接URL语法错误,并确保端口指定为
:1433,而不是::1433。 - 使用适用于您的配置文件和环境的相应命令启动JBoss以部署应用程序组件。 手动部署所需的EAR文件,并验证所有部署均显示“正常”状态。
- 通过测试所有配置的数据源并确认成功连接来验证数据库连接。
- 通过访问AEM Forms管理UI并检查
/lc/system/console/bundles页面上所有捆绑包是否均处于活动状态,验证服务器和应用程序的状态。 使用Configuration Manager运行验证服务器连接步骤。 如果在Configuration Manager启动URL处遇到HTTP 401或HTTP 404错误,请确认资源存在并且存储库路径正确。 如果缺少资源,但DSC组件已部署和处于活动状态,则可能不会影响当前实施。 在下次安装修补程序并运行完整的Configuration Manager后,该问题可能会得到解决。 - 通过调查任何
ClassNotFoundException或DSC调用错误、查看日志并确保部署所有必需的组件来解决剩余错误。
通过确认所有服务正在运行、捆绑包处于活动状态以及数据库连接成功来验证迁移是否成功。
recommendation-more-help
experience-cloud-kcs-help-kbarticles