使用内容传输工具的准则和最佳实践 guidelines
准则和最佳实践 best-practices
内容传输工具将内容传输过程与Cloud Acceleration Manager集成在一起。 使用此版本(2.0或更高版本,但现在建议使用版本3.0)才能获得它提供的所有好处:
- 一次性提取迁移集并将它并行摄取到多个环境中的自助方式
- 通过更好的加载状态、护栏和错误处理来改善用户体验
- 摄取日志将保留,并且始终可用于进行故障排除
要开始使用最新版本,请卸载旧版内容传输工具。 使用版本2.0及更高版本,您可以创建迁移集,并对迁移集重新运行提取和摄取。
不支持低于2.0.0的版本,建议您使用最新版本。
以下准则和最佳实践适用于内容传输工具的新版本:
-
在摄取阶段,Adobe建议您在删除目标Adobe Experience Manager (AEM)Cloud Service环境中的现有存储库(创作或Publish)的情况下启用 划出 模式来运行摄取。 然后,使用迁移集数据更新。 此模式比非划出模式更快,在非划出模式下,迁移集将应用于当前内容的顶部。
-
内容传输活动完成后,需要在云服务环境中使用正确的项目结构,才能确保内容在云服务环境中成功呈现。
-
运行内容传输工具之前,必须确保源 AEM 实例的
crx-quickstart
子目录中有足够的磁盘空间。这是因为内容传输工具会创建存储库的本地副本,以便稍后将其上传到迁移集。计算所需可用磁盘空间的一般公式如下:data store size + node store size * 1.5
-
数据存储大小:内容传输工具使用 64 GB,即使实际数据存储更大也是如此。
-
节点存储大小:区段存储目录大小或 MongoDB 数据库大小。因此,对于 20 GB 的区段存储大小,所需的可用磁盘空间将为 94 GB。
-
必须在整个内容传输活动中维护迁移集,以支持内容增补。 在内容传输活动期间,Cloud Acceleration Manager中一次最多可以为每个项目创建和维护10个迁移集。 如果需要超过10个迁移集,请在Cloud Acceleration Manager中创建第二个项目。 但是,这需要额外的项目管理和产品外管理,以避免多个用户覆盖Target上的内容。
-
避免更改CTT工具的安装目录。 默认情况下,安装在crx-quickstart/cloud-migration路径中进行。 此特定位置由其他库在内部使用。 修改此路径可能会导致提取问题。
使用内容传输工具之前的重要注意事项 important-considerations
请阅读以下章节,以了解运行内容传输工具时的重要注意事项:
-
内容传输工具的最低系统要求为AEM 6.3 +和Java™ 8。 如果您使用的是较低版本的AEM,请将内容存储库升级到AEM 6.5以使用内容传输工具。
-
必须在AEM环境中配置Java™,以便启动AEM的用户能够执行
java
命令。 -
内容传输工具可用于以下类型的数据存储:文件数据存储、S3数据存储、共享S3数据存储和Azure Blob存储数据存储。
-
如果您使用的是 沙盒环境,请确保您的环境为最新版本并已升级到最新版本。 如果您使用的是“生产环境”**,则会自动更新。
-
要开始引入,您必须属于要向其传输内容的Cloud Service实例中的本地AEM 管理员 组。 如果未手动提供迁移令牌,则无权限用户无法开始引入。
-
如果启用了设置 在摄取之前擦除云实例上的现有内容 选项,它将删除整个现有存储库并创建一个新存储库以将内容摄取到。 这意味着它会重置所有设置,包括目标Cloud Service实例上的权限。 对于添加到 管理员 组的管理员用户也是如此。 必须将该用户读入 管理员 组,才能检索内容传输工具的访问令牌。
-
提取密钥的有效期为自创建或续订密钥后的14天。 可以随时续订。 如果提取密钥已过期,则无法执行提取。
-
在将内容从源实例传输到目标实例之前,内容传输工具(CTT)不执行任何类型的内容分析。 例如,将内容摄取到Publish环境中时,CTT不区分已发布和未发布的内容。 迁移集中指定的任何内容都将摄取到所选的目标实例中。 用户可以将迁移集摄取到创作实例或Publish实例,或同时摄取两者。 Adobe建议在将内容移动到生产实例时,在源创作实例上安装CTT以将内容移动到目标创作实例。 同样,在源Publish实例上安装CTT以将内容移动到目标Publish实例。 有关更多详细信息,请参阅在Publish实例上运行内容传输工具。
-
内容传输工具传输的组只是内容为满足权限所需的组。 提取 进程将整个
/home/groups
复制到迁移集中。 有关详细信息,请参阅组迁移。 摄取 进程复制迁移的内容ACL中引用的所有组。 有关在封闭用户组(CUG)策略中使用的组的额外注意事项,请参阅迁移封闭用户组。 -
在提取阶段,内容传输工具将在活动 AEM 源实例上执行。
-
作者的 摄取阶段 缩小了整个作者部署。 这意味着创作AEM在整个摄取过程中不可用。 同时确保在运行 摄取 阶段时没有执行Cloud Manager管道。
-
使用
Amazon S3
或Azure
作为源AEM系统上的数据存储时,应配置数据存储以便不能删除存储的Blob(垃圾收集)。 这将确保索引数据的完整性,如果未能按此方式进行配置,则可能会导致因此索引数据缺乏完整性而导致提取失败。 -
如果使用自定义索引,则必须确保在运行内容传输工具之前使用
tika
节点配置自定义索引。 有关详细信息,请参阅准备新索引定义。 -
如果要执行增补,则现有内容的内容结构不得从进行初始提取时更改为运行增补提取时。 无法对自初始提取以来结构已更改的内容运行增补。 确保在迁移过程中对此进行限制。
-
如果您打算将版本包含在迁移集中,并使用
wipe=false
执行增补,则由于“内容传输工具”中的当前限制,必须禁用版本清除。 如果您希望启用版本清除,并且正在对迁移集执行增补,则必须作为wipe=true
执行引入。 -
内容传输工具(CTT)不支持合并引入。 要将来自多个系统的内容合并到单个Cloud Service实例中,只能迁移来自一个源系统的版本。 此过程需要使用带有wipe=false参数的迁移,由于此操作的增量性质,这可能会导致引入时间延长。 如果可能,请在开始迁移之前将内容整合到单个源系统中,以消除合并内容的需要。
-
迁移集在长时间不活动后过期,此后其数据将不再可用。 有关更多详细信息,请查看迁移集到期。
后续内容 whats-next
了解使用内容传输工具的指南、最佳实践和重要注意事项后,您现在就可以开始安装和使用工具了,从创建迁移集开始。 请参阅内容传输工具快速入门。