外部ノードを組み込みノードに再構成するための 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 の root パスワード。省略した場合は、テンプレートの検証時に、コマンド コンソールでパスワードの入力を求められます。
	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 の root パスワード。省略した場合は、テンプレートの検証時に、コマンド コンソールでパスワードの入力を求められます。
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 の root パスワード。省略した場合は、テンプレートの検証時に、コマンド コンソールでパスワードの入力を求められます。

廃止構成ファイルのテンプレート

サンプル 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.>"
            }
        }
}