使用内容传输工具

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

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

  • 内容传输工具的最低系统要求为 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​组。 无特权的用户将无法检索访问令牌,进而无法使用内容传输工具。

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

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

  • 内容传输工具(CTT)在将内容从源实例传输到目标实例之前,不会执行任何类型的内容分析。 例如,CTT在将内容摄取到发布环境时,不会区分已发布和未发布的内容。 迁移集中指定的任何内容都将被摄取到所选目标实例中。 用户能够将迁移集摄取到创作实例或发布实例中,或同时摄取到两者中。 建议在将内容移动到生产实例时,在源创作实例上安装CTT以将内容移动到目标创作实例,同样,在源发布实例上安装CTT以将内容移动到目标发布实例。

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

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

  • 完成内容传输流程的​提取​阶段后,在开始​摄取阶段​以将内容作为Cloud Service 暂存​或​生产​实例摄取到AEM之前,您将需要记录支持票证以通知Adobe您打算运行​摄取,以便Adobe可以确保在​摄取A1/>流程期间不会发生中断。​您需要在计划的​摄取​日期之前1周记录支持票证。 一旦您提交了支持票证,支持团队将就后续步骤提供指导。 您可以记录支持票证,其中包含以下详细信息:

    • 计划启动​摄取​阶段时的确切日期和预计时间(包含您的时区)。
    • 您计划将数据摄取到的环境类型(暂存或生产)。
    • 程序ID。
  • 作者的​摄取阶段​会按比例缩小整个作者部署。 这意味着作者 AEM 在整个摄取过程中将不可用。另外,请确保在运行​Ingestion​阶段时不执行Cloud Manager管道。

  • Amazon S3Azure用作源AEM系统上的数据存储时,应配置数据存储,以便无法删除存储的Blob(垃圾收集)。 这确保了索引数据的完整性,并且未能配置这种方式,可能会由于此索引数据缺乏完整性而导致提取失败。

  • 如果使用自定义索引,则必须确保在运行内容传输工具之前使用tika节点配置自定义索引。 有关更多详细信息,请参阅准备新索引定义

  • 如果您打算进行增补,则必须从采用初始提取到运行增补提取期间,不更改现有内容的内容结构。 无法对自初始提取以来结构已更改的内容运行增补。 请确保在迁移过程中限制此操作。

可用性

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

注意

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

运行内容传输工具

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

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

    图像

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

    图像

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

    图像

    注意

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

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

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

    图像

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

      注意

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

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

      注意

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

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

      注意

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

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

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

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

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

        重要

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

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

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

    图像

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

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

内容传输中的提取流程

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

注意

如果使用Amazon S3或Azure Data Store作为数据存储的类型,则可以运行可选的预复制步骤以显着加快提取阶段。 为此,您需要先配置azcopy.config文件,然后再运行提取。 有关更多详细信息,请参阅处理大内容存储库

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

    图像

    注意

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

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

    图像

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

    图像

    注意

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

增补提取

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

注意

初始内容传输完成后,建议在云服务上线之前,经常对差异内容进行增补,以缩短最终差异内容传输的内容冻结期。
此外,必须从采用初始提取到运行增补提取时,不要更改现有内容的内容结构。 无法对自初始提取以来结构已更改的内容运行增补。 请确保在迁移过程中限制此操作。

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

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

    重要

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

    图像

内容传输中的摄取流程

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

注意

如果使用Amazon S3或Azure Data Store作为数据存储的类型,则可以运行可选的预复制步骤以显着加快摄取阶段。 有关更多详细信息,请参阅使用AzCopy摄取

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

    重要

    如果使用带有预复制的摄取(对于S3或Azure数据存储),则建议先运行创作摄取。 这将在稍后运行发布摄取时加快其速度。

    重要

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

    图像

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

  2. 完成摄取后, 发布摄取​字段中的状态将更新为​已完成

    图像

增补摄取

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

注意

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

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

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

    图像

    重要

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

查看迁移集的日志

完成每个步骤(提取和摄取)后,检查日志并查找错误。 任何错误都应立即通过处理报告的问题或联系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 实例的版本。

在此页面上