第一步：导入迁移源--服务器迁移中心-火山引擎

文档中心

立即注册

导航

第一步：导入迁移源

最近更新时间：2024.07.17 15:05:56首次发布时间：2022.11.10 11:19:22

使用SMC将迁移源迁移至火山引擎前，您需要先通过迁移工具Agent将迁移源信息导入并连接到您的火山引擎账号。
本文介绍安装迁移工具Agent并导入迁移源的操作步骤。

说明

若您于2024年07月01日前安装了迁移工具Agent，Agent使用详情请参考导入迁移源。

前提条件

请确认您已经按照要求完成前置准备。详情可查看准备工作。

操作步骤

您需要在迁移源中安装迁移工具Agent，Agent可以收集迁移源信息并导入火山引擎。

Linux 操作系统

Windows 操作系统

登录待迁移的源服务器。
执行如下命令，通过公网下载迁移工具Agent。
```
sudo wget -O smc-agent_Linux_amd64.tar.gz https://smc-beijing.tos-cn-beijing.volces.com/smc-agent_Linux_amd64.tar.gz
```
说明
您也可以使用任意连通公网的服务器下载迁移工具Agent，再通过FTP等工具将Agent上传至待迁移的源服务器。操作详情可参考本地数据上传。

执行如下命令，解压并启动迁移工具Agent，导入源服务器信息至火山引擎。

sudo tar -zxvf smc-agent_Linux_amd64.tar.gz && ./smc_manage start -ak {{access key}} -sk {{secret key}}

说明

请将{{access key}}、{{secret key}} 替换为实际API访问密钥。获取密钥操作详情可查看Access Key（密钥）管理。
Agent运行后，将在smc_tools目录下生成临时密钥对id_rsa（临时私钥）、id_rsa.pub（临时公钥）。
- 目标实例或中转实例将在迁移过程中使用该临时密钥对，减少您自有密钥泄露风险，保证您的密钥安全。
- 请勿删除该密钥对，否则将导致迁移失败。
- 若由于误删密钥对导致迁移失败，您可以在迁移Agent所在目录以此执行./smc_agent stop与./smc_agent start命令再次运行Agent，即可重新导入迁移源并生成临时密钥对。
- 成功迁移后，请使用源服务器登录凭证（密码或密钥对）登录目标实例或自定义镜像。

解压后将获得如下文件。

文件名	说明
Linux-version	当前压缩包版本信息。
smc_agent	二进制文件，迁移工具主要文件。
smc_manage	二进制文件，迁移管理工具。
agent_cfg.json	JSON文件，用于记录迁移过程信息。
excludes.txt	txt文件，不迁移的文件和目录路径需要写入此文件。
user_cfg.json	JSON文件，用户信息配置文件。
smc_tools	文件夹，包含迁移过程中SMC使用到的临时密钥对、块复制工具、检测脚本等内容。

运行成功后，迁移Agent将开始向SMC上传迁移源信息。
说明
完成导入前请勿关闭迁移工具客户端，否则迁移源将与SMC控制台失去联系，无法完成导入。
您可以在运行Agent的目录下执行如下命令，查看SourceId(迁移源ID)及Agent运行日志，排查迁移问题。
```
tail -f smc.log
```
回显示例
您还可以管理迁移工具Agent使用的API访问密钥、配置无需迁移的文件、迁移源所属项目等信息。操作详情可查看管理迁移工具Agent。

说明

由于Windows操作系统仅支持“块复制”方式迁移数据，因此不支持排除无需迁移的文件或目录。

登录待迁移的源服务器。

您可以通过PowerShell或图形界面下载、运行迁移工具Agent。

注意

您也可以使用任意连通公网的服务器下载迁移工具Agent，再通过FTP等工具将Agent上传至待迁移的源服务器。操作详情可参考本地数据上传。
杀毒软件可能会禁止迁移工具运行，请检查其配置。
您需要以管理员（Administer）身份运行迁移工具。
开始运行后，Agent将自动生成smc.txt文件记录Agent运行日志，方便您排查迁移问题。

PowerShell

在PowerShell中执行如下命令，下载迁移工具Agent。

(New-Object -TypeName System.Net.WebClient).DownloadFile('https://smc-beijing.tos-cn-beijing.volces.com/smc-agent_Windows_x86_64.zip', 'C:\smc-agent_Windows_x86_64.zip')

说明

默认下载至C:\目录。

在PowerShell中执行如下命令，解压迁移工具Agent压缩包。

使用Unzip解压

cd C:\ ; unzip -o .\smc-agent_Windows_x86_64.zip ; C:\smc_agent -autostart=true -ak={{access key}} -sk={{secret key}}

PowerShell 5.0及以上版本

cd C:\ ; Expand-Archive -LiteralPath 'C:\smc-agent_Windows_x86_64.zip' -DestinationPath C:\ ; C:\smc_agent -autostart=true -ak={{access key}} -sk={{secret key}}

PowerShell 3.0及以上版本

powershell.exe -nologo -noprofile -command "& { Add-Type -A 'System.IO.Compression.FileSystem'; [IO.Compression.ZipFile]::ExtractToDirectory('C:\smc-agent_Windows_x86_64.zip', 'C:\'); }" ; C:\smc_agent -autostart=true -ak={{access key}} -sk={{secret key}}

说明

请将{{access key}}、{{secret key}}替换为实际API访问密钥。获取密钥操作详情可查看获取Access Key。

解压后将获得如下文件。

文件名	说明
Windows-version.txt	当前Agent版本信息。
smc_agent.exe	应用程序文件，迁移工具主要文件。
agent_cfg.json	JSON文件，用于记录迁移过程信息。
user_cfg.json	JSON文件，用户信息配置文件。
bin	文件夹，二进制文件存放目录。
sciter.dll	迁移工具依赖的库文件。
notice.txt	迁移工具遵守的规范信息。

系统将自动打开迁移Agent图形化界面，填入您在命令中传入的访问秘钥，并自动开始导入迁移源信息。

图形化界面
1. 登录源服务器。
2. 通过浏览器打开如下链接，下载迁移工具Agent。
```
https://smc-beijing.tos-cn-beijing.volces.com/smc-agent_Windows_x86_64.zip
```
  说明
  您也可以使用任意连通公网的服务器下载迁移工具Agent，再通过FTP等工具将Agent上传至待迁移的源服务器。操作详情可参考本地数据上传。
3. 解压迁移工具压缩包，解压获取的文件信息详情，可查看Agent文件信息。
4. 右键单击smc_agent.exe，单击“以管理员身份运行”按钮，运行迁移工具Agent。
5. 输入火山引擎访问密钥（Access Key）包含的Access Key ID和Secret Access Key，并单击“运行”按钮启动迁移Agent。
  说明
  获取访问密钥（Access Key）操作，可查看获取Access Key。

运行成功后，迁移Agent将开始向SMC上传迁移源信息。
说明
完成导入前请勿关闭迁移工具客户端，否则迁移源将与SMC控制台失去联系，无法完成导入。
您可以在运行Agent的目录下，查看Agent运行日志文件smc.txt，获取SourceId(迁移源ID)及Agent运行日志，排查迁移问题。
您还可以配置迁移源所属项目、代理服务器信息。操作详情可查看管理迁移工具Agent。

后续操作

您可以前往云服务器控制台查看迁移源信息并创建迁移任务。操作详情可查看查看迁移源详情、创建迁移任务。