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"

推送Agent失敗/Agent狀態異常

檢查主機參數（IP、用戶名、密碼）是否正確

檢查對應端口是否正常開放

檢查網絡是否正常訪問

地服務器瀏覽器訪問Agent下載地址，是否正常

OMS-Agent狀態異常時，如何檢查？

異常狀態	檢查
SSH驗證失敗（可修改）	檢查節點參數（IP、端口、用戶名、密碼）是否正確。檢查虛擬機是否開啟SSH登錄權限。
獲取安裝包失敗（可重試）	檢查安裝Windows計算機是否能訪問天翼云對象存儲域名
上傳安裝包失敗（可重試）	檢查虛擬機SFTP是否正常，可以通過SSH上傳文件。
安裝失敗（可重試）	檢查虛擬機規格系統是否與要求一致。
長期離線	檢查虛擬機是否和Windows計算機8098端口互通。如果8098端口不通，檢查安全組配置。檢查虛擬機是否啟動oms-agent（ps -ef

源端Agent注冊后為什么主機遷移服務控制臺沒有記錄？

如果在源端服務器上安裝和配置了遷移Agent，但是沒有在主機遷移服務控制臺查看到該源端服務器。請進行以下排查：

1. 首先請確認源端注冊成功，源端注冊成功的Linux和Windows Python2版本的控制臺會打印“successfully”字樣，Windows Python3版本會有“上傳源端信息成功”字樣。
2. 請確認是否登錄錯賬號或者錯誤的輸入了其他賬號的AK/SK。
3. 如果確認源端注冊成功，且控制臺版本與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會被鎖定？

遷移過程中，操作目的端服務器可能會導致遷移失敗。為了保證遷移順利實施，遷移過程中目的端服務器會被自動鎖定，遷移成功之后會自動解鎖。

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。

1. 右鍵單擊開始菜單。
2. 單擊“運行”，輸入cmd，進入命令行提示符界面。
3. 輸入cd C:\SMS-Agent-Py2，切換到Agent安裝目錄，執行SMSAgentDeploy.exe。

首次啟動Agent時無法啟動該如何處理？

因部分Windows機型權限限制，會導致第一次啟動Agent無法啟動，可使用如下方式啟動Agent。

1. 右鍵單擊開始菜單。
2. 單擊“運行”，輸入cmd，進入命令行提示符界面。
3. 輸入cd C:\SMS-Agent-Py2，切換到Agent安裝目錄，執行SMSAgentDeploy.exe。

Windows Agent雙擊無法運行

安裝Windows Agent，雙擊SMS-Agent安裝程序沒有響應，無法進入安裝向導。為系統設置的安全策略鎖定了該文件，需要解除對該文件的鎖定。右鍵單擊SMS-Agent-py運行程序查看屬性，勾選“解除鎖定”，單擊“確定”，然后重新運行。

啟動Agent時出現“IO監控啟動失敗”，該如何處理？

如果在源端服務器上啟動Agent時，出現“IO監控失敗”。請進行以下排查：

1. 卸載Agent并且重新安裝。
2. 檢查源端服務器是否有安裝殺毒軟件，有以下兩種情況：
   1. 當系統安裝殺毒軟件，安全軟件或防火墻時，會出現彈窗攔截IO監控驅動。出現攔截提示后，“允許本次操作”可以讓殺毒軟件允許IO監控程序運行。
   2. 不出現攔截頁面，直接攔截。這種情況需要手動將IO監控驅動：C:\Windows\System32\drivers\HwDiskMon.sys添加到殺毒軟件的信任區域中，然后重啟agent。如果還是不行，則需要卸載殺毒軟件。部分殺毒軟件會有一個安全防護進程長期駐留，單純關閉可能無法解決驅動攔截問題。
3. 修改配置文件，不啟動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操作。

解決方案

1. 登錄源端服務器。
2. 進入Agent安裝目錄（C:\SMS-Agent-Py2），雙擊agent-start.exe。
3. 復制AK，然后單擊窗口左上角圖標，在彈出菜單中選擇粘貼（Paste），然后按Enter鍵。
4. 復制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啟動失敗。

解決方案

1. 登錄源端系統。
2. 執行如下命令，設置字符集。

   export LANG="en_US.UTF-8"
   

3. 設置完成后，重新啟動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

1. 在桌面上右擊我的電腦，然后單擊“管理”。
2. 在計算機管理頁面下，單擊"服務和應用程序 > 服務"，找到并停止Windows Management Instrumentation服務。
3. 將目錄 C:\Windows\System32\wbem\repository重命名為 C:\Windows\System32\wbem\repository_old。
4. 啟動 winmgmt 服務。
5. 以管理員身份打開 cmd控制臺。
6. 執行如下命令，進入 C:\Windows\System32\wbem\目錄。

   cd C:\Windows\System32\wbem\
   

7. 分別執行如下命令，修復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
   

8. 重新啟動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以上空間。

解決方案

1. 登錄源端服務器。
2. 在源端執行 df -lh，檢查 /tmp目錄下是否有掛載卷，如有并檢查卷空間使用情況。
3. 如果 /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權限導致。

解決方案

1. 登錄源端服務器。
2. 執行 mount -l | grep /tmp，返回如下類似結果，說明被指定了noexec權限。

   /dev/vdb1 on /tmp type ext4 (rw, noexec, relatime, data=ordered)
   

3. 重新掛載該塊設備到 /tmp目錄下，掛載時不能指定noexec，或者可以執行 mount -o remount exec /tmp以明確指定exec權限。
4. 再次執行 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'。可能原因：

1. 存在同名卷組。

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

Linux系統不允許存在同名卷組，Linux系統中存在同名卷組時，會導致SMS Agent搜集源端磁盤信息失敗。可以執行 vgdisplay查看系統中是否存在同名卷組，以及執行 lvdisplay查看lvm創建時的主機名稱和時間等細節。

2. 源端沒有fdisk命令。

在源端執行 fdisk -l 命令，檢查系統是否存在fdisk命令。如果找不到fdisk命令，可能是 /sbin目錄不在PATH中或 /sbin目錄在PATH中但是沒生效（通過 su命令切換到root可能會存在該類情況）。

解決方案

1. 因Linux系統不允許存在同名卷組，所以源端同名卷組以及對應的邏輯卷不能正常掛載讀取。可以把掛載失敗的卷組磁盤掛載到另一臺主機上，檢查磁盤中的數據是否需要遷移。
   如果需要遷移，執行vgrename將重名的卷組更改名稱，然后再掛載回源端主機，重新啟動SMS Agent。
   如果不需要遷移，重新啟動SMS Agent。等遷移完后，再將磁盤掛載回源端主機。
2. 執行 source /etc/profile 后，重新啟動SMS Agent。

Window系統，啟動Agent提示：SMS.1901，Agent無法讀取磁盤信息

源端Window系統，安裝SMS-Agent后啟動Agent時，提示：SMS.1901，Agent無法讀取磁盤信息，原因可能為源端系統磁盤管理器無法打開。

解決方案

• 方案一

1. 重啟源端系統。
2. 打開運行窗口，輸入cmd，單擊“確定”，打開cmd命令窗口。
3. 輸入：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命令，檢查確認。

解決方案

1. 建議聯系源端服務器技術人員，將服務器恢復正常。
2. 源端服務器恢復正常運行后，使用 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會安裝失敗，導致配置階段報錯。

解決方案

1. 執行如下命令，確認源端服務器是否為BIOS啟動方式。

   #[ -d /sys/firmware/efi ] && echo UEFI || echo BIOS
   

   若輸出為bios，則是以bios方式啟動；若輸出為uefi，則是以uefi方式啟動。

2. 執行如下命令，檢查 /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文件夾是否為空。

3. 在源端云平臺或天翼云平臺，使用公共鏡像，創建一臺與源端服務器操作系統、系統版本相同的臨時服務器。

4. 登錄臨時服務器，將臨時服務器 /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/
   

5. 登錄源端服務器，確認 /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.”

1. 執行命令 route -n，查看路由表。參數說明參見下表。源端服務器存在多個默認網關時，就可能出現SMS-Agent獲取默認網關信息失敗的情況。這種情況下，請繼續執行后續步驟。

參數	說明
Destination	目的地址，0.0.0.0對應的網關是默認網關。
Gateway	網關地址。
Iface	網絡路徑出口。

2. 執行命令 ifconfig -a，查看網絡配置。
   最左側一列是網卡名，inet對應的是網卡的IP地址，ether對應的是網卡的mac地址。
   
3. 設置 .../SMS-Agent/agent/config/g-property.cfg配置文件中的 network.dev參數值
   首先您需要自行確認，源端服務器用于遷移的網卡是多塊網卡中的哪一塊。然后手動輸入 network.dev參數值為用于遷移的網卡對應的網卡名。
   例如：通過步驟2的指令，查看到的網卡名有eth0、eth1、eth2，其中eth0為用于遷移網卡的網卡名，則設置參數 network.dev = eth0。
   
4. 設置完成后，重新啟動SMS-Agent。

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

1. 查看是否設置了 .../SMS-Agent/agent/config/g-property.cfg配置文件中的 network.dev參數值。
   1. 是，請進行步驟2。
   2. 否，請進行步驟3。
2. 請參考提示一，確認network.dev參數值設置的網卡名是否正確。
   1. 如果設置錯誤，請修改為正確的網卡名后，重新啟動Agent。如果重啟還是出現相同提示，請進行步驟3。
   2. 如果設置正確，請進行步驟3。
3. 設置 .../SMS-Agent/agent/config/g-property.cfg配置文件中的 network.macaddr和 network.ipaddr參數值。設置完成后，重新啟動SMS-Agent。
4. 將提示一：步驟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<span>?</span>請保留。

/  /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.”。出現該問題，是因為源端服務器存在掛載點空間已滿的情況。

解決方案

1. 在源端服務器執行 df -TH命令，查看源端空間占用情況，找出空間已滿的掛載點。
   
2. 調整掛載點的文件和數據，保證源端服務器每個掛載點至少有1 MB空間。
3. 重新執行 df -TH命令 ， 查看所有掛載點空間滿足條件后，重新啟動SMS-Agent進行遷移。