대상 클라우드 서버의 리전은, 리전만 기입하면 되며, 가용존은 기입하지 않으셔도 됩니다. 값은 리전 리스트를 참고하십시오.
InstanceId
String
Yes
대상 클라우드 서버의 인스턴스 ID. 형식: ins-xxxxxxxx.
DataDisks
Array
No
원본 호스트에서 마이그레이션할 데이터 디스크 리스트로, 각 요소는 데이터 디스크를 나타내며 최대 20개의 데이터 디스크를 지원합니다.
DataDisks.Index
Integer
No
데이터 디스크의 일련 번호 범위는 [1에서 20 사이]입니다. 값이 1이면 데이터 디스크가 대상 CVM에 마이그레이션되고 연결되는 첫 번째 디스크임을 나타냅니다. 값이 2이면 데이터 디스크가 두 번째로 마이그레이션되어 대상 CVM에 연결됨을 나타내는 식입니다.
DataDisks.Size
Integer
No
원본 데이터 디스크 크기. 단위: GB, 범위: [10,16000].
DataDisks.MountPoint
String
No
원본 데이터 디스크 마운트 포인트. 예: "/mnt/disk1".
다음 예시를 참고하여 실제 비즈니스 시나리오를 기반으로 구성 파일을 수정할 수 있습니다.
예시1: Linux 소스 CVM을 Tencent Cloud 광저우 리전의 CVM으로 마이그레이션 할 때의 user.json 파일 설정은 다음과 같습니다.
{
"SecretId":"your secretId",
"SecretKey":"your secretKey",
"Region":"ap-guangzhou",
"InstanceId":"your instance id"
}
예시2: Linux 소스 CVM(마운트 포인트가 /mnt/disk1이며, 10GB 크기의 데이터 디스크 한 블록 포함)을 Tencent Cloud 광저우 리전의 대상 CVM(최소 한 블록의 데이터 디스크가 마운트되어야 함)으로 마이그레이션할 때의 user.json 파일 설정은 다음과 같습니다.
{
"SecretId":"your secretId",
"SecretKey":"your secretKey",
"Region":"ap-guangzhou",
"InstanceId":"your instance id",
"DataDisks":[
{
"Index":1,
"Size":10,
"MountPoint":"/mnt/disk1"
}
]
}
예시3: Linux 소스 CVM(포함된 두 데이터 디스크 중, 마운트 포인트가 /mnt/disk1인 10GB 크기의 disk1을 대상 CVM의 첫 번째 데이터 디스크로 마이그레이션하고, 마운트 포인트가 /mnt/disk2인 20GB 크기의 disk2를 대상 CVM의 두 번째 데이터 디스크로 마이그레이션 하려는 경우)을 Tencent Cloud 광저우 리전의 CVM(최소 두 데이터 디스크가 마운트 되어있는 경우)으로 마이그레이션 할 때의 user.json 파일 설정은 다음과 같습니다.
{
"SecretId":"your secretId",
"SecretKey":"your secretKey",
"Region":"ap-guangzhou",
"InstanceId":"your instance id",
"DataDisks":[
{
"Index":1,
"Size":10,
"MountPoint":"/mnt/disk1"
},
{
"Index":2,
"Size":20,
"MountPoint":"/mnt/disk2"
}
]
}
client.json 파일 매개변수 설명
client.json 구성 파일은 다음과 같이 설명됩니다.
매개변수 이름
유형
필수 입력여부
설명
Client.ToolMode
bool
No
툴 마이그레이션 모드 식별자로, 기본값은 false입니다. 툴을 통한 마이그레이션이 필요한 경우 값을 true로 수정하거나 툴 실행 시 --no-console 매개변수를 추가합니다.
마이그레이션하기 전에 원본 호스트와 대상 CVM을 별도로 확인해야 합니다. 다음 표를 확인하십시오.
타깃 CVM
1. 스토리지 공간: 타깃 CVM의 CBS(시스템 디스크 및 데이터 디스크 포함)에는 원본측에서 데이터를 로드할 수 있는 충분한 저장 공간이 있어야 합니다.
2. 보안 그룹: 443 포트 및 80 포트는 보안 그룹에서 제한할 수 없습니다.
3. 대역폭 설정: 더 빠른 마이그레이션을 위해 양쪽 끝의 대역폭을 최대한 늘리는 것이 좋습니다. 마이그레이션 과정에서 대략 데이터 양만큼의 트래픽 소모가 발생하게 되며, 필요한 경우 미리 네트워크 과금 모드를 변경하시기 바랍니다.
4. 대상 ECS와 원본 호스트의 운영 체제 유형이 동일한지 여부: 운영 체제가 일치하지 않으면 후속 이미지의 정보가 실제 운영 체제와 일치하지 않을 수 있으므로 대상 CVM의 운영 체제는 원본 호스트의 운영 체제 유형과 일치하는 것이 좋습니다. 예를 들어 CentOS 7 시스템의 원본 호스트를 마이그레이션할 때 CentOS 7 시스템의 CVM을 마이그레이션 대상으로 선택합니다.
2. 실행 which rsync rsync가 설치되어 있는지 확인하는 명령어입니다. 설치되어 있지 않다면 Rsync 설치 방법을 참고하여 설치를 진행하십시오.
3. SELinux의 활성화 여부를 확인하십시오. SELinux가 활성화되어 있으면 SELinux 비활성화 방법을 참고하여 비활성화하십시오.
4. Tencent Cloud API로 마이그레이션 요청이 이루어진 후 Cloud API는 현재의 UNIX 타임을 사용하여 생성된 Token을 검사합니다. 현재 시스템 시간이 올바른지 확인하십시오.
설명：
./go2tencentcloud_x64 --no-console --check과 같은 툴 명령을 사용하여 소스 서버를 자동으로 확인할 수 있습니다.
go2tencentcloud 마이그레이션 툴은 실행 시작 시 자동 점검하도록 기본 설정되어 있습니다. 점검 과정을 건너뛰고 강제 마이그레이션 하려면 client.json 파일의 Client.Extra.IgnoreCheck 필드를 true로 설정합니다.
마이그레이션 시작
Tencent Cloud에서 제공하는 go2tencentcloud 마이그레이션 툴은 체크포인트 재시작을 지원하며 마이그레이션 과정은 크게 세 단계로 나뉩니다. 사용자는 툴 실행 과정에서 마이그레이션 진행률을 직관적으로 확인할 수 있습니다.
1단계: 대상 CVM의 마이그레이션 모드 진입 단계. 마이그레이션을 준비합니다.
2단계: 대상 CVM의 마이그레이션 모드 진행 단계. 데이터를 마이그레이션 합니다.
3단계: 대상 CVM의 마이그레이션 모드 종료 단계. 마이그레이션을 완료합니다.
각 단계에서는 일련의 서브 작업을 실행해야 하며, 오랜 시간을 소모하는 일부 서브 작업은 최대 타임아웃 시간이 기본 설정되어 있습니다. 데이터 전송의 소요 시간은 소스 데이터 크기, 네트워크 대역폭 등의 영향을 받으므로, 마이그레이션 과정이 완료될 때까지 기다려 주시기 바랍니다.
주의사항：
마이그레이션을 시작한 후에는 대상 CVM이 마이그레이션 모드에 들어가므로, 마이그레이션이 완료되어 마이그레이션 모드를 종료할 때까지 대상 CVM에 시스템 재설치, 셧다운, 폐기, 비밀번호 재설정 등의 작업을 실행하지 마시길 바랍니다.
공용 네트워크 마이그레이션
사설 네트워크 마이그레이션 시나리오 1
사설 네트워크 마이그레이션 시나리오 2
사설 네트워크 마이그레이션 시나리오 3
1. 마이그레이션 툴 go2tencentcloud.zip을 원본 호스트에 다운로드하거나 업로드하고 다음 명령을 실행하여 해당 디렉터리로 들어갑니다.
2. 다음 명령어를 순서대로 실행하여 go2tencentcloud.zip의 압축을 풀고 디렉터리로 들어갑니다.
unzip go2tencentcloud.zip
cd go2tencentcloud
3. 다음 명령어를 순서대로 실행하여 go2tencentcloud-linux.zip의 압축을 풀고 디렉터리로 들어갑니다.
unzip go2tencentcloud-linux.zip
cd go2tencentcloud-linux
설명：
go2tencentcloud 디렉터리에 있는 파일은 마이그레이션되지 않으므로 이 디렉터리에 마이그레이션할 파일을 두지 마십시오.
4. user.json 파일에 타깃 CVM을 설정합니다.
user.json 파일 매개변수 설명에 따라 필수 항목과 필요 항목에 대한 값을 설정합니다.
5. client.json 파일에 마이그레이션 모드와 기타 항목을 설정합니다.
client.json 파일에서 Client.ToolMode'를 true`로 설정합니다. 즉, 툴을 통한 마이그레이션을 선택합니다. 필요한 경우 client.json 파일의 매개변수 설명을 기반으로 다른 매개변수를 구성합니다.
6. (옵션)원본 CVM에서 마이그레이션하지 않을 파일 또는 디렉터리를 제외합니다.
Linux 소스 서버에서 rsync_excludes_linux.txt 파일로 마이그레이션할 필요가 없는 파일 또는 디렉터리를 추가합니다.
7. 툴을 실행합니다.예를 들어, 64비트 Linux 소스 서버에서는 root 권한으로 다음 명령어를 실행하여 툴을 실행합니다.
sudo ./go2tencentcloud_x64
주의사항：
client.json에서 Client.ToolMode를 true로 수정하지 않은 경우 아래와 같이 툴을 실행할 때 --no-console 매개변수를 추가해야 합니다.
sudo ./go2tencentcloud_x64 --no-console
툴이 실행된 후 마이그레이션이 끝날 때까지 기다립니다. 일반적으로 성공적인 공용 네트워크 마이그레이션의 콘솔 출력은 다음과 같습니다.
5. (옵션)원본 호스트에서 마이그레이션하지 않을 파일 또는 디렉터리를 제외합니다.
마이그레이션할 필요가 없는 파일이나 디렉터리가 Linux 원본 호스트에 있는 경우 rsync_excludes_linux.txt 파일에 파일이나 디렉터리를 추가할 수 있습니다.
6. 게이트웨이같이 공용 네트워크에 액세스할 수 있는 호스트
에서 툴을 실행합니다.
예를 들어, 공용 네트워크에 액세스할 수 있는 CVM에서 다음 명령어로 툴을 실행하여, 1단계 마이그레이션을 진행합니다.
sudo ./go2tencentcloud_x64
주의사항：
client.json의 'Client.ToolMode'를 'true'로 수정하지 않은 경우 툴을 실행할 때 다음과 같이 '--no-console' 매개변수를 추가해야 합니다.
sudo ./go2tencentcloud_x64 --no-console
Stage 1 is finished and please run next stage at source machine.라는 문구가 출력되면, 1단계 마이그레이션이 완료되었다는 의미입니다. 아래 이미지와 같습니다.
7. 마이그레이션 대기 중인 원
본 호스트에서 툴을 실행합니
다.6단계(1단계)가 완료되면, 1단계의 모든 툴 목록을 마이그레이션할 소스 CVM에 복사한 뒤, 다시 툴을 실행하여 2단계 마이그레이션을 진행합니다.
예를 들어, 다음 명령어로 툴을 실행하여 2단계 마이그레이션을 진행합니다.
sudo ./go2tencentcloud_x64
주의사항：
client.json의 'Client.ToolMode'를 'true'로 수정하지 않은 경우 툴을 실행할 때 다음과 같이 '--no-console' 매개변수를 추가해야 합니다.
sudo ./go2tencentcloud_x64 --no-console
Stage 2 is finished and please run next stage at gateway machine.라는 문구가 제시되면, 2단계 마이그레이션이 완료되었다는 의미입니다. 아래 이미지와 같습니다.
8. 게이트웨이같이 공용 네트워크에 액세스할 수 있는 호스트에서 툴을 실행합니다.
7단계(2단계)가 완료되면, 2단계의 모든 툴 목록을 1단계의 CVM에 복사한 뒤, 다시 툴을 실행하여 3단계 마이그레이션을 진행합니다.
예를 들어, 다음 명령어로 툴을 실행하여 3단계 마이그레이션을 진행합니다.
sudo ./go2tencentcloud_x64
주의사항：
client.json의 'Client.ToolMode'를 'true'로 수정하지 않은 경우 툴을 실행할 때 다음과 같이 '--no-console' 매개변수를 추가해야 합니다.
sudo ./go2tencentcloud_x64 --no-console
Migrate successfully.라는 문구가 출력되면, 모든 마이그레이션 작업이 완료되었다는 의미입니다. 아래 이미지와 같습니다.
client.json 파일의 Client.Net.Proxy.Ip 및 Client.Net.Proxy.Port 항목을 네트워크 프록시의 IP 주소와 포트로 설정합니다. 네트워크 프록시에 인증이 필요한 경우 Client.Net.Proxy.User 및 Client.Net.Proxy.Password에 네트워크 프록시의 사용자 이름과 비밀번호를 입력하십시오. 인증이 필요하지 않으면 공백으로 두십시오.
또한, 다른 항목을 설정해야 하는 경우 client.json 파일 매개변수 설명에 따라 구성하십시오.
5. (옵션)원본 호스트에서 마이그레이션하지 않을 파일 또는 디렉터리를 제외합니다.
마이그레이션할 필요가 없는 파일이나 디렉터리가 Linux 원본 호스트에 있는 경우 rsync_excludes_linux.txt 파일에 파일이나 디렉터리를 추가할 수 있습니다.
6. 툴을 실행합니다.
예를 들어, 64비트 Linux 소스 서버에서는 root 권한으로 다음 명령어를 실행하여 툴을 실행합니다.
sudo ./go2tencentcloud_x64
주의사항：
client.json의 'Client.ToolMode'를 'true'로 수정하지 않은 경우 툴을 실행할 때 다음과 같이 '--no-console' 매개변수를 추가해야 합니다.
sudo ./go2tencentcloud_x64 --no-console
툴이 실행된 후 마이그레이션 프로세스가 완료될 때까지 기다립니다. 일반적으로 성공적인 마이그레이션의 콘솔 출력 정보는 다음 이미지와 같습니다.
마이그레이션 사후 점검
마이그레이션 결과가 실패인 경우, 로그 파일(마이그레이션 툴 디렉터리 안의 log 파일로 기본 설정)의 오류 정보 출력, 가이드 문서 또는 서비스 마이그레이션 관련 FAQ를 확인하여 문제를 해결하거나 복구하시기 바랍니다.
마이그레이션 성공 시, 대상 CVM이 정상적으로 실행되는지, 대상 CVM의 데이터가 소스 CVM과 일치하는지, 네트워크가 정상적인지 또는 다른 시스템 서비스가 정상적인지 등을 확인하시기 바랍니다.
