华为云用户手册

采集参数配置说明 参数 是否必选 配置说明 ip 是 Orcale数据库实例IP。 port 是 Orcale数据库实例端口号。 user 是 Orcale数据库实例账号（拥有select any dictionary权限）。 password 是 Orcale数据库实例账号对应的密码。 sid 否 Orcale数据库实例唯一标识符，与ServiceName有一个即可。 serviceName 否 Orcale数据库实例服务名与sid有一个即可。

采集原理 拥有的windows/linux机器，能与自建Oracle数据库网络互通，安装对应版本的MgC Agent（原Edge）。 通过提供的账号资源，连接登录凭证信息，登录到Oracle数据库上，账号有select any dictionary权限，不然采集结果数据将会受影响。 MgC服务通过IoTDA（ 设备接入服务 ）下发采集命令给装在主机上的MgC Agent，MgC Agent接受命令并创建Oracle数据库采集任务。 MgC Agent通过RPC通信协议，调用Oracle数据库采集器，进行对源端主机采集，采集器原理是通过调用数据库指令，拼接sql等获取所需数据。 采集器采集完成后，将采集结果通过RPC通信上报给MgC Agent，MgC Agent对RPC消息处理后,通过IoTDA上报采集结果给MgC。 MgC对采集结果处理存储等。 图1 采集链路流程

操作步骤 使用注册的用户名、密码登录MgC Agent控制台。 在总览页面，单击页面右上角的“连接”按钮，右侧弹出连接迁移中心页面。 图1 连接迁移中心 在第一步：输入云凭证区域，选择在MgC服务创建项目的区域，输入华为云账号的AK/SK，单击“查询项目”按钮。系统会对输入的AK/SK进行验证，验证通过后，即可进行下一步。如果提示AK/SK错误，请参考AK/SK验证失败，如何处理？进行排查处理。 如果是进行 主机迁移 ，输入的AK/SK需要具备 SMS 服务的相关权限。需要的权限和配置方法请参考SMS自定义策略。 您可以选择是否将输入的AK/SK保存为目的端凭证（推荐您选择“是”）。 选择“否”，与迁移中心连接成功后，输入的AK/SK会被删除。 选择“是”，与迁移中心连接成功后，输入的AK/SK会加密保存在本地，在后续进行迁移时，可以作为目的端凭证发送给源端SMS-Agent。 在第二步：关联迁移中心项目区域的项目下拉列表中，选择MgC控制台所创建的迁移项目，MgC Agent会将采集数据上报到该项目。 在第三步：预设当前迁移中心Agent名称区域，自定义MgC Agent在MgC控制台显示的名称，单击“连接”按钮，确认要与迁移中心进行连接，单击“确定”按钮。 与迁移中心连接成功后，设置的MgC Agent名称不支持修改。 当总览页面显示状态为“已连接”，代表与MgC连接成功。 图2 与MgC连接成功

命令矩阵 命令矩阵列出了MgC Agent包含的命令，以及命令所在绝对路径、功能、用法等信息。 表2 MgC Agent命令矩阵 命令所在节点 命令名 命令所在绝对路径 是否可独立调用 命令功能 命令用法 命令风险提示 命令类型 Edge accountPermission.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 查询管理员用户组角色 .\accountPermission.ps1 无 功能类 basicInfo.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 查询基础信息 .\basicInfo.ps1 无 功能类 checkBasicObjects.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 检查系统基本组件 .\checkBasicObjects.ps1 无 功能类 checkPerformanceObjects.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 检查系统性能组件 .\checkPerformanceObjects.ps1 无 功能类 diskInfo.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 查询磁盘基本信息 .\diskInfo.ps1 无 功能类 eachDiskPerformance.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 查询磁盘性能信息 .\eachDiskPerformance.ps1 无 功能类 fileSharingInfo.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 查询文件分享信息 .\fileSharingInfo.ps1 无 功能类 fireware.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 查询固件信息 .\fireware.ps1 无 功能类 memorySize.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 查询内存信息 .\memorySize.ps1 无 功能类 netcardInfo.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 查询网卡信息 .\netcardInfo.ps1 无 功能类 netcardPerform.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 查询网卡带宽和PPS .\netcardPerform.ps1 无 功能类 oemSystem.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 检查OEM系统 .\oemSystem.ps1 无 功能类 osInfo.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 查询系统信息 .\osInfo.ps1 无 功能类 processInfo.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 查询进程信息 .\processInfo.ps1 无 功能类 scheduledTasks.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 查询定时任务 .\scheduledTasks.ps1 无 功能类 specialHardware.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 查询硬件信息 .\specialHardware.ps1 无 功能类 systemRoot.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 查询系统目录 .\systemRoot.ps1 无 功能类 systemService.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 检查VSS 镜像服务 .\systemService.ps1 无 功能类 tcpNum.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 查询网络连接数 .\tcpNum.ps1 无 功能类 utilInfo.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 查询性能信息 .\utilInfo.ps1 无 功能类 virtioDriver.ps1 /Edge/tools/plugins/collectors/rda-collector-server/powershell 是 查询virtio驱动 .\virtioDriver.ps1 无 功能类 getArchitecture.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询系统架构 sh getArchitecture.sh 无 功能类 getBootLoader.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询系统引导类型 sh getBootLoader.sh 无 功能类 getCPUCores.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询CPU核数 sh getCPUCores.sh 无 功能类 getCpuFrequency.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询CPU主频信息 sh getCpuFrequency.sh 无 功能类 getCPURate.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询CPU使用率 sh getCPURate.sh 无 功能类 getCPUtype.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询CPU类型 sh getCPUtype.sh 无 功能类 getDisk_each_read_write_info.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询磁盘吞吐量 sh getDisk_each_read_write_info.sh 无 功能类 getDiskInfo.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询磁盘基本信息 sh getDiskInfo.sh 无 功能类 getDiskUtil.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询磁盘使用率 sh getDiskUtil.sh 无 功能类 getFileSharingInfo.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询文件分享信息 sh getFileSharingInfo.sh 无 功能类 getFirmwareType.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询固件类型 sh getFirmwareType.sh 无 功能类 getGPUDevices.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询GPU设备 sh getGPUDevices.sh 无 功能类 getHostname.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询主机名称 sh getHostname.sh 无 功能类 getMem.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询内存信息 sh getMem.sh 无 功能类 getMemRate.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询内存使用率 sh getMemRate.sh 无 功能类 getKernel.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询内核 sh getKernel.sh 无 功能类 getNetCards.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询网卡信息 sh getNetCards.sh 无 功能类 getNetcardsInfo.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询网卡带宽和PPS sh getNetcardsInfo.sh 无 功能类 getOsDisk.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询系统盘信息 sh getOsDisk.sh 无 功能类 getOsInfo.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询系统信息 sh getOsInfo.sh 无 功能类 getRawDevices.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询裸设备信息 sh getRawDevices.sh 无 功能类 getRsync.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询Rsync sh getRsync.sh 无 功能类 getProcessInfo.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询进程信息 sh getProcessInfo.sh 无 功能类 getScheduledTasks.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询定时任务 sh getScheduledTasks.sh 无 功能类 getUSBDevices.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询USB设备 sh getUSBDevices.sh 无 功能类 getTcpTotal.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询网络连接数 sh getTcpTotal.sh 无 功能类 getVirtioDriver.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询virtio驱动 sh getVirtioDriver.sh 无 功能类 getVirtualType.sh /Edge/tools/plugins/collectors/rda-collector-server/shell 是 查询虚拟类型 sh getVirtualType.sh 无 功能类

