CLI 업그레이드에 필요한 JSON 구성 파일 준비

vCenter Server Appliance를 업그레이드하기 위해 CLI 명령을 실행하기 전에 업그레이드 규격에 필요한 구성 매개 변수 및 해당 값이 있는 JSON 파일을 준비해야 합니다.

vCenter Server 설치 관리자에는 모든 업그레이드 유형에 필요한 JSON 템플릿이 포함되어 있습니다. 템플릿에 대한 자세한 내용은 vCenter Server Appliance의 CLI 업그레이드를 위한 JSON 템플릿의 내용을 참조하십시오.

현재 규격에 맞게 JSON 템플릿에 있는 구성 매개 변수의 값을 설정하면 최소 구성을 사용하여 장치를 업그레이드할 수 있습니다. 사용자 지정 구성을 위해 미리 설정된 값을 편집하고, 구성 매개 변수를 제거하고, 구성 매개 변수를 추가할 수 있습니다.

구성 매개 변수의 전체 목록과 해당 설명을 보려면 사용 중인 운영 체제의 설치 관리자 하위 디렉토리로 이동하여 vcsa-deploy upgrade --template-help 명령을 실행하거나 vCenter Server Appliance의 CLI 업그레이드를 위한 업그레이드 구성 매개 변수의 내용을 참조하십시오.

사전 요구 사항

JSON 구문에 익숙해야 합니다.
vCenter Server 설치 관리자 다운로드 및 마운트.

프로시저

vCenter Server Appliance 설치 관리자에서 vcsa-cli-installer 디렉토리로 이동하여 templates 하위 폴더를 엽니다.
업그레이드 템플릿을 upgrade 하위 폴더에서 작업 공간으로 복사합니다.

