Preparar el archivo de configuración JSON para la actualización de CLI

Antes de ejecutar el comando CLI para actualizar una instancia de vCenter Server Appliance, debe preparar un archivo JSON con los parámetros de configuración y sus valores para la especificación de la actualización.

El instalador de vCenter Server contiene plantillas JSON para todos los tipos de actualización. Para obtener información sobre las plantillas, consulte Plantillas JSON para la actualización de CLI de vCenter Server Appliance.

Para actualizar un dispositivo con la configuración mínima, establezca los valores según los parámetros de configuración en la plantilla JSON correspondiente a su especificación. Puede editar los valores preestablecidos, quitar los parámetros de configuración y agregar parámetros para configuraciones personalizadas.

Si desea conocer la lista completa de parámetros de configuración y sus descripciones, desplácese hasta el subdirectorio del instalador del sistema operativo y ejecute el comando vcsa-deploy upgrade --template-help, o bien consulte Actualizar los parámetros de configuración para la actualización de la CLI de vCenter Server Appliance.

Requisitos previos

Debe estar familiarizado con la sintaxis JSON.
Descargar el instalador de vCenter Server y montarlo.

Procedimiento

En el instalador de vCenter Server Appliance, desplácese hasta el directorio vcsa-cli-installer y abra la subcarpeta plantillas.
Copie las plantillas de actualización desde la subcarpeta actualización en su área de trabajo.

