외부 노드를 내장형 노드로 재구성하기 위한 JSON 구성 파일 준비

CLI를 실행하여 외부 Platform Services Controller가 있는 vCenter Server를 내장형 Platform Services Controller가 있는 vCenter Server로 재구성하거나 Platform Services Controller를 해제하기 전에 구성 매개 변수 및 규격 값이 포함된 JSON 파일을 준비해야 합니다.

converge.json 및 decommission_psc.json 샘플 템플릿은 vcsa-converge-cli\templates\converge 및 vcsa-converge-cli\templates\decommission에 위치합니다. 템플릿을 업무 공간에 저장합니다.

이러한 샘플 템플릿에는 가장 자주 사용되는 옵션이 포함되어 있습니다.

컨버전스 구성 매개 변수

converge.json 구성 파일의 구성 매개 변수는 부, 섹션 및 하위 섹션으로 구성됩니다.

표 1. converge.json 파일의 구성 매개 변수

부	섹션	하위 섹션	설명
vCenter	description	comments	장치가 실행 중인 vCenter Server Appliance 및 ESXi 호스트를 설명합니다.
	managing_esxi_or_vc	hostname	vCenter Server가 상주하는 vCenter Server의 ESXi 호스트에 대한 FQDN 또는 IP 주소입니다.
		username	ESXi 호스트 또는 vCenter Server에 대한 관리자 권한이 있는 사용자 ID입니다. 예를 들어 ESXi 호스트의 경우 root이고, vCenter Server의 경우 administrator@SSO_domain 입니다.
		password	ESXi 호스트 또는 vCenter Server에 대한 관리자 권한이 있는 사용자의 암호입니다. 생략된 경우 템플릿을 확인하는 동안 명령 콘솔에 암호를 입력하라는 메시지가 표시됩니다.
	vc_appliance	hostname	vCenter Server Appliance의 FQDN 또는 IP 주소입니다.
		username	administrator@SSO_domain입니다. 여기서 SSO_domain은 vCenter Server Appliance에 대한 vCenter Single Sign-On 도메인입니다.
		password	vCenter Single Sign-On 관리자 암호입니다. 생략된 경우 템플릿을 확인하는 동안 명령 콘솔에 암호를 입력하라는 메시지가 표시됩니다.
		root_password	vCenter Server Appliance 루트 암호입니다. 생략된 경우 템플릿을 확인하는 동안 명령 콘솔에 암호를 입력하라는 메시지가 표시됩니다.
	ad_domain_info 참고: 외부 Platform Services Controller가 Active Directory에 가입되지 않은 경우 JSON 템플릿에서 이 섹션을 제거하십시오.	domain_name	Platform Services Controller 장치의 Active Directory 도메인에 대한 FQDN 또는 IP 주소입니다.
		username	시스템을 제공된 도메인에 가입할 권한이 있는 Active Directory 도메인 사용자 ID입니다.
		password	시스템을 제공된 도메인에 가입할 권한이 있는 Active Directory 도메인 암호입니다.
		dns_ip	(선택 사항) Active Directory 도메인 이름을 확인하는 DNS IP 주소입니다. 기존 DNS 설정에서 제공된 Active Directory 도메인을 확인할 수 없는 경우에만 필요합니다.
replication		description	제공된 Platform Services Controller로 복제되는 vCenter Server Appliance를 설명합니다.
	partner	hostname	대상 Platform Services Controller 노드의 FQDN 또는 IP 주소입니다.

컨버전스 구성 파일 템플릿

샘플 converge.json 템플릿:

