将内容提取到云服务中 ingesting-content
Cloud Acceleration Manager 中的引入流程 ingestion-process
请按照以下步骤使用Cloud Acceleration Manager摄取迁移集：
-
转到Cloud Acceleration Manager。 单击项目信息卡，然后单击内容传输信息卡。 导航到 引入作业 并单击 新建引入
-
查看摄取核对清单，并确保已完成所有步骤。 要确保成功引入，必须执行以下步骤。 继续到 下一个 仅当核对清单完成时执行此步骤。
-
提供创建引入所需的信息。
- 迁移集： 选择包含提取的数据作为源的迁移集。
- 迁移集将在长时间不活动后过期，因此预计摄取将在执行提取后不久进行。 审核 迁移集到期 以了解详细信息。
note tip TIP 如果提取正在运行，则对话框将指示该情况。 成功完成提取后，摄取将自动开始。 如果提取失败或停止，则提取作业将撤销。 -
目标： 选择目标环境。 在此环境中摄取迁移集的内容。
- 摄取不支持快速开发环境(RDE)或预览类型的目标，并且即使用户有权访问，摄取也不会显示为可能的目标选择。
- 虽然可将迁移集同时引入到多个目标中，但目标一次只能是一个正在运行或正在等待引入的目标。
-
层： 选择层。 （创作/发布）。
- 如果源是
Author，建议将其摄取到Author对目标进行分层。 同样，如果源是Publish，目标应为Publish也一样。
- 如果源是
note note NOTE 如果目标层为 Author时，创作实例会在摄取期间关闭，并对用户（例如，作者或执行维护的任何人）不可用。 原因是为了保护系统，并防止任何可能丢失或导致引入冲突的更改。 确保您的团队了解此事实。 另请注意，环境在创作引入期间似乎处于休眠状态。-
擦除： 选择
Wipe值- 此 擦除 选项设置目标的摄取起点。 如果 擦除 之后，包括其所有内容的目标将被重置为Cloud Manager中指定的AEM版本。 如果未启用，则目标会保持其当前内容作为起点。
- 此选项会 NOT 会影响执行内容摄取的方式。 摄取始终使用内容替换策略和 非 内容合并策略，因此 擦除 和 非划出 在这种情况下，摄取迁移集将会覆盖目标上同一路径中的内容。 例如，如果迁移集包含
/content/page1并且目标已包含/content/page1/product1，摄取将删除整个page1路径及其子页面，包括product1，并将其替换为迁移集中的内容。 这意味着在执行 非划出 摄取到包含应维护的任何内容的目标。
note important IMPORTANT 如果设置 擦除 为摄取启用，它会重置整个现有Cloud Service，包括目标存储库实例的用户权限。 对于添加到中的管理员用户，此重置也为true 管理员 并且必须再次将该用户添加到管理员组才能开始引入。 -
预复制： 选择
Pre-copy值- 您可以运行可选的预复制步骤，以显着加快引入速度。 请参阅 使用AzCopy引入 以了解更多详细信息。
- 如果使用预复制引入（对于S3或Azure数据存储），建议运行
Author仅先摄取。 这样做可以加快Publish摄取。
note important IMPORTANT 仅当属于本地环境时，才能启动到目标环境的引入 AEM管理员 Cloud Service创作服务上的组。 如果您无法开始引入，请参阅 无法开始引入 以了解更多详细信息。 - 迁移集： 选择包含提取的数据作为源的迁移集。
-
选择摄取选项后，将会显示其估计持续时间。 这是基于类似摄取的历史数据的最佳估计。
- 此估算仅在提取的“检查大小”值已收集并且可用时才会计算并显示。
- 该值是一个估计值，虽然可以智能计算，但不应视为精确值。 各种因素都会改变实际持续时间。
- 在摄取运行期间，该值还将在持续时间对话框中可用，可通过"查看持续时间”引入操作。
-
单击 摄取.
-
然后，您可以从“摄取作业”列表视图中监视摄取，并使用摄取的操作菜单查看持续时间并记录摄取进度。
-
单击 (i) 按钮，以了解有关摄取作业的详细信息。 您可以通过单击来查看摄取操作在运行或完成时每个步骤的持续时间 …，然后单击 查看持续时间. 该提取中的信息还显示出来，以实现所摄取的内容。
增补引入 top-up-ingestion-process
内容传输工具具备允许通过执行 增补 迁移集的URL。 这样可修改迁移集，使其仅包含自上次提取以来已更改的内容，而无需再次提取所有内容。
要在完成某些摄取后摄取差异内容，您必须运行 增补提取，然后结合使用摄取方法和 擦除 option 已禁用. 请务必阅读 擦除 ，以避免丢失目标上已有的内容。
从创建引入作业开始，并确保 擦除 在摄取期间被禁用，如下所示：
疑难解答 troubleshooting
CAM无法检索迁移令牌 cam-unable-to-retrieve-the-migration-token
自动检索迁移令牌可能会由于各种原因而失败，其中包括您 通过Cloud Manager设置IP允许列表 在目标Cloud Service环境中。 在这种情况下，当您尝试开始摄取时，您将看到以下对话框：
通过单击对话框中的“获取令牌”链接，手动检索迁移令牌。 此时将打开另一个显示令牌的选项卡。 然后，您可以复制令牌并将其粘贴到 迁移令牌输入 字段。 现在，您应该能够开始引入。
无法开始引入 unable-to-start-ingestion
仅当属于本地环境时，才能启动到目标环境的引入 AEM管理员 Cloud Service创作服务上的组。 如果您不属于AEM管理员组，则在尝试开始引入时会看到如下所示的错误。 您可以请求管理员将您添加到本地 AEM管理员 或者询问令牌本身，然后您可以将它粘贴到 迁移令牌输入 字段。
无法访问迁移服务 unable-to-reach-migration-service
请求引入后，可能会向用户显示如下消息：“无法访问目标环境中的迁移服务。 如果是这样的话，请稍后重试或与Adobe支持人员联系。”
此消息表示Cloud Acceleration Manager无法访问目标环境的迁移服务以开始引入。 这种情况可能由于各种原因出现。
- AEMas a Cloud Service会维护环境状态，有时由于各种正常原因必须重新启动迁移服务。 如果该服务正在重新启动，则无法访问，但最终可用。
- 可能正在实例上运行另一个进程。 例如，如果 AEM版本更新 正在应用更新，系统可能忙，并且迁移服务定期不可用。 完成此过程后，可以再次尝试开始引入。
- 如果 已应用IP允许列表 它通过Cloud Manager阻止Cloud Acceleration Manager访问迁移服务。 无法为摄取添加IP地址，因为其地址是动态的。 目前，唯一的解决方案是在摄取和索引过程中禁用IP允许列表。
- 可能有其他原因需要调查。 如果摄取或索引继续失败，请联系Adobe客户关怀部门。
AEM版本更新和引入 aem-version-updates-and-ingestions
AEM版本更新 自动应用于环境以使其使用最新的AEMas a Cloud Service版本保持最新。 如果在执行摄取时触发更新，则可能会导致不可预测的结果，包括环境损坏。
如果“AEM版本更新”已载入目标程序，则摄取进程会尝试在启动之前禁用其队列。 完成摄取后，版本更新程序状态将返回到摄取开始前的状态。
如果“AEM版本更新”处于活动状态（即，更新正在运行或排队等待运行），则摄取将不会开始，并且用户界面会显示以下消息。 更新完成后，可以开始引入。 Cloud Manager可用于查看项目管道的当前状态。
因唯一性约束违规导致的追加数据引入失败 top-up-ingestion-failure-due-to-uniqueness-constraint-violation
导致此问题的常见原因 增补摄取 失败是节点ID中的冲突。 要识别此错误，请使用Cloud Acceleration Manager UI下载摄取日志，并查找如下条目：
java.lang.RuntimeException： org.apache.jackrabbit.oak.api.CommitFailedException： OakConstraint0030：违反了唯一性约束 [jcr：uuid] 值为a1a1a1a1-b2b2-c3c3-d4d4-e5e5e5e5e5： /some/path/jcr：content， /some/other/path/jcr：content
AEM中的每个节点都必须具有一个唯一的uuid。 此错误表示正在摄取的节点具有与目标实例上不同路径中存在的节点相同的uuid。 发生这种情况有两个原因：
- 在源上提取和后续操作之间移动节点 增补提取
- 记住：对于增补提取，节点仍将存在于迁移集中，即使它在源上不再存在。
- 目标上的节点会在摄取和后续增补摄取之间移动。
必须手动解决此冲突。 熟悉内容的用户必须确定必须删除这两个节点中的哪个节点，并牢记引用该节点的其他内容。 解决方案可能要求再次执行增补提取而不考虑违规节点。
无法删除引用节点导致追加数据引入失败 top-up-ingestion-failure-due-to-unable-to-delete-referenced-node
导致问题的另一个常见原因 增补摄取 失败是目标实例上特定节点的版本冲突。 要识别此错误，请使用Cloud Acceleration Manager UI下载摄取日志，并查找如下条目：
java.lang.RuntimeException： org.apache.jackrabbit.oak.api.CommitFailedException： OakIntegrity0001：无法删除引用的节点：8a2289f4-b904-4bd0-8410-15e41e0976a8
如果在引入和后续引入之间修改了目标上的节点，则可能会发生这种情况 非划出 摄取，以便创建一个新版本。 如果在启用“包含版本”的情况下提取迁移集，则可能会发生冲突，因为目标现在具有版本历史记录和其他内容所引用的较新版本。 摄取进程无法删除违规版本节点，因为它已被引用。
解决方案可能要求再次执行增补提取而不考虑违规节点。 或者，创建一个包含违规节点的小型迁移集，但禁用“包含版本”。
最佳实践表明 非划出 摄取必须使用包括版本的迁移集运行，在迁移历程完成之前，尽可能少地修改目标上的内容至关重要。 否则，可能会发生这些冲突。
由于节点属性值过大导致引入失败 ingestion-failure-due-to-large-node-property-values
MongoDB中存储的节点属性值不能超过16 MB。 如果节点值超过支持的大小，摄取将失败，并且日志将包含 BSONObjectTooLarge 错误并指定哪个节点超过了最大值。 这是MongoDB限制。
请参阅 Node property value in MongoDB 注释 内容传输工具的先决条件 以获取更多信息以及可帮助查找所有大型节点的Oak工具链接。 修复所有大小较大的节点后，再次运行提取和摄取。
引入已取消 ingestion-rescinded
使用正在运行的提取作为其源迁移集创建的摄取将耐心等待，直到提取成功，此时将正常开始。 如果提取失败或停止，则不会开始摄取及其索引作业，而是将取消摄取及其索引作业。 在这种情况下，请检查提取以确定其失败的原因，修复问题并重新开始提取。 运行固定提取后，可以计划新的引入。
重新运行引入后已删除的资源不存在
通常，不建议在两次引入之间修改云环境数据。
使用资产触屏UI从Cloud Service目标中删除资产时，虽然会删除节点数据，但不会立即删除包含图像的资产Blob。 它被标记为删除，因此不再出现在UI中；但是，它一直保留在数据存储中，直到发生垃圾收集并删除blob为止。
在删除以前迁移的资产，并在垃圾回收器完成删除资产之前运行下次摄取的情况下，摄取同一迁移集将不会恢复已删除的资产。 当摄取在云环境中检查资产时，没有节点数据；因此，摄取会将节点数据复制到云环境。 但是，当检查blob存储时，它会看到blob存在，并跳过对blob的复制。 这就是为什么当您从触屏UI查看资产时，元数据在摄取后出现，而图像却没有。 请记住，迁移集和内容摄取并非旨在处理这种情况。 他们的目标是向云环境添加新内容，而不是恢复以前迁移的内容。
后续内容 whats-next
摄取成功后，AEM索引将自动开始。 请参阅 迁移内容后编制索引 以了解更多信息。
完成将内容摄取到Cloud Service中后，您可以查看每个步骤（提取和摄取）的日志并查找错误。 请参阅 查看迁移集的日志 了解更多信息。