중요: JSON 구성 파일의 경로에는 ASCII 문자만 포함되어야 합니다. 확장 ASCII 및 ASCII가 아닌 문자는 지원되지 않습니다.
사용 사례에 필요한 템플릿 파일을 텍스트 편집기에서 엽니다.
JSON 구성 파일의 구문을 올바르게 유지하려면 JSON 편집기를 사용하십시오.
필수 구성 매개 변수의 값을 입력하고, 필요에 따라 추가적인 매개 변수와 해당 값을 입력합니다.
예를 들어 새 장치의 임시 네트워크에 IPv4 DHCP 할당을 사용하려면 템플릿의 temporary_network 하위 섹션에서 mode 매개 변수의 값을 dhcp로 변경하고, 정적 할당을 위한 기본 구성 매개 변수를 제거합니다.
```
        "temporary_network": {
            "ip_family": "ipv4",
            "mode": "dhcp"
        },
```
중요: 암호를 포함하여 모든 문자열 값에는 ASCII 문자만 포함되어야 합니다. 확장 ASCII 및 ASCII가 아닌 문자는 지원되지 않습니다.
백슬래시(\) 또는 따옴표(") 문자가 포함된 값을 설정하려면 문자 앞에 백슬래시(\) 문자가 있어야 합니다. 예를 들어 "password":"my\"password"는 암호를 my"password로 설정하고 "image":"G:\\vcsa\\VMware-vCenter-Server-Appliance-6.7.0.XXXX-YYYYYYY_OVF10.ova"는 경로를 G:\vcsa\VMware-vCenter-Server-Appliance-6.7.0.XXXX-YYYYYYY_OVF10.ova로 설정합니다.

부울 값은 소문자만 포함해야 합니다. 즉 값은 true 또는 false일 수 있습니다. 예: "ssh_enable":false
(선택 사항) 원하는 JSON 편집기를 사용하여 JSON 파일을 검증합니다.
UTF-8 형식으로 저장하고 파일을 닫습니다.

다음에 수행할 작업

업그레이드 규격에 필요한 경우 추가적인 템플릿을 작성하고 저장할 수 있습니다.

vCenter Server Appliance의 CLI 업그레이드를 위한 JSON 템플릿

vCenter Server 장치 설치 관리자에는 vcsa-cli-installer/templates 디렉토리에 있는 JSON 템플릿이 포함되어 있습니다. upgrade 하위 폴더에는 모든 업그레이드 유형에 필요한 최소 구성 매개 변수가 포함된 JSON 템플릿이 있습니다.

각 업그레이드 유형마다 새 장치를 ESXi 호스트에 배포하기 위한 템플릿 하나와 새 장치를 vCenter Server 인스턴스에 배포하기 위한 또 하나의 템플릿이 있습니다.

표 1. vCenter Server Appliance 설치 관리자에 포함되어 있는 업그레이드 JSON 템플릿
위치	템플릿	설명
vcsa-cli-installer\templates\upgrade\vcsa\6.7	embedded_vCSA_on_ESXi.json	ESXi 호스트에서 내장형 Platform Services Controller가 있는 vCenter Server Appliance 6.7를 vCenter Server Appliance 8.0으로 업그레이드하는 데 필요한 최소 구성 매개 변수를 포함합니다.
	embedded_vCSA_on_VC.json	vCenter Server 인스턴스에서 내장형 Platform Services Controller가 있는 vCenter Server Appliance 6.7를 vCenter Server Appliance 8.0으로 업그레이드하는 데 필요한 최소 구성 매개 변수를 포함합니다.
	vCSA_on_ESXi.json	ESXi 호스트에서 외부 Platform Services Controller가 있는 vCenter Server Appliance 6.7를 vCenter Server Appliance 8.0으로 업그레이드하는 데 필요한 최소 구성 매개 변수를 포함합니다.
	vCSA_on_VC.json	vCenter Server 인스턴스에서 외부 Platform Services Controller가 있는 vCenter Server Appliance 6.7를 vCenter Server Appliance 8.0으로 업그레이드하는 데 필요한 최소 구성 매개 변수를 포함합니다.
vcsa-cli-installer\templates\upgrade\vcsa\7.0	embedded_vCSA_on_ESXi.json	ESXi 호스트에서 내장형 Platform Services Controller가 있는 vCenter Server Appliance 7.0를 vCenter Server Appliance 8.0으로 업그레이드하는 데 필요한 최소 구성 매개 변수를 포함합니다.
vcsa-cli-installer\templates\upgrade\vcsa\7.0	embedded_vCSA_on_VC.json	vCenter Server 인스턴스에서 내장형 vCenter Server Appliance가 있는 vCenter Server Appliance 7.0을 Platform Services Controller Appliance 8.0으로 업그레이드하는 데 필요한 최소 구성 매개 변수를 포함합니다.

CLI를 사용하여 외부 Platform Services Controller가 있는 vCenter Server 업그레이드 정보

외부 Platform Services Controller를 사용하는 vCenter Server Appliance를 업그레이드하는 경우 장치에 내장된 해당 서비스가 포함된 vCenter Server 인스턴스로 변환됩니다. 이러한 이유로 JSON 업그레이드 템플릿에서 복제 파트너 매개 변수를 지정해야 합니다.

외부 Platform Services Controller를 사용하는 vCenter Server Appliance를 업그레이드하는 경우 JSON 업그레이드 템플릿에서 복제 파트너 매개 변수를 지정해야 합니다. 이러한 매개 변수는 업그레이드가 다음 vCenter Server 및 Platform Services Controller 업그레이드 시나리오 중 하나에 대한 것인지 여부를 나타냅니다.

SSO 도메인 내의 단일 vCenter Server 및 단일 Platform Services Controller 인스턴스입니다.
두 개 이상의 vCenter Server를 포함하는 SSO 도메인 내의 첫 번째 vCenter Server 및 Platform Services Controller 인스턴스입니다.
SSO 도메인 내에서 vCenter Server 및 Platform Services Controller 인스턴스를 복제합니다. 이는 기존 vCenter Server 7.0 인스턴스를 복제 파트너로 가리켜야 합니다.

중요: 외부 Platform Services Controller를 업그레이드할 수 없습니다. 업그레이드 프로세스는 Platform Services Controller 서비스를 vCenter Server Appliance로 컨버전스합니다. 자세한 내용은 Platform Services Controller 제거의 내용을 참조하십시오.

외부 Platform Services Controller를 사용하는 배포는 MxN 배포라고도 하며, 여기서 M은 vCenter Server를 나타내고 N은 외부 Platform Services Controller를 나타냅니다. 도메인에 vCenter Server 및 Platform Services Controller의 여러 인스턴스를 나타낼 때 이는 MnxNn으로 표시됩니다. 여기서 n은 인스턴스 수입니다. 예를 들어 M2xN2는 두 개의 vCenter Server 인스턴스와 동일한 도메인 내의 두 개의 Platform Services Controller 인스턴스를 나타냅니다. 이러한 배포를 업그레이드하는 경우 먼저 인스턴스 하나를 8.0 버전으로 업그레이드한 다음 두 개의 인스턴스 중 첫 번째 인스턴스를 복제 파트너로 지정하여 두 번째 인스턴스를 8.0으로 업그레이드합니다.

JSON 업그레이드 템플릿의 복제 매개 변수는 템플릿의 sso 섹션에 있으며 first_instance 및 replication_partner_hostname입니다.

매개 변수 이름	설명
`first_instance`	`first_instance` 매개 변수는 vCenter Server를 vCenter Server SSO 도메인의 첫 번째 인스턴스로 또는 복제 파트너로 식별합니다. 첫 번째 vCenter Server 인스턴스인 경우 `first_instance`를 `true`로 설정합니다. 동일한 SSO 도메인에 있는 vCenter Server의 추가 인스턴스의 경우에는 `first_instance`를 `false`로 설정합니다.
`replication_partner_hostname` *	`first_instance`를 `false`로 설정하는 경우 이미 버전 8.0으로 업그레이드되고 외부 PSC가 vCenter Server Appliance로 컨버전스된 vCenter Server의 FQDN 또는 IP 주소를 지정해야 합니다.

외부 Platform Services Controller를 사용하는 단일 vCenter Server Appliance의 CLI 업그레이드를 수행하는 경우 프로세스는 다음과 같습니다.

vCenter Server 배포에서 업그레이드할 때 vCSA_on_VC.json 템플릿을 사용하여 또는 ESXi에서 업그레이드할 때 vCSA_on_ESXi.json 템플릿을 사용하여 토폴로지에서 vCenter Server 인스턴스를 업그레이드합니다.
단일 vCenter Server 및 Platform Services Controller( M1xN1 배포)로 구성된 배포 토폴로지의 경우, first_instance 매개 변수가 true로 설정되도록 템플릿의 sso 섹션을 편집하고 replication_partner_hostname 매개 변수를 제거합니다.
```
"sso": {
"__comments": [ This is the first instance (M1) vCenter Server management node, with "first_instance" set to "true" and "replication_partner_hostname" removed.
],
"first_instance": true
}
```
JSON 템플릿에서 나머지 업그레이드 구성 매개 변수를 지정하고 CLI를 사용하여 vCenter Server를 버전 8.0으로 업그레이드합니다. CLI를 사용하여 vCenter Server 장치 업그레이드의 내용을 참조하십시오.
vCenter Server를 성공적으로 업그레이드한 후 Platform Services Controller의 서비스를 해제합니다. Platform Services Controller 해제의 내용을 참조하십시오.
중요: 토폴로지에서 모든 vCenter Server 인스턴스를 업그레이드하고 컨버전스한 후에만 Platform Services Controller 인스턴스의 서비스를 해제합니다.

두 개 이상의 vCenter Server 및 Platform Services Controller 인스턴스로 구성된 배포( M2xN2 배포)의 경우 먼저 M1 vCenter Server 인스턴스를 버전 8.0으로 업그레이드한 다음 vCenter Server 인스턴스를 복제하여 두 번째 인스턴스를 업그레이드합니다.

vCenter Server 배포에서 업그레이드할 때 vCSA_on_VC.json 템플릿을 사용하여 또는 ESXi에서 업그레이드할 때 vCSA_on_ESXi.json 템플릿을 사용하여 배포에서 vCenter Server 인스턴스를 업그레이드합니다.
첫 번째 vCenter Server 인스턴스( M1)의 경우 first_instance 매개 변수가 true로 설정되도록 템플릿의 sso 섹션을 편집하고 replication_partner_hostname 매개 변수를 제거합니다.
```
"sso": {
"__comments": [ This is the first instance (M1) vCenter Server management node, with "first_instance" set to "true" and "replication_partner_hostname" removed.
],
"first_instance": true
}
```
나머지 vCenter Server 인스턴스( M2)의 경우 first_instance 매개 변수가 false로 설정되도록 템플릿의 sso 섹션을 편집하고 두 번째 노드를 복제할 vCenter Server 인스턴스의 FQDN 또는 IP 주소를 제공합니다. 복제 파트너는 Platform Services Controller 인스턴스로 컨버전스된 버전 8.0으로 업그레이드한 첫 번째 vCenter Server 인스턴스( M1)입니다.
```
"sso": {
"__comments": [ This is the second instance (M2) vCenter Server management node, with "first_instance" set to "false" and "replication_partner_hostname" set to the hostname of the replication partner.],
"first_instance": false,
"replication_partner_hostname": "FQDN_or_IP_address"
```
JSON 템플릿에서 나머지 업그레이드 구성 매개 변수를 지정하고 CLI를 사용하여 업그레이드를 완료합니다. CLI를 사용하여 vCenter Server 장치 업그레이드의 내용을 참조하십시오.
토폴로지에서 모든 vCenter Server 인스턴스를 성공적으로 업그레이드한 후 Platform Services Controller 인스턴스의 서비스를 해제합니다. Platform Services Controller 해제의 내용을 참조하십시오.
중요: 토폴로지에서 모든 vCenter Server 인스턴스를 업그레이드하고 컨버전스한 후에만 Platform Services Controller 인스턴스의 서비스를 해제합니다.

vCenter Server Appliance의 CLI 업그레이드를 위한 업그레이드 구성 매개 변수

CLI 업그레이드를 위한 JSON 구성 파일을 준비할 때는 매개 변수와 값을 설정하여 vCenter Server Appliance의 업그레이드를 위한 입력 데이터를 제공해야 합니다.

JSON 업그레이드 파일에 있는 구성 매개 변수의 섹션 및 하위 섹션

CLI 업그레이드를 위한 JSON 구성 파일의 구성 매개 변수는 섹션과 하위 섹션으로 구성됩니다.

표 2. JSON 업그레이드 파일에 있는 구성 매개 변수의 섹션 및 하위 섹션
섹션	하위 섹션	설명
`new_vcsa` - 배포할 새 장치를 설명합니다.	`esxi`	새 장치를 ESXi 호스트에 직접 배포하려는 경우에만 사용합니다. 대상 ESXi 호스트를 설명하는 구성 매개 변수가 포함됩니다. `new_vcsa` 섹션, `esxi` 하위 섹션의 구성 매개 변수의 내용을 참조하십시오. 참고: 이 하위 섹션 또는 `vc` 하위 섹션을 채워야 합니다.
	`vc`	새 장치를 vCenter Server 인스턴스의 인벤토리에 배포하려는 경우에만 사용합니다. 대상 ESXi 호스트 또는 vCenter Server 인벤토리의 DRS 클러스터를 설명하는 구성 매개 변수가 포함됩니다. `new_vcsa` 섹션, `vc` 하위 섹션의 구성 매개 변수의 내용을 참조하십시오. 참고: 이 하위 섹션 또는 `esxi` 하위 섹션을 채워야 합니다. 대상 vCenter Server 인스턴스는 업그레이드하려는 vCenter Server Appliance일 수 없습니다. 이러한 경우에는 `esxi` 하위 섹션을 사용하십시오.
	`appliance`	새 장치를 설명하는 구성 매개 변수가 포함됩니다. `new_vcsa` 섹션, `appliance` 하위 섹션의 구성 매개 변수의 내용을 참조하십시오
	`os`	새 장치에 대한 SSH 관리자 로그인을 설정하는 `ssh_enable` 구성 매개 변수만 포함됩니다.
	`ovftool_arguments`	선택 사항입니다. 설치 관리자가 생성하는 OVF Tool 명령에 임의의 인수와 해당 값을 추가하기 위해 이 하위 섹션을 사용합니다. 중요: vCenter Server Appliance 설치 관리자는 `ovftool_arguments` 하위 섹션의 구성 매개 변수를 검증하지 않습니다. OVF Tool에서 인식하지 않는 인수를 설정하면 배포가 실패할 수 있습니다.
	`temporary_network`	새 장치의 임시 네트워크 설정을 설명하는 구성 매개 변수가 포함됩니다. `new_vcsa` 섹션, `temporary_network` 하위 섹션의 구성 매개 변수의 내용을 참조하십시오
	`user_options`	이전 장치에서 새 장치로 전송할 데이터 유형을 설정하는 `vcdb_migrateSet` 구성 매개 변수만 포함됩니다. `new_vcsa` 섹션, `user_options` 하위 섹션의 구성 매개 변수의 내용을 참조하십시오
`source_vc` - 업그레이드할 기존 장치를 설명합니다.	`managing_esxi_or_vc`	업그레이드할 장치가 있는 소스 ESXi 호스트 또는 vCenter Server Appliance 인스턴스를 설명하는 구성 매개 변수가 포함됩니다. `source_vc` 섹션, `managing_esxi_or_vc` 하위 섹션의 구성 매개 변수의 내용을 참조하십시오.
`source_vc` - 업그레이드할 기존 장치를 설명합니다.	`vc_vcsa`	업그레이드할 소스 장치를 설명하는 구성 매개 변수가 포함됩니다. `source_vc` 섹션, `vc_vcsa` 하위 섹션의 구성 매개 변수의 내용을 참조하십시오.
`source_vum` - 소스 VMware Update Manager 인스턴스를 설명합니다. VMware Update Manager 인스턴스에서 Migration Assistant를 자동으로 실행하려는 경우에 사용합니다.	`run_migration_assistant`	업그레이드하려는 소스 vCenter Server Appliance가 Windows 가상 시스템에서 실행되는 VMware Update Manager 인스턴스에 연결되어 있는 경우에 선택 사항입니다. 소스 VMware Update Manager 인스턴스에서 Migration Assistant를 자동으로 실행하려는 경우에 이 하위 섹션을 사용합니다. 업그레이드된 새 vCenter Server Appliance로 마이그레이션할 소스 VMware Update Manager 인스턴스를 설명하는 구성 매개 변수가 포함됩니다. `source_vum` 섹션, `run_migration_assistant` 하위 섹션의 구성 매개 변수의 내용을 참조하십시오. 참고: Migration Assistant에서는 기본적으로 포트 9123을 사용합니다. Update Manager 시스템의 다른 서비스에서 포트 9123을 사용하는 경우 Migration Assistant는 자동으로 사용 가능한 다른 포트를 찾습니다. Migration Assistant에 대해 사용자 지정 포트를 설정할 수 없습니다.
`ceip` - Vmware CEIP(고객 환경 향상 프로그램) 참여를 설명합니다.	`settings`	VMware CEIP(고객 환경 향상 프로그램)에 참여하거나 참여하지 않는 데 필요한 `ceip_enabled` 구성 매개 변수만 포함됩니다. `ceip` 섹션, `settings` 하위 섹션의 구성 매개 변수의 내용을 참조하십시오. 내장형 Platform Services Controller가 있는 vCenter Server Appliance 또는 Platform Services Controller 장치를 업그레이드하는 경우에만 필요합니다. 참고: `ceip_enabled` 구성 매개 변수를 `true`로 설정한 경우에는 CLI 배포 명령을 실행할 때 --acknowledge-ceip 인수를 사용해야 합니다. CEIP에 대한 자세한 내용은 "vCenter Server 및 호스트 관리" 의 고객 환경 향상 프로그램 구성 섹션을 참조하십시오.

중요: 암호를 포함하여 모든 문자열 값에는 ASCII 문자만 포함되어야 합니다. 확장 ASCII 및 ASCII가 아닌 문자는 지원되지 않습니다.

백슬래시(\) 또는 따옴표(") 문자가 포함된 값을 설정하려면 문자 앞에 백슬래시(\) 문자가 있어야 합니다. 예를 들어 "password":"my\"password"는 암호를 my"password로 설정하고 "image":"G:\\vcsa\\VMware-vCenter-Server-Appliance-8.0.0.XXXX-YYYYYYY_OVF10.ova"는 경로를 G:\vcsa\VMware-vCenter-Server-Appliance-8.0.0.XXXX-YYYYYYY_OVF10.ova로 설정합니다.

부울 값은 소문자만 포함해야 합니다. true 또는 false일 수 있습니다. 예: "ssh_enable":false

`new_vcsa` 섹션의 구성 매개 변수

표 3. `new_vcsa` 섹션, `esxi` 하위 섹션의 구성 매개 변수
이름	유형	설명
`hostname`	문자열	새 장치를 배포할 대상 ESXi 호스트의 IP 주소 또는 FQDN입니다.
`username`	문자열	대상 ESXi 호스트에서 관리 권한을 가진 사용자 이름입니다(예: root).
`password`	문자열	대상 ESXi 호스트에서 관리 권한을 가진 사용자의 암호입니다.
`deployment_network`	문자열	새 장치를 연결할 네트워크의 이름입니다. 네트워크는 대상 ESXi 호스트 또는 vCenter Server Appliance 인스턴스(`managing_esxi_or_vc` 구성 매개 변수로 식별) 네트워크 구성의 일부여야 합니다. 참고: 업그레이드할 장치가 있는 소스 ESXi 호스트 또는 vCenter Server Appliance 인스턴스( `managing_esxi_or_vc` 구성 매개 변수로 식별)에서 네트워크에 액세스할 수 있어야 합니다. 네트워크는 업그레이드를 수행하는 클라이언트 시스템에서도 액세스할 수 있어야 합니다. 대상 ESXi 호스트에 네트워크가 하나뿐인 경우에는 무시됩니다.
`datastore`	문자열	새 장치의 가상 시스템 구성 파일과 가상 디스크를 저장할 데이터스토어의 이름입니다. 데이터스토어는 대상 ESXi 호스트에서 사용할 수 있어야 합니다. 참고: 데이터스토어에 25GB 이상의 사용 가능한 디스크 공간이 있어야 합니다.
`port`	정수	대상 ESXi 호스트의 HTTPS 역방향 프록시 포트입니다. 기본 포트는 443입니다. 대상 ESXi 호스트에서 사용자 지정 HTTPS 역방향 프록시 포트를 사용하는 경우에만 사용합니다.
`ssl_certificate_verification`	문자열	CLI는 서버의 보안 인증서가 CA(인증 기관)에서 서명되었는지 확인한 후 보안 연결을 설정합니다. 인증서가 자체 서명된 경우 다음과 같은 SSL 인증서 구성 옵션 중 하나를 지정하지 않으면 CLI가 업그레이드를 중지합니다. 보안 SHA-1(해시 알고리즘 1) 인증서 지문을 지정합니다. 인증서 지문은 인증서를 고유하게 식별하는 16진수 문자열입니다. 지문은 지문 알고리즘을 사용하여 인증서 컨텐츠에서 계산됩니다. "thumbprint": "`certificate SHA-1 thumbprint`" `verification_mode`를 `NONE`으로 설정합니다. "verification_mode": "NONE" 자체 서명된 인증서가 있는 서버에 연결하는 경우 SHA-1 인증서 지문을 지정하지 않거나 검증 모드를 `NONE`으로 설정하면 CLI가 서버의 자체 서명된 인증서 지문을 표시하고 해당 인증서 지문을 수락하거나 거부하라는 메시지를 표시합니다. vcsa-deploy upgrade 명령 매개 변수 `--no-ssl-certificate-validation`을 사용하여 CLI가 자체 서명된 인증서 지문을 무시하도록 지정할 수도 있습니다. CLI 업그레이드 명령의 구문 항목을 참조하십시오.

표 4. `new_vcsa` 섹션, `vc` 하위 섹션의 구성 매개 변수
이름	유형	설명
`hostname`	문자열	새 장치를 배포할 대상 vCenter Server 인스턴스의 IP 주소 또는 FQDN입니다.
`username`	문자열	대상 vCenter Server 인스턴스에서 vCenter Single Sign-On 관리자의 이름입니다(예: [email protected]).
`password`	문자열	대상 vCenter Server 인스턴스에서 vCenter Single Sign-On 관리자의 암호입니다.
`deployment_network`	문자열	새 장치를 연결할 네트워크의 이름입니다. 네트워크는 대상 ESXi 호스트 또는 DRS 클러스터 네트워크 구성의 일부여야 합니다. 참고: 업그레이드할 장치가 있는 소스 ESXi 호스트에서 네트워크에 액세스할 수 있어야 합니다. 네트워크는 업그레이드를 수행하는 클라이언트 시스템에서도 액세스할 수 있어야 합니다. 대상 ESXi 호스트 또는 DRS 클러스터에 네트워크가 하나뿐인 경우에는 무시됩니다.
`datacenter`	어레이	새 장치를 배포할 대상 ESXi 호스트 또는 DRS 클러스터를 포함하는 vCenter Server 데이터 센터입니다. 데이터 센터가 폴더 또는 폴더 구조에 있는 경우, 쉼표로 구분된 문자열 목록으로 지정합니다. 예를 들면 다음과 같습니다. ["parent_folder", "child_folder", "datacenter_name"] 데이터 센터의 폴더 경로가 없는 경우에는 데이터 센터 이름만 사용합니다. 예를 들면 다음과 같습니다. ["datacenter_name"] 또는 "datacenter_name" 참고: 값은 대/소문자를 구분합니다.
`datastore`	문자열	새 장치의 모든 가상 시스템 구성 파일과 가상 디스크를 저장할 데이터스토어의 이름입니다. 참고: 대상 ESXi 호스트 또는 DRS 클러스터에서 데이터스토어를 사용할 수 있어야 합니다. 데이터스토어에 25GB 이상의 사용 가능한 디스크 공간이 있어야 합니다.
`port`	정수	대상 vCenter Server 인스턴스의 HTTPS 역방향 프록시 포트입니다. 기본 포트는 443입니다. 대상 vCenter Server 인스턴스에서 사용자 지정 HTTPS 역방향 프록시 포트를 사용하는 경우에만 사용합니다.
`target`	어레이	새 장치를 배포할 대상 클러스터, ESXi 호스트 또는 리소스 풀입니다. 이는 `datacenter` 매개 변수를 사용하여 지정한 대상입니다. 이 경로는 클러스터 이름, ESXi 호스트 이름 또는 리소스 풀 이름으로 끝나야 합니다. 중요: vCenter Server 인벤토리에 표시되는 이름을 제공해야 합니다. 예를 들어 vCenter Server 인벤토리에서 대상 ESXi 호스트의 이름이 IP 주소인 경우에는 FQDN을 제공할 수 없습니다. 참고: 모든 값은 대/소문자를 구분합니다. 배포된 장치를 데이터 센터의 계층 내 다른 위치에 나열하려면 이 섹션의 뒷부분에 설명된 vm_folder 매개 변수를 사용합니다. 대상 클러스터, ESXi 호스트 또는 리소스 풀이 폴더 또는 폴더 구조에 있는 경우, 값은 쉼표로 구분된 문자열 목록으로 지정합니다. 예를 들면 다음과 같습니다. ["parent_folder", "child_folder", "esxi-host.domain.com"] 대상 ESXi 호스트가 클러스터의 일부인 경우 경로를 쉼표로 구분된 문자열 목록으로 지정합니다. 예를 들면 다음과 같습니다. ["cluster_name","esxi-host.domain.com"] 리소스 풀에 배포하는 경우 리소스 풀 이름 앞에 Resources 레이블을 포함합니다. 예: ["cluster_name", "Resources", "resource_pool_name"] 참고: 사전 확인에서는 리소스 풀의 메모리만 확인됩니다.
`vm_folder`	문자열	선택 사항입니다. 새 장치를 추가할 VM(가상 시스템) 폴더의 이름입니다.

표 5. `new_vcsa` 섹션, `appliance` 하위 섹션의 구성 매개 변수
이름	유형	설명
`thin_disk_mode`	부울	씬 가상 디스크를 사용하여 새 장치를 배포하려면 `true`로 설정합니다.
`deployment_option`	문자열	새 장치의 크기입니다. 참고: 업그레이드할 장치의 데이터베이스 크기를 고려해야 합니다. 외부 데이터베이스의 경우 새 장치의 Oracle 데이터베이스 크기 및 스토리지 크기 확인의 내용을 참조하십시오. 기본 스토리지 크기를 사용하고 최대 10개의 호스트와 100개의 가상 시스템에 vCenter Server Appliance를 배포하려면 `tiny`로 설정합니다. 2개의 CPU, 10GB의 메모리 및 300GB의 스토리지가 장착된 장치를 배포합니다. 대형 스토리지 크기를 사용하고 최대 10개의 호스트와 100개의 가상 시스템에 vCenter Server Appliance를 배포하려면 `tiny-lstorage`로 설정합니다. 2개의 CPU, 10GB의 메모리 및 825GB의 스토리지가 장착된 장치를 배포합니다. 초대형 스토리지 크기를 사용하고 최대 10개의 호스트와 100개의 가상 시스템에 vCenter Server Appliance를 배포하려면 `tiny-xlstorage`로 설정합니다. 2개의 CPU, 10GB의 메모리 및 1700GB의 스토리지가 장착된 장치를 배포합니다. 기본 스토리지 크기를 사용하고 최대 100개의 호스트와 1,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 `small`로 설정합니다. 4개의 CPU, 16GB의 메모리 및 340GB의 스토리지가 장착된 장치를 배포합니다. 대형 스토리지 크기를 사용하고 최대 100개의 호스트와 1,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 `small-lstorage`로 설정합니다. 4개의 CPU, 16GB의 메모리 및 870GB의 스토리지가 장착된 장치를 배포합니다. 초대형 스토리지 크기를 사용하고 최대 100개의 호스트와 1,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 `small-xlstorage`로 설정합니다. 4개의 CPU, 16GB의 메모리 및 1750GB의 스토리지가 장착된 장치를 배포합니다. 기본 스토리지 크기를 사용하고 최대 400개의 호스트와 4,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 `medium`로 설정합니다. 8개의 CPU, 24GB의 메모리 및 525GB의 스토리지가 장착된 장치를 배포합니다. 대형 스토리지 크기를 사용하고 최대 400개의 호스트와 4,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 `medium-lstorage`로 설정합니다. 8개의 CPU, 24GB의 메모리 및 1025GB의 스토리지가 장착된 장치를 배포합니다. 초대형 스토리지 크기를 사용하고 최대 400개의 호스트와 4,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 `medium-xlstorage`로 설정합니다. 8개의 CPU, 24GB의 메모리 및 1905GB의 스토리지가 장착된 장치를 배포합니다. 기본 스토리지 크기를 사용하고 최대 1,000개의 호스트와 10,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 `large`로 설정합니다. 16개의 CPU, 32GB의 메모리 및 740GB의 스토리지가 장착된 장치를 배포합니다. 대형 스토리지를 사용하고 최대 1,000개의 호스트와 10,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 `large-lstorage`로 설정합니다. 16개의 CPU, 32GB의 메모리 및 1090GB의 스토리지가 장착된 장치를 배포합니다. 초대형 스토리지 크기를 사용하고 최대 1,000개의 호스트와 10,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 `large-xlstorage`로 설정합니다. 16개의 CPU, 32GB의 메모리 및 1970GB의 스토리지가 장착된 장치를 배포합니다. 기본 스토리지 크기를 사용하고 최대 2,000개의 호스트와 35,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 `xlarge`로 설정합니다. 24개의 CPU, 48GB의 메모리 및 1180GB의 스토리지가 장착된 장치를 배포합니다. 대형 스토리지 크기를 사용하고 최대 2,000개의 호스트와 35,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 `xlarge-lstorage`로 설정합니다. 24개의 CPU, 48GB의 메모리 및 1230GB의 스토리지가 장착된 장치를 배포합니다. 초대형 스토리지 크기를 사용하고 최대 2,000개의 호스트와 35,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 `xlarge-xlstorage`로 설정합니다. 24개의 CPU, 48GB의 메모리 및 2110GB의 스토리지가 장착된 장치를 배포합니다. 기본 크기의 스토리지를 사용하고 최대 10개의 호스트와 100개의 가상 시스템에 외부 Platform Services Controller가 있는 vCenter Server Appliance를 배포하려면 `management-tiny`로 설정합니다. 2개의 CPU, 10GB의 메모리 및 300GB의 스토리지가 포함된 장치를 배포합니다.
`image`	문자열	선택 사항입니다. vCenter Server Appliance 설치 패키지의 로컬 파일 경로 또는 URL입니다. 기본적으로 설치 관리자는 vcsa 폴더에 있는 ISO 파일에 포함된 설치 패키지를 사용합니다.
`name`	문자열	새 장치의 VM 이름입니다. 퍼센트 기호(%), 백슬래시(\) 또는 슬래시(/)를 제외하고 ASCII 문자만 포함해야 하며 길이가 80자를 넘지 않아야 합니다.
`ovftool_path`	문자열	선택 사항입니다. OVF Tool 실행 파일의 로컬 파일 경로입니다. 기본적으로 설치 관리자는 vcsa/ovftool 폴더에 있는 ISO 파일에 포함된 OVF Tool 인스턴스를 사용합니다.
`license`	문자열	선택 사항입니다. 장치에 적용할 라이센스 키입니다. 라이센스 키가 제공되지 않으면 평가판 라이센스가 사용됩니다.

표 6. `new_vcsa` 섹션, `temporary_network` 하위 섹션의 구성 매개 변수
이름	유형	설명
`ip_family`	문자열	새 장치에서 사용하는 임시 네트워크의 IP 버전입니다. `ipv4` 또는 `ipv6`으로 설정합니다.
`mode`	문자열	새 장치에서 사용하는 임시 네트워크의 IP 할당입니다. `static` 또는 `dhcp`으로 설정합니다.
`ip`	문자열	새 장치의 임시 IP 주소입니다. 정적 할당을 사용하는 경우, 즉 `mode` 매개 변수를 `static`으로 설정하는 경우에만 필요합니다. 임시 네트워크 IP 버전, 즉 `ip.family` 매개 변수의 값에 해당하는 IPv4 또는 IPv6 주소를 설정해야 합니다. IPv4 주소는 RFC 790 지침을 준수해야 합니다. IPv6 주소는 RFC 2373 지침을 준수해야 합니다.
`dns_servers`	문자열 또는 어레이	새 장치에서 사용하는 임시 네트워크의 DNS 서버 하나 이상의 IP 주소입니다. DNS 서버를 두 개 이상 설정하려면 쉼표로 구분된 문자열 목록 또는 쉼표로 구분된 목록의 단일 문자열을 사용하여 경로를 제공합니다. 예를 들면 다음과 같습니다. ["x.y.z.a", "x.y.z.b"] 또는 "x.y.z.a, x.y.z.b" 임시 IP 주소 할당에 정적 네트워크 모드를 사용하는 경우, 즉 `mode` 매개 변수를 `static`으로 설정한 경우에만 필요합니다.
`prefix`	문자열	새 장치에서 사용하는 임시 네트워크의 네트워크 접두사 길이입니다. `mode` 매개 변수가 `static`으로 설정된 경우에만 사용합니다 `mode` 매개 변수가 `dhcp`로 설정된 경우에는 제거합니다. 네트워크 접두사 길이는 서브넷 마스크에 설정된 비트 수입니다. 예를 들어 서브넷 마스크가 255.255.255.0인 경우 접두사 길이의 바이너리 버전에 24비트가 있으므로 네트워크 접두사 길이는 24입니다. IPv4 버전의 경우 값은 `0`에서 `32` 사이여야 합니다. IPv6 버전의 경우 값은 `0`에서 `128` 사이여야 합니다.
`gateway`	문자열	새 장치에서 사용하는 임시 네트워크의 기본 게이트웨이의 IP 주소입니다. IPv6 버전의 경우 값은 `default`일 수 있습니다.

표 7. `new_vcsa` 섹션, `user_options` 하위 섹션의 구성 매개 변수
이름	유형	설명
`vcdb_migrateSet`	문자열	이전 장치에서 새 장치로 마이그레이션할 데이터의 유형을 선택합니다. 데이터가 소스 vCenter Server에서 대상 서버로 복사됩니다. 데이터의 원래 소스는 변경되지 않습니다. 구성 데이터만 전송하려면 `core`로 설정합니다. 이 옵션을 선택하면 데이터 마이그레이션이 가장 빠르게 완료되어 시스템 다운타임이 최소화됩니다. 구성 및 기간별 데이터(이벤트 및 작업)를 즉시 전송하려면 `core_events_tasks`로 설정합니다. 모든 데이터가 소스 vCenter Server Appliance에서 마이그레이션될 때까지 vCenter Server가 시작되지 않습니다. 구성, 기간별 및 성능 메트릭 데이터를 즉시 전송하려면 `all`로 설정합니다. 모든 데이터가 Windows용 소스 vCenter Server에서 마이그레이션될 때까지 vCenter Server가 시작되지 않습니다. 이 옵션을 선택하면 가장 많은 양의 데이터가 전송되어 다른 데이터 마이그레이션 옵션보다 더 많은 다운타임이 필요합니다. 업그레이드가 완료된 후 백그라운드에서 기간별 데이터(이벤트 및 작업)를 전송하려면 `transfer_events_tasks_after_upgrade`로 설정합니다. 이 시간 동안에는 vCenter Server 성능이 최적이 아닐 수 있습니다. 업그레이드가 완료된 후 백그라운드에서 기간별 데이터 및 성능 메트릭 데이터를 전송하려면 `transfer_stats_events_tasks_after_upgrade`로 설정합니다. 이 시간 동안에는 vCenter Server 성능이 최적이 아닐 수 있습니다. 참고: 업그레이드 시간과 새 vCenter Server Appliance에 필요한 스토리지 양을 최소화하려면 `core` 값을 사용합니다. 기존 vCenter Server에서 업그레이드된 새 vCenter Server로 전송할 수 있는 데이터 유형에 대한 자세한 내용은 기존 vCenter Server Appliance의 데이터 전송의 내용을 참조하십시오.

표 8. `new_vcsa` 섹션, `sso` 하위 섹션의 구성 매개 변수
이름	유형	설명
`first_instance`	문자열	vCenter Server SSO 도메인에서 첫 번째 컨버전스 업그레이드 작업이거나 이 노드에 대한 복제 파트너를 설정하지 않으려면 `true`를 `first_instance`로 설정합니다. 이 노드에 대한 복제 파트너를 설정하려면 `first_instance`를 `false`로 설정하고 `replication_partner_hostname` 값을 현재 내장된 vCenter Server 토폴로지에 있는 이전에 수렴된 노드의 FQDN으로 제공합니다. `first_instance` 및 `replication_partner_hostname` 매개 변수 지정에 대한 자세한 내용은 CLI를 사용하여 외부 Platform Services Controller가 있는 vCenter Server 업그레이드 정보의 내용을 참조하십시오.
`replication_partner_hostname`	문자열	복제 파트너의 호스트 이름입니다. `first_instance`인 경우 제거합니다.

`source_vc` 섹션의 구성 매개 변수

표 9. `source_vc` 섹션, `managing_esxi_or_vc` 하위 섹션의 구성 매개 변수
이름	유형	설명
`hostname`	문자열	업그레이드할 장치가 있는 소스 ESXi 또는 vCenter Server 호스트의 IP 주소 또는 FQDN입니다.
`username`	문자열	소스 ESXi 호스트에서 관리 권한을 가진 사용자 이름입니다(예: root).
`password`	문자열	소스 ESXi 호스트에서 관리 권한을 가진 사용자의 암호입니다.
`port`	정수	소스 ESXi 호스트의 HTTPS 역방향 프록시 포트입니다. 기본 포트는 443입니다. 소스 ESXi 호스트에서 사용자 지정 HTTPS 역방향 프록시 포트를 사용하는 경우에만 사용합니다.

표 10. `source_vc` 섹션, `vc_vcsa` 하위 섹션의 구성 매개 변수
이름	유형	설명
`hostname`	문자열	업그레이드할 소스 장치의 IP 주소 또는 FQDN입니다.
`username`	문자열	소스 장치에서 vCenter Single Sign-On 관리자의 이름입니다(예: [email protected]). 중요: 사용자는 administrator@ `your_domain_name`이어야 합니다.
`password`	문자열	소스 장치에서 vCenter Single Sign-On 관리자의 암호입니다.
`root_password`	문자열	소스 장치 운영 체제의 루트 사용자 암호입니다.
`export_dir`	문자열	소스 구성 및 데이터를 내보낼 디렉토리입니다.

`source.vum` 섹션의 구성 매개 변수

표 11. `source_vum` 섹션, `run_migration_assistant` 하위 섹션의 구성 매개 변수
이름	유형	설명
`esxi_hostname`	문자열	소스 VMware Update Manager 인스턴스가 있는 ESXi 호스트의 IP 주소 또는 FQDN입니다. FQDN을 제공할 경우, FQDN은 업그레이드를 실행하는 클라이언트 시스템에서 확인 가능해야 합니다.
`esxi_username`	문자열	ESXi 호스트에서 관리 권한을 가진 사용자 이름입니다(예: root).
`esxi_password`	문자열	ESXi 호스트에서 관리 권한을 가진 사용자의 암호입니다.
`esxi_port`	문자열	ESXi 호스트의 HTTPS 역방향 프록시 포트입니다. 기본 포트는 443입니다. ESXi 호스트에서 사용자 지정 HTTPS 역방향 프록시 포트를 사용하는 경우에만 사용합니다.
`vum_hostname`	문자열	소스 VMware Update Manager 인스턴스가 실행되는 Windows 가상 시스템의 IP 주소 또는 FQDN입니다. FQDN을 제공할 경우, FQDN은 업그레이드를 실행하는 클라이언트 시스템에서 확인 가능해야 합니다.
`vum_os_username`	문자열	소스 VMware Update Manager 인스턴스가 실행되는 Windows 가상 시스템의 관리자 사용자 이름입니다.
`vum_os_password`	문자열	소스 VMware Update Manager 인스턴스가 실행되는 Windows 가상 시스템의 관리자 암호입니다. 값을 제공하지 않으면 템플릿을 확인하는 동안 명령 콘솔에 암호를 입력하라는 메시지가 표시됩니다.
`export_dir`	문자열	소스 구성 및 데이터를 내보낼 디렉토리입니다.

`ceip` 섹션의 구성 매개 변수

표 12. `ceip` 섹션, `settings` 하위 섹션의 구성 매개 변수
이름	유형	설명
`ceip_enabled`	부울	업그레이드된 새 장치에 대해 CEIP에 참여하려면 `true`로 설정합니다.