{
    "__version": "2.11.0",
    "__comments": "Template for VCSA with external Platform Services Controller converge",
        "vcenter": {
            "description": {
               "__comments": [
                    "This section describes the vCenter appliance which you want to",
                    "converge and the ESXi host on which the appliance is running. "
                ]
            },
            "managing_esxi_or_vc": {
                "hostname": "<FQDN or IP address of the ESXi or vCenter on which the vCenter Server Appliance resides.>",
                "username": "<Username of a user with administrative privilege on the ESXi host or vCenter Server. For example 'root' for ESXi and 'administrator@<SSO domain name>' for vCenter >",
                "password": "<Password of the administrative user on the ESXi host or vCenter Server. If left blank, or omitted, you will be prompted to enter it at the command console during template verification.>"
            },
            "vc_appliance": {
                "hostname": "<FQDN or IP address of the vCenter Server Appliance>",
                "username": "administrator@<SSO domain name>",
                "password": "<vCenter Single Sign-On administrator password. If left blank, or omitted, you will be prompted to enter it at the command console during template verification.>",
                "root_password": "<Appliance root password. If left blank, or omitted, you will be prompted to enter it at the command console during template verification.>",
            },
            "ad_domain_info": {
                "__comments": [
                    "Important Note: This section is needed only when PSC (Platform Services Controller) appliance is joined to a domain.",
                    "Remove this section if PSC appliance is not joined to a domain.",
                    "Keeping this section without valid values results in JSON validation errors."
                ],
                "domain_name": "<Domain name of the Platform Services Controller appliance's AD domain>",
                "username": "<AD domain username with privileges to join any machine to the provided domain>",
                "password": "<AD domain password with privileges to join any machine to the provided domain>",
                "dns_ip": "<DNS IP which resolves AD domain name. This is an optional field and is required only when the provided AD domain cannot be resolved by the existing DNS setting of the VCSA node.>"
            }
        },
    "replication": {
            "description": {
               "__comments": [
               "Important Note: Make sure you provide the information in this section very carefully, as this changes the replication topology.",
               "Refer to the documentation for complete details. Remove this section if this is first converge operation in your setup.",
               "This section provides details of the PSC node which will be set up as a replicated node for a new PSC on the target VCSA node."
            ]
                },
            "partner": {
                "hostname": "<FQDN or IP address of the target VCSA PSC node>"
            }
        }
}

해제 구성 매개 변수

decommision_psc.json 구성 파일의 구성 매개 변수는 부, 섹션 및 하위 섹션으로 구성됩니다.

표 2. decommisision_psc.json 파일의 구성 매개 변수

부	섹션	하위 섹션	설명
psc	description	comments	해제할 Platform Services Controller 장치와 장치가 실행 중인 Platform Services Controller 호스트를 설명합니다.
	managing_esxi_or_vc	hostname	Platform Services Controller가 상주하는 ESXi 호스트 또는 vCenter Server의 FQDN 또는 IP 주소입니다.
		username	ESXi 호스트 또는 vCenter Server에 대한 관리자 권한이 있는 사용자 ID입니다. 예를 들어 ESXi 호스트의 경우 root이고, vCenter Server의 경우 administrator@SSO_domain 입니다.
		password	ESXi 호스트 또는 vCenter Server에 대한 관리자 권한이 있는 사용자의 암호입니다. 생략된 경우 템플릿을 확인하는 동안 명령 콘솔에 암호를 입력하라는 메시지가 표시됩니다.
		port	(선택 사항) 호스트에 대한 포트입니다. 기본 포트는 443입니다.
	psc_appliance	hostname	해제할 외부 Platform Services Controller 장치의 FQDN 또는 IP 주소입니다. 참고: 해제 전에 현재 이 외부 Platform Services Controller를 사용 중인 다른 솔루션이 없음을 확인합니다.
		username	administrator@SSO_domain입니다. 여기서 SSO_domain은 vCenter Server Appliance에 대한 vCenter Single Sign-On 도메인입니다.
		password	vCenter Single Sign-On 관리자 암호입니다. 생략된 경우 템플릿을 확인하는 동안 명령 콘솔에 암호를 입력하라는 메시지가 표시됩니다.
		root_password	vCenter Server Appliance 루트 암호입니다. 생략된 경우 템플릿을 확인하는 동안 명령 콘솔에 암호를 입력하라는 메시지가 표시됩니다.
