本文介绍了如何排查在设置 Google Workspace Migrate 和进行迁移时可能遇到的问题。
排查关联或连接错误
查看服务主机日志- 要查找日志，请执行以下操作：
- 如果是安装平台，请前往 C:\Program Files\Google Workspace Migrate\Google Workspace Migrate Platform\AppBridgeServiceHost.log。
- 如果是安装节点，请前往 C:\Program Files\Google Workspace Migrate\Google Workspace Migrate Platform Node\AppBridgeServiceHost.log。
注意：如果您使用的是早期版本的 Google Workspace Migrate，则可能需要在路径中使用 G Suite 而不是 Google Workspace。
- 打开日志并滚动到末尾。
- 如果有任何相关问题，请进行问题排查。
您可以放心忽略以下消息：“Access denied: Symmetric encryption is required for this service request but not configured”（访问遭拒：这项服务请求需要对称加密，但并未配置）。
- 如果您无法解决问题，请参阅就 Google Workspace Migrate 问题与支持团队联系。
- 登录 Google Workspace Migrate 平台，然后点击右上角的 Servers（服务器）。
- 确认节点是否显示在列表中。
- 检查节点是否处于“Ready”（就绪）状态，即显示为绿色。
如果您在尝试将节点与 Google Workspace Migrate 平台关联时遇到错误，请检查该节点是否正在运行：
- 在运行此平台的计算机的浏览器中，输入节点的 IP 地址和端口（例如 http://192.0.2.1:5131）。
- 如果平台可以连接节点，且节点服务正在运行，您会收到“Node is running”（节点正在运行）消息。
- 如果您收到错误消息，请尝试以下方法：
- 如果是网络连接错误，请先解决，然后重试。
- 重启节点服务。
- 重新安装节点应用。如需详细操作步骤，请参阅安装节点服务器。
如果您遇到此错误，请执行以下操作：
- 查看节点服务器的服务主机日志。
如需了解详情，请参阅查看服务主机日志。
- 检查是否出现以下错误：The provided platform host address https://platformserver:443/Hub was unreachable。
- 如果您看到此错误，请尝试以下方法：
- 检查与平台服务器的网络连接。如果发现网络问题，请解决问题并重启节点服务。
- 如果平台配置了 TLS 证书，请在运行该平台的计算机上，打开一个浏览器并输入该平台的 IP 地址和端口（例如：https://192.0.2.1:5131）。此外，请确认 TLS 证书有效且未过期。
如果主机日志中显示 invalid_grant 消息，请检查以下方面：
- 您是否为目标账号启用了所有 API 范围。如需了解详情，请参阅使用 Google Cloud Console 启用 API。
- 服务账号是否已在 Google 管理控制台中获得了所需范围的授权。请使用您的 OAuth 2.0 客户端 ID 进行授权，而不要使用服务账号的客户端 ID。如需了解详情，请参阅创建 OAuth Web 客户端 ID。
如果迁移速度缓慢或者完全未迁移，那么该错误可能与 Google Workspace 的 API 配额等级有关。有关详情，请参阅使用配额。
跟踪迁移的运行状况和进度
监控子任务运行扫描或迁移桥时，您可以监控子任务的状态。
- 在 Google Workspace Migrate 平台中，点击 Scans（扫描）或 Bridges（迁移桥）。
- 在您要检查的扫描或迁移桥上，点击“Logs”（日志）图标
Partition log（子任务日志）。
- 在 State（状态）下，检查子任务的状态：
- Ready（准备就绪）- 准备好开始。
- Starting（即将开始）- 正在准备迁移或扫描。
- Crawling（正在抓取）- 正在从源系统读取数据。
- Processing（正在处理）- 正在准备向目标系统写入数据。
- Committing（正在提交）- 正在将数据写入目标系统。
- Cancelled（已取消）- 失败。请参阅针对取消的子任务进行问题排查。
- Completed（已完成）- 已完成工作。
- Skipped（已跳过；会在重试失败时显示）- 由于没有失败而跳过。
如果您在子任务日志中看到状态为 Canceled（已取消）的子任务，请使用以下方法进行问题排查。
方法 1：检查错误代码
如需查找错误代码，请将光标指向子任务日志中的某一行，然后点击“More”（更多）图标 Partition log（子任务日志）。请使用与失败操作关联的错误代码进行问题排查。如需了解详情，请参阅解读 Google Workspace Migrate 错误消息。
方法 2：检查节点
使用子任务日志检查节点上的所有子任务是否均已取消。如果所有节点都已取消，则通常表示是连接问题，例如源服务暂时不可用。请完成关联节点时出错中所述的步骤，然后重新尝试扫描或运行增量迁移。
方法 3：检查子任务执行日志
如果问题影响了多个节点，您可以检查子任务执行日志。如需查看与某个子任务关联的执行日志，请执行以下操作：
- 打开相应的子任务日志。
- 将光标指向日志中的某一行，然后点击“More”（更多）图标
- 点击 State（状态）
- 查看失败情况，以找出和排查问题的原因。
- 重新尝试扫描或迁移。
如果迁移摘要中的类似失败情况有所增加，则说明您的迁移配置可能有误。
请检查以下配置项，确保它们设置无误：
- 确保各种 API（尤其是 Admin SDK）已在 Google 管理控制台中正确启用。如需了解详情，请参阅使用 Google Cloud Console 启用 API。
- 确保源账号和 Google Workspace Migrate 中存在用户账号，并确认账号未被冻结、暂停或重命名。
- 确认所有用户都已启用必要的 Google Workspace Migrate 服务（例如 Gmail 或 Google 云端硬盘）。如需了解详情，请参阅 Google Workspace 使用要求。
如果您在主机日志中看到此错误，则可能需要允许第三方应用处理云端硬盘文件。
如需解决此问题，请按照允许第三方应用处理云端硬盘中存储的文件中的步骤操作。
修正迁移桥错误
运行迁移桥进行增量迁移您通常可以通过运行增量迁移来修复许多错误。通过增量迁移，可找出反复出现的错误并清理临时性问题，例如速率限制和配额等级、网络问题和 401 错误。您可以多次运行某一项增量迁移来进行问题排查。如需了解详情，请参阅准备开始使用。
| 60008 错误或关键字 | 问题排查步骤 |
|---|---|
| No mapping found (找不到映射). | 如果您要将共享云端硬盘数据从一个 Google Workspace Migrate 账号迁移到另一个账号，并在新账号中手动创建了共享云端硬盘，则可能会发生此错误。问题排查步骤： |
| 受影响的内容所依赖的处理操作失败。 | 查看同一个迁移桥中其他迁移失败的内容，并排查问题。解决问题后，请运行增量迁移桥。 |
|
父级对象迁移失败。 您可能还会看到“The bridge execution was halted or completed prior to dependency of the transaction being completed”（在所依赖的处理操作完成之前，执行的迁移桥已经停止或完成）。 |
受影响内容的父级对象迁移失败，或者子级对象已在父级对象之前迁移。问题排查步骤： |
| 目标父级实体在迁移后被移除、重命名或移至其他位置。如果其他迁移桥尝试再次迁移来源父级实体或子级实体，则无法找到这些实体。 | |
| 来源-目标映射对不受支持。 | 请检查映射，确保来源位置和目标位置均有效。如需了解详情，请参阅针对 Exchange、SharePoint、文件共享、Box 或 Google Workspace Migrate |
| LocationNotFound | 由于目标用户没有包含共享云端硬盘的 Google Workspace 许可，因此 Google Workspace 共享云端硬盘无法迁移到目标账号的共享云端硬盘。请检查目标账号的许可，然后重试。 |
| OrphanedContent |
如果您未在映射中将无主内容的所有者指定为源账号，您也可能会看到此错误消息。Google Workspace Migrate 不会迁移相关内容，会显示 60008 错误代码。在这种情况下，该错误是无法避免的。 注意：位于不同目标位置的孤立文件可能是由另一个问题所致。例如，如果映射中没有为无主内容指定目标文件夹，并且这些内容被放在目标用户的“我的云端硬盘”根文件夹中，便可能会发生这种情况。 |
| 找不到用户的映射关系 |
如果您要将文件从一个共享云端硬盘迁移到另一个，请务必使用身份映射，在迁移桥中将源用户映射到目标用户。
- 在 Google Workspace Migrate 平台中，点击 Scans（扫描）或 Bridges（迁移桥）。
- 在您要检查的扫描或迁移桥上，点击“Logs”（日志）图标
- 将光标指向相应处理记录，然后点击“More”（更多）图标
- 使用下表找出常见的处理记录错误，并了解问题排查步骤。
| 错误消息和代码 | 问题排查步骤 |
|---|---|
| 处理记录状态为 Failed（失败） | 使用处理记录详细信息找到相应处理记录并进行问题排查。 |
| 错误消息：The request type does not allow write operations（请求类型不允许写入操作）
错误代码：1048640 |
对象类型的请求处理程序无法将对象写入目标账号（例如，来源内容在 Google Workspace 中没有同等类型）。
请检查位置映射是否设置正确，映射是否合乎逻辑。 |
| 错误消息：An internal connector error occurred（出现了内部连接器错误）
错误代码：2097125 |
查看处理记录和执行日志中的错误消息。如果错误消息没有帮助，请查看平台或节点服务主机日志中的详细信息。 |
| 在所依赖的处理操作完成之前，执行的迁移桥已经停止或完成 | 由于内容依赖于先行迁移的其他内容，而后者迁移失败，因此该内容未能迁移。举例来说，由于某个文件夹不是在云端硬盘中创建的，因此其中的文件未能迁移。
请在错误中找到 ABHierarchicalPath.Path 并记下关联的内容，然后在处理记录日志中找到该内容，以了解迁移失败的原因。 |
系统可能会跳过处理记录日志中的处理记录，原因如下：
- 您要运行增量迁移，而对象自上次迁移后没有任何改变。
- 系统根据设置模板中的过滤条件排除了对象。
- 您要将电子邮件内容迁移到群组，而系统跳过了大型邮件附件。
- 您使用的是共享云端硬盘设置模板，但要将内容迁移到“我的云端硬盘”。
根据迁移来源，系统可能跳过某个内容的其他原因如下：
- SharePoint - 系统会跳过不属于文档库的文件夹。
- Exchange - 向 Google 群组迁移时，系统会跳过邮件草稿。
- Box - 系统会跳过空白的文件修订版本。
- 文件共享 - 系统会跳过节点没有足够权限来访问的内容。
- Gmail - 系统会跳过聊天消息（即聊天标签下的内容）。
使用默认设置模板在共享云端硬盘之间迁移时，GWM 会在目标账号中创建新的共享云端硬盘，但可能不会从来源共享云端硬盘迁移数据。原因如下：
- 源和目标没有身份映射。
- 模板中的允许未映射的用户选项未选中。
您可以通过以下两种方式解决此问题：
- 根据默认设置模板创建自定义模板，然后选中允许未映射的用户。
- 添加身份映射。
事务报告可能体积过大，无法下载。使用以下方法进行排查：
方法 1：在迁移之前添加过滤条件
如需减小报告大小，请对事务日志应用过滤条件，以搜索特定数据（例如完成状态或错误代码）。有关详情，请参阅监控迁移进度。
方法 2：下载带有过滤条件的日志
您可以使用命令行指定事务日志的下载方式：
- 如需减少日志中的项目数量，请使用 transactionState 选项。
- 如需延长日志下载的允许时长，请使用 queryTimeout 选项。
有关详情，请参阅使用命令行下载日志。
如果迁移速度低于预期，请确认是否满足以下系统要求。
Google API 配额级别
您的配额设置可能会导致错误代码，例如“403 禁止访问”错误、“429 请求过多”错误或“503 服务不可用”错误。如需验证配额级别是否影响迁移速度，请执行以下操作：
- 在 Google Cloud 控制台中查看配额。如需了解相关步骤，请参阅在 Google Cloud 控制台中查看配额。
- 调整配额以满足资源使用需求。如需了解相关步骤，请参阅使用控制台管理配额。
客户端节流设置
节流设置用于管理客户端向 Google 服务发送请求的速率。有时，这些设置会导致错误代码，例如“403 禁止访问”错误、“429 请求过多”错误或“503 服务不可用”错误。
如果 Google Workspace Migrate (GWM) 的节流速率过高，可能会导致这些错误代码。如果客户端节流较高，但服务器端节流并不明显，则调整 GWM 上的填充设置可能会有所帮助。
准备工作
- 只有经验丰富的管理员才能尝试进行这些更改，因为更新可能会产生意想不到的后果。
- 以下步骤设置了 Google 节流策略，但您可能还需要使用其他数据源，包括 googleThrottlingStrategy、exchangeThrottlingStrategy 和 sharepointThrottlingStrategy。
如需替换 GWM 2.1.54.0 及更高版本上的默认节流策略，请执行以下操作：
- 在平台服务器上，创建目录：C:\ProgramData\AppBridge\Overrides
- 添加名为 throttling_settings.json 的 JSON 文件
- 使用记事本将以下文本添加到 JSON 文件中：
{
"googleThrottlingStrategy": {
"throttlingModel": "ADAPTIVE_THROTTLING",
"adaptiveThrottlePadding": 32,
"adaptiveThrottleAcceptanceRatio": 1.1,
"adaptiveThrottleIntervalMs": 60000
}
} - 保存 JSON 文件。
- 在 Windows 系统任务栏中，点击
。
- 停止 GWM 服务，然后重新启动。
防火墙限制
为了减少对磁盘和网络操作的干扰，请从 Workspace 服务器中卸载防病毒软件、安全扫描器和其他非必要的软件。
Google Workspace Migrate 使用 MySQL 存储配置设置和日志记录详细信息。如果 MySQL 连接时断时续或无响应，请前往检查服务主机日志，然后按照平台安装步骤操作。
如果您在 AppBridgeServiceHost.log 中看到 MySQL 错误：
- 前往排查 MySQL 问题。
- 如果您仍需要帮助，请参阅针对 Google Workspace Migrate 问题联系支持团队。
还需要帮助？
请参阅就 Google Workspace Migrate 问题与支持团队联系。
“Google”、Google Workspace 以及相关标志和徽标是 Google LLC 的商标。其他所有公司名和产品名是其各自相关公司的商标。