在运行 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。例如，root（针对 ESXi 主机）和 administrator@SSO_domain（针对 vCenter Server）。
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。例如，root（针对 ESXi 主机）和 administrator@SSO_domain（针对 vCenter Server）。
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。例如，root（针对 ESXi 主机）和 administrator@SSO_domain（针对 vCenter Server）。
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.>"
            }
        }
}