通信矩阵 通信矩阵列出了使用MgC Agent需要开放的端口，以及端口使用的传输层协议、认证方式、加密方式、用途等信息。 表1 MgC Agent通信矩阵 源设备 源IP 源端口 目的设备 目的IP 目的端口 （侦听） 协议 端口说明 侦听端口是否可更改 认证方式 加密方式 NA NA NA MgC Agent所在主机 MgC Agent所在主机IP 27080 HTTPS MgC Agent服务监听端口，该端口用于人机交互 否 口令认证 HTTPS MgC Agent所在主机 MgC Agent所在主机IP NA MgC Agent所在主机 MgC Agent所在主机IP 5678 TCP MgC Agent服务监听端口，该端口用于采集器与MgC Agent内部交互 否 无 无 NA 主机 目的主机IP 用户输入 TCP SSH (Secure Shell) - 远程登录协议，用于安全登录文件传输（SCP，SFTP）及采集脚本执行 是 口令认证 SSL NA 主机 目的主机IP 5985 TCP winrm远程连接端口，用于远程执行采集脚本 否 口令认证 HTTPS 8080 平台 目的主机IP 443 TCP vmware平台信息采集监听端口。源端端口为继承巫山框架默认启动的端口，业务未使用。 否 口令认证 HTTPS 8000 数据库 目的主机IP 用户输入 TCP 数据库服务监听端口。源端端口为继承巫山框架才启动的端口，业务未使用。 是 口令认证 SSL 7050 容器 目的主机IP 用户输入 TCP 容器服务监听端口。源端端口为继承巫山框架才启动的端口，业务未使用。 是 密钥文件认证 HTTPS 9977 存储 目的主机IP 用户输入 TCP 对象存储服务 监听端口。源端端口为继承巫山框架才启动的端口，业务未使用。 是 口令认证 SSL

查看MgC Agent列表 登录迁移中心管理控制台。在左侧导航栏的项目下拉列表中选择创建的迁移项目。 单击左侧导航栏的“迁移中心Agent”，即可查看当前项目下的所有MgC Agent以及状态。 MgC Agent状态说明参见表1。 表1 MgC Agent状态说明 设备状态 说明 在线 MgC Agent与MgC控制台之间一直连接，无断开。 离线 MgC Agent运行程序退出与MgC控制台之间的连接断开1分钟后，置为“离线”状态。 未激活 已在MgC Agent完成注册但设备还未接入平台。 异常 无此状态，如出现该状态，请联系华为云技术支持。 冻结 无此状态，如出现该状态，请联系华为云技术支持。

