注意請確認已經按照遷移前準備工作完成賬號注冊,賬號充值,已獲取遷移權限和AK/SK,操作系統和遷移網絡符合要求,源端服務器環境準備完成,源端服務器hosts配置完成等工作。
安裝Windows版本的SMS-Agent
您需要在源端服務器上安裝遷移Agent并且輸入目的端服務器所在帳號的AK/SK,遷移Agent啟動成功后會收集源端服務器信息并自動發送給主機遷移服務。收集的所有信息僅用于數據遷移,不會用做其他用途。
Windows版的SMS-Agent安裝有兩種方式(必須使用Administrator用戶登錄Windows服務器):
- 基于圖形界面 Windows Agent(Python3):Windows Server 2019/Windows Server 2016/Windows Server 2012/Windows 10/Windows 8.1
- 基于命令行界面 Windows Agent(Python2):Windows Server 2008/Windows 7
前提條件
- 已獲取目的端云主機所在帳號的AK/SK。
- 已獲取源端服務器Administrator用戶權限。
- 已完成源端服務器hosts配置,
C:\Windows\System32\drivers\etc\hosts。 - 源端服務器的OS類型需要包含在Windows兼容性列表中。
- 源端服務器中未安裝殺毒軟件,殺毒軟件可能會導致Agent啟動失敗。
- 若啟動Agent時出現“IO監控啟動失敗”,請參考“啟動Agent時出現“IO監控啟動失敗”,該如何處理”。
下載SMS-Agent安裝文件
1、登錄主機遷移服務管理控制臺。
2、在左側導航樹中,單擊“遷移Agent”,進入“遷移Agent”頁面。

3、在Windows服務器Agent安裝區域,單擊Windows Agent下載窗格中的“鏈接”,仔細閱讀并同意服務聲明后,單擊“是”,下載相應的遷移Agent。
- 圖形界面(Windows Server 2019/Windows Server 2016/Windows Server 2012/Windows 10/Windows 8.1):請選擇“Windows Agent(Python3)”,將“SMS-Agent-Py3.exe”保存到本地。
- 命令行界面(Windows Server 2008/Windows 7):請選擇“Windows Agent(Python2)”,將“SMS-Agent-Py2.exe”保存到本地。
4、單擊對應Agent的“SHA256鏈接”,將包含Hash值的文件保存到本地。對遷移Agent進行軟件完整性校驗。
安裝SMS-Agent(Windows Server 2019/Windows Server 2016/Windows Server 2012/Windows 10/Windows 8.1)
- 請將“SMS-Agent-Py3.exe”文件上傳至源端服務器。
- 使用Administrator用戶登錄源端服務器,雙擊“SMS-Agent-Py3.exe”文件,進入SMS-Agent安裝界面。
- 單擊“安裝”,等待安裝完成。
- 單擊“完成”,進入SMS-Agent圖形界面。
- 輸入目的端服務器所在天翼云帳號的AK、SK,以及目的端服務器所在區域的SMS域名。SMS域名可在SMS控制臺的“遷移Agent”頁面獲取。
說明若不使用HTTPS代理,請選擇:直連。
若使用HTTPS代理,請選擇:使用代理,并輸入代理服務器IP、端口、代理用戶名、密碼。
- 如果您的賬號已經開通企業項目,輸入AK/SK后,Agent會查詢有主機遷移權限的企業項目并羅列,供您選擇。選擇具體的企業項目后,主機遷移服務會將主機遷移到您指定的企業項目中。實現遷移時權限、資源和財務的隔離。
- 單擊“啟動”,彈出“注意”窗口。
- 請您仔細閱讀“注意”窗口中的內容,單擊“是”。
- 當界面顯示“啟動成功!等待服務端命令”時,表示Windows版的SMS-Agent啟動成功,請訪問天翼云控制臺主機遷移服務界面進行后續操作。
安裝SMS-Agent(Windows Server 2008/Windows 7)
- 請將“SMS-Agent-Py2.exe”文件上傳至源端服務器。
- 使用Administrator用戶登錄源端服務器,雙擊“SMS-Agent-Py2.exe”文件,進入SMS-Agent安裝界面。
- 單擊“安裝”,等待安裝完成。
- 單擊“完成”,進入SMS-Agent命令行界面。
說明若為二次啟動,在安裝目錄下(C:\SMS-Agent-Py2)雙擊agent-start.exe。
- 若使用HTTPS代理服務器,請按照如下步驟執行。若不使用HTTPS代理服務器,請執行步驟6。
說明
代理服務器為一種特殊網絡服務,當您的源端無法通過公網訪問天翼云時,可以通過代理服務器訪問天翼云,代理服務器需用戶自行配置。
代理僅用于專線/VPN場景下源端到服務端的注冊,不用于數據遷移過程。
配置HTTPS代理服務器(可選)。進入Agent安裝目錄,如C:\SMS-Agent-Py2\config目錄下,修改 auth.cfg文件。若遷移過程中不使用HTTPS代理,禁止修改 auth.cfg文件。
[proxy-config]
enable = true
proxy_addr = //your-proxy-addr.com
proxy_port = proxyport
proxy_user =
use_password = false
說明
使用代理時,enable設置為true。
proxy_addr為代理服務器地址,允許源端服務器通過代理服務器訪問主機遷移服務,非目的端地址。your-proxy-addr.com需要更換為您代理服務器的地址,協議需要根據代理服務器的實際情況配置,建議您將代理服務器協議配置為https。
代理有用戶名的話,proxy_user就填寫用戶名,如root,沒有則不填。
代理有密碼的話, use_password設置為true,否則false。
- 根據命令提示,依次手動輸入目的端服務器所在天翼云帳號的AK、SK,以及目的端服務器所在區域的SMS域名。SMS域名可在SMS控制臺的“遷移Agent”頁面獲取。如果您的賬號已經開通企業項目,輸入AK/SK后,Agent會查詢有主機遷移權限的企業項目并羅列,供您選擇。選擇具體的企業項目后,主機遷移服務會將主機遷移到您指定的企業項目中。實現遷移時權限、資源和財務的隔離。認證通過后,提示SMS-Agent啟動,開始給主機遷移服務上傳源端服務器信息,界面隨即關閉。您可以前往SMS控制臺的遷移服務器列表頁面查看上報的源端服務器。
問題處理
- 在遷移Agent中輸入目的端服務器所在天翼云帳號的AK/SK以后,若出現“AK,SK鑒權失敗”的提示,請您參見如何處理遷移Agent中AK/SK校驗失敗?。
- 如果控制臺看不到源端服務器記錄,請參考源端Agent注冊后為什么主機遷移服務控制臺沒有記錄,進行排查處理。
安裝Linux版本的SMS-Agent
操作場景
您需要在源端服務器上安裝遷移Agent并且輸入目的端服務器所在天翼云的AK/SK,遷移Agent啟動成功后會自動收集源端服務器信息并發送給主機遷移服務。收集的所有信息僅用于數據遷移,不會用做其他用途。
前提條件
-
已獲取目的端服務器所在天翼云帳號的AK/SK。
- 如果您使用IAM用戶進行遷移,具體請參見如何獲取AK/SK?(IAM用戶)。
- 如果您直接使用帳號進行遷移,具體請參見如何獲取AK/SK?(賬號)。
-
源端服務器的OS類型需要包含在Linux兼容性列表中。
-
已完成源端服務器hosts配置,
/etc/hosts。
安裝Linux版的SMS-Agent
- 登錄主機遷移服務管理控制臺。
- 在左側導航樹中,單擊“遷移Agent”,進入“遷移Agent”頁面。

- 在Linux服務器Agent安裝區域,單擊Linux Agent下載窗格中的“鏈接”,仔細閱讀并同意服務聲明后,復制Agent的下載命令,前往源端服務器下載遷移Agent。
- 復制“sha256校驗碼”的下載命令,下載sha256校驗碼,對遷移Agent進行軟件完整性校驗,具體參見如何對遷移Agent進行軟件完整性校驗?。
- 一致性校驗完成后,執行命令
tar -zxvf SMS-Agent.tar.gz,解壓Agent軟件包。 - 執行命令
cd SMS-Agent,進入源端服務器的SMS-Agent目錄。 - 若使用HTTPS代理服務器,請執行步驟8。若不使用HTTPS代理服務器,請執行步驟9。代服務器為一種特殊網絡服務,當您的源端無法通過公網訪問天翼云時,可以通過代理服務器訪問天翼云,代理服務器需用戶自行配置。代理僅用于專線/VPN場景下源端到服務端的注冊,不用于數據遷移過程。
- 配置HTTPS代理服務器(可選)。執行命令
cd SMS-Agent/agent/config,進入config目錄。執行如下命令,打開并編輯auth.cfg文件。若遷移過程中不使用HTTPS代理,禁止修改auth.cfg文件。執行:wq!命令,保存auth.cfg文件并退出。
vi auth.cfg
#示例:(以下僅為示例說明,具體代理服務器信息,請根據實際情況填寫。)
[proxy-config]
enable = true
proxy_addr = //your-proxy-addr.com
proxy_port = 3128
proxy_user = root
use_password = true
說明enable:使用代理時,設置為true。
proxy_addr:代理服務器地址,允許源端服務器通過代理服務器訪問主機遷移服務,非目的端地址。your-proxy-addr.com需要更換為您代理服務器的地址,協議需要根據代理服務器的實際情況配置,建議您將代理服務器協議配置為https。
proxy_user:代理有用戶名的話,就填寫用戶名,如root;沒有則不填。
use_password:代理有密碼的話設置為true,否則false。
- 執行命令
./startup.sh,啟動遷移Agent。 - 請您仔細閱讀顯示的內容并輸入“y”,按“Enter”。
- 根據提示,輸入目的端服務器所在天翼云帳號的AK、SK,以及目的端服務器所在區域的SMS域名。SMS域名可在SMS控制臺的“遷移Agent”頁面獲取。如果您的賬號已經開通企業項目,輸入AK/SK后,Agent會查詢有主機遷移權限的企業項目并羅列,供您選擇。選擇具體的企業項目后,主機遷移服務會將主機遷移到您指定的企業項目中。實現遷移時權限、資源和財務的隔離。當出現如下界面時,表示Linux版的SMS-Agent啟動成功,開始給主機遷移服務上傳源端服務器信息。您可以前往SMS控制臺的遷移服務器列表頁面查看上報的源端服務器。
問題處理
- 如果遷移Agent啟動失敗,出現"
No such file or directory: 'rsync':'rsync'"等錯誤提示,請您參見Agent的安裝與啟動。 - 如果遷移Agent啟動失敗,出現“
sms.0202 AK/SK authentication failed. Ensure that the system time is consistent with the standard time and the AK and SK are correct.”等錯誤提示,請您參見如何處理遷移Agent中AK/SK校驗失敗?。 - 如果控制臺看不到源端服務器記錄,請參考源端Agent注冊后為什么主機遷移服務控制臺沒有記錄,進行排查處理。