使用内容传输工具

使用内容传输工具的重要注意事项

请阅读以下章节,以了解运行内容传输工具时的重要注意事项:

  • 内容传输工具的最低系统要求为 AEM 6.3 + 和 JAVA 8。如果您使用的是较低版本的 AEM,则需要将内容存储库升级到 AEM 6.5,才能使用内容传输工具。

  • 需要在AEM环境上配置Java,这样java命令就可以由开始AEM的用户执行。

  • 在安装版本1.3.0时,建议卸载旧版内容传输工具,因为该工具在体系结构上发生了重大更改。 对于1.3.0,您还应创建新的迁移集,并重新运行新迁移集的提取和摄取。

  • 内容传输工具可用于以下类型的数据存储:文件数据存储、S3数据存储、共享的S3数据存储和Azure Blob存储数据存储。

  • 如果您使用​沙箱环境,请确保环境为最新版本并升级到最新版本。 如果您使用的是“生产环境”**,则会自动更新。

  • 要使用内容传输工具,您必须是源实例上的管理员用户,并且属于要将内容传输到的Cloud Service实例中的本地AEM administrators​组。 无特权的用户将无法检索访问令牌,进而无法使用内容传输工具。

  • 如果启用设置​在ingestion​之前擦除Cloud实例上的现有内容,则会删除整个现有存储库并创建新存储库以将内容收录到其中。 这意味着它会重置所有设置,包括目标Cloud Service实例的权限。 对于添加到​administrators​组的管理员用户,也是如此。 需要将用户重新添加到​administrators​组,以检索CTT的访问令牌。

  • 访问令牌可以在特定时间段后或Cloud Service环境升级后定期过期。 如果访问令牌已过期,您将无法连接到Cloud Service实例,您必须检索新访问令牌。 与现有迁移集关联的状态图标将更改为红色云,并且当您将鼠标悬停在该云上方时,将显示一条消息。

  • 在将内容从源实例传输到目标实例之前,内容传输工具不执行任何类型的内容分析。 例如,在将内容引入发布环境时,CTT不区分已发布和未发布的内容。 迁移集中指定的任何内容都将被引入所选的目标实例。 用户可以将迁移集引入Author实例或Publish实例中,或同时引入两者。 建议在将内容移至生产实例时,CTT应安装一个源作者实例,以将内容移至目标作者实例,并以同样方式在源Publish实例上安装CTT以将内容移至目标发布实例。

  • 由内容传输工具传输的用户和用户组只是内容满足权限要求的用户和用户组。 提取​进程将整个/home复制到迁移集中,而​Ingestion​进程将复制迁移内容ACL中引用的所有用户和组。 要自动将现有用户和用户组映射到其IMS ID,请参阅使用用户映射工具

  • 在提取阶段,内容传输工具将在活动 AEM 源实例上执行。

  • 在完成内容传输过程的​提取​阶段后,并在开始​摄取阶段​将内容作为Cloud Service 阶段​或​生产​实例引入AEM之前,您需要记录支持票证以通知Adobe您打算运行​Ingestion,以便Adobe可确保在​Ingestion​过程中不发生中断。 您需要在计划的​Ingestion​日期之前1周记录支持票证。 一旦您提交了支持票证,支持团队将提供后续步骤的指导。

    • 使用以下详细信息记录支持票证:
      • 计划开始​摄取​阶段时,确切日期和估计时间(与时区一起)。
      • 环境类型(舞台或生产),您计划将数据引入其中。
      • 项目ID。
  • 作者的​摄取阶段​将会按比例缩小整个作者部署。这意味着作者 AEM 在整个摄取过程中将不可用。另外,请确保在运行​Ingestion​阶段时未执行Cloud Manager管道。

可用性

内容传输工具可从软件分发门户下载为zip文件。 您可以通过包管理器在源 Adobe Experience Manager (AEM) 实例上安装该包。确保下载最新版本。 有关最新版本的详细信息,请参阅发行说明

注意

软件分发门户下载内容传输工具。

运行内容传输工具

