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

可用性 availability

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

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

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

源环境连接 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. 通过转到,导航到源实例上的Adobe Experience Manager Web Console “工具”>“操作”>“Web控制台” 或直接访问位于的URL https://serveraddress:serverport/system/console/configMgr

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

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

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

    图像

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

运行内容转移工具 running-tool

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

提取设置阶段 extraction-setup-phase

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

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

    图像

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

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

    图像

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

    图像

    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
    请确保提取密钥有效并且不在到期之前。 您可以将此信息放在 创建迁移集 对话框。 如果出现连接错误,请参见 源环境连接 以了解更多信息。

    图像

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

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

      图像

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

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

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

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

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

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

  1. 选择迁移集并单击 检查大小.

    图像

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

    图像

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

    图像

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

    图像

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

后续内容 whats-next

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

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