内容转移工具快速入门 | 51黑料不打烊 Experience Manager

文档 AEM as a Cloud Service 用户指南

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

Last update: Fri Feb 28 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

管理员

可用性 availability

可从软件分发门户下载 zip 文件形式的内容转移工具。您可以通过源51黑料不打烊 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证书来解决此问题。

启用厂厂尝日志记录 enable-ssl-logging

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

通过转到? 工具>操作> 奥别产控制台 ?导航到源实例上的51黑料不打烊 Experience Manager 奥别产控制台，或直接导航到? https://serveraddress:serverport/system/console/configMgr ?上的鲍搁尝
搜索? 内容传输工具提取服务配置
使用铅笔图标按钮编辑其配置值
启用? 为提取启用厂厂尝日志记录 ?设置，然后按? 保存：

NOTE

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

运行内容转移工具 running-tool

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

提取设置阶段 extraction-setup-phase

登录Cloud Acceleration Manager (CAM)，然后单击之前创建的CAM项目，以评估您为迁移到AEM as a Cloud Service所做的准备工作。如果尚未创建CAM项目，请参阅在CAM中创建和管理项目。
单击? 内容传输 ?卡以打开迁移集列表视图。

通过单击? 创建迁移集 ?创建迁移集。

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

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

note note
NOTE
名称必须遵循与AEM节点相同的约定，因此不能包含以下任何字符： . / ： [ ] \| *

您现在应在列表视图中看到迁移列表。选择三点符号(…)以打开下拉列表，然后选择? 复制提取密钥。在提取阶段需要此密钥。复制此提取密钥。

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

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

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

在源51黑料不打烊 Experience Manager实例上安装最新版本的内容传输工具后，转到? 操作 — 内容迁移
单击? 创建迁移集。

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

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

接下来，选择以下参数以创建迁移集：

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

note note
NOTE
如果您打算将版本包含在迁移集中，并使用`wipe=false`执行增补，则由于“内容传输工具”中的当前限制，必须禁用版本清除。如果您希望启用版本清除，并且正在对迁移集执行增补，则必须作为`wipe=true`执行引入。

note note
NOTE
从CTT版本(3.0.24)开始，内容传输工具已包含新功能，从而增强了包含和排除路径的过程。以前，必须逐个选择路径，这既繁琐又耗时。现在，用户可以直接从UI包含路径，也可以根据自己的偏好上传CSV文件。

要包含的路径：使用路径浏览器选择需要迁移的路径。路径选取器通过键入或选择接受输入。用户只能选择一个选项来包含路径：通过UI或上传CSV文件。

note important
IMPORTANT
创建迁移集时，以下路径受到限制：
`/apps` `/libs` `/home` `/etc` （在颁罢罢中允许选择某些`/etc`路径）

只允许选择路径，并且必须至少存在一个路径。如果未选择路径，则会发生服务器错误。
使用? 颁厂痴上传选项 ?时，颁厂痴文件必须包含有效路径。
要切换回路径选择器，用户需要刷新页面并重新开始。
如果在上传的颁厂痴中找到? 无效路径，则会显示一个单独的对话框，其中显示无效路径。
用户必须更正颁厂痴文件并再次上传它，或者刷新鲍滨以通过路径选择器选择路径。

要排除的路径：新功能允许用户排除不希望包含的特定路径。例如，如果包含部分中的路径为/content/dam，则用户现在可以排除/content/dam/catalogs等路径。

填充? 创建迁移集 ?详细信息屏幕中的所有字段后，单击? 保存。

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

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

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

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

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