Importante: La ruta de acceso a los archivos de configuración JSON debe contener únicamente caracteres ASCII. No se admiten los caracteres ASCII extendidos ni los caracteres que no sean ASCII.
Abra el archivo de plantilla correspondiente a su caso de uso en un editor de texto.
Para garantizar la correcta sintaxis del archivo de configuración JSON, use un editor JSON.
Complete los valores para los parámetros de configuración requeridos y, como opción, introduzca parámetros adicionales y sus valores.
Por ejemplo, si desea utilizar una asignación de DHCP IPv4 para la red temporal del nuevo dispositivo, en la subsección temporary_network de la plantilla, cambie el valor del parámetro mode a dhcp y quite los parámetros de configuración predeterminados que son para una asignación estática.
```
        "temporary_network": {
            "ip_family": "ipv4",
            "mode": "dhcp"
        },
```
Importante: Los valores de cadena, incluidas las contraseñas, deben contener únicamente caracteres ASCII. No se admiten los caracteres ASCII extendidos ni los caracteres que no sean ASCII.
Para establecer un valor que contiene una barra diagonal inversa (\) o un carácter de comillas ("), debe anteponer a este carácter una barra diagonal inversa (\). Por ejemplo, "password":"my\"password" establece la contraseña my"password y "image":"G:\\vcsa\\VMware-vCenter-Server-Appliance-6.7.0.XXXX-YYYYYYY_OVF10.ova" establece la ruta de acceso G:\vcsa\VMware-vCenter-Server-Appliance-6.7.0.XXXX-YYYYYYY_OVF10.ova.

Los valores booleanos deben contener únicamente caracteres en minúsculas; es decir, un valor puede ser true o false. Por ejemplo, "ssh_enable":false.
(opcional) Para validar un archivo JSON, utilice un editor JSON de su elección.
Guárdelo en formato UTF-8 y cierre el archivo.

Qué hacer a continuación

Puede crear y guardar plantillas adicionales, si fuera necesario, para la especificación de actualización.

Plantillas JSON para la actualización de CLI de vCenter Server Appliance

El instalador de vCenter Server Appliance contiene plantillas JSON que están ubicadas en el directorio vcsa-cli-installer/templates. En la subcarpeta upgrade, puede encontrar las plantillas JSON con los parámetros de configuración mínimos para todo tipo de actualización.

Por cada tipo de actualización, existe una plantilla para implementar el dispositivo nuevo en un host ESXi y otra plantilla para implementar el dispositivo nuevo en una instancia de vCenter Server.

Tabla 1. Actualizar las plantillas JSON que se incluyen en el instalador de vCenter Server Appliance
Ubicación	Plantilla	Descripción
vcsa-cli-installer\templates\upgrade\vcsa\6.7	embedded_vCSA_on_ESXi.json	Contiene los parámetros de configuración mínimos que son obligatorios para actualizar una instancia de vCenter Server Appliance 6.7 con una instancia integrada de Platform Services Controller a vCenter Server Appliance 8.0 en un host ESXi.
	embedded_vCSA_on_VC.json	Contiene los parámetros de configuración mínimos que son obligatorios para actualizar una instancia de vCenter Server Appliance 6.7 con una instancia integrada de Platform Services Controller a vCenter Server Appliance 8.0 en una instancia de vCenter Server.
	vCSA_on_ESXi.json	Contiene los parámetros de configuración mínimos que son obligatorios para actualizar una instancia de vCenter Server Appliance 6.7 con una instancia externa de Platform Services Controller a vCenter Server Appliance 8.0 en un host ESXi.
	vCSA_on_VC.json	Contiene los parámetros de configuración mínimos que son obligatorios para actualizar una instancia de vCenter Server Appliance 6.7 con una instancia externa de Platform Services Controller a vCenter Server Appliance 8.0 en una instancia de vCenter Server.
vcsa-cli-installer\templates\upgrade\vcsa\7.0	embedded_vCSA_on_ESXi.json	Contiene los parámetros de configuración mínimos que son obligatorios para actualizar una instancia de vCenter Server Appliance 7.0 con una instancia integrada de Platform Services Controller a vCenter Server Appliance 8.0 en un host ESXi.
vcsa-cli-installer\templates\upgrade\vcsa\7.0	embedded_vCSA_on_VC.json	Contiene los parámetros de configuración mínimos que son obligatorios para actualizar una instancia de vCenter Server Appliance 7.0 con una instancia integrada de Platform Services Controller a vCenter Server Appliance 8.0 en una instancia de vCenter Server.

Acerca de la actualización de una instancia de vCenter Server con una instancia de Platform Services Controller externa mediante la CLI

Cuando se actualiza una instancia de vCenter Server Appliance que utiliza una instancia externa de Platform Services Controller, esta se convierte en una instancia de vCenter Server con esos servicios integrados en el dispositivo. Por este motivo, debe especificar los parámetros del socio de replicación en las plantillas de actualización JSON.

Al actualizar una instancia de vCenter Server Appliance que utiliza una instancia externa de Platform Services Controller, debe especificar los parámetros del socio de replicación en la plantilla de actualización JSON. Estos parámetros indican si la actualización se realiza para uno de los siguientes escenarios de actualización de vCenter Server y Platform Services Controller.

Una única instancia de vCenter Server y una única instancia de Platform Services Controller dentro de un dominio de SSO.
La primera instancia de vCenter Server y Platform Services Controller dentro de un dominio SSO que contiene más de una instancia de vCenter Server.
La replicación de instancias de vCenter Server y Platform Services Controller dentro de un dominio SSO, que debe apuntar a una instancia existente de vCenter Server 7.0 como el socio de replicación.

Importante: No es posible actualizar una instancia de Platform Services Controller externa. El proceso de actualización converge los servicios de Platform Services Controller en vCenter Server Appliance. Para obtener más información, consulte Eliminación de una instancia de Platform Services Controller.

A menudo, las implementaciones que utilizan una instancia externa de Platform Services Controller se denominan una implementación de MxN, donde M representa a vCenter Server y N representa la instancia externa de Platform Services Controller. Al representar varias instancias de vCenter Server y Platform Services Controller en un dominio, esto se expresa como MnxNn, donde n es el número de instancias. Por ejemplo, M2xN2 indica dos instancias de vCenter Server y dos instancias de Platform Services Controller dentro del mismo dominio. Al actualizar una implementación de este tipo, primero debe actualizar una instancia a la versión 8.0 y, a continuación, actualizar la segunda instancia a 8.0, especificando que la primera de las dos instancias es el socio de replicación.

Los parámetros de replicación de la plantilla de actualización JSON se encuentran en la sección sso de la plantilla y son first_instance y replication_partner_hostname.

Nombre de parámetro	Descripción
`first_instance`	El parámetro `first_instance` identifica a vCenter Server como la primera instancia del dominio SSO de vCenter Server o bien como un socio de replicación. Si es la primera instancia de vCenter Server, establezca `first_instance` en `true`. Para las instancias adicionales de vCenter Server del mismo dominio SSO, establezca `first_instance` en `false`.
`replication_partner_hostname` *	Si establece `first_instance` en `false`, debe especificar el FQDN o la dirección IP de una instancia de vCenter Server que ya se haya actualizado a la versión 8.0 y cuyo PSC externo haya convergido en vCenter Server Appliance.

Cuando realiza la actualización de la CLI de una única instancia de vCenter Server Appliance que utiliza una instancia externa de Platform Services Controller, el proceso es el siguiente:

Actualice la instancia de vCenter Server en su topología mediante la plantilla vCSA_on_ESXi.json cuando se actualice en ESXi o la plantilla vCSA_on_VC.json cuando la actualización se realice en una implementación de vCenter Server.
En el caso de una topología de implementación que conste de una única instancia de vCenter Server y una de Platform Services Controller (una implementación del tipo M1xN1), edite la sección sso de la plantilla de forma que el parámetro first_instance se establezca en true y elimine el parámetro replication_partner_hostname.
```
"sso": {
"__comments": [ This is the first instance (M1) vCenter Server management node, with "first_instance" set to "true" and "replication_partner_hostname" removed.
],
"first_instance": true
}
```
Especifique los parámetros de configuración de la actualización restantes en la plantilla JSON y actualice vCenter Server a la versión 8.0 mediante la CLI. Consulte Actualizar una instancia de vCenter Server Appliance mediante la interfaz CLI.
Una vez que vCenter Server se actualice correctamente, retire Platform Services Controller. Consulte Retirar la instancia de Platform Services Controller.
Importante: Retire las instancias de Platform Services Controller únicamente después de actualizar y converger todas las instancias de vCenter Server de la topología.

En el caso de una implementación que conste de dos o más instancias de vCenter Server y Platform Services Controller (una implementación del tipo M2xN2), primero debe actualizar la instancia M1 de vCenter Server a la versión 8.0 y, a continuación, actualizar la segunda instancia de vCenter Server de replicación.

Actualice las instancias de vCenter Server en su implementación mediante la plantilla vCSA_on_ESXi.json cuando se actualice en ESXi o la plantilla vCSA_on_VC.json cuando la actualización se realice en una implementación de vCenter Server.

Para la primera instancia de vCenter Server ( M1), edite la sección sso de la plantilla de modo que el parámetro first_instance se establezca en true y elimine el parámetro replication_partner_hostname.

"sso": {
"__comments": [ This is the first instance (M1) vCenter Server management node, with "first_instance" set to "true" and "replication_partner_hostname" removed.
],
"first_instance": true
}

Para la instancia de vCenter Server que queda ( M2), edite la sección sso de la plantilla de modo que el parámetro first_instance se establezca en false y proporcione el FQDN o la dirección IP de la instancia de vCenter Server en la que desea replicar el segundo nodo. El socio de replicación es la primera instancia de vCenter Server ( M1) que actualizó a la versión 8.0, la cual se ha convergido con su instancia de Platform Services Controller.
```
"sso": {
"__comments": [ This is the second instance (M2) vCenter Server management node, with "first_instance" set to "false" and "replication_partner_hostname" set to the hostname of the replication partner.],
"first_instance": false,
"replication_partner_hostname": "FQDN_or_IP_address"
```
Especifique los parámetros de la configuración de actualización restantes en las plantillas JSON y finalice la actualización mediante la CLI. Consulte Actualizar una instancia de vCenter Server Appliance mediante la interfaz CLI.
Después de actualizar correctamente todas las instancias de vCenter Server de la topología, retire las instancias de Platform Services Controller. Consulte Retirar la instancia de Platform Services Controller.
Importante: Retire las instancias de Platform Services Controller únicamente después de actualizar y converger todas las instancias de vCenter Server de la topología.

Actualizar los parámetros de configuración para la actualización de la CLI de vCenter Server Appliance

Cuando se preparan los archivos de configuración JSON para la actualización de CLI, es necesario establecer parámetros y valores con el fin de proporcionar los datos de entrada para la actualización de una instancia de vCenter Server Appliance.

Secciones y subsecciones de los parámetros de configuración en los archivos de actualización JSON

Los parámetros de configuración en los archivos de configuración JSON para la actualización de CLI se organizan en secciones y subsecciones.

Tabla 2. Secciones y subsecciones de los parámetros de configuración en los archivos de actualización JSON
Sección	Subsección	Descripción
`new_vcsa`: describe el dispositivo nuevo que desea implementar.	`esxi`	Se utiliza únicamente si se desea implementar el nuevo dispositivo directamente en un host ESXi. Contiene los parámetros de configuración que describen el host ESXi de destino. Consulte Parámetros de configuración en la sección `new_vcsa`, subsección `esxi`. Nota: Es necesario completar esta subsección o la subsección `vc`.
	`vc`	Se utiliza únicamente si se desea implementar el nuevo dispositivo en el inventario de una instancia de vCenter Server. Se incluyen los parámetros de configuración que describen el host ESXi o el clúster de DRS de destino del inventario de vCenter Server. Consulte Parámetros de configuración en la sección `new_vcsa`, subsección `vc`. Nota: Es necesario completar esta subsección o la subsección `esxi`. La instancia de vCenter Server de destino no puede ser el dispositivo de vCenter Server Appliance que se desea actualizar. En esos casos se debe utilizar la subsección `esxi`.
	`appliance`	Se incluyen los parámetros de configuración que describen el nuevo dispositivo. Consulte Parámetros de configuración en la sección `new_vcsa`, subsección `appliance`
	`os`	Se incluye únicamente el parámetro de configuración `ssh_enable` para establecer el inicio de sesión del administrador de SSH en el nuevo dispositivo.
	`ovftool_arguments`	Opcional. Utilice esta subsección para agregar argumentos arbitrarios con sus valores al comando de OVF Tool generado por el instalador. Importante: El instalador de vCenter Server Appliance no valida los parámetros de configuración en la subsección de `ovftool_arguments`. Si se establecen argumentos que OVF Tool no reconoce, es posible que se produzcan errores en la implementación.
	`temporary_network`	Se incluyen los parámetros de configuración que describen la configuración de red temporal del nuevo dispositivo. Consulte Parámetros de configuración en la sección `new_vcsa`, subsección `temporary_network`
	`user_options`	Se incluye solamente el parámetro de configuración `vcdb_migrateSet` para establecer los tipos de datos que se desea transferir del antiguo dispositivo al nuevo dispositivo. Consulte Parámetros de configuración en la sección `new_vcsa`, subsección `user_options`
`source_vc`: describe el dispositivo existente que se desea actualizar.	`managing_esxi_or_vc`	Se incluyen los parámetros de configuración que describen el host ESXi de origen o la instancia de vCenter Server Appliance en la que reside el dispositivo que se desea actualizar. Consulte Parámetros de configuración en la sección `source_vc`, subsección `managing_esxi_or_vc`.
	`vc_vcsa`	Se incluyen los parámetros de configuración que describen el dispositivo de origen que se desea actualizar. Consulte Parámetros de configuración en la sección `source_vc`, subsección `vc_vcsa`.
`source_vum`: describe la instancia de VMware Update Manager de origen. Utilice esta sección si desea ejecutar automáticamente Migration Assistant en la instancia de VMware Update Manager.	`run_migration_assistant`	Es opcional si la instancia de origen de vCenter Server Appliance que desea actualizar está conectada con una instancia de VMware Update Manager que se ejecuta en una máquina virtual de Windows. Utilice esta subsección si desea ejecutar automáticamente Migration Assistant en la instancia de origen de VMware Update Manager. Se incluyen los parámetros de configuración que describen la instancia de origen de VMware Update Manager, la cual se migrará a la nueva instancia de vCenter Server Appliance actualizada. Consulte Parámetros de configuración en la sección `source_vum`, subsección `run_migration_assistant`. Nota: La instancia de Migration Assistant utiliza el puerto 9123 de manera predeterminada. Si otro servicio del equipo de Update Manager usa el puerto 9123, Migration Assistant automáticamente encuentra otro puerto libre. No se puede establecer un puerto personalizado para Migration Assistant.
`ceip`: describe la unión al programa de mejora de la experiencia de cliente (Customer Experience Improvement Program, CEIP) de VMware.	`settings`	Se incluye solamente el parámetro de configuración `ceip_enabled` para unirse o no unirse al programa de mejora de la experiencia de cliente (Customer Experience Improvement Program, CEIP) de VMware. Consulte Parámetros de configuración en la sección `ceip`, subsección `settings`. Solo es necesario si se realiza una actualización de vCenter Server Appliance con una instancia integrada de Platform Services Controller o una instancia de Platform Services Controller Appliance. Nota: Si el parámetro de configuración `ceip_enabled` se establece en `true`, es necesario ejecutar el comando de implementación de CLI con el argumento --acknowledge-ceip. Para obtener más información sobre el CEIP, consulte la sección Configurar el Programa de mejora de la experiencia del cliente en Administrar vCenter Server y hosts.

Importante: Los valores de cadena, incluidas las contraseñas, deben contener únicamente caracteres ASCII. No se admiten los caracteres ASCII extendidos ni los caracteres que no sean ASCII.

Para establecer un valor que contiene una barra diagonal inversa (\) o un carácter de comillas ("), debe anteponer a este carácter una barra diagonal inversa (\). Por ejemplo, "password":"my\"password" establece la contraseña my"password y "image":"G:\\vcsa\\VMware-vCenter-Server-Appliance-8.0.0.XXXX-YYYYYYY_OVF10.ova" establece la ruta de acceso G:\vcsa\VMware-vCenter-Server-Appliance-8.0.0.XXXX-YYYYYYY_OVF10.ova.

Los valores booleanos solo deben contener caracteres en minúscula. Pueden ser true o false. Por ejemplo, "ssh_enable":false.

Parámetros de configuración en la sección `new_vcsa`

Tabla 3. Parámetros de configuración en la sección `new_vcsa`, subsección `esxi`
Nombre	Tipo	Descripción
`hostname`	string	La dirección IP o el FQDN del host ESXi de destino donde se desea implementar el nuevo dispositivo.
`username`	string	Un nombre de usuario con privilegios administrativos en el host ESXi de destino (por ejemplo, raíz).
`password`	string	La contraseña del usuario con privilegios administrativos en el host ESXi de destino.
`deployment_network`	string	El nombre de la red a la que se conectará el nuevo dispositivo. La red debe ser parte de la configuración de red del host ESXi de destino o la instancia de vCenter Server Appliance (identificada por el parámetro de configuración `managing_esxi_or_vc`). Nota: Se debe poder acceder a la red desde el host ESXi de origen o la instancia de vCenter Server Appliance (identificada por el parámetro de configuración `managing_esxi_or_vc`) en la que reside el dispositivo que se desea actualizar. Debe poder accederse también a la red desde el equipo cliente donde se está realizando la actualización. Se omite si el host ESXi de destino tiene una sola red.
`datastore`	string	El nombre del almacén de datos donde se desean almacenar los archivos de configuración de la máquina virtual y los discos virtuales del nuevo dispositivo. El almacén de datos debe estar disponible para el host ESXi de destino. Nota: El almacén de datos debe tener al menos 25 GB de espacio libre.
`port`	entero	El puerto de proxy inverso HTTPS del host ESXi de destino. El puerto predeterminado es 443. Se utiliza únicamente si el host ESXi de destino usa un puerto de proxy inverso HTTPS personalizado.
`ssl_certificate_verification`	string	La CLI verifica que el certificado de seguridad de un servidor esté firmado por una entidad de certificación (Certificate Authority, CA) y establece una conexión segura. Si el certificado es autofirmado, la CLI detiene la actualización, a menos que se especifique una de las siguientes opciones de configuración de certificados SSL: Especifique la huella digital de certificado con el algoritmo hash seguro 1 (Secure Hash Algorithm, SHA-1). Una huella digital de certificado es una cadena hexadecimal que identifica de forma exclusiva a un certificado. La huella digital se calcula a partir del contenido del certificado mediante un algoritmo de huella digital. "thumbprint": "`certificate SHA-1 thumbprint`" Establezca `verification_mode` en `NONE`. "verification_mode": "NONE" Si desea conectarse a un servidor con un certificado autofirmado y no especifica la huella digital de certificado SHA-1 ni configura el modo de verificación en `NONE`, la CLI muestra la huella digital del certificado autofirmado del servidor y solicita al usuario que acepte o rechace la huella digital del certificado. También puede indicar que la CLI ignore el certificado autofirmado mediante el parámetro del comando vcsa-deploy upgrade `--no-ssl-certificate-validation`. Consulte Sintaxis del comando de actualización de CLI.

Tabla 4. Parámetros de configuración en la sección `new_vcsa`, subsección `vc`
Nombre	Tipo	Descripción
`hostname`	string	La dirección IP o el FQDN de la instancia de vCenter Server de destino donde se desea implementar el nuevo dispositivo.
`username`	string	El nombre del usuario administrador de vCenter Single Sign-On en la instancia de vCenter Server de destino, por ejemplo, [email protected].
`password`	string	La contraseña del usuario administrador de vCenter Single Sign-On en la instancia de vCenter Server de destino.
`deployment_network`	string	El nombre de la red a la que se conectará el nuevo dispositivo. La red debe ser parte de la configuración de red del host ESXi de destino o del clúster de DRS. Nota: La red debe ser accesible desde el host ESXi de origen en el que reside el dispositivo que se desea actualizar. Debe poder accederse también a la red desde el equipo cliente donde se está realizando la actualización. Se omite si el host ESXi o el clúster de DRS de destino tienen una sola red.
`datacenter`	matriz	El centro de datos de vCenter Server que contiene el host ESXi o el clúster de DRS de destino en el que se desea implementar el dispositivo nuevo. Si el centro de datos se encuentra en una carpeta o una estructura de carpetas, el valor debe especificarse como una lista de cadenas separadas por comas. Por ejemplo, ["parent_folder", "child_folder", "datacenter_name"] Si no existe ninguna ruta de acceso de carpeta en el centro de datos, utilice el nombre del centro de datos. Por ejemplo, ["datacenter_name"] o "datacenter_name" Nota: El valor distingue entre mayúsculas y minúsculas.
`datastore`	string	El nombre del almacén de datos donde se almacenarán todos los archivos de configuración de las máquinas virtuales y los discos virtuales del nuevo dispositivo. Nota: El almacén de datos debe estar disponible para el host ESXi de destino o el clúster de DRS. El almacén de datos debe tener al menos 25 GB de espacio libre.
`port`	entero	El puerto de proxy inverso HTTPS de la instancia de vCenter Server de destino. El puerto predeterminado es 443. Se utiliza únicamente si la instancia de vCenter Server de destino usa un puerto de proxy inverso HTTPS personalizado.
`target`	matriz	El clúster de destino, el host ESXi o el grupo de recursos donde se desea implementar el nuevo dispositivo. Este es el destino especificado con el parámetro `datacenter`. Esta ruta de acceso debe terminar con un nombre de clúster, un nombre de host ESXi o un nombre de grupo de recursos. Importante: Es necesario proporcionar el nombre que se muestra en el inventario de vCenter Server. Por ejemplo, si el nombre del host ESXi de destino es una dirección IP en el inventario de vCenter Server, no se puede proporcionar un FQDN. Nota: Todos los valores distinguen mayúsculas de minúsculas. Si desea que el dispositivo implementado se muestre en otro lugar dentro de la jerarquía del centro de datos, utilice el parámetro vm_folder que se describe a continuación en esta sección. Si el clúster de destino, el host ESXi o el grupo de recursos se encuentran en una carpeta o una estructura de carpetas, el valor debe especificarse como una lista de cadenas separadas por comas. Por ejemplo, ["parent_folder", "child_folder", "esxi-host.domain.com"] Si el host de ESXi de destino forma parte de un clúster, especifique la ruta como una lista de cadenas separadas por comas. Por ejemplo, ["cluster_name","esxi-host.domain.com"] Si desea implementar en un grupo de recursos, incluya la etiqueta Resources antes del nombre del grupo de recursos. Por ejemplo: ["cluster_name", "Resources", "resource_pool_name"] Nota: Las comprobaciones previas solo verifican la memoria del grupo de recursos.
`vm_folder`	string	Opcional. El nombre de la carpeta de máquina virtual a la que se agregará el dispositivo nuevo.

Tabla 5. Parámetros de configuración en la sección `new_vcsa`, subsección `appliance`
Nombre	Tipo	Descripción
`thin_disk_mode`	Booleano	Se establece en `true` para implementar el nuevo dispositivo con discos virtuales finos.
`deployment_option`	string	El tamaño del dispositivo nuevo. Nota: Debe tener en cuenta el tamaño de la base de datos del dispositivo que desea actualizar. Para ver una base de datos externa, consulte Determinar el tamaño de la base de datos de Oracle y el tamaño de almacenamiento del nuevo dispositivo. Se establece en `tiny` si se desea implementar una instancia de vCenter Server Appliance para hasta 10 hosts y 100 máquinas virtuales con el tamaño de almacenamiento predeterminado. Se implementa un dispositivo con 2 CPU, 10 GB de memoria y 300 GB de almacenamiento. Se establece en `tiny-lstorage` si se desea implementar una instancia de vCenter Server Appliance para hasta 10 hosts y 100 máquinas virtuales con el tamaño de almacenamiento grande. Se implementa un dispositivo con 2 CPU, 10 GB de memoria y 825 GB de almacenamiento. Se establece en `tiny-xlstorage` si se desea implementar una instancia de vCenter Server Appliance para hasta 10 hosts y 100 máquinas virtuales con el tamaño de almacenamiento extragrande. Se implementa un dispositivo con 2 CPU, 10 GB de memoria y 1.700 GB de almacenamiento. Se establece en `small` si se desea implementar una instancia de vCenter Server Appliance para hasta 100 hosts y 1.000 máquinas virtuales con el tamaño de almacenamiento predeterminado. Se implementa un dispositivo con 4 CPU, 16 GB de memoria y 340 GB de almacenamiento. Se establece en `small-lstorage` si se desea implementar una instancia de vCenter Server Appliance para hasta 100 hosts y 1.000 máquinas virtuales con el tamaño de almacenamiento grande. Se implementa un dispositivo con 4 CPU, 16 GB de memoria y 870 GB de almacenamiento. Se establece en `small-xlstorage` si se desea implementar una instancia de vCenter Server Appliance para hasta 100 hosts y 1.000 máquinas virtuales con el tamaño de almacenamiento extragrande. Se implementa un dispositivo con 4 CPU, 16 GB de memoria y 1.750 GB de almacenamiento. Se establece en `medium` si se desea implementar una instancia de vCenter Server Appliance para hasta 400 hosts y 4.000 máquinas virtuales con el tamaño de almacenamiento predeterminado. Se implementa un dispositivo con 8 CPU, 24 GB de memoria y 525 GB de almacenamiento. Se establece en `medium-lstorage` si se desea implementar una instancia de vCenter Server Appliance para hasta 400 hosts y 4.000 máquinas virtuales con el tamaño de almacenamiento grande. Se implementa un dispositivo con 8 CPU, 24 GB de memoria y 1.025 GB de almacenamiento. Se establece en `medium-xlstorage` si se desea implementar una instancia de vCenter Server Appliance para hasta 400 hosts y 4.000 máquinas virtuales con el tamaño de almacenamiento extragrande. Se implementa un dispositivo con 8 CPU, 24 GB de memoria y 1.905 GB de almacenamiento. Se establece en `large` si se desea implementar una instancia de vCenter Server Appliance para hasta 1.000 hosts y 10.000 máquinas virtuales con el tamaño de almacenamiento predeterminado. Se implementa un dispositivo con 16 CPU, 32 GB de memoria y 740 GB de almacenamiento. Se establece en `large-lstorage` si se desea implementar una instancia de vCenter Server Appliance para hasta 1.000 hosts y 10.000 máquinas virtuales con el tamaño de almacenamiento grande. Se implementa un dispositivo con 16 CPU, 32 GB de memoria y 1.090 GB de almacenamiento. Se establece en `large-xlstorage` si se desea implementar una instancia de vCenter Server Appliance para hasta 1.000 hosts y 10.000 máquinas virtuales con el tamaño de almacenamiento extragrande. Se implementa un dispositivo con 16 CPU, 32 GB de memoria y 1.970 GB de almacenamiento. Se establece en `xlarge` si se desea implementar una instancia de vCenter Server Appliance para hasta 2.000 hosts y 35.000 máquinas virtuales con el tamaño de almacenamiento predeterminado. Se implementa un dispositivo con 24 CPU, 48 GB de memoria y 1.180 GB de almacenamiento. Se establece en `xlarge-lstorage` si se desea implementar una instancia de vCenter Server Appliance para hasta 2.000 hosts y 35.000 máquinas virtuales con el tamaño de almacenamiento grande. Se implementa un dispositivo con 24 CPU, 48 GB de memoria y 1.230 GB de almacenamiento. Se establece en `xlarge-xlstorage` si se desea implementar una instancia de vCenter Server Appliance para hasta 2.000 hosts y 35.000 máquinas virtuales con el tamaño de almacenamiento extragrande. Se implementa un dispositivo con 24 CPU, 48 GB de memoria y 2.110 GB de almacenamiento. Se establece en `management-tiny` si se desea implementar una instancia de vCenter Server Appliance con una instancia externa de Platform Services Controller para hasta 10 hosts y 100 máquinas virtuales con el tamaño de almacenamiento predeterminado. Se implementa un dispositivo con 2 CPU, 10 GB de memoria y 300 GB de almacenamiento.
`image`	string	Opcional. Una dirección URL o una ruta de acceso de archivo local al paquete de instalación de vCenter Server Appliance. De forma predeterminada, el instalador utiliza el paquete de instalación que se incluye en el archivo ISO de la carpeta vcsa.
`name`	string	El nombre de la máquina virtual para el nuevo dispositivo. Solo se deben incluir caracteres ASCII, excepto el signo de porcentaje (%), la barra diagonal inversa (\) o la barra diagonal (/), y no se deben superar los 80 caracteres de longitud.
`ovftool_path`	string	Opcional. Una ruta de acceso de archivo local al archivo ejecutable de OVF Tool. De forma predeterminada, el instalador utiliza la instancia de OVF Tool que se incluye en el archivo ISO de la carpeta vcsa/ovftool.
`license`	string	Opcional. Clave de licencia que se aplicará al dispositivo . Si no se proporciona la clave de licencia, se utilizará la licencia de evaluación.

Tabla 6. Parámetros de configuración en la sección `new_vcsa`, subsección `temporary_network`
Nombre	Tipo	Descripción
`ip_family`	string	La versión de IP para la red temporal del nuevo dispositivo. Se establece en `ipv4` o `ipv6`.
`mode`	string	La asignación de IP para la red temporal del nuevo dispositivo. Se establece en `static` o `dhcp`.
`ip`	string	La dirección IP temporal del nuevo dispositivo. Solo se requiere si se utiliza una asignación estática, es decir, si se establece el parámetro `mode` en `static`. Es necesario establecer una dirección IPv4 o IPv6 que coincida con la versión de IP de la red temporal, es decir, con el valor del parámetro `ip.family`. Una dirección IPv4 debe cumplir con las directrices RFC 790. Una dirección IPv6 debe cumplir con las directrices RFC 2373.
`dns_servers`	cadena o matriz	Las direcciones IP de uno o varios servidores DNS para la red temporal del nuevo dispositivo. Para establecer más de un servidor DNS, utilice una lista de cadenas separada por comas o una lista separada por comas como una sola cadena para proporcionar la ruta de acceso. Por ejemplo, ["x.y.z.a", "x.y.z.b"] o "x.y.z.a, x.y.z.b" Solo se requiere si se utiliza el modo de red estático para la asignación de direcciones IP temporales, es decir, si se establece el parámetro `mode` en `static`.
`prefix`	string	La longitud del prefijo de red para la red temporal del nuevo dispositivo. Usar solo si el parámetro `mode` se establece en `static`. Eliminar si el parámetro `mode` se establece en `dhcp`. La longitud del prefijo de red es el número de bits que se establecen en la máscara de subred. Por ejemplo, si la máscara de subred es 255.255.255.0, hay 24 bits en la versión binaria de la longitud del prefijo, por lo que la longitud del prefijo de red es 24. Para la versión de IPv4, el valor debe estar entre `0` y `32`. Para la versión de IPv6, el valor debe estar entre `0` y `128`.
`gateway`	string	La dirección IP de la puerta de enlace predeterminada para la red temporal del nuevo dispositivo. Para la versión de IPv6, el valor puede ser `default`.

Tabla 7. Parámetros de configuración en la sección `new_vcsa`, subsección `user_options`
Nombre	Tipo	Descripción
`vcdb_migrateSet`	string	Seleccione los tipos de datos que desea migrar del dispositivo antiguo al dispositivo nuevo. Los datos se copian desde la instancia de vCenter Server de origen en el servidor de destino. El origen de datos original permanece sin cambios. Se establece en `core` si solo se desea transferir los datos de configuración. Esta opción proporciona la migración de datos más rápida y mantiene el periodo de inactividad del sistema al mínimo. Se establece en `core_events_tasks` si se desean transferir los datos de configuración y los datos históricos (eventos y tareas) de inmediato. vCenter Server no se iniciará hasta que se hayan migrado todos los datos desde la instancia de origen de vCenter Server Appliance. Se establece en `all` si se desean transferir los datos de configuración, los datos históricos y las métricas de rendimiento de inmediato. vCenter Server no se iniciará hasta que se hayan migrado todos los datos de la instancia de origen de vCenter Server para Windows. Esta opción transfiere la mayor cantidad de datos y requiere más tiempo de inactividad que otras opciones de migración de datos. Se establece en `transfer_events_tasks_after_upgrade` si se desean transferir los datos históricos (eventos y tareas) en segundo plano después de que finaliza la actualización. Durante este tiempo, es posible que el rendimiento de vCenter Server no sea óptimo. Se establece en `transfer_stats_events_tasks_after_upgrade` si se desean transferir los datos históricos y los datos de las métricas de rendimiento en segundo plano después de que finalice la actualización. Durante este tiempo, es posible que el rendimiento de vCenter Server no sea óptimo. Nota: Para minimizar el tiempo de actualización y la cantidad de almacenamiento necesario para la nueva instancia de vCenter Server Appliance, use el valor `core`. Para obtener más información sobre los tipos de datos que se pueden transferir desde una instancia existente de vCenter Server a la instancia nueva y actualizada de vCenter Server, consulte Transferir datos desde una instancia existente de vCenter Server Appliance.

Tabla 8. Parámetros de configuración en la sección `new_vcsa`, subsección `sso`
Nombre	Tipo	Descripción
`first_instance`	string	Establezca `first_instance` en `true` si esta es la primera operación de convergencia de actualización en el dominio SSO de vCenter Server o si no desea establecer el socio de replicación para este nodo. Si desea establecer el socio de replicación para este nodo, establezca `first_instance` en `false` y proporcione el valor de `replication_partner_hostname` como el FQDN de un nodo convergido anteriormente que actualmente se encuentra en una topología integrada de vCenter Server. Para obtener más información sobre cómo especificar los parámetros de `first_instance` y `replication_partner_hostname`, consulte Acerca de la actualización de una instancia de vCenter Server con una instancia de Platform Services Controller externa mediante la CLI.
`replication_partner_hostname`	string	Nombre de host del socio de replicación. Se debe eliminar si es `first_instance`.

Parámetros de configuración en la sección `source_vc`

Tabla 9. Parámetros de configuración en la sección `source_vc`, subsección `managing_esxi_or_vc`
Nombre	Tipo	Descripción
`hostname`	string	La dirección IP o el FQDN del host ESXi o vCenter Server de origen donde reside el dispositivo que se desea actualizar.
`username`	string	Un nombre de usuario con privilegios administrativos en el host ESXi de origen (por ejemplo, raíz).
`password`	string	La contraseña de un usuario con privilegios administrativos en el host ESXi de origen.
`port`	entero	El puerto de proxy inverso HTTPS del host ESXi de origen. El puerto predeterminado es 443. Se utiliza únicamente si el host ESXi de origen usa un puerto de proxy inverso HTTPS personalizado.

Tabla 10. Parámetros de configuración en la sección `source_vc`, subsección `vc_vcsa`
Nombre	Tipo	Descripción
`hostname`	string	La dirección IP o el FQDN del dispositivo de origen que se desea actualizar.
`username`	string	El usuario administrador de vCenter Single Sign-On en el dispositivo de origen (por ejemplo, [email protected]). Importante: El usuario debe ser administrator@ `su_nombre_de_dominio`.
`password`	string	La contraseña del usuario administrador de vCenter Single Sign-On en el dispositivo de origen.
`root_password`	string	La contraseña para el usuario raíz del sistema operativo del dispositivo de origen.
`export_dir`	string	El directorio para exportar la configuración y los datos de origen.

Parámetros de configuración en la sección `source.vum`

Tabla 11. Parámetros de configuración en la sección `source_vum`, subsección `run_migration_assistant`
Nombre	Tipo	Descripción
`esxi_hostname`	string	La dirección IP o el FQDN del host ESXi donde se encuentra la instancia de origen de VMware Update Manager. Si se proporciona un FQDN, ese nombre debe poder resolverse desde el equipo cliente donde se ejecuta la actualización.
`esxi_username`	string	Un nombre de usuario con privilegios administrativos en el host ESXi (por ejemplo, raíz).
`esxi_password`	string	La contraseña de un usuario con privilegios administrativos en el host ESXi.
`esxi_port`	string	El puerto de proxy inverso HTTPS del host ESXi. El puerto predeterminado es 443. Se utiliza únicamente si el host ESXi usa un puerto de proxy inverso HTTPS personalizado.
`vum_hostname`	string	La dirección de IP o el FQDN de la máquina virtual de Windows en la que se ejecuta la instancia de VMware Update Manager de origen. Si se proporciona un FQDN, ese nombre debe poder resolverse desde el equipo cliente donde se ejecuta la actualización.
`vum_os_username`	string	El nombre de usuario administrador de la máquina virtual de Windows en la que se ejecuta la instancia de VMware Update Manager de origen.
`vum_os_password`	string	La contraseña de administrador de la máquina virtual de Windows en la que se ejecuta la instancia de VMware Update Manager de origen. Si no se provee, se solicita que introduzca la contraseña en la consola de comandos durante la comprobación de la plantilla.
`export_dir`	string	El directorio para exportar la configuración y los datos de origen.

Parámetros de configuración en la sección `ceip`

Tabla 12. Parámetros de configuración en la sección `ceip`, subsección `settings`
Nombre	Tipo	Descripción
`ceip_enabled`	Booleano	Se establece en `true` para unirse al CEIP en el nuevo dispositivo actualizado.