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

JSON 배포 파일에 있는 구성 매개 변수의 섹션 및 하위 섹션

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

표 1. JSON 배포 파일에 있는 구성 매개 변수의 섹션 및 하위 섹션
섹션 하위 섹션 설명
new_vcsa - 배포할 장치를 설명합니다. esxi

새 장치를 ESXi 호스트에 직접 배포하려는 경우에만 사용합니다.

대상 ESXi 호스트를 설명하는 구성 매개 변수가 포함됩니다.

배포 중에 vSAN 또는 vLCM 관리 클러스터 중 무엇을 구성할지에 따라 관련 섹션에서 구성 매개 변수에 대한 자세한 내용을 참조하십시오.
참고: esxi 또는 vc 하위 섹션을 채워야 합니다.
vc

장치를 vCenter Server 인스턴스의 인벤토리에 배포하려는 경우에만 사용합니다.

대상 ESXi 호스트 또는 vCenter Server 인벤토리의 DRS 클러스터를 설명하는 구성 매개 변수가 포함됩니다. new_vcsa 섹션, vc 하위 섹션의 구성 매개 변수의 내용을 참조하십시오.

참고: 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 설치 관리자는 ovftool_arguments 하위 섹션의 구성 매개 변수를 검증하지 않습니다. OVF Tool에서 인식하지 않는 인수를 설정하면 배포가 실패할 수 있습니다.
ceip - CEIP(고객 환경 향상 프로그램) 참여를 설명합니다. settings

VMware CEIP(고객 환경 향상 프로그램)에 참여하거나 참여하지 않는 데 필요한 ceip_enabled 구성 매개 변수만 포함됩니다. ceip 섹션, settings 하위 섹션의 구성 매개 변수의 내용을 참조하십시오.

참고: true로 설정한 경우에는 CLI 배포 명령을 실행할 때 --acknowledge-ceip 인수를 사용해야 합니다.

CEIP에 대한 자세한 내용은 "vCenter Server 및 호스트 관리" 의 고객 환경 향상 프로그램 구성 섹션을 참조하십시오.

중요:

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

