如何在源端主机下载并安装迁移Agent？

源端Windows系统服务器

登录SMS控制台，在左侧导航树中，单击“迁移Agent”，进入“迁移Agent”页面。
在Windows服务器Agent安装区域，单击Windows Agent下载窗格中的“链接”，仔细阅读并同意服务声明后，单击“是”，下载相应的迁移Agent。
按照界面指引完成安装和启动。

源端Linux系统服务器

登录SMS控制台，在左侧导航树中，单击“ 迁移Agent ”，进入“ 迁移Agent ”页面。
在Linux服务器Agent安装区域，单击Linux Agent下载窗格中的“ 链接 ”，仔细阅读并同意服务声明后，复制Agent的下载命令，前往源端服务器下载迁移Agent。
按照界面指引完成安装和启动。

Agent无法下载该如何处理？

1、首先确认电脑能正常访问互联网，然后在cmd窗口中执行命令，查看是否出现Address。

nslookup sms-agent-2-0.obs.cn-gz1.ctyun.cn

2、如果有解析出IP，查看hosts文件中是否有该域名的记录，有的话删除掉然后重新下载；如果没有出现IP，可以在hosts文件中增加一条如下的记录之后重新下载。

{Addresses}sms-agent-2-0.obs.cn-gz1.ctyun.cn

例如：100.100.100.0 sms-agent-2-0.obs.cn-gz1.ctyun.cn

windows中hosts文件在 C:\Windows\System32\drivers\etc下，使用超级管理员权限打开才能编辑。linux中hosts文件在 /etc目录下。

3、如果尝试以上方法均无法下载，建议换一台电脑下载之后再上传到该服务器上。

如何对迁移Agent进行软件完整性校验？

进入“主机迁移服务”页面。
在“迁移Agent”页面，单击对应Agent的“下载sha256”，将包含Hash值的文件保存到本地。
使用以下命令获取本地迁移Agent程序的Hash值。

Windows：certutil -hashfile SMS-Agent-PyN.exe SHA256

SMS-Agent-PyN.exe代表所下载的迁移Agent。

Linux：sha256sum SMS-Agent.tar.gz
将2获取的Hash值和3获取的Hash值进行比较。
若一致则通过校验。
若不一致，请在“迁移Agent”页面，重新下载对应版本的Agent，重复步骤3~步骤4进行校验。

源端Agent注册后为什么主机迁移服务控制台没有记录？

如果在源端服务器上安装和配置了迁移Agent，但是没有在主机迁移服务控制台查看到该源端服务器。请进行以下排查：

首先请确认源端注册成功，源端注册成功的Linux和Windows Python2版本的控制台会打印“successfully”字样，Windows Python3版本会有“上传源端信息成功”字样。
请确认是否登录错账号或者错误的输入了其他账号的AK/SK。
如果确认源端注册成功，且控制台版本与Agent版本匹配，仍然没有记录，请等待1分钟后刷新页面再查看。

SMS-Agent配置文件中的证书验证开关参数说明

您可以在SMS-Agent安装目录下的 g-property.cfg配置文件中，设置调用API请求时，是否进行证书验证。

servercheck = Ture，表示开启证书验证，在调用API请求时，会进行证书验证。
servercheck = False，表示关闭证书验证，在调用API请求时，不进行证书验证。

如何查找SMS的运行日志？

SMS-Agent的运行日志存放在Agent安装目录下的Logs文件夹中。

表 SMS-Agent的日志文件

类型	路径	说明
startup.log	Windows：C:\SMS-Agent-Py3\Logs或C:\SMS-Agent-Py2\Logs。 Linux：../SMS-Agent/agent/Logs。其中../代表SMS-Agent的解压路径。	记录Agent启动日志信息。
SmsAgent_Info.log	Windows：C:\SMS-Agent-Py3\Logs或C:\SMS-Agent-Py2\Logs。 Linux：../SMS-Agent/agent/Logs。其中../代表SMS-Agent的解压路径。	记录Agent运行的所有日志信息。
SmsAgent_Error.log	Windows：C:\SMS-Agent-Py3\Logs或C:\SMS-Agent-Py2\Logs。 Linux：../SMS-Agent/agent/Logs。其中../代表SMS-Agent的解压路径。	记录Agent运行的错误日志信息。