请阅读以下章节,了解如何使用内容传输工具将内容迁移至 AEM as a Cloud Service (创作/发布):

  1. 选择Adobe Experience Manager并导航到工具 — > Operations -> 内容迁移

    图像

  2. 从​内容迁移​向导中选择​内容传输​选项。

    图像

  3. 创建第一个迁移集时将显示以下控制台。 单击​创建迁移集​以创建新的迁移集。

    图像

    注意

    如果您有现有的迁移集,控制台将显示现有迁移集的列表及其当前状态。

    此外,单击​创建用户映射配置​可访问用户映射工具

  4. 按如下所述填充​创建迁移集​屏幕中的字段。

    图像

    1. 名称:输入迁移集的名称。

      注意

      迁移集名称不允许使用特殊字符。

    2. Cloud Service 配置:输入目标 AEM as a Cloud Service 作者 URL。

      注意

      在内容传输活动期间,您一次最多可以创建和维护四个迁移集。
      此外,您还必须为每个特定的环境(暂存开发​或​生产)单独创建迁移。

    3. 访问令牌:输入访问令牌。

      注意

      可以使用​打开访问令牌​按钮检索访问令牌。 您需要确保您属于目标 Cloud Service实例中的AEM管理员组。

    4. 参数:选择以下参数以创建迁移集:

      1. 包含版本:根据需要选择。

      2. 包括来自IMS用户和组的映射:选择选项以包括来自IMS用户和组的映射。有关详细信息,请参阅用户映射工具

      3. 要包含的路径:使用路径浏览器选择需要迁移的路径。路径选取器通过键入或选择接受输入。

        重要

        创建迁移集时,以下路径受到限制:

        • /apps
        • /libs
        • /home
        • /etc (允 /etc 许在CTT中选择某些路径)
  5. 在​创建迁移集​详细信息屏幕中填充所有字段后,单击​保存

  6. 您将在​概述​页面中查看迁移集。

    图像

    此屏幕中的所有现有迁移集及其当前状态和状态信息都会显示在​概述​页面上。您可能会看到下面介绍的一些图标。

    • 红色云​表示您无法完成提取流程。
    • 绿色云​表示您可以完成完整的提取流程。
    • 黄色图标​表示您没有创建现有迁移集,而特定迁移集是由同一实例中的其他用户创建的。
  7. 从“概述”页面中选择一个迁移集,然后单击​属性​以查看或编辑迁移集属性。编辑属性时,无法更改容器名称或服务URL。

内容传输中的提取流程

请按照以下步骤从内容传输工具中提取迁移集:

  1. 从​概述​页面中选择一个迁移集,然后单击​提取​以开始提取。将显示​迁移集提取​对话框,并单击​Extract​以开始提取阶段。

    图像

    注意

    您可以选择在提取阶段覆盖暂存容器。

  2. 提取​字段现在显示​RUNNING​状态,以指示提取正在进行中。

    图像

    提取完成后,迁移集的状态将更新为​已完成,而且​信息​字段下会显示一个​纯绿色​的云朵图标。

    图像

    注意

    UI具有自动重新加载功能,每30秒重新加载一次概述页面。
    提取阶段启动后,将创建写锁定并在 60 秒后将其释放。因此,如果停止提取,则需要等待一分钟以便释放锁定,之后才能再次开始提取。

增补提取

内容传输工具具备支持差异内容增补的功能,借助该功能,您可以仅传输自上次内容传输活动以来所做的更改。

注意

初始内容传输完成后,建议在云服务上线之前,经常对差异内容进行增补,以缩短最终差异内容传输的内容冻结期。

完成提取流程后,可以使用增补提取方法传输增量内容。应遵循以下步骤:

  1. 导航到​概述​页面,然后选择要对其执行增补提取的迁移集。单击​提取​以开始增补提取。此时将显示​迁移集提取​对话框。

    重要

    您应该禁用​在提取期间覆盖暂存容器​选项。

    图像

内容传输中的摄取流程

