CLI 업그레이드를 위한 JSON 구성 파일을 준비할 때는 매개 변수와 값을 설정하여 vCenter Server Appliance 또는 Platform Services Controller 장치의 업그레이드를 위한 입력 데이터를 제공해야 합니다.
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 구성 매개 변수만 포함됩니다. new.vcsa 섹션, os 하위 섹션의 구성 매개 변수 항목을 참조하십시오. |
|
ovftool.arguments |
선택 사항입니다. 설치 관리자가 생성하는 OVF Tool 명령에 임의의 인수와 해당 값을 추가하기 위해 이 하위 섹션을 사용합니다.
중요:
vCenter Server Appliance 설치 관리자는
ovftool.arguments 하위 섹션의 구성 매개 변수를 검증하지 않습니다. OVF Tool에서 인식하지 않는 인수를 설정하면 배포가 실패할 수 있습니다.
|
|
sso |
새 장치에 vCenter Single Sign-On 사이트를 설정하는 내장된 Platform Services Controller가 있는 vCenter Server Appliance 5.5를 업그레이드하는 경우에만 필요합니다. |
|
temporary.network |
새 장치의 임시 네트워크 설정을 설명하는 구성 매개 변수가 포함됩니다. new.vcsa 섹션, temporary.network 하위 섹션의 구성 매개 변수 항목을 참조하십시오. |
|
user-options |
이전 장치에서 새 장치로 전송할 데이터 유형을 설정하는 vcdb.migrateSet 구성 매개 변수만 포함됩니다. new.vcsa 섹션, user-options 하위 섹션의 구성 매개 변수 항목을 참조하십시오. |
|
source.vc - 업그레이드할 기존 장치를 설명합니다. |
esxi |
업그레이드할 장치가 있는 소스 ESXi 호스트를 설명하는 구성 매개 변수가 포함됩니다. source.vc 섹션, esxi 하위 섹션의 구성 매개 변수를 참조하십시오. |
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 - CEIP(고객 환경 향상 프로그램) 참여를 설명합니다. |
settings |
VMware CEIP(고객 환경 향상 프로그램)에 참여하거나 참여하지 않는 데 필요한 내장된 Platform Services Controller가 있는 vCenter Server Appliance, 내장된 vCenter Single Sign-On이 있는 vCenter Server Appliance 5.5 또는 Platform Services Controller 장치를 업그레이드하는 경우에만 필요합니다.
참고:
ceip.enabled 구성 매개 변수를
true 로 설정한 경우에는 CLI 배포 명령을 실행할 때
--acknowledge-ceip 인수를 사용해야 합니다.
CEIP에 대한 자세한 내용은 "vCenter Server 및 호스트 관리" 의 고객 환경 향상 프로그램 구성 섹션을 참조하십시오. |
백슬래시(\) 또는 따옴표(") 문자가 포함된 값을 설정하려면 문자 앞에 백슬래시(\) 문자가 있어야 합니다. 예를 들어 "password":"my\"password"
는 암호를 my"password로 설정하고 "image":"G:\\vcsa\\VMware-vCenter-Server-Appliance-6.5.0.XXXX-YYYYYYY_OVF10.ova"
는 경로를 G:\vcsa\VMware-vCenter-Server-Appliance-6.5.0.XXXX-YYYYYYY_OVF10.ova로 설정합니다.
부울 값은 소문자만 포함해야 합니다. true
또는 false
일 수 있습니다. 예: "ssh.enable":false
new.vcsa
섹션의 구성 매개 변수
이름 | 유형 | 설명 |
---|---|---|
hostname |
string | 새 장치를 배포할 대상 ESXi 호스트의 IP 주소 또는 FQDN입니다. |
username |
string | 대상 ESXi 호스트에서 관리 권한을 가진 사용자 이름입니다(예: root). |
password |
string | 대상 ESXi 호스트에서 관리 권한을 가진 사용자의 암호입니다. |
deployment.network |
string | 새 장치를 연결할 네트워크의 이름입니다. 네트워크는 대상 ESXi 호스트 네트워크 구성의 일부여야 합니다.
참고: 업그레이드할 장치가 있는 소스
ESXi 호스트에서 네트워크에 액세스할 수 있어야 합니다. 네트워크는 업그레이드를 수행하는 클라이언트 시스템에서도 액세스할 수 있어야 합니다.
대상 ESXi 호스트에 네트워크가 하나뿐인 경우에는 무시됩니다. |
datastore |
string | 새 장치의 가상 시스템 구성 파일과 가상 디스크를 저장할 데이터스토어의 이름입니다. 데이터스토어는 대상 ESXi 호스트에서 사용할 수 있어야 합니다.
참고: 데이터스토어에 25GB 이상의 사용 가능한 디스크 공간이 있어야 합니다.
|
port |
정수 | 대상 ESXi 호스트의 HTTPS 역방향 프록시 포트입니다. 기본 포트는 443입니다. 대상 ESXi 호스트에서 사용자 지정 HTTPS 역방향 프록시 포트를 사용하는 경우에만 사용합니다. |
이름 | 유형 | 설명 |
---|---|---|
hostname |
string | 새 장치를 배포할 대상 vCenter Server 인스턴스의 IP 주소 또는 FQDN입니다. |
username |
string | 대상 vCenter Server 인스턴스에서 vCenter Single Sign-On 관리자의 이름입니다(예: [email protected]). |
password |
string | 대상 vCenter Server 인스턴스에서 vCenter Single Sign-On 관리자의 암호입니다. |
deployment.network |
string | 새 장치를 연결할 네트워크의 이름입니다. 네트워크는 대상 ESXi 호스트 또는 DRS 클러스터 네트워크 구성의 일부여야 합니다.
참고: 업그레이드할 장치가 있는 소스
ESXi 호스트에서 네트워크에 액세스할 수 있어야 합니다. 네트워크는 업그레이드를 수행하는 클라이언트 시스템에서도 액세스할 수 있어야 합니다.
대상 ESXi 호스트 또는 DRS 클러스터에 네트워크가 하나뿐인 경우에는 무시됩니다. |
datacenter |
문자열 또는 어레이 | 새 장치를 배포할 대상 ESXi 호스트 또는 DRS 클러스터를 포함하는 vCenter Server 데이터 센터입니다.
데이터 센터가 폴더 또는 폴더 구조에 있는 경우, 값은 쉼표로 구분된 문자열 목록이거나 쉼표로 구분된 목록의 단일 문자열이어야 합니다. 예를 들면 다음과 같습니다.
["parent_folder", "child_folder", "datacenter_name"]또는 "parent_folder, child_folder, datacenter_name"
참고: 값은 대/소문자를 구분합니다.
|
datastore |
string | 새 장치의 모든 가상 시스템 구성 파일과 가상 디스크를 저장할 데이터스토어의 이름입니다.
참고: 대상
ESXi 호스트 또는 DRS 클러스터에서 데이터스토어를 사용할 수 있어야 합니다.
데이터스토어에 25GB 이상의 사용 가능한 디스크 공간이 있어야 합니다. |
port |
정수 | 대상 vCenter Server 인스턴스의 HTTPS 역방향 프록시 포트입니다. 기본 포트는 443입니다. 대상 vCenter Server 인스턴스에서 사용자 지정 HTTPS 역방향 프록시 포트를 사용하는 경우에만 사용합니다. |
target |
문자열 또는 어레이 | 새 장치를 배포할 대상 ESXi 호스트 또는 DRS 클러스터입니다.
중요:
vCenter Server 인벤토리에 표시되는 이름을 제공해야 합니다. 예를 들어
vCenter Server 인벤토리에서 대상
ESXi 호스트의 이름이 IP 주소인 경우에는 FQDN을 제공할 수 없습니다.
대상
ESXi 호스트 또는 DRS 클러스터가 폴더 또는 폴더 구조에 있는 경우, 값은 쉼표로 구분된 문자열 목록이거나 쉼표로 구분된 목록의 단일 문자열이어야 합니다. 예를 들면 다음과 같습니다.
["parent_folder", "child_folder", "esxi-host.domain.com"]또는 "parent_folder, child_folder, esxi-host.domain.com"
대상
ESXi 호스트가 클러스터의 일부인 경우에는 쉼표로 구분된 문자열 목록 또는 쉼표로 구분된 목록의 단일 문자열을 사용하여 경로를 제공합니다. 예를 들면 다음과 같습니다.
["cluster_name", "esxi-host.domain.com"]또는 "cluster_name, esxi-host.domain.com"
참고: 값은 대/소문자를 구분합니다.
|
vm.folder |
string | 선택 사항입니다. 새 장치를 추가할 VM 폴더의 이름입니다. |
이름 | 유형 | 설명 |
---|---|---|
thin.disk.mode |
Boolean | 씬 가상 디스크를 사용하여 새 장치를 배포하려면 true 로 설정합니다. |
deployment.option |
string | 새 장치의 크기입니다.
참고: 업그레이드할 장치의 데이터베이스 크기를 고려해야 합니다. 외부 데이터베이스의 경우
새 장치의 Oracle 데이터베이스 크기 및 스토리지 크기 확인을 참조하십시오.
|
image |
string | 선택 사항입니다. vCenter Server Appliance 설치 패키지의 로컬 파일 경로 또는 URL입니다. 기본적으로 설치 관리자는 vcsa 폴더에 있는 ISO 파일에 포함된 설치 패키지를 사용합니다. |
name |
string | 새 장치의 VM 이름입니다. 퍼센트 기호(%), 백슬래시(\) 또는 슬래시(/)를 제외하고 ASCII 문자만 포함해야 하며 길이가 80자를 넘지 않아야 합니다. |
ovftool.path |
string | 선택 사항입니다. OVF Tool 실행 파일의 로컬 파일 경로입니다. 기본적으로 설치 관리자는 vcsa/ovftool 폴더에 있는 ISO 파일에 포함된 OVF Tool 인스턴스를 사용합니다. |
이름 | 유형 | 설명 |
---|---|---|
ssh.enable |
Boolean | 새 장치에서 SSH 관리자 로그인을 사용하려면 true 로 설정합니다. |
이름 | 유형 | 설명 |
---|---|---|
site-name |
string | 새 장치의 vCenter Single Sign-On 사이트 이름입니다. 내장된 vCenter Single Sign-On이 있는 vCenter Server Appliance 5.5를 업그레이드하는 경우에만 필요합니다. |
이름 | 유형 | 설명 |
---|---|---|
ip.family |
string | 새 장치에서 사용하는 임시 네트워크의 IP 버전입니다. |
mode |
string | 새 장치에서 사용하는 임시 네트워크의 IP 할당입니다. |
ip |
string | 새 장치의 임시 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 |
string | 새 장치에서 사용하는 임시 네트워크의 네트워크 접두사 길이입니다. 네트워크 접두사 길이는 서브넷 마스크에 설정된 비트 수입니다. 예를 들어 서브넷 마스크가 255.255.255.0인 경우 접두사 길이의 바이너리 버전에 24비트가 있으므로 네트워크 접두사 길이는 24입니다. IPv4 버전의 경우 값은 IPv6 버전의 경우 값은 |
gateway |
string | 새 장치에서 사용하는 임시 네트워크의 기본 게이트웨이의 IP 주소입니다. IPv6 버전의 경우 값은 |
system.name |
string | 새 장치에서 사용하는 임시 네트워크의 기본 네트워크 ID입니다. IP 주소 또는 FQDN일 수 있으며 가능하면 FQDN을 사용하는 것이 좋습니다. FQDN 및 점으로 구분된 10진수는 RFC 1123 지침을 준수해야 합니다. |
이름 | 유형 | 설명 |
---|---|---|
vcdb.migrateSet |
string | 이전 장치에서 새 장치로 전송할 데이터의 유형입니다.
참고: 새 장치에 최소 업그레이드 시간과 스토리지 요구 사항을 사용하려면
core 값을 사용합니다.
|
source.vc
섹션의 구성 매개 변수
이름 | 유형 | 설명 |
---|---|---|
hostname |
string | 업그레이드할 장치가 있는 소스 ESXi 호스트의 IP 주소 또는 FQDN입니다. |
username |
string | 소스 ESXi 호스트에서 관리 권한을 가진 사용자 이름입니다(예: root). |
password |
string | 소스 ESXi 호스트에서 관리 권한을 가진 사용자의 암호입니다. |
port |
정수 | 소스 ESXi 호스트의 HTTPS 역방향 프록시 포트입니다. 기본 포트는 443입니다. 소스 ESXi 호스트에서 사용자 지정 HTTPS 역방향 프록시 포트를 사용하는 경우에만 사용합니다. |
이름 | 유형 | 설명 |
---|---|---|
hostname |
string | 업그레이드할 소스 장치의 IP 주소 또는 FQDN입니다. |
username |
string | 소스 장치에서 vCenter Single Sign-On 관리자의 이름입니다(예: [email protected]).
중요: 사용자는 administrator@
your_domain_name이어야 합니다.
|
password |
string | 소스 장치에서 vCenter Single Sign-On 관리자의 암호입니다. |
root.password |
string | 소스 장치 운영 체제의 루트 사용자 암호입니다. |
source.vum
섹션의 구성 매개 변수
이름 | 유형 | 설명 |
---|---|---|
esxi.hostname |
string | 소스 VMware Update Manager 인스턴스가 있는 ESXi 호스트의 IP 주소 또는 FQDN입니다. FQDN을 제공할 경우, FQDN은 업그레이드를 실행하는 클라이언트 시스템에서 확인 가능해야 합니다. |
esxi.username |
string | ESXi 호스트에서 관리 권한을 가진 사용자 이름입니다(예: root). |
esxi.password |
string | ESXi 호스트에서 관리 권한을 가진 사용자의 암호입니다. |
esxi.port |
string | ESXi 호스트의 HTTPS 역방향 프록시 포트입니다. 기본 포트는 443입니다. ESXi 호스트에서 사용자 지정 HTTPS 역방향 프록시 포트를 사용하는 경우에만 사용합니다. |
vum.hostname |
string | 소스 VMware Update Manager 인스턴스가 실행되는 Windows 가상 시스템의 IP 주소 또는 FQDN입니다. FQDN을 제공할 경우, FQDN은 업그레이드를 실행하는 클라이언트 시스템에서 확인 가능해야 합니다. |
vum.os.username |
string | 소스 VMware Update Manager 인스턴스가 실행되는 Windows 가상 시스템의 관리자 사용자 이름입니다. |
vum.os.password |
string | 소스 VMware Update Manager 인스턴스가 실행되는 Windows 가상 시스템의 관리자 암호입니다. 값을 제공하지 않으면 템플릿을 확인하는 동안 명령 콘솔에 암호를 입력하라는 메시지가 표시됩니다. |
export.dir |
string | 소스 구성 및 데이터를 내보낼 디렉토리입니다. |
ceip
섹션의 구성 매개 변수
이름 | 유형 | 설명 |
---|---|---|
ceip.enabled |
Boolean | 업그레이드된 새 장치에 대해 CEIP에 참여하려면 true 로 설정합니다. |