创建 IAM 用户 IAM用户由账号创建并管理，可以确保账号及资源的安全性，有关IAM的详细介绍请参见IAM用户。此处介绍如何创建一个具有MgC使用权限的IAM用户。若您不需要使用IAM用户，可以略过此部分内容。 访问华为云，单击页面右上角的“控制台”，使用注册账号登录控制台。 在“控制台”页面，将鼠标移动至右上方的用户名，在下拉列表中选择“ 统一身份认证 ”。 创建用户组并授权 创建用户组，单击用户组操作列的“授权”。在用户组选择策略页面中，选择“迁移中心（MgC）”，勾选需要授予用户组的权限。 MgC的所有系统权限策略说明参见表1。 表1 MgC系统权限 策略名称 描述 策略类别 MgC FullAccess 迁移中心管理员权限，拥有操作MgC的所有权限。 系统策略 MgC ReadOnlyAccess 迁移中心只读权限，仅能查看MgC资源，无法进行操作。 系统策略 MgC DiscoveryAccess 迁移中心资源发现操作权限，拥有操作资源发现功能的权限和只读权限。 系统策略 MgC AssessAccess 迁移中心评估操作权限，拥有操作评估功能、资源发现功能的权限和只读权限。 系统策略 MgC MigrateAccess 迁移中心迁移操作权限，拥有操作迁移功能、评估功能、资源发现功能的权限和只读权限。 系统策略 MgC AppDiscoveryAccess 迁移中心资源采集操作权限，拥有操作资源采集功能、资源发现功能的权限和只读权限。 系统策略 MgC MrrAccess 迁移中心业务验证操作权限，拥有业务验证功能的权限和只读权限。 系统策略 MgC常用操作与系统策略的授权关系参见表2。 表2 MgC操作与系统策略关系 操作 MgC FullAccess MgC ReadOnlyAccess MgC DiscoveryAccess MgC AssessAccesss MgC MigrateAccess MgC AppDiscoveryAccess 操作迁移中心资源 √ x x x x x 查看迁移中心资源 √ √ √ √ √ √ 操作迁移中心资源发现功能 √ x √ √ √ √ 操作迁移中心评估功能 √ x x √ √ x 操作迁移中心迁移功能 √ x x x √ x 操作迁移中心资源采集功能 √ x x x x √ 创建用户并加入用户组 创建用户时选择步骤3创建的具有MgC权限的用户组。

使用须知 源端是Windows主机时，源端主机需要满足如下条件： 需要对安装MgC Agent的主机开放5985端口。 需要开启WinRM远程访问，并与安装MgC Agent的主机建立连接，方法请参考Windows服务器WinRM服务配置与故障排查。 允许执行shell脚本。在源端主机打开PowerShell（以管理员身份），然后运行以下命令来查看当前的执行策略。 Get-ExecutionPolicy 如果返回值为“Restricted”，则表示不允许运行任何脚本。需要执行如下命令，并输入Y，将策略改为“RemoteSigned”。 Set-ExecutionPolicy RemoteSigned 源端是Linux主机时，源端主机需要满足如下条件： 需要对安装MgC Agent的主机开放22端口。 需要开放root账号的直接连接权限。即允许通过SSH等远程连接方式使用root账号登录到源端Linux主机。 需要启用SFTP和SSH服务。 需要支持以下SSH连接安全算法： ssh-ed25519、ecdsa-sha2-nistp256、ecdsa-sha2-nistp384、ecdsa-sha2-nistp521、rsa-sha2-512、rsa-sha2-256。 如果源端主机不支持以上安全算法，推荐升级OpenSSH版本至8.0及以上版本，否则无法进行主机深度采集。 iptable未禁用与MgC Agent所在主机的通信。在源端主机执行如下命令，如果命令输出中的source字段包含MgC Agent所在主机的访问IP和端口，则代表已禁用，需要取消禁用。 iptables -L INPUT -v -n 完成用户注册后，建议每3-6个月更换一次密码。

准备工作 建议在源端内网环境中准备一台用于安装MgC Agent（原Edge）的Windows主机，并确保该Windows主机满足以下要求： 可以连接外网（公网），并检查是否能够访问MgC和IoTDA服务的 域名 ，具体需要检查的域名请查看域名列表。 检查是否已开放MgC Agent（原Edge）需要的端口，所需端口请查看通信矩阵。 PowerShell 版本在3.0及以上。 推荐规格不小于4U8G。 安全组的出方向规则中，需要包含8883端口。 关闭该主机上的杀毒、防护类软件，该类软件会拦截MgC Agent的执行，导致迁移工作流执行失败。 不建议将MgC Agent安装在源端待迁移的主机上，主要原因包括： 资源消耗：MgC Agent在采集和迁移运行过程中会消耗CPU和内存资源。在迁移任务量大时，这可能会对源端的业务运行造成影响。 端口占用：MgC Agent会占用源端主机上的一些端口，也可能会对源端业务产生影响。 已 注册华为账号 并开通华为云，并获取账号的AK/SK。 已在MgC控制台创建迁移项目。

操作步骤 使用在源端内网环境准备好的Windows主机，登录迁移中心管理控制台。 在左侧导航栏单击“迁移中心Agent”，进入迁移中心Agent页面。 在Windows区域，单击“下载安装包”，将MgC Agent安装程序下载到Windows主机。 将下载的MgC Agent安装包解压，双击安装程序，单击“下一步”。如果无法正常启动安装程序，请尝试以兼容性模式运行，方法请参见已兼容性模式运行程序。 在许可证协议界面，仔细阅读许可证协议，勾选我接受“许可证协议”中的条款，单击“下一步”。 选择安装目录（请选择C盘作为安装目录），单击“安装”。 当前仅支持安装在C盘目录下。若选择其他磁盘进行安装，可能导致MgC Agent无法正常启动。 安装完成后，单击“完成”，打开MgC Agent控制台，进入用户注册页面。

