Antes de ejecutar las CLI para volver a configurar vCenter Server con una instancia externa de Platform Services Controller a vCenter Server con una instancia integrada de Platform Services Controller o retirar una instancia de Platform Services Controller, debe preparar un archivo JSON con los parámetros de configuración y sus valores para la especificación.

Las plantillas de muestra converge.json y decommission_psc.json se encuentran en vcsa-converge-cli\templates\converge y vcsa-converge-cli\templates\decommission. Guarde las plantillas en su área de trabajo.

Estas plantillas de muestra contienen las opciones más utilizadas.

Parámetros de configuración para converger

Los parámetros de configuración en el archivo de configuración converge.json están organizados en partes, secciones y subsecciones.

Tabla 1. Parámetro de configuración para el archivo converge.json
Parte Sección Subsección Descripción
vCenter description comments Se describe la instancia de vCenter Server Appliance y el host ESXi en el que se ejecuta el dispositivo.
managing_esxi_or_vc hostname FQDN o dirección IP del host ESXi de vCenter Server donde reside vCenter Server.
username Identificador del usuario con privilegios de administrador en el host ESXi o vCenter Server. Por ejemplo, root para el host ESXi y administrator@SSO_domain para vCenter Server.
password Contraseña del usuario con privilegios de administrador en el host ESXi o vCenter Server. Si se omite, se solicita la introducción de la contraseña en la consola de comandos durante la comprobación de la plantilla.
vc_appliance hostname FQDN o dirección IP de vCenter Server Appliance.
username administrator@SSO_domain donde SSO_domain es el dominio de vCenter Single Sign-On para vCenter Server Appliance.
password Contraseña de administrador de vCenter Single Sign-On. Si se omite, se solicita la introducción de la contraseña en la consola de comandos durante la comprobación de la plantilla.
root_password Contraseña raíz de vCenter Server Appliance. Si se omite, se solicita la introducción de la contraseña en la consola de comandos durante la comprobación de la plantilla.
ad_domain_info
Nota: Si la instancia externa de Platform Services Controller no se unió a Active Directory, elimine esta sección de la plantilla JSON.
domain_name FQDN o dirección IP del dominio de Active Directory para el dispositivo Platform Services Controller.
username Identificador del usuario del dominio de Active Directory con privilegios para unir cualquier máquina al dominio proporcionado.
password Contraseña del dominio de Active Directory con privilegios para unir cualquier máquina al dominio proporcionado.
dns_ip (Opcional) Dirección IP de DNS que resuelve el nombre de dominio de Active Directory. Solo se requiere cuando la configuración de DNS existente no puede resolver el dominio de Active Directory proporcionado.
replication description Se describe la instancia de vCenter Server Appliance en replicación con la instancia de Platform Services Controller proporcionada.
partner hostname FQDN o dirección IP del nodo de Platform Services Controller de destino.

Plantilla de archivos de configuración para converger

Plantilla converge.json de muestra:

{
    "__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>"
            }
        }
}

Parámetros de configuración para retirar

Los parámetros de configuración en el archivo de configuración decommision_psc.json están organizados en partes, secciones y subsecciones.

Tabla 2. Parámetro de configuración para el archivo decommisision_psc.json
Parte Sección Subsección Descripción
psc description comments Se describe el dispositivo de Platform Services Controller que se desea retirar y el host Platform Services Controller en el que se ejecuta el dispositivo.
managing_esxi_or_vc hostname FQDN o dirección IP del host de ESXi o vCenter Server en el que reside la Platform Services Controller.
username Identificador del usuario con privilegios de administrador en el host ESXi o vCenter Server. Por ejemplo, root para el host ESXi y administrator@SSO_domain para vCenter Server.
password Contraseña del usuario con privilegios de administrador en el host ESXi o vCenter Server. Si se omite, se solicita la introducción de la contraseña en la consola de comandos durante la comprobación de la plantilla.
port (Opcional) Puerto para el host. El puerto predeterminado es 443.
psc_appliance hostname FQDN o dirección IP del dispositivo externo de Platform Services Controller que se desea retirar.
Nota: Asegúrese de que ninguna otra solución use actualmente esta instancia externa de Platform Services Controller antes de retirarla.
username administrator@SSO_domain donde SSO_domain es el dominio de vCenter Single Sign-On para vCenter Server Appliance.
password Contraseña de administrador de vCenter Single Sign-On. Si se omite, se solicita la introducción de la contraseña en la consola de comandos durante la comprobación de la plantilla.
root_password Contraseña raíz de vCenter Server Appliance. Si se omite, se solicita la introducción de la contraseña en la consola de comandos durante la comprobación de la plantilla.
vcenter description comments Se describe la instancia integrada de vCenter Server Appliance en replicación con la instancia de Platform Services Controller proporcionada.
managing_esxi_or_vc hostname FQDN o dirección IP del host de ESXi o vCenter Server en el que reside la vCenter Server Appliance.
username Identificador del usuario con privilegios de administrador en el host ESXi o vCenter Server. Por ejemplo, root para el host ESXi y administrator@SSO_domain para vCenter Server.
password Contraseña del usuario con privilegios de administrador en el host ESXi o vCenter Server. Si se omite, se solicita la introducción de la contraseña en la consola de comandos durante la comprobación de la plantilla.
port (Opcional) Puerto para el host. El puerto predeterminado es 443.
vc_appliance hostname FQDN o dirección IP de vCenter Server Appliance.
username administrator@SSO_domain donde SSO_domain es el dominio de vCenter Single Sign-On para vCenter Server Appliance.
password Contraseña de administrador de vCenter Single Sign-On. Si se omite, se solicita la introducción de la contraseña en la consola de comandos durante la comprobación de la plantilla.
root_password Contraseña raíz de vCenter Server Appliance. Si se omite, se solicita la introducción de la contraseña en la consola de comandos durante la comprobación de la plantilla.

Plantilla de archivos de configuración para retirar

Plantilla decommission.json de muestra:

{    
"__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.>"
            }
        }
}