内容转移工具快速入门

上次更新： 2023-11-30

主题：

创建对象：

可用性

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

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

注意

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

源环境连接

注意

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

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

Azure Blob存储服务： casstorageprod.blob.core.windows.net

注意

如果提取由于以下错误而失败：“javax.net.ssl.SSLHandshakeException： sun.security.validator.ValidatorException： PKIX路径构建失败： sun.security.provider.certpath.SunCertPathBuilderException：无法找到请求的目标的有效证书路径”，则可以通过导入相关的CA证书来解决此问题。

启用SSL日志记录

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

通过转到，导航到源实例上的Adobe Experience Manager Web Console 工具 — 操作 — Web控制台 或直接访问位于的URL https://serveraddress:serverport/system/console/configMgr
搜索 内容传输工具提取服务配置
使用铅笔图标按钮编辑其配置值
启用 为提取启用ssl日志记录 设置，然后按保存：

注意

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

运行内容传输工具

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

提取设置阶段

登录Cloud Acceleration Manager (CAM)，然后单击之前创建的CAM项目，以评估您为迁移到AEMas a Cloud Service所做的准备情况。如果尚未创建CAM项目，请参阅在CAM中创建和管理项目。
单击 内容传输 卡片。这会将您转到迁移集列表视图。
通过单击创建迁移集 创建迁移集.

注意

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

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

注意

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

注意

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

填充迁移集

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

在源Adobe Experience Manager实例上安装最新版本的内容传输工具后，请转到 操作 — 内容迁移
单击 创建迁移集
将之前从CAM复制的提取密钥粘贴到的提取密钥输入字段 创建迁移集 表单。执行此操作后，迁移集名称和Cloud Acceleration Manager (CAM)项目名称字段会自动填充。这些名称应与CAM中的“迁移集”名称和您创建的CAM项目名称匹配。您现在可以添加内容路径。添加内容路径后，保存迁移集。您可以使用包含或排除的版本运行提取。

注意

请确保提取密钥有效并且未接近其过期时间。您可以将此信息放在 创建迁移集 对话框。如果出现连接错误，请参见源环境连接以了解更多信息。
接下来，选择以下参数以创建迁移集：
1. 包含版本：根据需要选择。当包含版本时，路径 /var/audit 将自动包含以迁移审核事件。
  
  注意
  
  如果您打算将版本作为迁移集的一部分包括在内，并使用执行增补 wipe=false时，由于内容传输工具中的当前限制，您必须禁用版本清除。如果您希望启用版本清除，并且要对迁移集执行增补，则必须按以下方式执行引入 wipe=true.
2. 要包含的路径：使用路径浏览器选择需要迁移的路径。路径选取器通过键入或选择接受输入。
  重要
  创建迁移集时，以下路径受到限制：
  - /apps
  - /libs
  - /home
  - /etc (部分 /etc 允许在CTT中选择路径)
单击保存填充 创建迁移集 详细信息屏幕。

确定迁移集大小

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

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

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

选择迁移集并单击 检查大小.
这将打开 检查大小 对话框。
单击 检查大小 以启动进程。然后，您将返回到迁移集列表视图，并且您应该会看到一条消息，指示 检查大小 正在运行。
之后 检查大小 进程已完成，状态将更改为 已完成. 选择相同的迁移集并单击 检查大小 查看结果。以下是示例 检查大小 结果没有警告。
如果 检查大小 结果指示磁盘空间不足，或者迁移集超出产品限制，或者两者都超出警告将显示状态。