增量同步后启用/修改一致性校验策略 当工作流执行完“增量同步”步骤后，可以启用/修改一致性校验策略。 将鼠标移动到进度条，在弹窗中单击一致性校验策略后的“修改”，右侧弹出一致性校验策略窗口。 图3 修改一致性策略 勾选“数据一致性校验”功能，根据参数说明并结合实际需求配置校验策略。 图4 配置校验策略 表3 校验策略参数说明 参数 说明 启用哈希校验 通过计算和比较文件内容的哈希值进行校验。适合于单文件体积大且文件内容重要的场景，将增加源端CPU负载及源端磁盘IO负载，校验时间也更长。 注意： 被运作中的软件占用的文件无法进行哈希校验。 勾选该选项后，必须指定校验目录，并且只校验指定目录下的文件内容。 数据范围 排除下列目录：填写不需要进行数据校验的目录路径，最多支持填写30个路径，路径之间用英文逗号隔开。例如：/root/data,/var。不填则校验所有目录文件。 仅包含下列目录：只对填写的目录文件进行校验。 须知： 请务必输入正确路径，路径错误或路径下不存在文件时，校验结果中会显示校验文件数量为0。 需要校验的数据量越大，则一致性校验的用时越长，建议仅对关键目录进行校验。 为避免校验数据量过大，以下路径将被默认排除： Linux系统的"/bin","/boot","/dev","/home","/etc","/lib","/media","/proc","/sbin","/selinux","/sys","/usr","/var","/run","/tmp"目录。 Windows系统的分区根目录，如：C:\，O:\。 启用复检模式 只有进行过至少一次一致性校验后，才可以打开复检选项，启用复检将只对上一次校验结果中不一致的文件进行校验。 配置完成后，单击“保存”按钮，在完成增量同步后，系统自动进行数据一致性校验。 当同步及校验完成后，前往SMS控制台，查看校验结果。

重试/全量重试 在主机迁移工作流运行过程中，MgC Agent（原Edge）会为每台源端服务器启动一个SMS-Agent迁移进程，该进程启动后会与SMS控制台进行通信，并接收命令执行迁移。在工作流进行到“全量迁移”和“增量同步”两个子步骤阶段，如果源端SMS-Agent进程与SMS控制台断开连接，MgC控制台会监控到该情况，同时迁移工作流会失败并出现“重试”和“全量重试”的按钮。以下是导致源端SMS-Agent进程与SMS控制台断开连接的原因，请根据具体原因选择对应的处理方法： 原因一：因网络异常导致源端SMS-Agent进程和SMS控制台断开连接。 该情况通常SMS-Agent进程依旧存在，只需要将网络恢复，等待SMS控制台的迁移任务恢复连接，然后在迁移工作流单击“重试”即可恢复迁移。 图1 重试 Linux 源端检测SMS-Agen进程的指令： # ps -ef | grep -v grep | grep linuxmain Windows 源端检测SMS-Agen进程的powershell指令： # Get-Process -Name SMSAgentDeploy -ErrorAction SilentlyContinue 原因二：源端主机重启等原因导致SMS-Agent进程中止，使得SMS-Agent与SMS控制台断开连接。 该情况由于SMS-Agent进程中止，导致迁移程序无法断点续传，需要已有的SMS任务重新创建。针对这种情况，MgC提供了一键“全量重试”的功能。您只需在迁移工作流单击“全量重试”按钮并确认，工作流将会直接跳到“迁移任务清理”步骤对SMS任务进行删除。SMS任务清理完毕后，工作流会再次从“启动迁移Agent”步骤运行，并在源端重新启动SMS-Agent进程，创建新的SMS迁移任务进行迁移。 图2 全量重试 全量重试功能会删除旧任务，重新创建SMS迁移任务，已经迁移的数据会被覆盖。

使用须知 目前支持采集的VMware版本包括：VMware 5.0~7.0 VMware扫描和网段扫描两种方法都采用私有IP结合MgC Agent ID的方式来标识内网中的主机资源。这意味着，一旦完成一次资源采集，如果被采集的主机私有IP发生变更，系统将在下一次采集时将其识别为一个新的主机资源，从而导致主机资源数量增加。为了避免这种情况，建议在迁移过程完成之前，不要更改源端主机的私有IP地址。 通过VMware扫描发现的主机支持自动采集指定周期内的主机性能数据，无需再手动配置进行性能采集。 通过VMware扫描方式采集的性能数据来源于vCenter中留存的历史样本统计数据。vCenter历史样本统计数据的默认留存策略为： 最近1天：每5分钟留存一条数据。 最近1周：每30分钟留存一条数据。 最近1月：每2小时留存一条数据。

问题分析 出现该问题可能是因为数值超出了Hive支持的数值范围。 在数据处理中，如果遇到极大值或极小值，Hive可能无法以标准数值格式表示这些极端数值，而是将它们显示为 “Infinity”（表示无限大）或 “-Infinity”（表示无限小）。这些值并不是有效的数字，因此在进行数值转换或计算时，可能会引发异常。 在校验过程中，Hive和Spark对这些无法表示的数值有默认的处理方式： 当数值为 Infinity 或 -Infinity 时，会被默认处理并显示为 -1。 当数值为 NaN（Not a Number，非数字）时，会被默认处理并显示为 0。