vcenter	description	comments	제공된 Platform Services Controller로 복제되는 내장형 vCenter Server Appliance를 설명합니다.
	managing_esxi_or_vc	hostname	vCenter Server Appliance가 상주하는 ESXi 호스트 또는 vCenter Server의 FQDN 또는 IP 주소입니다.
		username	ESXi 호스트 또는 vCenter Server에 대한 관리자 권한이 있는 사용자 ID입니다. 예를 들어 ESXi 호스트의 경우 root이고, vCenter Server의 경우 administrator@SSO_domain 입니다.
		password	ESXi 호스트 또는 vCenter Server에 대한 관리자 권한이 있는 사용자의 암호입니다. 생략된 경우 템플릿을 확인하는 동안 명령 콘솔에 암호를 입력하라는 메시지가 표시됩니다.
		port	(선택 사항) 호스트에 대한 포트입니다. 기본 포트는 443입니다.
	vc_appliance	hostname	vCenter Server Appliance의 FQDN 또는 IP 주소입니다.
		username	administrator@SSO_domain입니다. 여기서 SSO_domain은 vCenter Server Appliance에 대한 vCenter Single Sign-On 도메인입니다.
		password	vCenter Single Sign-On 관리자 암호입니다. 생략된 경우 템플릿을 확인하는 동안 명령 콘솔에 암호를 입력하라는 메시지가 표시됩니다.
		root_password	vCenter Server Appliance 루트 암호입니다. 생략된 경우 템플릿을 확인하는 동안 명령 콘솔에 암호를 입력하라는 메시지가 표시됩니다.

해제 구성 파일 템플릿

샘플 decommission.json 템플릿:

{    
"__comments": "Template for decommissioning PSC node with converge CLI tool.",
    "__version": "2.11.0",
        "psc": {
            "description": {
               "__comments": [
                   "This section describes the PSC appliance which you want to",
                    "decommission and the ESXi host on which the appliance is running. "
                ]
            },
            "managing_esxi_or_vc": {
                "hostname": "<FQDN or IP address of the ESXi or vCenter on which the Platform Services Controller appliance resides.>",
                "username": "<Username of a user with administrative privilege on the ESXi host or vCenter Server. For example 'root' for ESXi and 'administrator@<SSO domain name>' for vCenter >",
                "password": "<Password of the administrative user on the ESXi host or vCenter Server. If left blank, or omitted, you will be prompted to enter it at the command console during template verification.>",
                "port": "This section may be removed, if default port is 443. If not, custom port have to be specified"
            },
            "psc_appliance": {
                "hostname": "<FQDN or IP address of the Platform Services Controller appliance>",
                "username": "administrator@<SSO domain name>",
                "password": "<vCenter Single Sign-On administrator password. If left blank, or omitted, you will be prompted to enter it at the command console during template verification.>",
                "root_password": "<Appliance root password. If left blank, or omitted, you will be prompted to enter it at the command console during template verification.>",
            }
        }
        "vcenter": {
            "description": {
               "__comments": [
                    "This section describes the embedded vCenter appliance which is in ",
                    "replication with the provided PSC"
                ]
            },
            "managing_esxi_or_vc": {
                "hostname": "<FQDN or IP address of the ESXi or vCenter on which the vCenter Server Appliance resides.>",
                "username": "<Username of a user with administrative privilege on the ESXi host or vCenter Server. For example 'root' for ESXi and 'administrator@<SSO domain name>' for vCenter >",
                "password": "<Password of the administrative user on the ESXi host or vCenter Server. If left blank, or omitted, you will be prompted to enter it at the command console during template verification.>",
                "port": "This section may be removed, if default port is 443. If not, custom port have to be specified"
            },
            "vc_appliance": {
                "hostname": "<FQDN or IP address of the vCenter Server Appliance>",
                "username": "administrator@<SSO domain name>",
                "password": "<vCenter Single Sign-On administrator password. If left blank, or omitted, you will be prompted to enter it at the command console during template verification.>",
                "root_password": "<Appliance root password. If left blank, or omitted, you will be prompted to enter it at the command console during template verification.>"
            }
        }
}