内容转移工具快速入门 getting-started-content-transfer-tool
可用性 availability
可从软件分发门户下载 zip 文件形式的内容转移工具。您可以通过源Adobe Experience Manager (AEM)实例上的包管理器安装该包。 确保下载最新版本。 有关最新版本的更多详细信息,请参阅发行说明。
仅支持版本2.0.0及更高版本,建议使用最新版本。
Source环境连接 source-environment-connectivity
源AEM实例可能正在防火墙后面运行,在该防火墙中,它只能访问已添加到允许列表的特定主机。 要成功运行提取,需要从运行AEM的实例访问以下端点:
- Azure Blob存储服务:
casstorageprod.blob.core.windows.net
启用SSL日志记录 enable-ssl-logging
了解SSL/TLS连接问题有时可能很困难。 要对提取过程中的连接问题进行故障诊断,可通过源AEM环境的“系统控制台”启用SSL日志记录,步骤如下:
-
通过转到 工具>操作> Web控制台 导航到源实例上的Adobe Experience Manager Web控制台,或直接导航到 https://serveraddress:serverport/system/console/configMgr 上的URL
-
搜索 内容传输工具提取服务配置
-
使用铅笔图标按钮编辑其配置值
-
启用 为提取启用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中创建的迁移集,请在源Adobe Experience Manager (AEM)实例上安装最新版本的内容传输工具。 要了解如何填充迁移集,请参阅此部分。
-
在源Adobe Experience Manager实例上安装最新版本的内容传输工具后,转到 操作 — 内容迁移
-
单击 创建迁移集。
-
将之前从CAM复制的提取密钥粘贴到 创建迁移集 表单的提取密钥输入字段中。 执行此操作后,迁移集名称和Cloud Acceleration Manager (CAM)项目名称字段会自动填充。 这些名称应与CAM中的“迁移集”名称和您创建的CAM项目名称匹配。 您现在可以添加内容路径。 添加内容路径后,保存迁移集。 您可以使用包含或排除的版本运行提取。
note note NOTE 请确保提取密钥有效并且不在到期之前。 粘贴提取密钥后,您可以在 创建迁移集 对话框中获取此信息。 如果收到连接错误,请参阅Source环境连接以了解更多信息。 -
接下来,选择以下参数以创建迁移集:
-
包含版本:根据需要选择。 当包含版本时,将自动包含路径
/var/audit
以迁移审核事件。note note NOTE 如果您打算将版本包含在迁移集中,并使用 wipe=false
执行增补,则由于“内容传输工具”中的当前限制,必须禁用版本清除。 如果您希望启用版本清除,并且正在对迁移集执行增补,则必须作为wipe=true
执行引入。 -
要包含的路径:使用路径浏览器选择需要迁移的路径。 路径选取器通过键入或选择接受输入。
note important IMPORTANT 创建迁移集时,以下路径受到限制: /apps
/libs
/home
/etc
(在CTT中允许选择某些/etc
路径)
-
-
填充 创建迁移集 详细信息屏幕中的所有字段后,单击 保存。
确定迁移集大小 migration-set-size
创建迁移集后,强烈建议先对迁移集运行大小检查,然后再启动提取流程。
通过对迁移集运行大小检查,您能够:
- 确定
crx-quickstart
子目录中是否有足够的磁盘空间以成功完成提取。 - 确定迁移集大小是否在受支持的产品限制之内,并避免内容摄取失败。
按照以下步骤运行大小检查:
-
选择一个迁移集,然后单击 检查大小。
-
这将打开 检查大小 对话框。
-
单击 检查大小 以启动进程。 然后,您将返回到迁移集列表视图,并且您应该会看到一条消息,指示 检查大小 正在运行。
-
检查大小 进程完成后,状态将更改为 已完成。 选择相同的迁移集,然后单击 检查大小 以查看结果。 以下是 检查大小 结果无警告的示例。
-
如果 检查大小 结果指示磁盘空间不足,或迁移集超出产品限制,或两者都超出,则会显示 警告 状态。
后续内容 whats-next
了解如何创建迁移集后,您现在就可以了解内容传输工具中的提取和摄取流程了。 在学习这些流程之前,您必须先查看处理大型内容存储库,以显着加快内容传输活动的提取和摄取阶段,从而将内容移动到AEM as a Cloud Service。