解决方法 查看源端主机是否处于关机状态。 如果是，请将源端主机开机后重试。 如果否，请继续执行步骤2.。 在安装MgC Agent的主机，打开命令行窗口，使用ping命令测试与源端主机的公网IP是否连通；使用telnet命令测试源端主机的端口（如22端口）是否可以访问。命令格式分别为：ping {源端主机IP地址}、telnet {源端主机IP地址} {端口}。 如果IP和端口均能连通，请执行步骤3.。 如果IP或端口不通，请检查源端主机安全组入方向规则中，协议端口号为TCP：22和ICMP：全部的源地址是否配置为安装MgC Agent主机的公网IP。确认安全组规则配置无误后，重新进行迁移准备度检查。 检查源端是否有防火墙、杀毒软件等安全拦截。如果有，请关闭或调整拦截规则后重试。

MgC主机工作流进度计算 MgC主机工作流中的每个资源都会在SMS创建一个迁移任务，例如，SMS创建的任务有6个子任务，每个子任务进度为100%后会进行下一个子任务，所有子任务进度为100%（即总进度为6个100%）代表任务迁移完成。MgC工作流的资源迁移进度会根据SMS任务实际已完成子任务的百分比之和除以600%，得到的百分比计算结果即为当前资源迁移进度。 以下图为例，计算结果为：380% ÷ 600% ≈ 63% 图1 SMS子任务进度

迁移准备 检查主机是否为XEN规格 可以在主机的基本信息页面，通过主机规格名称来判断是否为XEN规格。当前XEN规格名称包括：C1、C2、S1、M1、E1、E2、Et2、D1、H1、G1、G2型弹性云服务器。 图1 查看主机规格 安装驱动 源端为Linux主机，请参考以下任一方案安装驱动。 XEN实例变更为KVM实例（Linux-自动配置）中的步骤1~步骤2 XEN实例变更为KVM实例（Linux-手动配置）中的步骤1~步骤3 XEN实例变更为KVM实例（Linux-批量自动配置）中的步骤1~步骤2 源端为Windows主机，请参考XEN实例变更为KVM实例（Windows）中的步骤1~步骤3安装驱动。

进行存储迁移时，如何选择集群规格？ 使用MgC进行存储迁移时，我们推荐使用C6和C7系列中8U16G的规格，即c6.2xlarge.2或c7.2xlarge.2。具体的规格详情和用途如下。 规格名称 带宽 用途 通用计算增强型c6 | c6.2xlarge.2 | 8vCPUs | 16GiB 基准带宽：4.5 Gbit/s 最大带宽：15 Gbit/s 作为迁移节点、列举节点、master节点 通用计算增强型c7 | c7.2xlarge.2 | 8vCPUs | 16GiB 最大带宽：15 Gbit/s 作为迁移节点、列举节点、master节点 以上规格可以满足大多数迁移场景的需求，能够确保迁移速度和稳定性。如果选择的规格小于推荐规格，可能会因为资源不足而导致迁移速度变慢，影响迁移效率和稳定性。因此，在选择集群规格时，请务必根据实际需求选择推荐或更高的集群规格。 父主题： 存储迁移

迁移工作流状态一直处于“运行中”，如何判断迁移是否正常？ 迁移工作流除了“开始迁移”、“开始同步”两个阶段运行时间比较久以外，其它步骤一般运行不会超过3分钟。如果长时间卡在某一步，可能是因为MgC Agent（原Edge）上报结果给MgC的过程中丢失。 解决办法： 方法一：单击工作流名称，在工作流详情页面的主机页签，可以查看每个资源工作流状态。 方法二：请联系技术支持人员帮忙追踪任务是否正常收发。 父主题： 主机迁移工作流

问题分析 使用spark-sql 客户端，进行sql操作，出现用同一个命令存在返回值不同的情况。 这是因为在进行大数据对数的求和计算时，由于分布式计算顺序的不确定性，可能会导致计算结果的不一致性。特别是处理接近或等于double类型最大值（1.7976931348623157E+308）的数据时，加上一个较小的数值（如2.0）可能会导致数值溢出，使得结果保持不变。这是double类型在处理极大数值时溢出的常见现象。

解决方法 核对凭证信息。 请仔细检查凭证中的用户名和密码是否输入正确，包括大小写和特殊字符。 测试凭证有效性。 使用核对后的用户名和密码尝试登录源端主机，验证凭证的有效性。 如果可以登录，请更新在MgC Agent（原Edge）上添加的源端主机凭证信息为核对后的信息，然后重新进行迁移准备度检查。 如果无法登录，则是用户名或密码错误。请继续执行后续步骤。 重置密码或联系源端主机管理员。 如果您确定用户名正确，但忘记了密码，可以选择重置源端主机的密码。源端主机为华为云E CS 时，请参考在控制台重置ECS密码。源端非华为云ECS主机，需要您自行获取重置密码的方法。 如果您不确定用户名是否正确，请联系源端主机的管理员以获取正确的用户名和密码。 确认用户名和密码无误后，更新在MgC Agent上添加的源端主机凭证信息，然后重新进行迁移准备度检查。