请按照以下步骤从内容传输工具中摄取迁移集:

  1. 从​概述​页面中选择一个迁移集,然后单击​摄取​以开始提取。此时将显示​迁移集摄取​对话框。单击​收录​以开始摄取阶段。 否则其会将内容同时摄取到“创作”和“发布”。

    重要

    启用“在摄取​之前擦除Cloud实例上的现有内容”选项后,将删除整个现有存储库并创建新存储库以将内容摄取到其中。​这意味着它会重置所有设置,包括目标Cloud Service实例的权限。 对于添加到​administrators​组的管理员用户,也是如此。

    图像

    此外,单击​客户关怀​可记录票证,如上图所示。 另外,请参阅使用内容传输工具的重要注意事项以了解更多信息。

  2. 完成摄取后,PUBLISH INGESTION​字段中的状态将更新为​FINISHED

    图像

增补摄取

内容传输工具具备支持差异内容​增补​的功能,借助该功能,您可以仅传输自上次内容传输活动以来所做的更改。

注意

初始内容传输完成后,建议在云服务上线之前,经常对差异内容进行增补,以缩短最终差异内容传输的内容冻结期。

完成摄取流程后,可以使用增补摄取方法传输增量内容。应遵循以下步骤:

  1. 导航到​概述​页面,然后选择要对其执行增补摄取的迁移集。单击​摄取​以开始增补提取。此时将显示​迁移集摄取​对话框。

    图像

    重要

    您应禁用“在摄取​之前擦除Cloud实例上的现有内容”选项,以防止从以前的摄取活动中删除现有内容。​此外,单击​客户关怀​可记录票证,如上图所示。

查看迁移集的日志

完成每个步骤(提取和摄取)后,请检查日志并查找错误。 任何错误都应立即通过处理报告的问题或联系Adobe支持来解决。

您可以从​概述​页面查看现有迁移集的日志。应遵循以下步骤:

  1. 导航到​概述​页面并选择您要删除的迁移集,然后单击操作栏中的​查看日志

    图像

  2. 此时将显示​日志​对话框。单击​提取日志,以在新选项卡中查看日志。

    图像
    或者,

    您还可以从​概述​屏幕上查看迁移集的日志。选择迁移集,然后单击​提取​字段下的状态。在此例中,单击​已完成​以在新选项卡中查看日志。

    图像

  3. 要在不使用用户界面的情况下跟踪日志,您可以通过 SSH 连接到源 AEM 环境并跟踪 crx-quickstart/cloud-migration/extraction-XXXXX/output.log file

删除迁移集

您可以从​概述​页面删除迁移集。应遵循以下步骤:

  1. 导航到​概述​页面并选择您要删除的迁移集,然后单击操作栏中的​删除

    图像

  2. 单击​删除迁移集​对话框中的​删除​以确认删除。

    图像

疑难解答

缺少 Blob ID

如果报告缺少的 Blob ID(如下所述),则表明需要在现有存储库中执行一致性检查并还原缺少的 Blob。
ERROR o.a.j.o.p.b.AbstractSharedCachingDataStore - Error retrieving record [ba45c53f8b687e7056c85dceebf8156a0e6abc7e]

执行以下命令

注意

--verbose标记在报告从中引用 Blob 的节点路径时需要使用。

对于存储库 AEM 6.5(Oak 1.8 及更低版本)

java -jar oak-run.jar datastorecheck --consistency --store [<SEGMENT_STORE_PATH>|<MONGO_URI>] --[s3ds|fds] <DATASTORE_CFG> --verbose <OUT_DIR> --dump

对于拥有 Oak 1.10 以上版本的存储库

java -jar oak-run.jar datastore --check-consistency [<SEGMENT_STORE_PATH>|<MONGO_URI>] --[s3ds|fds|azureds] <DATASTORE_CFG> --out-dir <OUT_DIR> --work-dir <TEMP_DIR> --verbose

有关更多详细信息,请参阅 Oak Runnable Jar

可以检查在上述指定 OUT_DIR 中为保持一致性而创建的文件是否存在缺少二进制文件的路径,以及是否执行了相应操作,例如从备份中还原、删除路径、重建索引等。

UI 行为

作为用户,您可能会在内容传输工具的用户界面 (UI) 中看到以下行为更改:

  • 内容传输工具 UI 中的图标可能与本指南中显示的屏幕截图有所不同,也可能根本不显示,这取决于源 AEM 实例的版本。

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now