Linux系统迁移和同步源端数据所产生的日志文件以及获取路径参见下表。

表 Linux系统迁移和同步日志文件

类型	路径	说明
f2f_migrate_schedule.log	/root/f2f_migrate_schedule.log	Linux迁移和同步源端数据时产生的日志。
f2f_migrate_error.log	/root/f2f_migrate_error.log	Linux迁移和同步源端数据时产生的报错日志。

为什么迁移过程中目的端ECS会被锁定？

迁移过程中，操作目的端服务器可能会导致迁移失败。为了保证迁移顺利实施，迁移过程中目的端服务器会被自动锁定，迁移成功之后会自动解锁。如果您想手动解除锁定，请参考如何解除目的端服务器锁定状态？。

如何解除目的端服务器锁定状态？

迁移完成后会自动解除ECS锁定，但是由于权限、网络等因素可能导致解锁目的端失败。如果服务器记录未删除，可以尝试单击该服务器的“更多 > 解锁目的端”进行解锁。如果解锁时提示“权限不足”，请更换有权限的账号重试。如果服务器记录已删除，则需要调用云主机的API接口，解锁云服务器，进行解锁。

Linux版的迁移Agent启动提示“rsync not installed on the source server”该如何处理？

启动Linux版的迁移Agent时，提示“rsync not installed on the source server.”，则说明此源端服务器未安装rsync组件。Linux迁移依赖rsync组件，若源端未安装rsync组件，会导致Agent启动失败。您需要先安装rsync组件，再重新启动迁移Agent。

应用程序因并行配置不正确无法启动

Windows 2008 Python2版本的Agent安装后，无法启动，提示“sms.5109应用程序因并行配置不正确无法启动”。因部分Windows机型权限限制，会导致第一次启动Agent无法启动，可使用如下方式启动Agent。

右键单击开始菜单。
单击“运行”，输入cmd，进入命令行提示符界面。
输入cd C:\SMS-Agent-Py2，切换到Agent安装目录，执行SMSAgentDeploy.exe。

首次启动Agent时无法启动该如何处理？

因部分Windows机型权限限制，会导致第一次启动Agent无法启动，可使用如下方式启动Agent。

右键单击开始菜单。
单击“运行”，输入cmd，进入命令行提示符界面。
输入cd C:\SMS-Agent-Py2，切换到Agent安装目录，执行SMSAgentDeploy.exe。

Windows Agent双击无法运行

安装Windows Agent，双击SMS-Agent安装程序没有响应，无法进入安装向导。为系统设置的安全策略锁定了该文件，需要解除对该文件的锁定。右键单击SMS-Agent-py运行程序查看属性，勾选“解除锁定”，单击“确定”，然后重新运行。

启动Agent时出现“IO监控启动失败”，该如何处理？

如果在源端服务器上启动Agent时，出现“IO监控失败”。请进行以下排查：

卸载Agent并且重新安装。
检查源端服务器是否有安装杀毒软件，有以下两种情况：
1. 当系统安装杀毒软件，安全软件或防火墙时，会出现弹窗拦截IO监控驱动。出现拦截提示后，“允许本次操作”可以让杀毒软件允许IO监控程序运行。
2. 不出现拦截页面，直接拦截。这种情况需要手动将IO监控驱动：C:\Windows\System32\drivers\HwDiskMon.sys添加到杀毒软件的信任区域中，然后重启agent。如果还是不行，则需要卸载杀毒软件。部分杀毒软件会有一个安全防护进程长期驻留，单纯关闭可能无法解决驱动拦截问题。
修改配置文件，不启动IO监控。如果不需要同步数据，可以通过修改配置文件，取消IO监控。修改Agent安装目录config下 g-property.cfg的 enablesync为False，然后重启Agent。

启动Agent时提示“INTERNAL ERROR: cannot create temporary directory!”怎么办

SMS-Agent-Py2安装后会在C盘temp目录下释放一些文件，而当前C盘空间不足或者用户缺少在C盘创建目录的权限。

解决方案

检查C盘当前可用空间，如果空间不足，请清理C盘。
检查当前用户能否在C盘创建temp目录，如果没有则需要赋予写入权限。

如何处理迁移Agent提示“AK,SK鉴权失败,请保证系统时间与标准时间一致，并检查AK,SK”？

问题描述

在迁移Agent中输入天翼云账号AK/SK以后，AK/SK校验失败。

Windows系统提示用户：

"AK/SK authentication failed. Ensure that the system time is consistent with the standard time and the AK and SK are correct."

Linux系统提示用户：

"AK/SK authentication failed. Ensure that the system time is consistent with the standard time and the AK and SK are correct."

问题原因

出现该问题可能的原因有：

AK，SK输入错误。
源端服务器时间与标准时间不匹配。
源端服务器时区设置不对。
AK，SK被删除或停用。

处理方法

AK，SK输入错误

请您检查输入的天翼云账号AK/SK是否正确，特别是复制的时候有没有复制空格或者遗漏字符等。重新输入天翼云账号AK/SK进行校验。

源端服务器时间与标准时间不匹配

请您检查源端服务器的系统时间与其所在时区的标准时间是否一致，若不一致会导致迁移Agent中AK/SK校验失败。

此时请您将源端服务器的系统时间与其所在时区的标准时间调整一致再重新输入天翼云账号AK/SK进行校验。若源端服务器有业务依赖于服务器时间，请确认是否能够修改该时间，避免对业务造成影响。

源端服务器时区设置不对

修改源端服务器时区使时间+时区能转化为标准UTC时间。重新输入天翼云账号AK/SK进行校验。

AK，SK被删除或停用

请前往“我的凭证 > 访问密钥”中查看使用的AK/SK是否在列表中。

如果不在列表中，可以更换或创建一个新的AK/SK。

如果在列表中，检查是否被停用，如果被停用请重新启用。

Windows 2008 Agent启动后无法粘贴AK/SK该如何处理？

SMS-Agent-Py2安装后启动Agent，在命令窗口右键无法弹出菜单进行粘贴AK/SK操作。

解决方案

登录源端服务器。
进入Agent安装目录（C:\SMS-Agent-Py2），双击agent-start.exe。
复制AK，然后单击窗口左上角图标，在弹出菜单中选择粘贴（Paste），然后按Enter键。
复制SK，然后单击窗口左上角图标，在弹出菜单中选择粘贴（Paste），然后按Enter键。

Agent启动时提示“utf-8 codec can't decode byte 0xce in position0: invalid continuation byte”该如何处理？

Linux系统使用 ./startup.sh或者 bash startup.sh启动Agent后，提示："utf-8 codec can't decode byte 0xce in position0: invalid continuation byte"，当源端系统字符集错误，与SMS不兼容，会导致Agent启动失败。

解决方案

登录源端系统。
执行如下命令，设置字符集。
```
export LANG="en_US.UTF-8"
```
设置完成后，重新启动Agent，若还是有问题，可执行如下命令，设置字符集。
```
export LC_ALL="en_US.UTF-8"
export LANG="en_US.UTF-8"
```

说明
设置字符集只会对当前shell以及当前shell中的应用产生影响，不会影响您的文件以及其他应用。

Agent启动时提示“加载wmi模块失败”该如何处理？

Agent启动时提示“SMS.1205 无法加载wmi模块”或 “failed to load wmi”。出现该问题可能是wmi相关文件缺失或者损坏导致。Windows系统进行源端信息采集时需要使用wmi模块采集cpu，内存，磁盘等信息，无法导入该模块将导致无法采集到源端信息。因此可以考虑修复wmi相关文件。修复过程中会停止winmgmt服务，请确保该操作不会对源端业务造成影响。此外该操作会对源端文件进行变更，可能存在风险，建议克隆源端之后在克隆机上先进行验证。

修复WMI

在桌面上右击我的电脑，然后单击“管理”。
在计算机管理页面下，单击"服务和应用程序 > 服务"，找到并停止Windows Management Instrumentation服务。
将目录 C:\Windows\System32\wbem\repository重命名为 C:\Windows\System32\wbem\repository_old。
启动 winmgmt 服务。
以管理员身份打开 cmd控制台。
执行如下命令，进入 C:\Windows\System32\wbem\目录。
```
cd C:\Windows\System32\wbem\
```

分别执行如下命令，修复WMI。

for /f %s in ('dir /b *.mof') do mofcomp %s
for /f %s in ('dir /b en-us\*.mfl') do mofcomp en-us\%s

重新启动Agent。

如何重启Agent？

Windows环境重启Agent

Agent版本为Python3时：

1.在任务托盘栏中右键点击SMS Agent图标，单击“Quit”。

2.打开文件夹 C:\SMS-Agent-Py3，单击运行SMS-Agent.exe。

3.在弹出的页面输入相关信息，点击启动即可。

Agent版本为Python2时：

1.打开文件夹 C:\SMS-Agent-Py2，单击运行 restart.bat。

2.在弹出的CMD窗口中按照提示输入AK/SK即可。

Linux环境重启Agent

1.进入SMS-Agent解压目录，执行 ./restart.sh命令，运行Agent重启脚本。

2.按照提示输入AK/SK即可。

Linux系统提示“/tmp卷空间不足导致agent无法启动"该如何处理？

执行 sh startup.sh启动sms Agent时，提示：

Failed to write all bytes for cffibackend.cpython-36m-x86_64-linux.gnu.so fwrite: No space left on device

Agent启动时，会在 /tmp目录下新增目录及文件，这些文件占用空间大约40M。该问题可能是 /tmp所在卷空间不足导致，因此需要给 /tmp目录预留100M以上空间。

解决方案

登录源端服务器。
在源端执行 df -lh，检查 /tmp目录下是否有挂载卷，如有并检查卷空间使用情况。
如果 /tmp目录下挂载卷空间剩余不多，可采用以下两种方式处理：
1. 删除部分无用的文件或者扩容/tmp目录挂载的卷。
2. 执行 export TMPDIR=/home/user/tmpdir（/home/user/tmpdir替换为满足条件的目录）将缓存目录设置为其他目录。

Linux系统提示“Agent startup failed because the noexec permission is not allow on /tmp for SMS Agent. Please remount /tmp without noexec.”该如何处理？

执行 sh startup.sh启动sms Agent时，提示 “SMS.5102 Agent startup failed because the noexec permission is not allow on /tmp for SMS Agent. Please remount /tmp without noexec.”。该问题一般是由于有块设备挂载在 /tmp目录下，但是挂载时未指定exec权限或者指定了noexec权限导致。

解决方案

登录源端服务器。
执行 mount -l | grep /tmp，返回如下类似结果，说明被指定了noexec权限。
```
/dev/vdb1 on /tmp type ext4 (rw, noexec, relatime, data=ordered)
```
重新挂载该块设备到 /tmp目录下，挂载时不能指定noexec，或者可以执行 mount -o remount exec /tmp以明确指定exec权限。
再次执行 mount -l | grep /tmp，返回类似结果即可重启启动Agent进行迁移。
```
/dev/vdb1 on /tmp type ext4 (rw, relatime, data=ordered)
```

只支持迁移X86架构的服务器？

目前SMS Agent只支持迁移X86架构的服务器，不支持迁移Arm等其他架构的服务器。如果您源端是Arm架构的服务器，请咨询鲲鹏相应专家服务。

Linux启动Agent时提示“启动SMS Agent失败！磁盘”

Linux Agent启动失败，提示：Failed to start sms agent!'disks'。可能原因：

存在同名卷组。

可查看SmsAgent_Error.log日志，是否有提示：“Multiple VGs found with the same name”。

Linux系统不允许存在同名卷组，Linux系统中存在同名卷组时，会导致SMS Agent搜集源端磁盘信息失败。可以执行 vgdisplay查看系统中是否存在同名卷组，以及执行 lvdisplay查看lvm创建时的主机名称和时间等细节。

源端没有fdisk命令。

在源端执行 fdisk -l 命令，检查系统是否存在fdisk命令。如果找不到fdisk命令，可能是 /sbin目录不在PATH中或 /sbin目录在PATH中但是没生效（通过 su命令切换到root可能会存在该类情况）。

解决方案

因Linux系统不允许存在同名卷组，所以源端同名卷组以及对应的逻辑卷不能正常挂载读取。可以把挂载失败的卷组磁盘挂载到另一台主机上，检查磁盘中的数据是否需要迁移。
如果需要迁移，执行vgrename将重名的卷组更改名称，然后再挂载回源端主机，重新启动SMS Agent。
如果不需要迁移，重新启动SMS Agent。等迁移完后，再将磁盘挂载回源端主机。
执行 source /etc/profile 后，重新启动SMS Agent。

Window系统，启动Agent提示：SMS.1901，Agent无法读取磁盘信息

源端Window系统，安装SMS-Agent后启动Agent时，提示：SMS.1901，Agent无法读取磁盘信息，原因可能为源端系统磁盘管理器无法打开。

解决方案

方案一

重启源端系统。
打开运行窗口，输入cmd，单击“确定”，打开cmd命令窗口。
输入：diskmgmt.msc，单击回车键。
1. 如果可以打开磁盘管理器，即可重启SMS-Agent。
2. 如果无法打开磁盘管理器，请采用方案二。

方案二：通过镜像迁移。

Linux操作系统，启动Agent时，磁盘信息采集失败，该如何处理？

Linux系统，启动Agent时，提示：Failed to obtain information about disk %s. Cause: unknown physical volume!出现该问题的原因可能是在lvm场景下，源端服务器存在unknown物理卷，导致服务器异常，Agent无法采集到磁盘信息，可通过 pvs命令，检查确认。

解决方案

建议联系源端服务器技术人员，将服务器恢复正常。
源端服务器恢复正常运行后，使用 pvs命令，检查是否出现unknown物理卷。如未出现unknown物理卷，请重新迁移。

Linux操作系统，启动Agent时，提示：SMS.6562：component i386-pc not found on source server. For solution, see SMS API Reference.

Linux系统，启动迁移Agent时，出现提示：SMS.6562：component i386-pc not found on source server. For solution, see SMS API Reference。天翼云平台BIOS启动方式的服务器，安装grub需要i386-pc组件。出现该提示说明源端服务器为BIOS方式启动，但缺少安装grub的组件i386-pc。当缺少该组件时，迁移Agent配置目的端阶段，grub会安装失败，导致配置阶段报错。

解决方案

执行如下命令，确认源端服务器是否为BIOS启动方式。
```
#[ -d /sys/firmware/efi ] && echo UEFI || echo BIOS
```
若输出为bios，则是以bios方式启动；若输出为uefi，则是以uefi方式启动。
执行如下命令，检查 /usr/lib/grub/目录下是否有i386-pc文件夹。
```
#[ -d /sys/firmware/efi ] && echo UEFI || echo BIOS
```
如没有i386-pc文件夹，请执行步骤3；如有i386-pc文件夹，执行命令 ls /usr/lib/grub/i386-pc，检查i386-pc文件夹是否为空。
在源端云平台或天翼云平台，使用公共镜像，创建一台与源端服务器操作系统、系统版本相同的临时服务器。
登录临时服务器，将临时服务器 /usr/lib/grub/ 目录下的整个i386-pc文件夹，传输到源端服务器的 /usr/lib/grub/ 目录下（如源端服务器存在空的i386-pc文件夹，请直接覆盖）。您可以使用 SCP，Rsync等方式进行传输。SCP传输示例：
```
#scp -r /usr/lib/grub/i386-pc username@xx.xx.xx.xx:/usr/lib/grub/
```
登录源端服务器，确认 /usr/lib/grub/ 目录下，已存在传输过来的i386-pc文件夹，重新启动迁移Agent。

Linux操作系统，启动Agent时，提示：SMS.6563：File initrd or initramfs of the xxxx version not found under /boot directory. For solution, see SMS API Reference.

Linux系统，启动迁移Agent时，出现提示：SMS.6563：File initrd or initramfs of the xxxx version not found under /boot directory. For solution, see SMS API Reference。出现该提示说明源端服务器缺少initrd或initramfs镜像文件。因部分云服务平台的服务器系统使用了定制内核，启动时使用了特定机制，不需要initrd或initramfs镜像文件也能正常启动。但天翼云平台服务器，缺少initrd或initramfs镜像文件，会导致启动失败。Initrd和Initramfs镜像文件作用基本相同，都是为系统提供内核启动需要的驱动。不同操作系统，使用的镜像文件不同，例如：Ubuntu操作系统使用的是Initrd镜像文件，格式为initrd.img-xxx，而部分Centos操作系统使用的是Initramfs镜像文件，格式为initramfs-xxx.img。请在源端安装更新相应的镜像文件，重新启动迁移agent。

迁移谷歌云平台服务器，选择是否禁用部分服务？

源端为谷歌云平台Linux系统服务器，启动迁移Agent时，出现如下图所示提示，需要您选择是否禁用相关服务。

背景

因部分谷歌云服务依赖于谷歌云平台，迁移到天翼云后，无法正常运行，导致服务器在启动阶段卡住或其它服务无法正常启动。因此，在迁移前请您阅读禁用详情，并根据业务需求，评估是否需要禁用部分谷歌服务。

说明：

禁用不会对源端服务器产生影响，只在迁移配置目的端阶段，对目的端服务器进行配置操作。
如果您的业务需求依赖于谷歌云平台服务，请咨询天翼云技术支持后再进行迁移。
选择禁用，请输入“y”，在Agent配置目的端阶段，系统会禁用谷歌相关服务。
选择不禁用，请输入“n”，在SMS-Agent的安装目录：.../SMS-Agent/agent/config/g-property.cfg文件中修改 disableplatformservice参数为False。迁移后会保留所有服务设置，可能会导致服务器或部分服务启动失败等问题。

禁用详情

以 /etc/systemd/system目录下服务为开机服务的主机（如：Ubuntu，Centos8，Centos9）。选择禁用，只会删除 /etc/systemd/system目录下google服务相关的软链接，软链接指向的源端服务文件不受影响。删除服务软连接并不会影响服务实际的文件，只是被删除的服务不会在开机时自启动。
以 /etc/init目录下服务为开机服务的主机（如：Centos6）。选择禁用，Agent会检测 /etc/init目录下google开头的配置文件，将这些配置文件移动到 /etc/backup_googleconf, 并创建备份压缩文件 google_conf_bak.tar.gz。

Linux操作系统，启动Agent时，提示：SMS.0410：Failed to obtain NicName/IPAddress information of source server.

出现该提示，是因为当源端服务器存在多块网卡时，SMS-Agent可能获取源端默认网关信息会失败，从而导致无法获取正确的网卡名，Mac地址和IP地址。

解决方案

提示一：“SMS.0410：Failed to obtain NicName information of source server.”

执行命令 route -n，查看路由表。参数说明参见下表。源端服务器存在多个默认网关时，就可能出现SMS-Agent获取默认网关信息失败的情况。这种情况下，请继续执行后续步骤。

参数	说明
Destination	目的地址，0.0.0.0对应的网关是默认网关。
Gateway	网关地址。
Iface	网络路径出口。

执行命令 ifconfig -a，查看网络配置。

最左侧一列是网卡名，inet对应的是网卡的IP地址，ether对应的是网卡的mac地址。
设置 .../SMS-Agent/agent/config/g-property.cfg配置文件中的 network.dev参数值

首先您需要自行确认，源端服务器用于迁移的网卡是多块网卡中的哪一块。然后手动输入 network.dev参数值为用于迁移的网卡对应的网卡名。

例如：通过步骤2的指令，查看到的网卡名有eth0、eth1、eth2，其中eth0为用于迁移网卡的网卡名，则设置参数 network.dev = eth0。
设置完成后，重新启动SMS-Agent。

提示二：“SMS.0410：Failed to obtain IPAddress information of source server.”

查看是否设置了 .../SMS-Agent/agent/config/g-property.cfg配置文件中的 network.dev参数值。
1. 是，请进行步骤2。
2. 否，请进行步骤3。
请参考提示一，确认network.dev参数值设置的网卡名是否正确。
1. 如果设置错误，请修改为正确的网卡名后，重新启动Agent。如果重启还是出现相同提示，请进行步骤3。
2. 如果设置正确，请进行步骤3。
设置 .../SMS-Agent/agent/config/g-property.cfg配置文件中的 network.macaddr和 network.ipaddr参数值。设置完成后，重新启动SMS-Agent。
将提示一：步骤2所查询到的正确网卡名对应的 inet （IP地址）和 ether （MAC地址），手动设置到 network.macaddr和 network.ipaddr参数值。设置完成后，重启agent。
```
#MAC地址和IP地址都要设置，MAC地址字符间需要用“-”连接。
network.macaddr= xx-xx-xx-xx-xx-xx（MAC地址）
network.ipaddr= xxx.xxx.xxx.xxx（IP地址）
```

启动Agent失败，提示：SMS.0609，检测到旧版本残留，请退出当前agent程序，完全卸载agent后，重新安装最新版

源端安装新版本SMS-Agent时，旧版本没有卸载或旧版本卸载不完全，Agent进程仍然存在，导致新版本安装不完全，部分文件没有完全替换。

解决方案

源端为Windows主机
1. 打开“任务管理器”，检查是否仍然存在运行中的SMS-Agent程序。
  1. 如果有，请结束当前SMS-Agent程序，再执行2。
  2. 如果没有，请执行2。
2. 请参考如何卸载源端服务器中的SMS-Agent，将旧版SMS-Agent完全卸载。
3. 旧版SMS-Agent完全卸载后，重新安装最新版本SMS-Agent。
源端为Linux主机
1. 请参考如何卸载源端服务器中的SMS-Agent，将旧版SMS-Agent完全卸载。
2. 旧版SMS-Agent完全卸载后，重新安装最新版本SMS-Agent。

Linux系统，启动Agent失败，提示：SMS.1353: Bind mount or repeated mount detected on /xxx of the source server.

出现该提示，可能是因为源端服务器存在重复挂载/绑定式挂载的情况，该情况可能导致数据重复迁移或者目的端磁盘空间不够等问题。

重复挂载 ：指某个磁盘或者分区同时挂载在多个目录下。例如：磁盘 /dev/vda1同时挂载在根目录 / 和 /home/mnt_test目录下。

绑定式挂载 ：指将挂载磁盘或分区的目录挂载到另一目录下。例如：磁盘 /dev/vda1挂载在根目录 /下，然后将根目录 /挂载在 /root/bind_test/bind_mount目录下。

重复挂载与绑定式挂载的共同特征：

其中任一目录下的磁盘数据发生改变，另一目录也会同步改变。
mount指令下同一个磁盘或者分区重复出现，且挂载在不同位置。

解决办法

情况1：重复挂载

1、在源端SMS-Agent的解压路径：.../SMS-Agent/agent/config/g-property.cfg 文件中的 tar.exclude.dir和 rsync.exclude.dir参数后，添加需要排除的挂载点。例如情况一，将 /home/mnt_test/*添加到 tar.exclude.dir和 rsync.exclude.dir参数后，表示将 /home/mnt_test/目录下面所有文件排除，不做迁移和同步。

2、（可选）如果您需要迁移完成后，目的端挂载情况与源端一致，可以进行如下操作：

迁移完成后，在目的端服务器的 /etc/fstab文件里面修改挂载内容，如下图所示。保证目的端 /dev/vdb磁盘自动挂载在 /mnt文件夹和 /home/mnt_test文件夹下。

3、重新启动SMS-Agent进行迁移。

情况2：绑定式挂载

1、在源端SMS-Agent的解压路径：.../SMS-Agent/agent/config/g-property.cfg 文件中的 tar.exclude.dir和 rsync.exclude.dir参数后，添加需要排除的挂载点。例如情况二，将 /root/bind_test/bind_mount/*添加到 tar.exclude.dir和 rsync.exclude.dir参数后，表示将 /root/bind_test/bind_mount/目录下面所有文件排除，不做迁移和同步。

2、（可选）如果您需要迁移完成后，目的端挂载情况与源端一致，可以进行如下操作：

迁移完成后，在目的端服务器的 /etc/fstab文件里面修改挂载内容，如下图所示。保证目的端 /dev/vda1磁盘自动挂载在 /root/bind_test/bind_mount文件夹下。挂载目录与挂载点请根据实际情况修改，第一项为挂载目录（/），第二项为挂载点（/root/bind_test/bind_mount），第三项为文件系统类型 （ext3），rw,bind 0 0 请保留。

/  /root/bind_test/bind_mount  ext3  rw,bind 0 0

3、重新启动SMS-Agent进行迁移。

Linux系统，启动Agent失败，提示：SMS.1352: Unknown physical volumes detected on the source server.

出现该问题，可能是因为源端服务器某个卷组同时建立在2个物理卷上，但其中一个物理卷被卸载。

解决方案

方案一：将卸载的物理卷重新挂载回源端服务器，再进行迁移。
方案二：请联系主机迁移服务技术支持协助，将unknown的物理卷进行伪装后迁移。

Linux系统，启动Agent失败，提示：SMS.1351: Mount point /xxx detected on the source server, which has no free space. Ensure that there is at least 1 MB of space.

Linux系统，启动Agent失败，提示：“SMS.1351: Mount point /xxx detected on the source server, which has no free space. Ensure that there is at least 1 MB of space.”。出现该问题，是因为源端服务器存在挂载点空间已满的情况。

解决方案

在源端服务器执行 df -TH命令，查看源端空间占用情况，找出空间已满的挂载点。
调整挂载点的文件和数据，保证源端服务器每个挂载点至少有1 MB空间。
重新执行 df -TH命令，查看所有挂载点空间满足条件后，重新启动SMS-Agent进行迁移。

Agent启动失败，提示：Failed to obtain the JSON configuration file, Incorrect SMS domain name，Please check the entered voucher or network Failed to start sms agent!local variable 'cloud_region_json' referenced before assignment.

Agent启动失败，报错如下图所示：

可能原因：源端主机未按照要求配置hosts，或者hosts配置错误造成。

活动

应用商城

合作伙伴

开发者

支持与服务

了解天翼云

查看所有产品

主机迁移服务SMS

主机迁移服务SMS

如何在源端主机下载并安装迁移Agent？

Agent无法下载该如何处理？

如何对迁移Agent进行软件完整性校验？

源端Agent注册后为什么主机迁移服务控制台没有记录？

SMS-Agent配置文件中的证书验证开关参数说明

如何查找SMS的运行日志？

为什么迁移过程中目的端ECS会被锁定？

如何解除目的端服务器锁定状态？

Linux版的迁移Agent启动提示“rsync not installed on the source server”该如何处理？

应用程序因并行配置不正确无法启动

首次启动Agent时无法启动该如何处理？

Windows Agent双击无法运行

启动Agent时出现“IO监控启动失败”，该如何处理？

启动Agent时提示“INTERNAL ERROR: cannot create temporary directory!”怎么办

如何处理迁移Agent提示“AK,SK鉴权失败,请保证系统时间与标准时间一致，并检查AK,SK”？

Windows 2008 Agent启动后无法粘贴AK/SK该如何处理？

Agent启动时提示“utf-8 codec can't decode byte 0xce in position0: invalid continuation byte”该如何处理？

Agent启动时提示“加载wmi模块失败”该如何处理？

如何重启Agent？

Linux系统提示“/tmp卷空间不足导致agent无法启动"该如何处理？

Linux系统提示“Agent startup failed because the noexec permission is not allow on /tmp for SMS Agent. Please remount /tmp without noexec.”该如何处理？

只支持迁移X86架构的服务器？

Linux启动Agent时提示“启动SMS Agent失败！磁盘”

Window系统，启动Agent提示：SMS.1901，Agent无法读取磁盘信息

Linux操作系统，启动Agent时，磁盘信息采集失败，该如何处理？

Linux操作系统，启动Agent时，提示：SMS.6562：component i386-pc not found on source server. For solution, see SMS API Reference.

Linux操作系统，启动Agent时，提示：SMS.6563：File initrd or initramfs of the xxxx version not found under /boot directory. For solution, see SMS API Reference.

迁移谷歌云平台服务器，选择是否禁用部分服务？

Linux操作系统，启动Agent时，提示：SMS.0410：Failed to obtain NicName/IPAddress information of source server.

启动Agent失败，提示：SMS.0609，检测到旧版本残留，请退出当前agent程序，完全卸载agent后，重新安装最新版

Linux系统，启动Agent失败，提示：SMS.1353: Bind mount or repeated mount detected on /xxx of the source server.

Linux系统，启动Agent失败，提示：SMS.1352: Unknown physical volumes detected on the source server.

Linux系统，启动Agent失败，提示：SMS.1351: Mount point /xxx detected on the source server, which has no free space. Ensure that there is at least 1 MB of space.

Agent启动失败，提示：Failed to obtain the JSON configuration file, Incorrect SMS domain name，Please check the entered voucher or network Failed to start sms agent!local variable 'cloud_region_json' referenced before assignment.