保留源端存储类型转换说明 配置存储策略选择“保留源端存储类型”时，源端存储类型与华为 云存储 类型之间的转换关系参见表1。括号内的数值分别代表：每月每GB容量费用|每万次读取请求费用|每万次写入请求费用|每GB标准取回费用（标准存储类型不涉及）。表中费用数据仅供参考，具体以各云厂商提供的数据为准。 下表中各云厂商的费用参考区域：华为云、百度云、阿里云、腾讯云、金山云为北京区域，谷歌云、亚马逊云为中国香港区域，微软云为东亚区域，七牛云、优刻得为中国大陆，按量优惠取最贵收费，若存在冗余存储而官方存储类型未区分取非冗余储存价格，单位：元。 下表中不存在的云厂商存储类型可能会迁移失败，建议手动解冻后再迁移至OBS。

解决方法 您可以参考方法一或方法二，在目的端主机进行处理。 方法一： 登录目的端主机，在开始菜单打开“运行”输入框。 输入“diskmgmt.msc”，按“Enter”，进入磁盘管理页面。 在磁盘管理页面，可以看到数据盘处于“脱机”状态。 图1 脱机 使用鼠标右键单击“脱机”的数据盘，会出现联机的菜单，单击联机即可恢复正常。 图2 联机 方法二： 登录目的端主机，鼠标右键单击开始菜单。 单击“运行”，输入cmd，进入命令行提示符界面。 执行diskpart，启动磁盘管理工具。 执行list disk，列出当前服务器所有磁盘。 如下图所示，磁盘0处于“联机”状态，磁盘1处于“脱机”状态。 执行select disk 1选择脱机状态的磁盘（根据实际情况，选择对应的脱机磁盘）。 执行online disk联机所选择的脱机磁盘。 如果磁盘联机后显示只读，请执行attribute disk clear readonly。

解决方法 在迁移方案设计页面的应用列表，单击操作列的“查看资源配置”，进入目的端配置表页面。 在资源配置明细区域，单击主机资源操作列的“更改目的端规格”，右侧弹出资源详情窗口。 单击主机规格后的“更改规格”，可以修改目的端主机规格和镜像。 单击磁盘对应的目的端规格处的“更改规格”，可以修改目的端磁盘的存储类型和资源总用量（磁盘容量）。Linux主机的磁盘容量可以根据源端主机磁盘的实际使用量，进行缩容，即小于源端磁盘容量。更改磁盘规格后，系统会自动判断是否进行了磁盘缩容，在主机资源配置明细列表中的“磁盘缩容”列，“是”代表已缩容；“否”代表未缩容。 系统盘容量取值范围为：40 G~1024 G 数据盘容量取值范围为：10 G~32768 G 当前仅支持Linux主机磁盘缩容，需确保缩容后容量大于源端实际使用量。 跨可用区迁移场景仅支持扩容，即使配置缩容，系统也会自动创建一个与源端磁盘容量相同的目的端磁盘。

解决方法 检查迁移准备度配置参数中的“接入IP”填写是否正确。确保MgC Agent能够通过该地址和端口连接到源端主机。 如果地址错误，请修改为正确地址后重试。 如果地址正确，请继续执行步骤2.。 查看源端主机是否处于关机状态。 如果是，请将源端主机开机后重试。 如果否，请继续执行步骤3.。 在安装MgC Agent的主机，打开命令行窗口，使用telnet命令测试源端主机的端口（如5985端口）是否可以访问。命令格式分别为：telnet {源端主机IP地址} {端口}。 如果端口可以访问，请执行步骤4.。 如果端口无法访问，请检查源端主机安全组入方向规则中，协议端口号为TCP：5985和ICMP：全部的源地址是否配置为安装MgC Agent主机的公网IP。确认安全组规则配置无误后，重新进行迁移准备度检查。 检查源端是否有防火墙、杀毒软件等安全拦截。如果有，请关闭或调整拦截规则后重试。

保留SMS迁移任务 如果需要在主机工作流迁移完成后保留SMS迁移任务，需要手动在“迁移任务清理”步骤前添加一个卡点步骤，如图5所示。添加卡点步骤的方法和注意事项请参见添加阶段/步骤。 图5 添加卡点步骤 当工作流执行到该卡点步骤时，不要进行手动确认操作，如图6所示。此时SMS控制台上的迁移任务不会被清理且状态为“已完成”，如图7所示。如果进行了手动确认，SMS控制台上的任务会被删除。 图6 卡点步骤 图7 迁移完成

将HTTP/HTTPS数据源迁移到OBS时，如果存在URL不同但对象名称相同的情况，会如何处理？ 当从HTTP/HTTPS数据源迁移数据到对象存储服务（OBS）时，由于OBS不区分URL差异，只识别对象名称，因此同名对象会根据创建工作流时，迁移配置中所选的“同名覆盖方式”策略进行处理，目的端同一目录下不会出现同名对象。 不覆盖：第一个同名对象迁移到OBS后，后续同名对象（无论URL是否相同）直接跳过不会被迁移，只保留第一个迁移的同名对象。 直接覆盖：后一个迁移的同名对象会覆盖前一个迁移的同名对象，只保留最后一个迁移的同名对象。 条件覆盖：对于后续迁移的同名对象，根据以下条件决定是否覆盖。 如果最后修改时间较新，则覆盖前一个同名对象。 如果最后修改时间相同，比较文件大小；如果大小不同，则后一个对象覆盖前一个。 如果最后修改时间和文件大小都相同，则跳过，保留已迁移的对象。 父主题： 存储迁移

