从AEM 6.0迁移UGC至AEM 6.3的步骤及包制作问题咨询

我来帮你梳理从AEM 6.0迁移UGC到AEM 6.3的具体步骤，亲测可行，你可以跟着一步步来：

一、迁移前准备工作 #

• 确保源AEM 6.0实例和目标AEM 6.3实例都处于稳定运行状态，暂时关闭不必要的后台任务避免干扰
• 备份源实例的UGC数据（通常存储在/content/usergenerated路径下），同时备份目标实例的对应路径，防止导入出错回滚
• 确认目标实例已经安装好所有必要的UGC相关依赖包，比如Communities相关组件，确保版本兼容6.3

二、从AEM 6.0导出UGC数据 #

• 你可以用AEM的CRXDE Lite或者命令行工具crx2oak来导出UGC内容：
  • 命令行方式示例：

    java -jar crx2oak.jar --source http://admin:admin@aem60-host:4502/crx/server --target ./ugc-export.zip --include-path /content/usergenerated
    

  • 如果用CRXDE Lite操作更直观：直接右键/content/usergenerated节点，选择"Export"，勾选"Include subnodes"和"Include versions"（如果需要保留版本历史），导出为zip包
• 导出完成后一定要检查zip包内容，确认包含所有需要迁移的UGC节点，比如评论、评分、用户上传的媒体等

三、预处理导出的UGC数据（关键步骤） #

• 先解压导出的zip包，找到jcr_root/content/usergenerated下的.content.xml属性文件
• 替换AEM 6.0特有的属性和节点类型为6.3兼容的格式：
  • 比如把旧的cq:social前缀的节点类型替换为sling:social（符合6.3的Communities规范）
  • 检查并更新所有引用的用户ID、路径，确保目标实例中对应的用户已经存在（如果用户数据也需要迁移，得先完成用户迁移）
• 处理媒体文件：确认所有上传的图片、视频等二进制文件路径正确，在zip包中保持完整的目录结构

四、导入UGC数据到AEM 6.3 #

• 同样可以用crx2oak命令行工具或者CRXDE Lite的导入功能：
  • 命令行方式示例：

    java -jar crx2oak.jar --source ./ugc-export.zip --target http://admin:admin@aem63-host:4502/crx/server
    

  • CRXDE Lite操作：右键目标路径/content/usergenerated，选择"Import"，选择预处理后的zip包，跟着向导完成导入
• 导入过程中要实时查看日志，遇到错误（比如节点类型不兼容、权限问题）及时调整，必要时修改导入参数

五、迁移后验证与修复 #

• 登录目标AEM 6.3实例，导航到Communities相关页面，检查UGC内容是否正确显示：比如评论是否加载正常、用户上传的媒体是否能正常访问
• 测试UGC的交互功能：比如新增评论、评分，确保原有数据不会影响新功能的使用
• 修复权限问题：确保目标实例中对应用户有访问和修改UGC的权限，必要时调整ACL设置
• 清理临时文件：删除导出的zip包和预处理的临时文件夹，避免占用服务器空间

内容的提问来源于stack exchange，提问作者Gyanendra