CLI 업그레이드를 위한 JSON 구성 파일을 준비할 때는 매개 변수와 값을 설정하여 vCenter Server Appliance의 업그레이드를 위한 입력 데이터를 제공해야 합니다.
JSON 업그레이드 파일에 있는 구성 매개 변수의 섹션 및 하위 섹션
CLI 업그레이드를 위한 JSON 구성 파일의 구성 매개 변수는 섹션과 하위 섹션으로 구성됩니다.
| 섹션 | 하위 섹션 | 설명 |
|---|---|---|
new_vcsa - 배포할 새 장치를 설명합니다. |
esxi |
새 장치를 ESXi 호스트에 직접 배포하려는 경우에만 사용합니다.
대상
ESXi 호스트를 설명하는 구성 매개 변수가 포함됩니다.
new_vcsa 섹션, esxi 하위 섹션의 구성 매개 변수의 내용을 참조하십시오.
참고: 이 하위 섹션 또는
vc 하위 섹션을 채워야 합니다.
|
vc |
새 장치를 vCenter Server 인스턴스의 인벤토리에 배포하려는 경우에만 사용합니다. 대상 ESXi 호스트 또는 vCenter Server 인벤토리의 DRS 클러스터를 설명하는 구성 매개 변수가 포함됩니다.
참고: 이 하위 섹션 또는
esxi 하위 섹션을 채워야 합니다.
대상 vCenter Server 인스턴스는 업그레이드하려는 vCenter Server Appliance일 수 없습니다. 이러한 경우에는 |
|
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 하위 섹션의 구성 매개 변수의 내용을 참조하십시오. |
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 인스턴스를 설명하는 구성 매개 변수가 포함됩니다.
참고:
Migration Assistant에서는 기본적으로 포트 9123을 사용합니다.
Update Manager 시스템의 다른 서비스에서 포트 9123을 사용하는 경우
Migration Assistant는 자동으로 사용 가능한 다른 포트를 찾습니다.
Migration Assistant에 대해 사용자 지정 포트를 설정할 수 없습니다.
|
ceip - Vmware CEIP(고객 환경 향상 프로그램) 참여를 설명합니다. |
settings |
VMware CEIP(고객 환경 향상 프로그램)에 참여하거나 참여하지 않는 데 필요한 내장형 Platform Services Controller가 있는 vCenter Server Appliance 또는 Platform Services Controller 장치를 업그레이드하는 경우에만 필요합니다.
참고:
ceip_enabled 구성 매개 변수를
true로 설정한 경우에는 CLI 배포 명령을 실행할 때
--acknowledge-ceip 인수를 사용해야 합니다.
CEIP에 대한 자세한 내용은 "vCenter Server 및 호스트 관리" 의 고객 환경 향상 프로그램 구성 섹션을 참조하십시오. |
백슬래시(\) 또는 따옴표(") 문자가 포함된 값을 설정하려면 문자 앞에 백슬래시(\) 문자가 있어야 합니다. 예를 들어 "password":"my\"password"는 암호를 my"password로 설정하고 "image":"G:\\vcsa\\VMware-vCenter-Server-Appliance-7.0.0.XXXX-YYYYYYY_OVF10.ova"는 경로를 G:\vcsa\VMware-vCenter-Server-Appliance-7.0.0.XXXX-YYYYYYY_OVF10.ova로 설정합니다.
부울 값은 소문자만 포함해야 합니다. true 또는 false일 수 있습니다. 예: "ssh_enable":false
new_vcsa 섹션의 구성 매개 변수
| 이름 | 유형 | 설명 |
|---|---|---|
hostname |
문자열 | 새 장치를 배포할 대상 ESXi 호스트의 IP 주소 또는 FQDN입니다. |
username |
문자열 | 대상 ESXi 호스트에서 관리 권한을 가진 사용자 이름입니다(예: root). |
password |
문자열 | 대상 ESXi 호스트에서 관리 권한을 가진 사용자의 암호입니다. |
deployment_network |
문자열 | 새 장치를 연결할 네트워크의 이름입니다. 네트워크는 대상 ESXi 호스트 또는 vCenter Server Appliance 인스턴스(
참고: 업그레이드할 장치가 있는 소스
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" 자체 서명된 인증서가 있는 서버에 연결하는 경우 SHA-1 인증서 지문을 지정하지 않거나 검증 모드를 vcsa-deploy upgrade 명령 매개 변수 |
| 이름 | 유형 | 설명 |
|---|---|---|
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 호스트 또는 리소스 풀입니다. 이는
중요:
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(가상 시스템) 폴더의 이름입니다. |
| 이름 | 유형 | 설명 |
|---|---|---|
thin_disk_mode |
부울 | 씬 가상 디스크를 사용하여 새 장치를 배포하려면 true로 설정합니다. |
deployment_option |
문자열 | 새 장치의 크기입니다.
참고: 업그레이드할 장치의 데이터베이스 크기를 고려해야 합니다. 외부 데이터베이스의 경우
새 장치의 Oracle 데이터베이스 크기 및 스토리지 크기 확인의 내용을 참조하십시오.
|
image |
문자열 | 선택 사항입니다. vCenter Server Appliance 설치 패키지의 로컬 파일 경로 또는 URL입니다. 기본적으로 설치 관리자는 vcsa 폴더에 있는 ISO 파일에 포함된 설치 패키지를 사용합니다. |
name |
문자열 | 새 장치의 VM 이름입니다. 퍼센트 기호(%), 백슬래시(\) 또는 슬래시(/)를 제외하고 ASCII 문자만 포함해야 하며 길이가 80자를 넘지 않아야 합니다. |
ovftool_path |
문자열 | 선택 사항입니다. OVF Tool 실행 파일의 로컬 파일 경로입니다. 기본적으로 설치 관리자는 vcsa/ovftool 폴더에 있는 ISO 파일에 포함된 OVF Tool 인스턴스를 사용합니다. |
| 이름 | 유형 | 설명 |
|---|---|---|
ip_family |
문자열 | 새 장치에서 사용하는 임시 네트워크의 IP 버전입니다.
|
mode |
문자열 | 새 장치에서 사용하는 임시 네트워크의 IP 할당입니다.
|
ip |
문자열 | 새 장치의 임시 IP 주소입니다. 정적 할당을 사용하는 경우, 즉 임시 네트워크 IP 버전, 즉 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 주소 할당에 정적 네트워크 모드를 사용하는 경우, 즉 |
prefix |
문자열 | 새 장치에서 사용하는 임시 네트워크의 네트워크 접두사 길이입니다.
네트워크 접두사 길이는 서브넷 마스크에 설정된 비트 수입니다. 예를 들어 서브넷 마스크가 255.255.255.0인 경우 접두사 길이의 바이너리 버전에 24비트가 있으므로 네트워크 접두사 길이는 24입니다. IPv4 버전의 경우 값은 IPv6 버전의 경우 값은 |
gateway |
문자열 | 새 장치에서 사용하는 임시 네트워크의 기본 게이트웨이의 IP 주소입니다. IPv6 버전의 경우 값은 |
| 이름 | 유형 | 설명 |
|---|---|---|
vcdb_migrateSet |
문자열 | 이전 장치에서 새 장치로 마이그레이션할 데이터의 유형을 선택합니다. 데이터가 소스 vCenter Server에서 대상 서버로 복사됩니다. 데이터의 원래 소스는 변경되지 않습니다.
참고: 업그레이드 시간과 새
vCenter Server Appliance에 필요한 스토리지 양을 최소화하려면
core 값을 사용합니다.
기존 vCenter Server에서 업그레이드된 새 vCenter Server로 전송할 수 있는 데이터 유형에 대한 자세한 내용은 기존 vCenter Server Appliance의 데이터 전송의 내용을 참조하십시오. |
| 이름 | 유형 | 설명 |
|---|---|---|
first_instance |
문자열 | vCenter Server SSO 도메인에서 첫 번째 컨버전스 업그레이드 작업이거나 이 노드에 대한 복제 파트너를 설정하지 않으려면 이 노드에 대한 복제 파트너를 설정하려면
|
replication_partner_hostname |
문자열 | 복제 파트너의 호스트 이름입니다. first_instance인 경우 제거합니다. |
source_vc 섹션의 구성 매개 변수
| 이름 | 유형 | 설명 |
|---|---|---|
hostname |
문자열 | 업그레이드할 장치가 있는 소스 ESXi 또는 vCenter Server 호스트의 IP 주소 또는 FQDN입니다. |
username |
문자열 | 소스 ESXi 호스트에서 관리 권한을 가진 사용자 이름입니다(예: root). |
password |
문자열 | 소스 ESXi 호스트에서 관리 권한을 가진 사용자의 암호입니다. |
port |
정수 | 소스 ESXi 호스트의 HTTPS 역방향 프록시 포트입니다. 기본 포트는 443입니다. 소스 ESXi 호스트에서 사용자 지정 HTTPS 역방향 프록시 포트를 사용하는 경우에만 사용합니다. |
| 이름 | 유형 | 설명 |
|---|---|---|
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 섹션의 구성 매개 변수
| 이름 | 유형 | 설명 |
|---|---|---|
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 섹션의 구성 매개 변수
| 이름 | 유형 | 설명 |
|---|---|---|
ceip_enabled |
부울 | 업그레이드된 새 장치에 대해 CEIP에 참여하려면 true로 설정합니다. |