主机评估策略推荐逻辑说明 本节介绍对主机进行规格评估时，关于推荐策略和偏好设置配置项推荐逻辑的详细说明。 表1 评估策略参数说明 参数 子参数 说明 购买区域 - 选择在华为云购买资源的区域。推荐您选择靠近目标用户的区域，可以减少网络时延，提高访问速度。 推荐策略 匹配源端规格 根据源端规格推荐最合适的华为云对应资源规格。 如果是通过手动添加或内网发现获取的源端主机，则将X实例，通用计算型，计算增强型三种规格类型，根据“偏好设置”选项（价格优先或性能优先）进行排序，依次检索各类型下所有虚拟机规格，选出第一个CPU和内存均不小于源端，且在阈值内的在售规格。如检索完所有规格类型仍未匹配到合适的规格，则会报错提示。如果需要特殊特性和功能（例如内存增强），应通过高级选项进行设置或通过应用场景匹配来获取更准确的推荐。 须知： CPU阈值计算规则：基于源端主机的CPU核数，采用向上取整至最接近的2幂次指数。例如：源端主机为3核CPU，阈值计算为4核，因为4是大于3的最小2的幂次；源端主机为4核CPU，阈值则为8核，8是大于4的下一个2的幂次。 内存阈值计算规则：为源端主机内存的1.5倍。例如：源端主机内存为4 GB，则阈值计算为4 GB的1.5倍，即6 GB。 例如： 源端6U8G + 价格优先：如果X实例有相应规格在售，则目的端推荐x1.6u.8g。 源端6U8G + 性能优先： 如果c7规格有相应规格在售，则目的端推荐c7.2xlarge.1 (8U8G)。 如果c7规格有CPU和内存不小于源端且在阈值内（8U12G）的规格在售，则推荐最接近源端的规格；如果C7规格中没有找到合适的规格，系统将按照性能顺序，向下一个性能等级的虚拟机规格类型进行搜索。如果性能略低的规格类型中仍然没有找到合适的规格，系统将继续搜索更低性能的计算增强型虚拟机，直到按照性能顺序检索完全部计算增强型虚拟机。如果在所有计算增强型虚拟机规格中均未找到符合要求的规格，则会报错提示。 匹配业务场景 以源端业务场景为基础，结合华为云最佳实践进行资源规格推荐。 系统将基于源端业务场景自动选择一系列性能要求相匹配的规格类型，并将这些类型根据“优先级设置”选项（价格优先或性能优先）进行排序，依次检索各类型下所有虚拟机规格，选出第一个CPU和内存均不小于源端，且在阈值内的在售规格。如检索完所有规格类型仍未匹配到合适的规格，则会报错提示。 例如： 源端规格4U8G，优先级设置选择“性能优先”，应用场景为个人应用，则推荐X实例和通用计算型。 X实例有相同规格在售，则目的端推荐x1.4u.8g。 X实例无相同规格在售，但有阈值内规格，如4u10g的规格在售，则目的端推荐x1.4u.10g X实例无阈值内规格在售，则检索低一个性能等级的规格类型，存在CPU和内存大小均不低于源端且在阈值内的规格在售，则选择该规格；如果不存在，则继续查找更低性能的规格类型，直至按照性能顺序检索完全部对标的虚拟机规格类型，如果仍无符合要求的规格，则会报错提示。 优先级设置 性能优先 推荐的目的端规格要求性能最佳。 价格优先 推荐的目的端规格在满足要求的前提下尽量节约成本。 偏好设置 虚拟机类型偏好（可选） 选择期望的目的端主机类型，支持多选。 虚拟机规格族偏好（可选） 根据选择的主机类型，罗列出包含的规格族类型，选择期望的目的端主机规格族，支持多选。 须知： 勾选“仅显示适合专属主机规格族”，则只能选择在购买区域所选Region下专属主机所包含的规格，并且虚拟机类型偏好将无法选择。 系统盘规格偏好（可选） 选择期望的目的端系统盘规格类型。 数据盘规格偏好（可选） 选择期望的目的端数据盘规格类型。 虚拟机规格调整 选择主机性能规格的推荐策略。 选择“不调整”，会推荐与源端主机性能相同或不小于源端且在阈值内的CPU核数、内存大小。 设置了虚拟机规格族偏好 在“虚拟机规格族偏好”里选择了规格族，则根据“优先级设置”选项（价格优先或性能优先），按照价格/性能对该规格族下规格类型进行排序，并按顺序检索各规格类型下所有规格，选出第一个CPU和内存均不小于源端，且在阈值内的在售规格。如果检索完列表仍未找到合适规格，则会报错提示。 未设置虚拟机规格族偏好 未选择“虚拟机规格族偏好”，则推荐逻辑与所选的推荐策略（匹配源端规格或匹配业务场景）一致。 选择“按性能负载调整”，需要先完成源端主机性能采集，获取源端主机性能负载数据，再通过设置数据处理规则，推荐满足条件的CPU核数、内存大小。采集的性能数据越多，推荐的规格越准确，建议主机性能采集时长不少于7天。 选择“按性能负载调整”，会通过设置的数据处理规则对目标CPU数量和内存大小进行调整。从最后一条采集数据起，选取“性能数据范围（天）”内的数据，从小到大排序，再根据设定的“CPU性能基准百分位”，从排序后的数据中选取相应的性能数值，最后使用设定的“CPU舒适系数”，对选定的性能数值进行调整。计算方式如下： CPU = 性能基准百分位的数值 x 源端CPU个数 x 舒适系数，向上取整。 内存 = 性能基准百分位的数值 x 源端内存大小 x 舒适系数，向上取整。 例如： 源端规格为8u16g，性能数据范围设为7天，CPU的性能基准百分位设为100%，CPU舒适系数为1.2，内存性能基准百分位设为95%，内存舒适系数为1，则会选取近7天的数据，从小到大排序，选取性能百分位坐标处的性能数值（假设分别为40%和50%），则： CPU = 40%（性能百分位数值）x 8（源端CPU个数）x 1.2（舒适系数）= 3.8，向上取整，CPU推荐值为4。 内存 = 50%（性能百分位数值）x 16 GB（源端内存大小）x 1（舒适系数）= 8 GB，内存推荐值为8 GB。 然后根据“匹配源端规格”的推荐逻辑，如果X实例的4U8G没有售完，则会推荐4U8G的X实例规格（x1.4u.8g）。 注意： 如果选择开启“忽略样本过少性能数据”，且采样的性能数据少于性能数据范围（天） x 288（采集默认5min一次，一天288次） x 50%，则不会根据性能进行调整。 设置了虚拟机规格族偏好 在“虚拟机规格族偏好”里选择了规格族，则根据“优先级设置”选项（价格优先或性能优先），按照价格/性能对该规格族下规格类型进行排序，并按顺序检索各规格类型下所有规格，使用对源端调整后的规格，选出第一个CPU和内存均不小于源端，且在阈值内的在售规格。如果检索完列表仍未找到合适规格，则会报错提示。 例如：源端规格为8U16G，通过性能数据调整后的规格为4U8G，优先级设置为性能优先，高级设置中选择计算增强型，且计算增强型中性能最强的C7有4U8G在售，则会推荐4U8G的C7规格；如果无4U8G的规格，但有阈值内规格（如8U8G）在售，则会推荐不小于且最接近的C7规格，如果没有阈值内规格，则依次检索性能较低的规格。如果检索完所有性能类型仍无符合要求的规格，则会报错提示。 未设置虚拟机规格族偏好 未选择“虚拟机规格族偏好”，则使用对源端调整后的规格，推荐逻辑与所选的推荐策略（匹配源端规格或匹配业务场景）一致。 例如：应用场景为个人应用（对应通用计算型），源端规格为8U16G，通过性能数据调整后的规格为4U8G，优先级设置为性能优先，高级设置中未选择规格族，如果X实例有4U8G在售，则会推荐4U8G的X实例规格（x1.4u.8g）。 父主题： 规格评估

