마이그레이션 도구를 사용하여 온-프레미스 VMware Cloud Director에서 VMware Cloud Director service로 마이그레이션하는 방법

VMware Cloud Director service 마이그레이션 도구를 사용하여 온-프레미스 VMware Cloud Director 설치를 VMware Cloud Director service로 마이그레이션할 수 있습니다.

마이그레이션 도구를 사용하여 온-프레미스에서 SDDC 리소스를 유지하면서 VMware Cloud Director service로 원활하게 마이그레이션합니다. 마이그레이션에 성공한 후 VMware Cloud Director service를 사용하여 온-프레미스 SDDC 리소스를 관리합니다.

마이그레이션을 용이하게 하기 위해 재사용 가능한 매개 변수와 해당 값(예: 온-프레미스 인스턴스의 호스트 이름, 배포를 마이그레이션하는 VMware Cloud 조직의 조직 ID 등)을 다음 형식으로 사용하여 호스트의 /tmp 디렉토리 아래에 migration.properties 파일을 생성하도록 선택할 수 있습니다.

SITE_NAME=migration.eng.example.com
SITE_ADMIN_USERNAME=administrator
IS_APPLIANCE=true/false
CSP_ORG_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
CSP_ORG_REFRESH_TOKEN=API Token
CELL_USERNAME=root
DBHOST_USERNAME=root

마이그레이션 중에 마이그레이션 도구는 파일의 값을 사용할지 아니면 각 매개 변수에 대해 사용자 지정 값을 입력할지를 선택하라는 메시지를 표시합니다. 마이그레이션 전에 migration.properties 파일을 생성하지 않도록 선택하면 마이그레이션 도구가 해당 파일을 생성하고 마이그레이션 중에 입력한 값으로 채웁니다. 그런 다음, 후속 마이그레이션을 위해 파일을 재사용할 수 있습니다.

참고: 마이그레이션은 VMware Cloud Director 데이터베이스의 크기와 인터넷 대역폭에 따라 10분에서 2시간 정도 걸릴 수 있습니다.

표 1. 지원되는 마이그레이션 경로
소스 온-프레미스 환경 버전	VMware Cloud Director service 마이그레이션 지원
VMware Cloud Director 10.3.3	VMware Cloud Director service(10.3.3)
VMware Cloud Director 10.4	VMware Cloud Director service(10.4)
VMware Cloud Director 10.4.1	VMware Cloud Director service(10.4.1)

사전 요구 사항

온-프레미스 VMware Cloud Director 환경과 VMware Cloud Director service 간의 호환성을 확인하려면 온-프레미스 설치 앞에 있는 로드 밸런서에 공개적으로 액세스할 수 있는지 확인합니다.
VMware 지원팀에 문의하여 VMware Cloud 조직이 마이그레이션을 지원하는지 확인합니다. 마이그레이션 지원 요청을 제출하는 방법의 내용을 참조하십시오.
마이그레이션을 실행할 호스트에 curl, jq, zip, ssh, scp, sshpass 및 md5sum 지원 패키지를 설치했는지 확인합니다.
VMware Cloud Director 호스트 이름, 관리자 사용자 이름 및 관리자 암호를 가져옵니다.
온-프레미스 VMware Cloud Director 배포 유형(장치 기반 또는 Linux 기반)을 기록해 둡니다.
장치 배포를 사용하는 경우 기본 및 셀 OS 자격 증명을 기록해 둡니다.
Linux 배포를 사용하는 경우 활성 셀 OS 자격 증명 및 외부 데이터베이스 호스트 OS 자격 증명을 기록해 둡니다.
VMware Cloud API 토큰을 생성하고 토큰 자격 증명을 저장합니다. 토큰의 범위에는 관리자 및 NSX Cloud 관리자 서비스 역할, 개발자 또는 조직 소유자 조직 역할이 포함되어야 합니다. API 토큰을 생성하는 방법을 참조하십시오.
사용 중인 VMware Cloud Director 구성에 대해 마이그레이션이 지원되는지 확인합니다. VMware Cloud Director-VMware Cloud Director Service 마이그레이션 제한 사항을 참조하십시오.
온-프레미스 구성이 VMware Cloud Director service에서 지원되는 확장/축소 최대값과 일치하는지 확인합니다. VMware Cloud Director Service에 대한 구성 최대값을 참조하십시오.
https://github.com/vmware-samples/cloud-director-service-migration의 마이그레이션 스크립트를 해당 스크립트를 실행하려는 호스트로 다운로드합니다.