백슬래시(\) 또는 따옴표(") 문자가 포함된 값을 설정하려면 문자 앞에 백슬래시(\) 문자가 있어야 합니다. 예를 들어 "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 섹션의 구성 매개 변수

표 2. vSAN 및 vLCM 관리 클러스터가 있는 배포를 위한 new_vcsa 섹션, esxi 하위 섹션의 구성 매개 변수
이름 유형 설명
hostname 문자열 장치를 배포할 대상 ESXi 호스트의 IP 주소 또는 FQDN입니다.
username 문자열 대상 ESXi 호스트에서 관리 권한을 가진 사용자 이름입니다(예: root).
password 문자열 대상 ESXi 호스트에서 관리 권한을 가진 사용자의 암호입니다.
deployment_network 문자열

장치를 연결할 네트워크의 이름입니다.

참고: 대상 ESXi 호스트에서 액세스할 수 있는 네트워크여야 합니다.

대상 ESXi 호스트에 네트워크가 하나뿐인 경우에는 무시됩니다.

datacenter 문자열 생성하려는 특정 데이터 센터입니다.
cluster 문자열 vSAN 또는 vLCM 관리 클러스터의 이름입니다.
compression_only 부울 vSAN 클러스터에서 압축을 사용하도록 설정하려면 값을 true로 설정합니다. 이 매개 변수를 true로 설정하면 deduplication_and_compression 매개 변수를 false로 설정해야 합니다.
deduplication_and_compression 부울 vSAN 클러스터에서 압축 및 중복 제거를 사용하도록 설정하려면 값을 true로 설정합니다. 이 매개 변수를 true로 설정하면 compression_only 매개 변수를 false로 설정해야 합니다.
cache_disk 캐시에 사용할 디스크의 정식 이름 또는 UUID 목록입니다. SSD만 지정합니다.
capacity_disk 스토리지에 사용할 디스크의 정식 이름 또는 UUID 목록입니다. SSD 또는 HDD를 지정합니다.
enable_vlcm 부울 vLCM 관리 클러스터를 생성하려면 true로 설정합니다.
datastore 문자열

장치의 구성 파일과 가상 디스크를 저장할 데이터스토어의 이름입니다.

참고:

데이터스토어는 ESXi 호스트에서 액세스할 수 있어야 합니다.

씬 디스크 모드를 사용하는 경우 데이터스토어 크기에 최소 25GB 공간이 있어야 합니다.
port 정수

대상 ESXi 호스트의 HTTPS 역방향 프록시 포트입니다.

기본 포트는 443입니다. 대상 ESXi 호스트에서 사용자 지정 HTTPS 역방향 프록시 포트를 사용하는 경우에만 사용합니다.

표 3. vSAN 또는 vLCM 관리 클러스터가 없는 배포를 위한 new_vcsa 섹션, esxi 하위 섹션의 구성 매개 변수
이름 유형 설명
hostname 문자열 장치를 배포할 대상 ESXi 호스트의 IP 주소 또는 FQDN입니다.
username 문자열 대상 ESXi 호스트에서 관리 권한을 가진 사용자 이름입니다(예: root).
password 문자열 대상 ESXi 호스트에서 관리 권한을 가진 사용자의 암호입니다.
deployment_network 문자열

장치를 연결할 네트워크의 이름입니다.

참고: 대상 ESXi 호스트에서 액세스할 수 있는 네트워크여야 합니다.

대상 ESXi 호스트에 네트워크가 하나뿐인 경우에는 무시됩니다.

datastore 문자열

장치의 구성 파일과 가상 디스크를 저장할 데이터스토어의 이름입니다.

참고:

데이터스토어는 ESXi 호스트에서 액세스할 수 있어야 합니다.

씬 디스크 모드를 사용하는 경우 데이터스토어 크기에 최소 25GB 공간이 있어야 합니다.
port 정수

대상 ESXi 호스트의 HTTPS 역방향 프록시 포트입니다.

기본 포트는 443입니다. 대상 ESXi 호스트에서 사용자 지정 HTTPS 역방향 프록시 포트를 사용하는 경우에만 사용합니다.

표 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 호스트 또는 DRS 클러스터에 네트워크가 하나뿐인 경우에는 무시됩니다.

datacenter 어레이

장치를 배포할 대상 ESXi 호스트 또는 DRS 클러스터를 포함하는 vCenter Server 데이터 센터입니다.

데이터 센터가 폴더 또는 폴더 구조에 있는 경우, 값은 쉼표로 구분된 문자열 목록으로 지정합니다. 예를 들면 다음과 같습니다. 
["parent_folder", "child_folder", "datacenter_name"]
참고: 값은 대/소문자를 구분합니다.
datastore 문자열

장치의 구성 파일과 가상 디스크를 저장할 데이터스토어의 이름입니다.

참고:

대상 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"]
대상 ESXi 호스트가 클러스터의 일부인 경우 경로를 쉼표로 구분된 문자열 목록으로 지정합니다. 예를 들면 다음과 같습니다. 
["cluster_name", "esxi-host.domain.com"]
참고: 값은 대/소문자를 구분합니다.
vm_folder 문자열 선택 사항입니다. 장치가 배포된 VM 폴더의 이름입니다.
표 5. new_vcsa 섹션, appliance 하위 섹션의 구성 매개 변수
이름 유형 설명
thin_disk_mode 부울 씬 가상 디스크를 사용하여 장치를 배포하려면 true로 설정합니다.
deployment_option 문자열 장치의 크기입니다.
  • 기본 스토리지 크기를 사용하고 최대 10개의 호스트와 100개의 가상 시스템에 vCenter Server Appliance를 배포하려면 tiny로 설정합니다.

    2개의 CPU, 12GB의 메모리 및 315GB의 스토리지가 포함된 장치를 배포합니다.

  • 대형 스토리지 크기를 사용하고 최대 10개의 호스트와 100개의 가상 시스템에 vCenter Server Appliance를 배포하려면 tiny-lstorage로 설정합니다.

    2개의 CPU, 12GB의 메모리 및 1390GB의 스토리지가 장착된 장치를 배포합니다.

  • 초대형 스토리지 크기를 사용하고 최대 10개의 호스트와 100개의 가상 시스템에 vCenter Server Appliance를 배포하려면 tiny-xlstorage로 설정합니다.

    2개의 CPU, 12GB의 메모리 및 3145GB의 스토리지가 포함된 장치를 배포합니다.

  • 기본 스토리지 크기를 사용하고 최대 100개의 호스트와 1,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 small로 설정합니다.

    4개의 CPU, 19GB의 메모리 및 380GB의 스토리지가 포함된 장치를 배포합니다.

  • 대형 스토리지 크기를 사용하고 최대 100개의 호스트와 1,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 small-lstorage로 설정합니다.

    4개의 CPU, 19GB의 메모리 및 1435GB의 스토리지가 포함된 장치를 배포합니다.

  • 초대형 스토리지 크기를 사용하고 최대 100개의 호스트와 1,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 small-xlstorage로 설정합니다.

    4개의 CPU, 19GB의 메모리 및 3195GB의 스토리지가 포함된 장치를 배포합니다.

  • 기본 스토리지 크기를 사용하고 최대 400개의 호스트와 4,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 medium로 설정합니다.

    8개의 CPU, 28GB의 메모리 및 600GB의 스토리지가 포함된 장치를 배포합니다.

  • 대형 스토리지 크기를 사용하고 최대 400개의 호스트와 4,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 medium-lstorage로 설정합니다.

    8개의 CPU, 28GB의 메모리 및 1600GB의 스토리지가 포함된 장치를 배포합니다.

  • 초대형 스토리지 크기를 사용하고 최대 400개의 호스트와 4,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 medium-xlstorage로 설정합니다.

    8개의 CPU, 28GB의 메모리 및 3360GB의 스토리지가 포함된 장치를 배포합니다.

  • 기본 스토리지 크기를 사용하고 최대 1,000개의 호스트와 10,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 large로 설정합니다.

    16개의 CPU, 37GB의 메모리 및 965GB의 스토리지가 포함된 장치를 배포합니다.

  • 대형 스토리지를 사용하고 최대 1,000개의 호스트와 10,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 large-lstorage로 설정합니다.

    16개의 CPU, 37GB의 메모리 및 1665GB의 스토리지가 포함된 장치를 배포합니다.

  • 초대형 스토리지 크기를 사용하고 최대 1,000개의 호스트와 10,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 large-xlstorage로 설정합니다.

    16개의 CPU, 37GB의 메모리 및 3425GB의 스토리지가 포함된 장치를 배포합니다.

  • 기본 스토리지 크기를 사용하고 최대 2,000개의 호스트와 35,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 xlarge로 설정합니다.

    24개의 CPU, 56GB의 메모리 및 1705GB의 스토리지가 포함된 장치를 배포합니다.

  • 대형 스토리지 크기를 사용하고 최대 2,000개의 호스트와 35,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 xlarge-lstorage로 설정합니다.

    24개의 CPU, 56GB의 메모리 및 1805GB의 스토리지가 포함된 장치를 배포합니다.

  • 초대형 스토리지 크기를 사용하고 최대 2,000개의 호스트와 35,000개의 가상 시스템에 vCenter Server Appliance를 배포하려면 xlarge-xlstorage로 설정합니다.

    24개의 CPU, 56GB의 메모리 및 3565GB의 스토리지가 포함된 장치를 배포합니다.

image 문자열

선택 사항입니다. vCenter Server Appliance 설치 패키지의 로컬 파일 경로 또는 URL입니다.

기본적으로 설치 관리자는 vcsa 폴더에 있는 ISO 파일에 포함된 설치 패키지를 사용합니다.

name 문자열

장치의 VM 이름입니다.

퍼센트 기호(%), 백슬래시(\) 또는 슬래시(/)를 제외하고 ASCII 문자만 포함해야 하며 길이가 80자를 넘지 않아야 합니다.

ovftool_path 문자열

선택 사항입니다. OVF Tool 실행 파일의 로컬 파일 경로입니다.

기본적으로 설치 관리자는 vcsa/ovftool 폴더에 있는 ISO 파일에 포함된 OVF Tool 인스턴스를 사용합니다.

표 6. new_vcsa 섹션, 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"

mode 매개 변수가 static으로 설정된 경우 선택 사항입니다. 모드가 DHCP로 설정된 경우 지원되지 않습니다.
prefix 문자열

네트워크 접두사 길이입니다.

mode 매개 변수가 static으로 설정된 경우에만 사용합니다 mode 매개 변수가 dhcp로 설정된 경우에는 제거합니다.

네트워크 접두사 길이는 서브넷 마스크에 설정된 비트 수입니다. 예를 들어 서브넷 마스크가 255.255.255.0인 경우 접두사 길이의 바이너리 버전에 24비트가 있으므로 네트워크 접두사 길이는 24입니다.

IPv4 버전의 경우 값은 0에서 32 사이여야 합니다.

IPv6 버전의 경우 값은 0에서 128 사이여야 합니다.

gateway 문자열

기본 게이트웨이의 IP 주소입니다.

IPv6 버전의 경우 값은 default일 수 있습니다.

ports 문자열

선택 사항입니다. vCenter Server Appliance에서 직접 HTTP 연결에 사용하는 포트 번호입니다. 기본적으로 포트 80은 HTTPS 포트 443으로 요청을 리디렉션합니다. vCenter Server HTTP 및 HTTPS 포트를 사용자 지정할 수 있습니다. 사용자 지정 HTTP 및 HTTPS 포트 번호를 지정하는 경우 이미 vCenter Server에서 이미 사용 중인 포트 또는 기본 HTTP 및 HTTPS 포트 80 및 443을 사용하고 있지 않은지 확인합니다.

사용자 지정 포트를 지정하는 옵션은 HTTP 포트의 경우 "rhttpproxy.ext.port1":"port_number"이고 HTTPS 포트의 경우 "rhttpproxy.ext.port2:"port_number"입니다.

다음 예제에서는 HTTP 및 HTTPS 포트에 대해 포트 81 및 444를 지정합니다. 

ports: {"rhttpproxy.ext.port1":"81", "rhttpproxy.ext.port2":"444"}

vCenter Server에서 사용 중인 포트에 대한 자세한 내용은 vCenter Server의 필수 포트 항목을 참조하십시오.

system_name 문자열

기본 네트워크 ID입니다.

IP 주소 또는 FQDN일 수 있으며 가능하면 FQDN을 사용하는 것이 좋습니다.

배포 후에는 이 매개 변수의 값을 변경할 수 없습니다.

FQDN 및 점으로 구분된 10진수는 RFC 1123 지침을 준수해야 합니다.

표 7. new_vcsa 섹션, os 하위 섹션의 구성 매개 변수
이름 유형 설명
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 시간 동기화를 사용하여 장치를 배포하려면 true로 설정합니다. VMware Tools는 장치의 시간을 ESXi 호스트의 시간과 동기화합니다.

시간 동기화를 위해 NTP 서버를 설정한 경우, 즉 ntp.servers 매개 변수를 설정한 경우에는 무시됩니다.

표 8. new_vcsa 섹션, sso 하위 섹션의 구성 매개 변수
이름 유형 설명
password 문자열

vCenter Single Sign-On 관리자 사용자인 administrator@your_domain_name의 암호입니다.

vCenter Server Appliance를 새 vCenter Single Sign-On 도메인의 첫 번째 인스턴스로 배포하는 경우에는 vCenter Single Sign-On 관리자 사용자의 암호를 설정해야 합니다.

암호에는 8~20자를 포함해야 하며 대문자, 소문자, 숫자 및 특수 문자(예: 달러 기호($), 해시 키(#), 앳 기호(@), 마침표(.) 또는 느낌표(!))를 하나 이상 사용해야 합니다. 모든 문자는 ASCII 문자여야 합니다.

domain_name 문자열

vCenter Single Sign-On 도메인 이름(예: vsphere.local)입니다.

vCenter Server Appliance를 새 vCenter Single Sign-On 도메인의 첫 번째 인스턴스로 배포하는 경우에는 새 vCenter Single Sign-On 도메인의 이름을 설정해야 합니다.
replication_partner_hostname 문자열

파트너 vCenter Server의 시스템 이름입니다.

기존 vCenter Single Sign-On 도메인에 복제 파트너를 배포하는 경우에만 필요합니다.

sso_port 정수

파트너 vCenter Server의 HTTPS 역방향 프록시 포트입니다.

기본 포트는 443입니다. 파트너에서 사용자 지정 HTTPS 역방향 프록시 포트를 사용하는 경우에만 사용합니다.

ceip 섹션의 구성 매개 변수

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