操作步骤 换包操作。 在安装MgC Agent的主机，执行如下命令，进入MgC Agent指定目录。 cd /opt/cloud/Edge/tools/plugins/collectors/bigdata-migration/hadoop3 执行如下命令，删除目录下的旧包。 rm -f hadoop-c* hadoop-m* hadoop-y* zookeeper-* hbase-* hadoop-h* 从集群HBase客户端复制新包并存放到指定目录。请根据实际情况替换xxxx@xxx.xx.xx.xx为安全集群的用户名和IP地址。 scp hadoop-c* hadoop-m* hadoop-y* zookeeper-* hbase-* opentracing-* jaeger-core-* commons-validator* hadoop-h* xxxx@xxx.xx.xx.xx:/opt/cloud/Edge/tools/plugins/collectors/bigdata-migration/hadoop3 修改新包的权限和用户。 chmod 755 hadoop-c* hadoop-m* hadoop-y* zookeeper-* hbase-* opentracing-* jaeger-core-* commons-validator* hadoop-h* chown edge:edge hadoop-c* hadoop-m* hadoop-y* zookeeper-* hbase-* opentracing-* jaeger-core-* commons-validator* hadoop-h* 重启MgC Agent。 cd /opt/cloud/Edge/scripts sh start.sh

操作步骤 参考创建元数据连接，创建第一个Delta元数据连接。 使用步骤1.创建的第一个元数据连接，创建元数据同步任务，将源端的元数据同步至迁移中心。 创建N个Delta元数据连接，除了执行机IP和端口不同以外，其余参数配置需要与步骤1.中的第一个元数据连接保持一致。 “N”需要根据您现有的ECS资源和表的数量来确定。在ECS资源充足且表数量非常多的情况下，增加元数据连接的数量可以提高数据校验的效率。 为避免数据重复，除了步骤1.创建的第一个元数据连接以外，新增的元数据连接不需要创建同步任务进行元数据采集。 参考创建表组并添加数据表，将源端数据表加入表组中。其中元数据连接选择步骤1.创建的第一个元数据连接。 分别创建源端执行机连接和目的端执行机连接，方法请参考创建执行机连接。 分别创建源端Delta统计任务和目的端Delta统计任务并执行，方法请参考创建统计任务并执行校验。需要注意，在配置任务时，命令参数中的Spark-submit命令需要配置mgc.delta.metadata.client.ips参数，参数值为所有元数据连接的IP地址和端口，用英文逗号分隔。 例如：mgc.delta.metadata.client.ips = xx.xx.xx.xx:22,xx.xx.xx.xx:22