프로시저

명령을 실행하여 마이그레이션 도구를 시작합니다.
sh migrate.sh
migration.properties 파일을 생성한 경우 파일 컨텐츠의 재사용을 확인하고 5단계로 이동합니다.
1. 확인 메시지가 표시되면 y를 입력하여 migration.properties 파일 재사용을 확인합니다.
2. 확인 메시지가 표시되면 y를 입력하여 온-프레미스 VMware Cloud Director 인스턴스의 호스트 이름을 재사용합니다.
3. 확인 메시지가 표시되면 y를 입력하여 관리자 사용자 이름을 재사용합니다.
확인 메시지가 표시되면 온-프레미스 VMware Cloud Director 인스턴스의 호스트 이름을 입력합니다.
확인 메시지가 표시되면 관리자 사용자 이름 또는 온-프레미스 VMware Cloud Director 인스턴스를 입력합니다.
확인 메시지가 표시되면 관리자 암호 또는 온-프레미스 VMware Cloud Director 인스턴스를 입력합니다.
확인 메시지가 표시되면 온-프레미스 배포가 장치 기반인지 여부를 확인하고, 그렇지 않으면 거부합니다.
장치 배포를 사용하는 경우 기본 VMware Cloud Director 장치 셀에 대한 자격 증명을 입력합니다.
1. 확인 메시지가 표시되면 셀에 대한 root 사용자 이름을 입력하거나 migration.properties 파일에서 값의 재사용을 확인합니다.
2. 확인 메시지가 표시되면 root 암호를 입력합니다.
Linux 설치를 사용하는 경우 확인 메시지가 표시되면 데이터베이스 호스트에 대한 자격 증명을 입력합니다.
1. 확인 메시지가 표시되면 호스트 이름을 입력하거나 migration.properties 파일의 값이 재사용되도록 합니다.
2. 확인 메시지가 표시되면 데이터베이스 사용자 이름을 입력하거나 migration.properties 파일값 재사용을 확인합니다.
3. 확인 메시지가 표시되면 데이터베이스 암호를 입력합니다.
확인 메시지가 표시되면 VMware Cloud Director service 인스턴스를 배포하려는 VMware Cloud 조직의 긴 조직 ID를 입력하거나 파일의 해당 인스턴스 재사용을 확인합니다.
확인 메시지가 표시되면 생성한 VMware Cloud 조직에 대한 VMware Cloud API 액세스 토큰을 입력합니다.
둘 이상의 VMware Cloud Director service 환경이 있는 경우 확인 메시지가 표시되면 VMware Cloud Director를 마이그레이션할 환경을 선택하고 환경 번호를 입력합니다.
확인 메시지가 표시되면 온-프레미스 배포를 마이그레이션할 VMware Cloud Director service 인스턴스의 이름을 입력합니다.
온-프레미스 VMware Cloud Director 인스턴스가 VMware Cloud Director service로 마이그레이션되었습니다.
VMware 역방향 프록시를 통해 새로 생성된 VMware Cloud Director 인스턴스를 SDDC에 연결합니다.

예: VMware Cloud Director service로 마이그레이션

이 예에서는 마이그레이션 도구와 migration.properties 파일을 사용하여 Linux 배포를 VMware Cloud Director service로 마이그레이션하는 데 필요한 단계를 보여 줍니다.

SITE_NAME=migration.eng.example.com
SITE_ADMIN_USERNAME=administrator
IS_APPLIANCE=false
CSP_ORG_ID=11111111-2222-3333-4444-555555555555
CSP_ORG_REFRESH_TOKEN=Ab4XdNsdMeNFVSHA8q3ze8ebR0t4Hik7lSs6DZJTFoF_wcQaTWw7U6O8ZLk6j4IM
CELL_USERNAME=root
DBHOST_USERNAME=root

명령을 실행하여 마이그레이션 도구를 시작합니다.

sh migrate.sh

이 도구는 migration.properties 파일을 사용할지 여부를 선택하고 일부 단계에서 추가 입력을 제공하라는 메시지를 표시합니다.

성공적인 마이그레이션을 위한 출력은 다음과 유사합니다.

Migration Input properties file present, wish to reuse [y/n]: y
Script will reuse the input values located in /tmp/migration.properties
Site FQDN name (found: migration.eng.example.com), wish to reuse [y/n]: y
Site admin user name (found: administrator), wish to reuse [y/n]: y
Enter admin password for on-prem VCD site migration.eng.example.com: xxxxx
Successfully collected administrator credentials for migration.eng.example.com
Is migration.eng.example.com appliance based (found: false), wish to reuse [y/n]: y
Found active Cell: migration-vcd1.eng.example.com
Username for cell migration-vcd1.eng.example.com  (found: root), wish to reuse [y/n]: y
Enter password for cell migration-vcd1.eng.example.com: xxxxxx
Successfully collected root credentials for migration-vcd1.eng.example.com
Successfully downloaded responses.properties from migration-vcd1.eng.example.com
Found Database HOSTNAME: migration-db.eng.example.com
Found Database Name: vcloud
Username for DB Host migration-db.eng.example.com (found: root), wish to reuse [y/n]: y
Enter password for DB Host migration-db.eng.example.com: xxxxx
Successfully collected root credentials for migration-db.eng.example.com
CSP ORG ID (found: 11111111-2222-3333-4444-555555555555), wish to reuse [y/n]: y
CSP ORG refresh Token (found: Ab4XdNsdMeNFVSHA8q3ze8ebR0t4Hik7lSs6DZJTFoF_wcQaTWw7U6O8ZLk6j4IM), wish to reuse [y/n]: y
Retrieving list of environments associated for org: 11111111-2222-3333-4444-555555555555
Found following 4 environments in org: 11111111-2222-3333-4444-555555555555
US West - Oregon (66666)
Australia - Sydney (77777)
Europe - Germany (88888)
Asia - Japan (99999)
Select environment for CDI migration: values (1-5)] : 1
Selected Environment: US West - Oregon (66666)
Compatibility Check Succeeded, found upgrade category: release-10.3:production
Successfully collected all required resources from migration.eng.example.com for migration
Enter CDI Name to migrate: MigratedInstance
Uploading collected resources from migration.eng.example.com for migration
Upload Resource Task URN: urn:vcdc:task:99999999-8888-7777-6666-555555555555
Setting up maintenance mode on all cloud cells
Entering maintenance mode on migration-vcd1.eng.example.com
Successfully entered maintenance mode.
Successfully entered maintenance mode on migration-vcd1.eng.example.com
Entering maintenance mode on migration-vcd2.eng.example.com
Successfully entered maintenance mode.
Successfully entered maintenance mode on migration-vcd2.eng.example.com
Entering maintenance mode on migration-vcd3.eng.example.com
Successfully entered maintenance mode.
Successfully entered maintenance mode on migration-vcd3.eng.example.com
Successfully entered maintenance mode on all cloud cells
Migrate to CDI Task ID: urn:vcdc:task:888888888-7777-6666-5555-4444444444444
Migrate to CDI task run status: IN_PROGRESS - Deploying instance
Migrate to CDI task run status: IN_PROGRESS - Waiting for service to be available
Migrate to CDI task run status: IN_PROGRESS - Backup VMware Cloud Director database schema
Migrate to CDI task run status: IN_PROGRESS - Waiting for all cells to be ready
Migrate to CDI task run status: IN_PROGRESS - Creating groups in system org
Migrate to CDI task run status: IN_PROGRESS - Integrating VCD micrometer metrics with Wavefront
Migrate to CDI task run status: SUCCESS -
Migrate to CDI status SUCCESS for task urn:vcdc:task:888888888-7777-6666-5555-4444444444444