内容转移工具快速入门 getting-started-content-transfer-tool

可用性 availability

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

仅支持版本2.0.0及更高版本,建议使用最新版本。

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

Source环境连接 source-environment-connectivity

NOTE
如果从Cloud Acceleration Manager中删除了迁移集,也可能会发生连接错误。

源AEM实例可能正在防火墙后面运行,在该防火墙中,它只能访问已添加到允许列表的特定主机。 要成功运行提取,需要从运行AEM的实例访问以下端点:

  • Azure Blob存储服务: casstorageprod.blob.core.windows.net
NOTE
如果提取由于以下错误而失败:“javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX路径构建失败: sun.security.provider.certpath.SunCertPathBuilderException:无法找到请求的目标的有效证书路径”,则可以通过导入相关的CA证书来解决此问题。

启用SSL日志记录 enable-ssl-logging

了解SSL/TLS连接问题有时可能很困难。 要对提取过程中的连接问题进行故障诊断,可通过源AEM环境的“系统控制台”启用SSL日志记录,步骤如下:

  1. 通过转到​ 工具>操作> Web控制台 ​导航到源实例上的Adobe Experience Manager Web控制台,或直接导航到​ https://serveraddress:serverport/system/console/configMgr ​上的URL

  2. 搜索​ 内容传输工具提取服务配置

  3. 使用铅笔图标按钮编辑其配置值

  4. 启用​ 为提取启用SSL日志记录 ​设置,然后按​ 保存

    图像

NOTE
此标记仅用于调试SSL问题。 请确保在运行提取之前禁用该标志,因为它可能需要大量磁盘空间。 这可能会占用驱动器容量,并导致提取过程失败。

运行内容转移工具 running-tool

以下部分适用于内容传输工具的新版本。 请阅读以下章节,了解如何使用内容传输工具将内容迁移到AEM as a Cloud Service:

提取设置阶段 extraction-setup-phase

  1. 登录Cloud Acceleration Manager (CAM),然后单击之前创建的CAM项目,以评估您为迁移到AEM as a Cloud Service所做的准备工作。 如果尚未创建CAM项目,请参阅在CAM中创建和管理项目。

  2. 单击​ 内容传输 ​卡以打开迁移集列表视图。

    图像

  3. 通过单击​ 创建迁移集 ​创建迁移集。

    note note
    NOTE
    在Cloud Acceleration Manager中,每个项目最多可以创建10个迁移集,包括过期的迁移集。

    图像

    将显示以下对话框。 请注意,迁移集将在长时间不活动后过期。 在项目信息卡和迁移作业表行上显示一段时间内的警告后,迁移集将过期,并且其数据将不再可用。 有关详细信息,请查看迁移集过期

    图像

    note note
    NOTE
    名称必须遵循与AEM节点相同的约定,因此不能包含以下任何字符: . / : [ ] | *
  4. 您现在应在列表视图中看到迁移列表。 选择三点符号()以打开下拉列表,然后选择​ 复制提取密钥。 在提取阶段需要此密钥。 复制此提取密钥。

    note note
    NOTE
    通过提取密钥,您的源AEM环境可安全地连接到迁移集。 请像对待密码一样谨慎对待此密钥,切勿通过不安全的媒介(如电子邮件)共享此密钥。

    图像

填充迁移集 populating-the-migration-set

要填充您在Cloud Acceleration Manager中创建的迁移集,请在源Adobe Experience Manager (AEM)实例上安装最新版本的内容传输工具。 要了解如何填充迁移集,请参阅此部分。

  1. 在源Adobe Experience Manager实例上安装最新版本的内容传输工具后,转到​ 操作 — 内容迁移

  2. 单击​ 创建迁移集

    图像

  3. 将之前从CAM复制的提取密钥粘贴到​ 创建迁移集 ​表单的提取密钥输入字段中。 执行此操作后,迁移集名称和Cloud Acceleration Manager (CAM)项目名称字段会自动填充。 这些名称应与CAM中的“迁移集”名称和您创建的CAM项目名称匹配。 您现在可以添加内容路径。 添加内容路径后,保存迁移集。 您可以使用包含或排除的版本运行提取。

    note note
    NOTE
    请确保提取密钥有效并且不在到期之前。 粘贴提取密钥后,您可以在​ 创建迁移集 ​对话框中获取此信息。 如果收到连接错误,请参阅Source环境连接以了解更多信息。

    图像

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

    1. 包含版本:根据需要选择。 当包含版本时,将自动包含路径/var/audit以迁移审核事件。

      图像

      note note
      NOTE
      如果您打算将版本包含在迁移集中,并使用wipe=false执行增补,则由于“内容传输工具”中的当前限制,必须禁用版本清除。 如果您希望启用版本清除,并且正在对迁移集执行增补,则必须作为wipe=true执行引入。
    2. 要包含的路径:使用路径浏览器选择需要迁移的路径。 路径选取器通过键入或选择接受输入。

      note important
      IMPORTANT
      创建迁移集时,以下路径受到限制:
      • /apps
      • /libs
      • /home
      • /etc (在CTT中允许选择某些/etc路径)
  5. 填充​ 创建迁移集 ​详细信息屏幕中的所有字段后,单击​ 保存

确定迁移集大小 migration-set-size

创建迁移集后,强烈建议先对迁移集运行大小检查,然后再启动提取流程。
通过对迁移集运行大小检查,您能够:

  • 确定crx-quickstart子目录中是否有足够的磁盘空间以成功完成提取。
  • 确定迁移集大小是否在受支持的产品限制之内,并避免内容摄取失败。

按照以下步骤运行大小检查:

  1. 选择一个迁移集,然后单击​ 检查大小

    图像

  2. 这将打开​ 检查大小 ​对话框。

    图像

  3. 单击​ 检查大小 ​以启动进程。 然后,您将返回到迁移集列表视图,并且您应该会看到一条消息,指示​ 检查大小 ​正在运行。

    图像

  4. 检查大小 ​进程完成后,状态将更改为​ 已完成。 选择相同的迁移集,然后单击​ 检查大小 ​以查看结果。 以下是​ 检查大小 ​结果无警告的示例。

    图像

  5. 如果​ 检查大小 ​结果指示磁盘空间不足,或迁移集超出产品限制,或两者都超出,则会显示​ 警告 ​状态。

后续内容 whats-next

了解如何创建迁移集后,您现在就可以了解内容传输工具中的提取和摄取流程了。 在学习这些流程之前,您必须先查看处理大型内容存储库,以显着加快内容传输活动的提取和摄取阶段,从而将内容移动到AEM as a Cloud Service。

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab