华为云用户手册

约束与限制 创建EMR Delta Lake到 MRS Delta Lake数据校验任务存在以下约束与限制： 源端EMR环境的Spark版本为3.3.1时，支持Delta Lake（有元数据）和Delta Lake（无元数据）的数据校验。 源端EMR环境的Spark版本为2.4.8时，仅支持Delta Lake（有元数据）的数据校验。 Hbase校验不支持纯冷数据表。 在进行Hive 2.x与Hive 3.x版本间数据校验时，由于Hive 2.x版本在查询固定长度字符串类型char(N)数据时，如果实际数据长度不满足N长度，Hive会以空格补齐至N长度。而Hive 3.x版本在查询时不会进行这种补齐操作。这可能导致在不同版本间比较结果时出现差异。为了避免因版本差异导致的数据不一致问题，建议使用Beeline作为客户端工具进行作业对数。 在进行ClickHouse数据校验时，如果源端阿里云的ClickHouse版本为21.8.15.7，目的端华为云的ClickHouse版本为23.3.2.37，由于这两个版本在处理IPv4和IPv6字段类型以及相关函数计算结果上存在差异，因此无法进行字段校验。 在执行Hive数据的日级别增量、小时级增量以及指定日期的校验时，如果分区字段为date类型，且分区值的格式不是标准的YYYY-MM-DD时，系统目前不支持对这种场景进行数据校验。

购买资源 场景 委托对象 自定义策略名称 细粒度最小使用权限 购买资源 MgC MgC PurchaseAgencyPolicy eps:resources:add（企业项目资源迁入） ecs:cloudServers:createServers（创建云服务器） evs:volumes:list（查询云硬盘列表） ecs:cloudServerFlavors:get（查询云服务器规格详情和扩展信息列表） ecs:cloudServers:list（查询云服务器详情列表） vpc:publicIps:update（更新弹性公网IP） vpc:publicIps:create（创建弹性公网IP）

迁移方案配置 场景 委托对象 自定义策略名称 细粒度最小使用权限 主机标准迁移模板 - 导入OBS桶里的目的端配置 MgC MgC ImportTargetConfigurationAgencyPolicy obs:object:GetObject（获取对象内容、获取对象元数据） obs:bucket:ListBucket（列举桶内对象） obs:bucket:ListAllMyBuckets（获取桶列表） 主机标准迁移模板 - 导出支持的目的端配置 MgC ExportTargetConfigurationAgencyPolicy ims:images:list（查询镜像列表） ecs:cloudServerFlavors:get（查询云服务器规格详情和扩展信息列表） 对象存储批量迁移模板-配置目的端 MgC ListObsBucketsAgencyPolicy obs:bucket:ListBucket（列举桶内对象） obs:bucket:ListAllMyBuckets（获取桶列表）

创建迁移集群 场景 委托对象 自定义策略名称 细粒度最小使用权限 创建迁移集群 OMS OMS ObsMigrationAgencyPolicy ecs:cloudServers:createServers（创建云服务器） ecs:cloudServers:listServerInterfaces（查询云服务器网卡信息） ecs:cloudServers:showServer（查询云服务器详情） ecs:cloudServers:deleteServers（删除云服务器） nat:natGateways:create（创建NAT网关） nat:natGateways:get（查询NAT网关详情） nat:natGateways:delete（删除NAT网关） nat:snatRules:create（创建SNAT规则） nat:snatRules:get（查询SNAT规则详情） nat:dnatRules:list（查询DNAT规则列表） nat:snatRules:list（查询SNAT规则列表） nat:snatRules:delete（删除SNAT规则） nat:natGateways:list（查询NAT网关列表） vpc:securityGroups:create（创建安全组） vpc:securityGroups:delete（删除安全组） vpc:securityGroups:get（查询安全组列表或详情） vpc:securityGroupRules:create（创建安全组规则） vpc:securityGroupRules:get（查询安全组规则列表或详情） vpc:securityGroupRules:delete（删除安全组规则） vpcep:epservices:create（创建终端节点服务） vpcep:epservices:get（查询终端节点服务详情） vpcep:epservices:delete（删除终端节点服务） vpcep:connections:update（接受或拒绝终端节点的连接） vpcep:permissions:update（批量添加或移除终端节点服务的白名单） lts:topics:create（创建日志主题） lts:topics:delete（删除指定日志主题） lts:groups:create（创建日志组） lts:groups:get（查询指定日志组） lts:groups:delete（删除指定日志组） ims:images:list（查询镜像列表） E CS ECS ObsMigrationAgencyPolicy apm:icmgr:*（apm采集组件的所有权限）

配置主机购买模板 场景 委托对象 自定义策略名称 细粒度最小使用权限 配置主机购买模板 MgC MgC PurchaseTemplateAgencyPolicy iam:projects:listProjects（查询租户项目） eps:enterpriseProjects:list（查看企业项目列表） vpc:subnets:get（查询子网列表或详情） vpc:securityGroups:get（查询安全组列表或详情） vpc:vpcs:get（查询虚拟私有云详情）

主机迁移 工作流 场景 委托对象 自定义策略名称 细粒度最小使用权限 主机迁移工作流 MgC MgC ServerMigrationAgencyPolicy ecs:cloudServers:showServer（查询云服务器详情） ecs:cloudServers:createServers（创建云服务器） sms:server:migrationServer（迁移源端服务器） sms:server:queryServer（查看源端服务器） ecs:cloudServers:list（查看云服务器列表） ecs:cloudServers:listServerBlockDevices（查询弹性云服务器磁盘信息） ecs:cloudServerQuotas:get（查询租户配额） vpc:publicIps:create（创建弹性公网IP） ecs:cloudServers:get（查询云服务器详情） ecs:cloudServers:changeVpc（云服务器切换虚拟私有网络） ecs:cloudServers:attach（弹性云服务器云主机挂载磁盘） ecs:cloudServers:start（批量启动云服务器） ecs:cloudServers:detachVolume（卸载指定弹性云服务器的磁盘） ecs:cloudServers:stop（批量关闭云服务器） ecs:servers:unlock（解锁定云服务器） evs:volumes:delete（删除云硬盘） evs:volumes:use（云硬盘挂载和卸载依赖） evs:volumes:get（查询单个云硬盘详情） vpc:privateIps:list（查询私有IP列表） ims:images:get（查询镜像详情）

跨可用区迁移 场景 委托对象 自定义策略名称 细粒度最小使用权限 跨可用区迁移 MgC MgC AzMigrationAgencyPolicy ecs:cloudServers:showServer（查询云服务器详情） ecs:flavors:get（查询云服务器规格） ecs:cloudServerFlavors:get（查询云服务器规格详情和扩展信息列表） ecs:cloudServerQuotas:get（查询租户配额） ecs:servers:list（查询云服务器列表） ecs:cloudServers:list（查询云服务器详情列表） ecs:servers:stop（关闭云服务器） ecs:cloudServers:listServerInterfaces（查询云服务器网卡信息） ecs:cloudServers:createServers（创建云服务器） ecs:cloudServers:listServerBlockDevices（查询弹性云服务器磁盘信息） ecs:cloudServerNics:update（云服务器网卡配置私有IP） ecs:availabilityZones:list（查询可用区列表） ecs:servers:start（启动云服务器） ecs:cloudServers:changeNetworkInterface（更新云服务器指定网卡属性） ecs:serverInterfaces:get （查询云服务器网卡） ecs:cloudServers:get（查询云服务器详情） vpc:publicIps:create（创建弹性公网IP） vpc:publicIps:update（更新弹性公网IP） vpc:subnets:get（查询子网列表或详情） vpc:networks:get（查询网络列表或详情） vpc:publicIps:list（查询弹性公网IP） vpc:publicIps:get（查询弹性公网IP详情） vpc:ports:get（查询端口列表或详情） vpc:ports:delete（删除端口） vpc:ports:update（更新端口） vpc:ports:create（创建端口） evs:types:get（查询云硬盘类型） evs:volumes:list（查询云硬盘列表） cbr:vaults:get（查询指定存储） cbr:vaults:list（查询存储库列表） cbr:vaults:create（创建存储库） cbr:vaults:addResources（添加资源） cbr:vaults:backup（执行备份） cbr:backups:list（查询备份列表） cbr:tasks:list（查询任务列表） cbr:tasks:get（查询单个任务） cbr:backups:delete（删除备份） cbr:backups:get（查询指定备份） cbr:vaults:delete（删除存储库） ims:wholeImages:create（制作整机镜像） ims:images:list（查询镜像列表） ims:images:delete（删除镜像） ims:images:get（查询镜像详情） ims:serverImages:create（制作镜像）

规格评估 场景 委托对象 自定义策略名称 细粒度最小使用权限 规格评估 MgC MgC ServerAssessAgencyPolicy ecs:cloudServerFlavors:get（查询云服务器规格详情和扩展信息列表） ims:images:list（查询镜像列表） evs:types:get（查询云硬盘类型） deh:dedicatedHosts:get（获取专属主机详情） deh:dedicatedHosts:list（查询专属主机列表）

认证方式 当前仅支持添加公有云资源类型的凭证。支持的认证方式参见表1。 表1 公有云认证方式 资源类型 认证方式 说明 公有云 AK/SK 适用于添加华为云、阿里云、AWS、腾讯云、七牛云和金山云等云平台凭证。各云平台的AK/SK获取方法请参考如何获取云平台凭证。 配置文件 适用于添加谷歌云平台凭证。配置文件需要上传谷歌云服务账号凭据，该凭证必须为json格式文件，且大小不能超过4KB。 ID/密钥 适用于添加Azure平台凭证。添加凭证所需的信息获取方法请参见如何获取添加Azure凭证所需的信息。 云上凭证的存储有效期为7天，超过7天后，凭证会过期，需要重新输入。

IAM 用户权限 MgC在 统一身份认证 服务（IAM）能力基础上，为用户提供细粒度的权限管理功能，帮助用户灵活便捷地对账号下的IAM用户设置不同的MgC资源权限，结合权限策略实现权限隔离。 以下是使用MgC不同功能时，IAM用户需要配置的权限。为IAM用户配置权限的方法请参考创建自定义策略。 功能 权限Action 配置主机购买模板 vpc:vpcs:list（查询虚拟私有云列表） vpc:subnets:get（查询子网列表或详情） vpc:publicIps:list（查询弹性公网IP） vpc:securityGroups:get（查询安全组列表或详情） eps:enterpriseProjects:list（查看企业项目列表） ecs:availabilityZones:list（查询可用区列表） 主机迁移工作流 vpc:vpcs:list（查询虚拟私有云列表） vpc:vpcs:get（查询虚拟私有云详情） vpc:subnets:get（查询子网列表或详情） vpc:publicIps:list（查询弹性公网IP） vpc:publicIps:get（查询弹性公网IP详情） vpc:securityGroups:get（查询安全组列表或详情） eps:enterpriseProjects:list（查看企业项目列表） eps:enterpriseProjects:get（查看有企业项目详情） 主机规格评估 ecs:cloudServerFlavors:get（查询云服务器规格详情和扩展信息列表） ecs:cloudServers:list（查询云服务器详情列表） ecs:cloudServers:showServer（查询云服务器详情） ecs:flavors:get（查询云服务器规格） ims:images:list（查询镜像列表） ims:images:get（查询镜像详情） evs:volumes:list（查询云硬盘列表） evs:types:get（查询云硬盘类型） AZ迁移工作流 ecs:availabilityZones:list（查询可用区列表） 配置TCO对比产品映射 ecs:cloudServerFlavors:get（查询云服务器规格详情和扩展信息列表） ims:images:list（查询镜像列表） evs:types:get（查询云硬盘类型） 存储迁移工作流 Tenant Guest（全部云服务只读权限）(除IAM权限) OMS Administrator（ 对象存储迁移 服务所有权限） 迁移集群 Tenant Guest（全部云服务只读权限）(除IAM权限) OMS Administrator（对象存储迁移服务所有权限） nat:natGateways:list（查询NAT网关列表） smn:topic:list（主题查询权限） 委托授权 iam:agencies:listAgencies（查询指定条件下的委托列表信息） iam:roles:listRoles（查询权限列表） iam:quotas:listQuotas（查询配额） iam:permissions:listRolesForAgency（查询委托的所有权限） iam:agencies:createAgency（创建委托） iam:permissions:grantRoleToAgency（为委托授予指定权限） iam:roles:createRole（创建自定义策略） iam:roles:updateRole（修改自定义策略） 父主题： 权限管理

产品对比 在使用成本方面，系统会对指定时间内，源端云厂商使用费用和华为云使用费用进行比较，您可以在产品对比页面的对比结果中查看。 我们还会给出源端云厂商和华为云同等规格配置的产品月均成本比较，您可以在产品对比页面的产品价格对比中查看。并且可以通过和您的销售经理沟通，针对每种类别产品分别调整价格计算比例（优惠折扣）进一步优化华为云的使用成本。 在上云成本分析（凭证）任务列表，单击任务名称。 单击操作列的“产品对比”按钮，进入“产品对比”页面。 查看成本对比结果和产品价格对比，根据实际情况调整价格计算比例（优惠折扣）优化华为云的使用成本。 单击页面右上角“导出结果”按钮，可以将产品对比结果导出PDF格式到本地。

查看配置 系统会根据解析出来的产品规格及用量自动匹配华为云上的产品及用量，在匹配策略上系统坚持在不低于您当前配置的前提下优先考虑成本的原则，给出华为云上的产品规格及用量配置。 您可以通过查看配置进入产品映射明细列表，在这个列表中，您可以添加、修改、删除产品和规格映射，调整程序预定义的资源映射逻辑，从而获取您真实需要的产品规格列表。 在上云成本分析（凭证）任务列表，单击任务名称。 单击操作列的“查看配置”按钮，进入“产品映射”页面。 单击映射类型前的按钮，可以查看映射详情。 映射：指在不同产品或规格之间建立的对应关系。 标准映射：指迁移中心推荐的源端产品规格到华为云的对应产品规格。 非标准映射：指在没有标准映射产品规格可用时，迁移中心选择的最接近的替代产品规格，或者用户根据需求手动更改后所选择的产品规格。

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

操作流程 操作步骤 说明 准备工作 注册华为账号 、开通华为云，并为账户充值。 获取账号迁移权限。 获取目的端账号的AK/SK。 创建项目 通过创建独立的项目，可以将不同的操作场景进行区分和隔离，从而实现更好的组织管理和资源分配。 下载并安装MgC Agent（原Edge） MgC Agent是用于配合迁移中心进行源端资源发现与采集的工具，同时MgC Agent还提供了工作流模块，用于配合云端迁移工作流任务。 采集主机资源 通过公网采集/内网采集/手动添加等方式，获取源端主机资源。 关联应用（可选） 将采集到的待迁移主机添加到应用，在后续的规格评估和创建迁移工作流时，选择该应用，即可对与应用中的所有主机进行目的端规格评估和创建迁移工作流。 规格评估 规格评估是根据源端资源规格、性能和应用场景以及特定的成本、可用性、性能、安全合规等需求，为您推荐最合适的华为云对应资源规格。 创建主机迁移工作流 通过迁移工作流，将源端主机批量迁移到目的端。

功能介绍 日志记录：系统会生成详细的操作日志，日志文件存储于：{MgC Agent安装路径}/logs/audit/audit.log 。 事件记录界面：MgC Agent控制台提供事件记录页面，可以查看事件来源、资源名称、关键行为名称、操作时间和结果等事件记录。 过滤与搜索：事件记录列表支持按关键行为名称进行过滤和按关键字进行搜索。 错误排查：当操作结果为失败时，可以查看MgC Agent日志以获取失败原因。 关键行为和资源显示： 对于修改密码或凭证等关键行为，资源字段会显示账号名称或凭证ID等内容。 对于MgC下发指令给MgC Agent或MgC Agent上报数据到MgC等关键行为，资源字段会显示存储这些内容的文件所在路径，您可以根据以下路径自行查找。 下发指令存储在{MgC Agent安装路径}/logs/audit/downlink_command.txt文件中。 上报数据存储在{MgC Agent安装路径}/logs/audit/uplink_data.txt文件中。 周期性日志归档：系统会自动在每月初将audit.log文件压缩为zip包并存储到 {MgC Agent安装路径}/logs/audit/目录下，压缩包名称为：年份-月份.zip，例如：2024-xx.zip。

离线升级 使用注册的用户名、密码登录MgC Agent控制台，在左侧导航树选择“采集工具管理”，进入应用关联采集器页面。 可以查看已安装的采集器类型、版本以及安装路径等信息。 在迁移中心管理控制台的迁移工具页面，下载最新版本的采集器安装包，并放入MgC Agent安装目录的根目录下（如C:\Edge），请勿修改采集器安装包名称。然后单击“离线升级”按钮，系统开始自动安装并升级采集器。 在应用关联采集器页面，查看已安装的采集器版本信息更新为最新版本时，代表采集器已升级完成。 如果安装包中包含多个采集器，会一次性全部升级。

手动升级 使用注册的用户名、密码登录MgC Agent控制台，在左侧导航树选择“采集工具管理”，进入应用关联采集器页面。 可以查看已安装的采集器类型、版本以及安装路径等信息。 如果是新增采集器，在迁移中心管理控制台的迁移中心Agent页面，下载采集器安装包并手动解压至采集器安装路径下（如C:\Edge\tools\plugins\collectors\app-discovery-collectors\python\mgc-app-discovery-collectors），然后单击“刷新状态”按钮，系统会自动安装采集器。在应用关联采集器页面，查看已安装的采集器列表出现新增的采集器时，代表新增采集器成功。 如果需要修改采集器配置文件，复制采集器的安装路径，打开配置文件所在目录，找到配置文件修改并保存后，单击“刷新状态”按钮，系统会自动更新采集器配置信息。

Windows系统 以下步骤以Windows 11 为例。 启动脚本位置。 在MgC Agent安装目录下（默认为C:\Edge）：.\tools\SecAs-1.2.29\bin\startup.bat，启动脚本。 配置JVM参数。 进入MgC Agent安装目录下（默认为C:\Edge），编辑.\tools\SecAs-1.2.29\bin\catalina.bat，配置参数。 在文件中 “@echo off”的下一行，添加如下信息： set "JAVA_OPTS=-Xms512M -Xmx1024M" 其中“-Xms512M -Xmx1024M”即为可进行配置的JVM参数。-Xms512M 表示JVM初始分配的堆内存为512M。-Xmx1024M 表示JVM最大允许分配的堆内存为1024M。可按需添加其他JVM参数。 单击保存，退出catalina.bat。完成EdgeTomcat服务器JVM参配置。 该配置只对启动脚本启动的MgC Agent生效，开机或者服务自动启动的MgC Agent不生效。 重启EdgeTomcat服务器。 若主机上MgC Agent还在运行，则需先停止Edge Tomcat服务器以及采集器插件，再重新启动MgC Agent。 停止Edge Tomcat服务器： 若是由开机或者服务自动启动的MgC Agent，则按以下步骤操作： 打开任务管理器（可以按下ctrl + alt + delete，并在弹出的页面中选择 任务管理器 打开）。在任务管理器的页签中选择详细信息。 图1 详细信息 找到名为“ tomcat9.exe”的程序，选中后单击结束任务。 图2 结束任务 若是由运行脚本文件启动的MgC Agent，则关闭运行脚本时弹出的“命令提示符” 窗口即可。 图3 命令提示符 停止采集器插件： 通过任务管理器停止采集器插件： 打开任务管理器（可以按下ctrl + alt + delete，并在弹出的页面中选择 任务管理器 打开）。在任务管理器的页签中选择详细信息。 图4 详细信息 找名为“ rda-storage-collector.exe” “rda-collector-server.exe”、“rda-collector-platform.exe”、“rda-collector-kubernetes.exe”、“rda-collector-database.exe” 的程序，分别选中后再单击结束任务。 图5 结束任务 通过运行脚本结束单个采集器插件程序（以停止采集插件 rda-storage-collector 为例）： 进入MgC Agent安装目录下（默认为C:\Edge\tools\plugins\collectors\rda-storage-collector\bin\stop.bat），运行stop.bat。 在 .\tools\plugins\collectors 目录下找到对应采集器插件的目录。 重启MgC Agent： 进入MgC Agent安装目录下（默认为C:\Edge），运行.\tools\SecAs-1.2.29\bin\startup.bat。即可重新启动Edge Tomcat服务器以及对应采集器插件。 查询正在运行的Edge Tomcat服务器的JVM参数。 此功能需要在windows上安装java开发环境。 打开任务管理器（可以按下ctrl + alt + delete，并在弹出的页面中选择 任务管理器 打开）。在任务管理器的页签中选择详细信息。 图6 详细信息 分以下两种情况： 若是由开机或者服务自动启动的MgC Agent，则在任务管理器寻找名为 tomcat9.exe 的程序，查看其对应pid。 图7 任务管理器 若是由启动脚本启动的MgC Agent，则寻找 java.exe 的程序，查看其对应pid。若有多个 java.exe 的程序的情况，解决方法如下： 多个 java.exe 的程序，在查询了某个java程序JVM信息后，可通过命令提示符返回的内容中 java_class_path 字段的值来判断是否为MgC Agent程序。包含MgC Agent与tomcat字段的极大可能为MgC Agent程序。 获取到pid后，以管理员权限打开命令提示符（cmd），并输入如下指令并回车： jinfo PID PID 为 之前获取到的MgC Agent程序pid，在命令提示符返回的内容中，可查看生效的JVM参数。 图8 命令提示符

Linux系统 以下步骤以centos8为例。 启动脚本位置 在MgC Agent安装目录下（默认为/opt/cloud/Edge） ./scripts/start.sh，启动脚本。 配置JVM参数 MgC Agent安装目录下（默认为/opt/cloud/Edge），编辑. /tools/SecAs-1.2.29/bin/catalina.sh。 在文档的开头，添加信息： JAVA_OPTS="-Xms512M -Xmx1024M" 其中“-Xms512M -Xmx1024M”即为可进行配置的JVM参数。-Xms512M 表示JVM初始分配的堆内存为512M。-Xmx1024M 表示JVM最大允许分配的堆内存为1024M。可按需添加其他JVM参数。 单击保存，退出catalina.bat。完成Edge Tomcat服务器JVM参配置。 重启Edge Tomcat服务器。 若主机上MgC Agent还在运行，则需先停止Edge Tomcat服务器以及采集器插件。 在MgC Agent安装目录下（默认为/opt/cloud/Edge），进入.\script 目录。 执行以下命令，停止MgC Agent脚本。 sh stop.sh MgC Agent停止后，再执行以下命令，启动MgC Agent脚本，完成MgC Agent重启。 sh start.sh 查询正在运行的Edge Tomcat服务器的JVM参数。 输入“ps -ef|grep java”命令，查看运行MgC Agent时的JVM参数。

查看大数据插件日志 执行如下命令，进入MgC Agent安装目录中的日志目录。该目录包含了大数据插件运行时产生的各种日志文件。 cd /opt/cloud/Edge/tools/plugins/collectors/bigdata-migration/logs 使用vi命令来查看具体的日志文件。 vi xxx.log xxx.log需要替换为具体的日志文件名。不同类型的日志文件名和说明参加下表： 日志文件名 说明 debug.log 大数据插件运行时调试日志。 error.log 大数据插件运行时报错日志。 run.log 大数据插件运行时全部日志。 warn.log 大数据插件运行时告警日志。 rda_run.log 记录插件启动命令。 api.log/user.log 已弃用，无内容记录。 如果日志文件已经被归档，可以按照如下步骤查看归档日志。 使用cd命令进入归档日志目录。xxx/需要替换为具体的归档日志目录。 cd xxx/ 使用 gunzip 命令来解压对应的归档日志文件，以便查看。例如，归档日志文件名为 archived_log.gz，则可以使用命令 gunzip archived_log.gz 来解压。

操作步骤 在安装旧版本MgC Agent的Windows主机，登录迁移中心管理控制台。 在左侧导航栏单击“迁移中心Agent”，进入迁移中心Agent页面。 在Windows版区域，单击“下载安装包”，将最新版本的MgC Agent安装程序下载到Windows主机。 双击最新版本的MgC Agent安装程序，开始安装，覆盖旧版本的MgC Agent。安装完成后，前往MgC控制台，在设备列表中确认设备的版本已更新为最新版本。

查看MgC Agent各种日志文件 执行如下命令，进入MgC Agent安装目录中的日志目录。该目录包含了MgC Agent运行时产生的各种日志文件。 cd /opt/cloud/Edge/logs/edge-server 使用vi命令来查看具体的日志文件。 vi xxx.log xxx.log需要替换为具体的日志文件名。不同类型的日志文件名和说明参加下表： 日志文件名 说明 debug.log MgC Agent运行时调试日志。 error.log MgC Agent运行时报错日志。 operation.log 操作日志，记录用户对接口调用日志。 plugins.log IoTDA相关日志，记录了MgC Agent与Mgc通过IoTDA交互的消息日志。 run.log MgC Agent运行时全部日志。 warn.log MgC Agent运行时告警日志。 user.log 用户审计日志。 如果日志文件已经被归档，可以按照如下步骤查看归档日志。 使用cd命令进入归档日志目录。xxx/需要替换为具体的归档日志目录。 cd xxx/ 使用 gunzip 命令来解压对应的归档日志文件，以便查看。例如，归档日志文件名为 archived_log.gz，则可以使用命令 gunzip archived_log.gz 来解压。

WinRM远程连接失败故障排查 如果远程连接测试失败，请参考方法进行故障排查： 检查端口连接：使用 telnet 命令测试源端服务器的5985端口是否可以访问。如果端口无法访问，检查源端防火墙或安全防护软件设置，确保5985端口开放。 telnet ip port 检查网络配置：检查网络执行模式是否设置为“经典模式”，通过以下注册表命令检查： reg query "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa" /v forceguest 如果 forceguest 的值为“REG_DWORD 0x0”，则代表网络执行模式是“经典模式”。 如果 forceguest 的值不是“REG_DWORD 0x0”，使用以下命令设置或更新 forceguest 值： reg add "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa" /v forceguest /t reg_dword /d 0x0 确认账号密码：确保在连接命令中输入的账号和密码是准确无误，错误的凭证会导致登录失败。 请按照以上方法排查，通常能够帮助定位并解决连接问题。如果问题依旧存在，建议联系技术支持人员寻求帮助。

解决方法 请按照以下步骤，手动启动MgC Agent进程： 执行如下命令，进入MgC Agent安装目录中的scripts目录。 cd /opt/cloud/Edge/scripts/ 执行如下命令，启动MgC Agent。 ./start.sh 当出现如下图所示提示时，表示MgC Agent已经启动。 执行如下命令，查看MgC Agent进程。 ps -ef |grep edge 当出现如下图所示提示时，表示MgC Agent进程已经启动。

WinRM服务配置 使用管理员权限（如 administrator 账户或 administrators 组内的本地账户）登录到源端服务器。 以管理员权限运行PowerShell。 在PowerShell中执行如下命令，启动WinRM服务。 winrm quickconfigEnable-PSRemotingSet-ExecutionPolicy -ExecutionPolicy RemoteSigned 使用管理员权限，登录安装MgC Agent（原Edge）的服务器，并以管理员权限运行PowerShell。步骤5.~7.均在安装MgC Agent的主机上执行。 配置信任主机。 在PowerShell中执行如下命令，将源端服务器加入到信任的host中。 winrm set winrm/config/client '@{TrustedHosts="*"}' 出于安全考虑，建议使用源端服务器的WinRMhost（即主机名或IP地址）替换TrustedHosts 的值"*"。不替换代表信任任意主机。 测试远程连接。 使用以下命令测试与源端服务器的连接，“登录账号”和“源端服务器IP”需要替换为源端服务器实际的登录账号和IP地址。 Enter-PSSession -Credential 登录账号 -ComputerName 源端服务器IP 在弹出的对话框中输入源端服务器登录账号对应的密码，单击“确定”，测试是否连接成功。 如果连接成功，可以输入任意命令来测试联调性。 如果连接失败，请参考WinRM远程连接失败故障排查，进行处理。

主机深度采集 完成主机资源发现后，可以按照以下步骤对主机资源进行深度采集。 在主机列表，单击操作列的“配置凭证”，弹出配置窗口。 根据表2，配置参数。 表2 深度采集参数配置说明 参数 配置说明 类型 根据实际的主机操作系统类型选择。 IP 选择主机接入IP，可以为公网IP，也可以是私有IP。 端口 主机开放端口。 Windows主机默认为5985端口，无法修改。 Linux主机默认22端口，可根据实际情况修改。 凭证 选择主机凭证。 如果已提前添加主机凭证，在下拉列表中选择该主机凭证。 如果未提前添加主机凭证，单击“创建凭证”，参考添加资源凭证中的Windows主机/Linux主机认证方式说明创建主机凭证。创建完成后，在下拉列表中选择该主机凭证。 须知： 为确保采集过程具备充分的系统访问权限，从而能够获取到必要的信息和数据。对主机深度采集的凭证要求如下： 对Linux主机进行深度采集时，请添加Root账号和密码作为采集凭证。 对Windows主机进行深度采集时，请添加Administrator账号和密码作为采集凭证。 凭证配置完成后，单击操作列的“深度采集”，系统开始深度采集。当深度采集列的状态为“已完成”时，代表采集完成。

Linux版本 执行如下命令，进入MgC Agent安装目录中的scripts目录。 cd /opt/cloud/Edge/scripts/ 执行如下命令，启动MgC Agent。 ./start.sh 当出现如下图所示提示时，表示MgC Agent已经启动。 执行如下命令，查看MgC Agent进程。 ps -ef |grep edge 当出现如下图所示提示时，表示MgC Agent进程已经启动。

操作步骤 执行如下命令，进入MgC Agent安装目录中的scripts目录。 cd /opt/cloud/Edge/scripts/ 执行如下命令，启动MgC Agent卸载脚本。 ./uninstall.sh 当出现如下图所示提示时，表示Linux版的MgC Agent需要更新环境变量。 执行如下命令，更新环境变量。 source /etc/profile 执行如下命令，启动MgC Agent卸载脚本。 ./uninstall.sh 当出现如下图所示提示时，表示Linux版的MgC Agent已经卸载。

操作步骤 使用注册的用户名、密码登录MgC Agent控制台，在左侧导航树选择“任务管理”，进入应任务管理页面。 单击“创建任务”按钮，右侧弹出新建任务窗口，根据待采集资源选择采集器类型，单击“下一步”，进入任务参数配置页面。 在基本参数区域，自定义任务名称；在采集器参数区域，根据采集器参数配置说明，配置采集器参数信息，其中带参数为必填参数。 配置完成后，单击“确认”按钮，采集任务创建完成。在任务列表中可以查看任务的数据源采集状态。 数据源采集成功后，可以通过如下方式获取采集结果： 单击任务操作列的“下载json”，将采集结果保存为json文件，用于将采集结果导入MgC进行应用关联分析，详情请参考导入工具采集结果。 单击任务操作列的“下载csv”，将采集结果保存为csv文件，用于本地查看采集结果。 单击任务操作列的“显示结果路径”，可以查看采集结果存放路径。

解决方法 将占用27080端口的应用进程停用。 在将应用进程停用前，请自行评估风险并承担相应后果。 Linux主机： 输入如下命令，查询占用端口的应用ID。 netstat -tlnp | grep 27080 例如，查询到的应用ID为11083。 输入如下命令，根据获得的应用ID查询应用进程。此处的应用ID仅为举例，请根据实际查询结果进行替换。 ps -ef | grep 11083 确认占用端口的应用可以停用后，执行如下命令，将该应用进程停止。然后重新安装MgC Agent。 kill -9 11083 Windows主机： 打开Windows命令行窗口，输入如下命令，查询占用端口的应用ID。 netstat -ano | findstr 27080 例如，查询到的应用ID为5816。以下应用ID仅为举例，请以实际查询结果为准。 打开任务管理器，在“详细信息”页签，根据获得的应用ID查找应用进程。 确认占用端口的应用可以停用后，选择应用进程，单击鼠标右键，选择“结束任务”，将该应用进程停止。然后重新安装MgC Agent。