CLI 배포를 위한 JSON 구성 파일을 준비할 때는 매개 변수와 값을 설정하여 vCenter Server Appliance 또는 Platform Services Controller 장치의 배포를 위한 입력 데이터를 제공해야 합니다.
JSON 배포 파일에 있는 구성 매개 변수의 섹션 및 하위 섹션
CLI 업그레이드를 위한 JSON 구성 파일의 구성 매개 변수는 섹션과 하위 섹션으로 구성됩니다.
| 섹션 | 하위 섹션 | 설명 |
|---|---|---|
new.vcsa - 배포할 새 장치를 설명합니다. |
esxi |
새 장치를 ESXi 호스트에 직접 배포하려는 경우에만 사용합니다.
대상
ESXi 호스트를 설명하는 구성 매개 변수가 포함됩니다.
new.vcsa 섹션, esxi 하위 섹션의 구성 매개 변수의 내용을 참조하십시오.
참고:
esxi 또는
vc 하위 섹션을 채워야 합니다.
|
vc |
장치를 vCenter Server 인스턴스의 인벤토리에 배포하려는 경우에만 사용합니다. 대상 ESXi 호스트 또는 vCenter Server 인벤토리의 DRS 클러스터를 설명하는 구성 매개 변수가 포함됩니다.
참고:
vc 또는
esxi 하위 섹션을 채워야 합니다.
|
|
appliance |
장치를 설명하는 구성 매개 변수가 포함됩니다. new.vcsa 섹션, appliance 하위 섹션의 구성 매개 변수의 내용을 참조하십시오. |
|
network |
장치의 네트워크 설정을 설명하는 구성 매개 변수가 포함됩니다. new.vcsa 섹션, network 하위 섹션의 구성 매개 변수의 내용을 참조하십시오. |
|
os |
장치의 운영 체제 설정을 설명하는 구성 매개 변수가 포함됩니다. new.vcsa 섹션, os 하위 섹션의 구성 매개 변수의 내용을 참조하십시오. |
|
sso |
장치의 vCenter Single Sign-On 설정을 설명하는 구성 매개 변수가 포함됩니다. new.vcsa 섹션, sso 하위 섹션의 구성 매개 변수의 내용을 참조하십시오. |
|
ovftool.arguments |
설치 관리자가 생성하는 OVF Tool 명령에 임의의 인수와 해당 값을 추가하기 위한 선택적 하위 섹션입니다.
중요:
vCenter Server Appliance 설치 관리자는
ovftool.arguments 하위 섹션의 구성 매개 변수를 검증하지 않습니다. OVF Tool에서 인식하지 않는 인수를 설정하면 배포가 실패할 수 있습니다.
|
|
ceip - CEIP(고객 환경 향상 프로그램) 참여를 설명합니다. |
settings |
VMware CEIP(고객 환경 향상 프로그램)에 참여하거나 참여하지 않는 데 필요한 내장된 Platform Services Controller가 있는 vCenter Server Appliance 또는 Platform Services Controller 장치를 배포하는 경우에만 필요합니다.
참고:
true로 설정한 경우에는 CLI 배포 명령을 실행할 때
--acknowledge-ceip 인수를 사용해야 합니다.
CEIP에 대한 자세한 내용은 "vCenter Server 및 호스트 관리" 의 고객 환경 향상 프로그램 구성 섹션을 참조하십시오. |
암호를 포함하여 모든 문자열 값에는 ASCII 문자만 포함되어야 합니다. 확장 ASCII 및 ASCII가 아닌 문자는 지원되지 않습니다.
백슬래시(\) 또는 따옴표(") 문자가 포함된 값을 설정하려면 문자 앞에 백슬래시(\) 문자가 있어야 합니다. 예를 들어 "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 |
문자열 | 장치를 배포할 대상 ESXi 호스트의 IP 주소 또는 FQDN입니다. |
username |
문자열 | 대상 ESXi 호스트에서 관리 권한을 가진 사용자 이름입니다(예: root). |
password |
문자열 | 대상 ESXi 호스트에서 관리 권한을 가진 사용자의 암호입니다. |
deployment.network |
문자열 | 장치를 연결할 네트워크의 이름입니다.
참고: 대상
ESXi 호스트에서 액세스할 수 있는 네트워크여야 합니다.
대상 ESXi 호스트에 네트워크가 하나뿐인 경우에는 무시됩니다. |
datastore |
문자열 | 장치의 모든 가상 시스템 구성 파일과 가상 디스크를 저장할 데이터스토어의 이름입니다.
참고:
데이터스토어는 ESXi 호스트에서 액세스할 수 있어야 합니다. 데이터스토어에 사용 가능한 공간이 충분히 있어야 합니다. |
port |
정수 | 대상 ESXi 호스트의 HTTPS 역방향 프록시 포트입니다. 기본 포트는 443입니다. 대상 ESXi 호스트에서 사용자 지정 HTTPS 역방향 프록시 포트를 사용하는 경우에만 사용합니다. |
| 이름 | 유형 | 설명 |
|---|---|---|
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 호스트 또는 DRS 클러스터에 네트워크가 하나뿐인 경우에는 무시됩니다. |
datacenter |
문자열 또는 어레이 | 장치를 배포할 대상 ESXi 호스트 또는 DRS 클러스터를 포함하는 vCenter Server 데이터 센터입니다.
데이터 센터가 폴더 또는 폴더 구조에 있는 경우, 값은 쉼표로 구분된 문자열 목록이거나 쉼표로 구분된 목록의 단일 문자열이어야 합니다. 예를 들면 다음과 같습니다.
["parent_folder", "child_folder", "datacenter_name"]또는 "parent_folder, child_folder, datacenter_name"
참고: 값은 대/소문자를 구분합니다.
|
datastore |
문자열 | 장치의 모든 가상 시스템 구성 파일과 가상 디스크를 저장할 데이터스토어의 이름입니다.
참고:
대상 ESXi 호스트 또는 DRS 클러스터에서 액세스할 수 있는 데이터스토어여야 합니다. 데이터스토어에 15GB 이상의 여유 디스크 공간이 있어야 합니다. |
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 |
문자열 | 선택 사항입니다. 장치를 추가할 VM 폴더의 이름입니다. |
| 이름 | 유형 | 설명 |
|---|---|---|
thin.disk.mode |
부울 | 씬 가상 디스크를 사용하여 장치를 배포하려면 true로 설정합니다. |
deployment.option |
문자열 | 장치의 크기입니다.
|
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" 정적 할당을 사용하는 경우, 즉 |
prefix |
문자열 | 네트워크 접두사 길이입니다. 네트워크 접두사 길이는 서브넷 마스크에 설정된 비트 수입니다. 예를 들어 서브넷 마스크가 255.255.255.0인 경우 접두사 길이의 바이너리 버전에 24비트가 있으므로 네트워크 접두사 길이는 24입니다. IPv4 버전의 경우 값은 IPv6 버전의 경우 값은 |
gateway |
문자열 | 기본 게이트웨이의 IP 주소입니다. IPv6 버전의 경우 값은 |
ports |
문자열 | (선택 사항) vCenter Server Appliance에서 직접 HTTP 연결에 사용하는 포트 번호입니다. 기본적으로 포트 80은 HTTPS 포트 443으로 요청을 리디렉션합니다. vCenter Server HTTP 및 HTTPS 포트를 사용자 지정할 수 있습니다. 사용자 지정 HTTP 및 HTTPS 포트 번호를 지정하는 경우 이미 vCenter Server에서 이미 사용 중인 포트 또는 기본 HTTP 및 HTTPS 포트 80 및 443을 사용하고 있지 않은지 확인합니다. 사용자 지정 포트를 지정하는 옵션은 HTTP 포트의 경우 다음 예제에서는 HTTP 및 HTTPS 포트에 대해 포트 81 및 444를 지정합니다. ports: {"rhttpproxy.ext.port1":"81", "rhttpproxy.ext.port2":"444"} vCenter Server에서 사용 중인 포트에 대한 자세한 내용은 vCenter Server 및 Platform Services Controller의 필수 포트 항목을 참조하십시오.
참고:
ports 매개 변수는 vSphere 6.5 업데이트 2부터 지원됩니다.
|
system.name |
문자열 | 기본 네트워크 ID입니다. IP 주소 또는 FQDN일 수 있으며 가능하면 FQDN을 사용하는 것이 좋습니다. 배포 후에는 이 매개 변수의 값을 변경할 수 없습니다. FQDN 및 점으로 구분된 10진수는 RFC 1123 지침을 준수해야 합니다. |
| 이름 | 유형 | 설명 |
|---|---|---|
password |
문자열 | 장치 운영 체제의 루트 사용자 암호입니다. 암호에는 8~20자를 포함해야 하며 대문자, 소문자, 숫자 및 특수 문자(예: 달러 기호($), 해시 키(#), 앳 기호(@), 마침표(.) 또는 느낌표(!))를 하나 이상 사용해야 합니다. 모든 문자는 공백 없는 소문자 ASCII 문자여야 합니다. |
ntp.servers |
문자열 또는 어레이 | 선택 사항입니다. 시간 동기화를 위해 사용되는 NTP 서버 하나 이상의 호스트 이름 또는 IP 주소입니다.
NTP 서버를 두 개 이상 설정하려면 쉼표로 구분된 문자열 목록을 사용하거나 쉼표로 구분된 목록을 단일 문자열로 사용하여 경로를 제공합니다. 예를 들면 다음과 같습니다.
["x.y.z.a", "x.y.z.b"]또는 "x.y.z.a, x.y.z.b" |
ssh.enable |
부울 | SSH 관리자가 장치에 로그인할 수 있게 하려면 true로 설정합니다.
참고:
vCenter Server Appliance 고가용성을 사용하려면 장치에 대한 원격 SSH 액세스가 가능해야 합니다.
|
time.tools-sync |
부울 | 선택 사항입니다. VMware Tools 시간 동기화를 사용하여 장치를 배포하려면 시간 동기화를 위해 NTP 서버를 설정한 경우, 즉 |
| 이름 | 유형 | 설명 |
|---|---|---|
password |
문자열 | vCenter Single Sign-On 관리자 사용자인 administrator@your_domain_name의 암호입니다.
|
domain-name |
문자열 | vCenter Single Sign-On 도메인 이름(예: vsphere.local)입니다.
|
first-instance |
부울 | Platform Services Controller 장치를 배포하는 경우에만 필요합니다. 기본값은 Platform Services Controller 장치를 기존 vCenter Single Sign-On 도메인에 가입시키려면 가입된 Platform Services Controller 인스턴스는 해당 인프라 데이터를 복제하며 고급 연결 모드를 사용하도록 설정합니다. Platform Services Controller 서비스 관리에 대한 자세한 내용은 "Platform Services Controller 관리" 의 내용을 참조하십시오. |
platform.services.controller |
문자열 | 외부 Platform Services Controller의 시스템 이름입니다. 외부 Platform Services Controller가 있는 vCenter Server Appliance를 배포하는 경우에만 필요합니다. |
replication-partner-hostname |
문자열 | 파트너 Platform Services Controller의 시스템 이름입니다. Platform Services Controller 장치를 기존 vCenter Single Sign-On 도메인에 복제 파트너로 배포하는 경우에만 필요합니다. |
sso.port |
정수 | 파트너 Platform Services Controller의 HTTPS 역방향 프록시 포트입니다. 기본 포트는 443입니다. 파트너 Platform Services Controller에서 사용자 지정 HTTPS 역방향 프록시 포트를 사용하는 경우에만 사용합니다. |
site-name |
문자열 | vCenter Single Sign-On 사이트 이름입니다. 내장된 Platform Services Controller가 있는 vCenter Server Appliance 또는 Platform Services Controller 장치를 배포하는 경우에만 필요합니다.
참고: 내장 연결 모드를 설정하는 경우
Default-First-Site를 첫 번째 인스턴스의 사이트 이름으로 사용합니다.
|
ceip 섹션의 구성 매개 변수
| 이름 | 유형 | 설명 |
|---|---|---|
ceip.enabled |
부울 | 이 장치에 대해 CEIP에 참여하려면 true로 설정합니다. |
