El instalador de CLI se puede utilizar para migrar automáticamente una instancia de vCenter Servero Platform Services Controller desde Windows a un dispositivo.

El archivo ISO del instalador contiene plantillas de ejemplo de archivos JSON que contienen parámetros de configuración mínimos requeridos para migrar una instancia de vCenter Server o Platform Services Controller desde Windows a un dispositivo. Las plantillas de ejemplo están ubicadas en el directorio vcsa-cli-installer/templates/migrate.

Nota: Antes de migrar una implementación de vCenter Server mediante una instancia externa de Platform Services Controller, primero debe converger la instancia externa de Platform Services Controller en una instancia integrada de Platform Services Controller y, a continuación, realizar la migración. Consulte el artículo KB 68137 de la base de conocimientos.

Las tareas de CLI para migrar la instalación de vCenter Server de Windows a un dispositivo:

  1. Descargar el instalador de vCenter Server y montarlo.
  2. Descargar y ejecutar VMware Migration Assistant en el equipo Windows de origen.
  3. Preparar los archivos de configuración JSON para la migración de CLI.
  4. Ejecutar la comprobación previa antes de realizar la migración.
  5. Realizar una migración de CLI de vCenter Server de Windows a un dispositivo.

Se puede ejecutar el instalador de CLI varias veces con diferentes archivos JSON para realizar varias migraciones de CLI, o bien se pueden ejecutar las migraciones de CLI de manera simultánea en modo de lotes.

Importante: El nombre de usuario que utiliza para iniciar sesión en la máquina desde la que desea ejecutar el instalador de CLI, la ruta de acceso al instalador de vCenter Server Appliance, la ruta de acceso al archivo de configuración JSON y los valores de cadena del archivo de configuración JSON (incluidas las contraseñas) deben contener solamente caracteres ASCII. No se admiten los caracteres ASCII extendidos ni los caracteres que no sean ASCII.

Preparar los archivos de configuración JSON para la migración de CLI

Cuando se utiliza la CLI para migrar una instalación de vCenter Server de origen a una instancia de vCenter Server Appliance de destino, es necesario preparar una plantilla JSON con los valores de configuración para el nuevo dispositivo.

Es posible migrar instancias de vCenter Server o Platform Services Controller de Windows a una instancia de vCenter Server Appliance si se establecen valores para los parámetros de configuración en las plantillas disponibles en el archivo ISO del instalador. Los parámetros de configuración no incluidos en las plantillas se establecen en sus valores predeterminados. Es posible agregar parámetros de configuración a las plantillas y establecer sus valores según la especificación de la migración.

El directorio vcsa-cli-installer/templates/migrate contiene plantillas de migración de ejemplo para la migración de CLI de vCenter Server 6.7 hacia un dispositivo.

Para conocer la lista completa de parámetros de configuración y sus descripciones, desplácese hasta el subdirectorio del instalador de su sistema operativo y ejecute el comando vcsa-deploy migrate --template-help.
Importante: El nombre de usuario que utilizará para iniciar sesión en la máquina desde donde desea ejecutar el instalador de CLI, la ruta de acceso al instalador de vCenter Server Appliance, la ruta de acceso al archivo de configuración JSON y sus valores de cadena, incluidas las contraseñas, deben contener solamente caracteres ASCII. No se admiten los caracteres ASCII extendidos ni los caracteres que no sean ASCII.

Para realizar la migración por lotes, coloque las plantillas JSON de definición de la implementación en un solo directorio. Cuando se invoca, el instalador de CLI migra la implementación existente a la nueva versión de vCenter Server mediante la topología definida en las plantillas JSON.

Requisitos previos

Compruebe que el entorno cumpla con los requisitos de la migración. Consulte Requisitos del sistema para migrar implementaciones de vCenter Server a implementaciones de vCenter Server Appliance,

Prepare el entorno para la migración. Consulte Preparación para la migración.

Procedimiento

  1. Abra la subcarpeta migrate en el directorio vcsa-cli-installer/templates.
  2. Copie la plantilla de migración de la subcarpeta migrate a su área de trabajo. Para vCenter Server 6.7, utilice la carpeta migrate/winvc6.7/.
  3. 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.
  4. Complete los valores para los parámetros de configuración requeridos y, si lo desea, introduzca parámetros adicionales y sus valores.
    Importante: 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":"C:\\vmware\\vcsa" establece la ruta de acceso C:\vmware\vcsa.

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

  5. Guárdelo en formato UTF-8 y cierre el archivo.

Resultados

El archivo estará listo para usarse en la migración.

Qué hacer a continuación

Es posible crear y guardar tantas plantillas como sean necesarias para cada entorno. Una vez lista la plantilla, ejecute una comprobación previa antes de usarla para realizar la migración. Consulte Ejecutar una comprobación previa antes de una migración de CLI a vCenter Server Appliance.

Plantillas JSON para la migración de CLI de vCenter Server para Windows

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

Tabla 1. Migración de las plantillas JSON que se incluyen en el instalador de vCenter Server
Ubicación Plantilla Descripción
vcsa-cli-installer\templates\migrate\vcsa\winvc6.7 embedded_win_vc_to_embedded_vCSA_on_ESXi.json Contiene los parámetros de configuración mínimos necesarios para migrar vCenter Server 6.7 en Windows con una instancia de Platform Services Controller integrada a una instancia de vCenter Server Appliance 8.0 en un host ESXi.
embedded_win_vc_to_embedded_vCSA_on_VC.json Contiene los parámetros de configuración mínimos necesarios para migrar vCenter Server 6.7 en Windows con una instancia de Platform Services Controller integrada a vCenter Server Appliance 8.0 en una instancia de vCenter Server.
win_vc_to_vCSA_on_ESXi.json Contiene los parámetros de configuración mínimos necesarios para migrar vCenter Server 6.7 en Windows con una instancia de Platform Services Controller externa a una instancia de vCenter Server Appliance 8.0 en un host ESXi.
win_vc_to_vCSA_on_VC.json.json Contiene los parámetros de configuración mínimos necesarios para migrar vCenter Server 6.7 en Windows con una instancia de Platform Services Controller externa a una instancia de vCenter Server Appliance 8.0 en una instancia de vCenter Server.

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

Al migrar una instancia de vCenter Server para Windows 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 migración JSON.

Al migrar una instancia de vCenter Server para Windows que utiliza una instancia externa de Platform Services Controller, debe especificar los parámetros del socio de replicación en la plantilla de migración JSON. Estos parámetros indican si la migración se realiza para uno de los siguientes escenarios de migració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: Antes de migrar una implementación de vCenter Server mediante una instancia externa de Platform Services Controller, primero debe converger la instancia externa de Platform Services Controller en una instancia integrada de Platform Services Controller y, a continuación, realizar la migración. 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 migrar una implementación de este tipo, primero debe migrar una instancia a la versión 8.0 y, a continuación, migrar 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 migració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 migrado a la versión 8.0 y cuyo PSC externo haya convergido en vCenter Server Appliance.

Cuando realiza la migración de la CLI de una única instancia de vCenter Server para Windows que utiliza una instancia externa de Platform Services Controller, el proceso es el siguiente:
  1. Migre vCenter Server en su topología mediante la plantilla win_vc_to_vCSA_on_ESXi.json cuando se migre en ESXi o la plantilla win_vc_to_vCSA_on_VC.json cuando la migración se realice en una implementación de vCenter Server.

  2. 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
    }
  3. Especifique los parámetros de configuración restantes en la plantilla JSON y migre vCenter Server a la versión 8.0 mediante la CLI. Consulte Realizar una migración de CLI de vCenter Server de Windows a un dispositivo.
  4. Una vez que vCenter Server se migre 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 migrar 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 migrar la instancia M1 de vCenter Server a la versión 8.0 y, a continuación, migrar la segunda instancia de vCenter Server de replicación.
  1. Migre vCenter Server en su topología mediante la plantilla win_vc_to_vCSA_on_ESXi.json cuando se migre en ESXi o la plantilla win_vc_to_vCSA_on_VC.json cuando la migración se realice en una implementación de vCenter Server.

  2. 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
    }
  3. 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 migró a la versión 8.0, la cual 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"
  4. Especifique los parámetros de configuración restantes en las plantillas JSON y migre vCenter Server a la versión 8.0 mediante la CLI. Consulte Realizar una migración de CLI de vCenter Server de Windows a un dispositivo.
  5. Después de migrar 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 migrar y converger todas las instancias de vCenter Server de la topología.

Parámetros de configuración de la migración

Cuando se usa el instalador de CLI para migrar la instalación de vCenter Server a un dispositivo, se deben proporcionar los parámetros con valores para la especificación de migración.

En la tabla, se incluyen los parámetros de configuración destinados a proporcionar datos de entrada para la instancia de origen de vCenter Server.

Importante: La ruta de acceso al instalador de vCenter Server Appliance, la ruta de acceso al archivo de configuración JSON y sus valores de cadena, incluidas las contraseñas, deben contener solamente 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":"C:\\vmware\\vcsa" establece la ruta de acceso C:\vmware\vcsa.

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

Secciones y subsecciones de los parámetros de configuración en las plantillas de migración JSON

Los parámetros de configuración en las plantillas de migración JSON se organizan en secciones y subsecciones.

Tabla 2. Secciones y subsecciones de los parámetros de configuración en las plantillas de migración JSON
Sección Subsección Descripción
new_vcsa: describe el dispositivo de destino al que desea migrar. esxi Se utiliza únicamente si se desea implementar el dispositivo directamente en un host ESXi.
Contiene los parámetros de configuración que describen el host ESXi de destino.
Nota: Es necesario completar la subsección esxi o vc.
vc Se utiliza únicamente si se desea implementar el 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.

Nota: Es necesario completar la subsección vc o esxi.
appliance Se incluyen los parámetros de configuración que describen el dispositivo.
os Se incluyen los parámetros de configuración que describen la configuración del sistema operativo del dispositivo.
ovftool_arguments Subsección opcional para agregar argumentos arbitrarios y 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 Contiene los parámetros de configuración que describen la red temporal para migrar los datos del dispositivo de origen al nuevo dispositivo de destino.
user-options Debe usarse solamente cuando la instancia de origen es una instancia de vCenter Server. Contiene los parámetros de configuración que permiten controlar aspectos del proceso de migración para componentes en particular.
source_vc: describe la instancia de origen de vCenter Server, vCenter Single Sign-On o Platform Services Controller. vc_win Contiene los parámetros de configuración que describen la instalación de origen en Windows de vCenter Server o Platform Services Controller.
run_migration_assistant Debe usarse solamente si la instalación de origen en Windows se ejecuta como una máquina virtual y se busca automatizar la invocación de Migration Assistant. En una instalación de origen en Windows que se ejecuta en un equipo físico, o si se está ejecutando Migration Assistant manualmente en el equipo Windows de origen, copie y pegue el valor de huella digital de la salida de la consola de Migration Assistant del equipo de origen en la clave migration_ssl_thumbprint de la subsección vc_win; luego, elimine la sección run_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.

Solo es necesario si implementa un dispositivo de vCenter Server.

Nota: Si se establece en true, se debe 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.

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 en el que se desea implementar el 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 dispositivo.
Nota: El acceso a la red debe ser posible desde el host ESXi de destino.

Se omite si el host ESXi de destino tiene una sola red.

datastore string El nombre del almacén de datos en el que se almacenarán todos los archivos de configuración de las máquinas virtuales y los discos virtuales del dispositivo.
Nota: Debe ser posible acceder al almacén de datos desde el host ESXi.

El almacén de datos debe tener suficiente espacio libre.

port entero El número de puerto del host ESXi. El puerto predeterminado es 443.
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": "huella digital SHA-1 de certificado "

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 para 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 migració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 en el que se desea implementar el 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 dispositivo.
Nota: Debe ser posible acceder a la red desde el host ESXi o el clúster de DRS de destino en el que se desea implementar el dispositivo.

Se omite si el host ESXi o el clúster de DRS de destino tienen una sola red.

datacenter cadena o 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.
Si el centro de datos se encuentra en una carpeta o una estructura de carpetas, el valor debe ser una lista de cadenas separada por comas o una lista separada por comas como una sola cadena. Por ejemplo,
["parent_folder", "child_folder", "datacenter_name"]
o
"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 en el que se almacenarán todos los archivos de configuración de las máquinas virtuales y los discos virtuales del dispositivo.
Nota: El acceso al almacén de datos debe ser posible desde el host ESXi o el clúster de DRS de destino.

El almacén de datos debe tener al menos 25 GB de espacio libre.

port entero El número de puerto de vCenter Server. El puerto predeterminado es 443.
target cadena o 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 ser una lista de cadenas separada por comas o una lista separada por comas como una sola cadena. Por ejemplo,
["parent_folder", "child_folder", "esxi-host.domain.com"]
o
"parent_folder, child_folder, esxi-host.domain.com"
Si el host ESXi de destino forma parte de un clúster, 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,
["cluster_name", "esxi-host.domain.com"] 
				  
o
"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.
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 dispositivo con discos virtuales finos.
deployment_option string El tamaño del 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.

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 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.

Tabla 6. Parámetros de configuración en la sección new_vcsa, subsección os
Nombre Tipo Descripción
password string La contraseña del usuario raíz del sistema operativo del dispositivo.

La contraseña debe tener entre 8 y 20 caracteres, y debe contener al menos uno de los siguientes tipos de carácter: una mayúscula, una minúscula, un número y un carácter especial, como por ejemplo, un signo de dólar ($), un numeral (#), una arroba (@), un punto (.) o un signo de exclamación (!). Todos los caracteres deben ser caracteres ASCII inferiores sin espacios.

ssh_enable Booleano Se establece en true para habilitar el inicio de sesión del administrador de SSH en el dispositivo.
Tabla 7. 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 del dispositivo.

Se establece en ipv4 o ipv6.

mode string La asignación de IP para la red del dispositivo.

Se establece en static o dhcp.

ip string La dirección IP del 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, 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 Direcciones IP de uno o varios servidores DNS.
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 una asignación estática, es decir, si se establece el parámetro mode en static.

prefix string Longitud del prefijo de red.

Solo se requiere si se utiliza una asignación, es decir, si se establece el parámetro mode en static.

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 Dirección IP de la puerta de enlace predeterminada.

Para la versión de IPv6, el valor puede ser default.

Tabla 8. 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. Esto 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 de la instancia de origen de vCenter Server para Windows.
  • 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 migració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 de una instancia existente de vCenter Server a una instancia nueva y actualizada de vCenter Server, consulte Transferir datos desde una instancia existente de vCenter Server Appliance.

Tabla 9. 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 migración de convergencia en el dominio de 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 migración de una instancia de vCenter Server para Windows con una instancia de Platform Services Controller externa mediante la CLI.

replication_partner_hostname string Nombre de host del socio de replicación. Eliminar si es first_instance

Requisitos para la invocación automática de Migration Assistant

Se puede usar la subsección run_migration_assistant para automatizar la invocación de Migration Assistant. La invocación automática funciona solamente si la instalación de origen en Windows se ejecuta como una máquina virtual.

La cuenta de usuario que se especifica en los parámetros os_username o vum_os_username requiere la elevación al privilegio de administrador. Por ejemplo:
  • La cuenta de administrador de Windows integrada.
  • Una cuenta de usuario con un nombre de usuario no administrador, que forma parte del grupo de administradores locales de Windows.
  • Una cuenta de administrador de dominio con el nombre de usuario Administrador, que forma parte del grupo de administradores locales de Windows.
  • El ID de nombre de usuario debe estar en el formato su_nombre_de_dominio\\user_ID o user_ID@su_nombre_de_dominio.
Restricción: La invocación automática del Asistente de migración no funciona con una cuenta de Windows que requiere la elevación al privilegio de administrador. En su lugar, ejecute el Asistente de migración manualmente en el equipo Windows de origen. Copie y pegue el valor de huella digital de la salida de la consola del Asistente de migración del equipo de origen en la clave migration_ssl_thumbprint de la subsección vc_win y, luego, elimine la sección run_migration_assistant.

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

Tabla 10. Parámetros de configuración en la sección source_vc, subsección vc_win
Nombre Tipo Descripción
hostname string El nombre de host o la dirección IP de la instalación de origen en Windows de vCenter Server o Platform Services Controller que desea migrar.
username string Un nombre de usuario de vCenter Single Sign-On con privilegios administrativos para la instancia de vCenter Server, vCenter Single Sign-On o Platform Services Controller que desea migrar.
password string La contraseña de la instancia de vCenter Server o Platform Services Controller que desea migrar.
migration_port string El número de puerto de Migration Assistant que se muestra en la consola de Migration Assistant. El puerto predeterminado es 9123.
active_directory_domain string El nombre del dominio de Active Directory al que se asocia la instancia de vCenter Server de origen.
active_directory_username string El nombre de usuario administrador del dominio de Active Directory al que se une la instancia de vCenter Server de origen.
active_directory_password string La contraseña de administrador del dominio de Active Directory al que se une la instancia de vCenter Server de origen.
Nota: El instalador comprueba las credenciales introducidas, pero no revisa los privilegios necesarios para agregar el equipo de destino al dominio de Active Directory. Compruebe que las credenciales tengan todos los permisos necesarios para agregar un equipo al dominio de Active Directory.
migration_ssl_thumbprint string La huella digital SSL de Migration Assistant.
Tabla 11. Parámetros de configuración en la sección source_vc, subsección run_migration_assistant
Nombre Tipo Descripción
esxi_hostname string El FQDN o la dirección IP de la instancia de ESXi donde reside la instancia de origen de vCenter Server, vCenter Single Sign-On o Platform Services Controller.
esxi_username string El nombre de usuario de un usuario con privilegios administrativos en el host ESXi.
esxi_password string La contraseña del usuario del host ESXi. Si se omite, se solicita la introducción de la contraseña en la consola de comandos durante la comprobación de la plantilla.
esxi_port string El número de puerto del host ESXi. El puerto predeterminado es 443.
os_username string El nombre de usuario administrador del equipo Windows de origen.
os_password string La contraseña de usuario administrador del equipo Windows de origen. Si se omite, se solicita la introduzca en la consola de comandos durante la comprobación de la plantilla.
migration_ip string La dirección IP del adaptador de red por migrar.
migration_port string El número de puerto de Migration Assistant que se muestra en la consola de Migration Assistant. El puerto predeterminado es 9123.
export_dir string El directorio para exportar la configuración y los datos de origen.
sa_password string La dirección IP de la contraseña correspondiente al usuario de la cuenta de servicio de vCenter Server. Esta opción solamente es necesaria si el servicio de vCenter Server se ejecuta en una cuenta que no es del sistema local. Si se omite, se solicita la introduzca en la consola de comandos durante la comprobación de la plantilla.
Tabla 12. Parámetros de configuración en la sección source_vum, subsección run_migration_assistant
Nombre Tipo Descripción
esxi_hostname string El FQDN o la dirección IP de la instancia de ESXi donde reside la instancia de origen de vCenter Server, vCenter Single Sign-On o Platform Services Controller.
esxi_username string El nombre de usuario de un usuario con privilegios administrativos en el host ESXi.
esxi_password string La contraseña del usuario del host ESXi. Si se omite, se solicita la introducción de la contraseña en la consola de comandos durante la comprobación de la plantilla.
esxi_port string El número de puerto del host ESXi. El puerto predeterminado es 443.
vum_hostname string El FQDN o la dirección IP de la instancia de ESXi donde reside la instancia de origen de Update Manager.
vum_os_username string El nombre de usuario administrador del equipo Windows de origen.
vum_os_password string La contraseña del usuario administrador del equipo Windows de origen de Update Manager. Si se omite, se solicita la introduzca en la consola de comandos durante la comprobación de la plantilla.
migration_port string El número de puerto de Migration Assistant que se muestra en la consola de Migration Assistant. El puerto predeterminado es 9123.
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 13. 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 para este dispositivo.

Ejecutar una comprobación previa antes de una migración de CLI a vCenter Server Appliance

Es posible ejecutar una comprobación previa para verificar que se cumplan los requisitos de migración y resolver todos los problemas antes de migrar la implementación de vCenter Server.

Antes de migrar la implementación de vCenter Server a un dispositivo, se puede ejecutar una comprobación previa para averiguar el requisito de espacio de disco, el tiempo de actualización estimado y las extensiones registradas con la instancia de vCenter Server Appliance. También es posible, y altamente recomendable, ejecutar una actualización previa al planificar la actualización.

Requisitos previos

Preparar los archivos de configuración JSON para la migración de CLI mediante los parámetros de configuración y las plantillas de ejemplo.

Procedimiento

  1. Compruebe la plantilla sin implementar el dispositivo. Para ello, introduzca el comando: vcsa-deploy migrate --verify-template-only path_to_json_file.
  2. Ejecute CLI Migrate mediante la opción --precheck-only.
    Puede ajustar sus planes de migración según los requisitos de espacio en disco y el tiempo de migración estimado. Si recibe un error, puede solucionar los problemas antes de realizar la migración real.
  3. Después de resolver los errores, vuelva a ejecutar el comando CLI Migrate mediante la opción --verify-template-only hasta que se resuelvan todos los errores.

Resultados

Ya está preparado para realizar una migración de CLI sin errores.

Qué hacer a continuación

Realizar una migración de CLI de vCenter Server de Windows a un dispositivo.

Realizar una migración de CLI de vCenter Server de Windows a un dispositivo

Se puede migrar vCenter Server a un dispositivo de un equipo que se encuentre en la red de vSphere.

Requisitos previos

Procedimiento

  1. Desplácese hasta el directorio de instalación de CLI del software del sistema operativo.
    • Si planea implementar el dispositivo desde un equipo con el sistema operativo Windows, desplácese hasta el directorio vcsa-cli-installer\win32.
    • Si planea implementar el dispositivo desde un equipo con el sistema operativo Linux, desplácese hasta el directorio vcsa-cli-installer/lin64.
    • Si planea implementar el dispositivo desde un equipo con el sistema operativo Mac, desplácese hasta el directorio vcsa-cli-installer/mac.
  2. Seleccione el instalador de CLI: vcsa-deploy.exe.
  3. Ejecute el comando de migración.
    vcsa-deploy migrate --accept-eula optional_arguments path_to_the_json_file
    La variable optional_arguments es una lista separada por espacios de argumentos opcionales para establecer configuraciones adicionales.
    Por ejemplo, puede establecer la ubicación del registro y otros archivos de salida generados por el instalador.
    vcsa-deploy migrate --accept-eula --log-dir=path_to_the_location path_to_the_json_file

Resultados

Se implementa la plantilla de migración. Puede Comprobar que la actualización o la migración de vCenter Server se hayan realizado correctamente.

Sintaxis del comando de migración de CLI

Puede usar uno o más argumentos de comando para establecer los parámetros de ejecución del comando de migración.

Puede agregar una lista de argumentos separada por espacios al comando de actualización de CLI.
vcsa-deploy migrate list_of_arguments path_to_the_json_file

El argumento template requerido proporciona la ruta de acceso de un archivo JSON en el que se describe el procedimiento de implementación de vCenter Server Appliance. Puede colocar varios archivos JASON en un directorio y la CLI migrará todas las implementaciones en modo de lotes. Para obtener más información sobre cómo realizar migraciones simultáneas, consulte Preparar los archivos de configuración JSON para la migración de CLI.

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":"C:\\vmware\\vcsa" establece la ruta de acceso C:\vmware\vcsa.

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

Argumento opcional Descripción
--accept-eula Acepta el contrato de licencia de usuario final.

Se requiere para ejecutar el comando de implementación.

-h, --help Muestra el mensaje de ayuda para el comando.
--template-help Muestra el mensaje de ayuda para los parámetros de configuración del archivo de implementación JSON. Puede usar vcsa-deploy [subcommand] --help para obtener una lista de argumentos específicos de subcomandos.
-v, --verbose Agrega información de depuración a la salida de la consola.
-t, --terse Oculta la salida de la consola. Solo muestra mensajes de error y advertencia.
--log-dir, LOG_DIR Especifica la ubicación del registro y otros archivos de salida que genera el instalador.
--skip-ovftool-verification

Realiza una comprobación básica de los parámetros de configuración e implementa vCenter Server Appliance, pero no valida los parámetros de OVF Tool en la subsección ovftool_arguments de la plantilla JSON. Si se establecen argumentos que OVF Tool no reconoce, es posible que se produzcan errores en la implementación.

--no-ssl-certificate-verification

Prohíbe la verificación de SSL de las conexiones de ESXi.

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 está autofirmado, la CLI detendrá la actualización a menos que se especifique que la CLI pase por alto el certificado autofirmado mediante el parámetro de comando --no-ssl-certificate-validation.

Si va a conectarse a un servidor con un certificado autofirmado y se produce un error al especificar que la CLI lo acepte, la CLI muestra la huella digital del certificado autofirmado del servidor y le solicita que la acepte o la rechace.

También puede especificar que la CLI pase por alto los certificados autofirmados mediante el parámetro de configuración ssl_certificate_verification en la plantilla JSON. Consulte Actualizar los parámetros de configuración para la actualización de la CLI de vCenter Server Appliance.

Importante: Evite utilizar esta opción, ya que puede ocasionar problemas durante o después de la actualización debidos a una identidad no validada del host de destino.
--operation-id Permite proporcionar un identificador para realizar un seguimiento de la instalación, la migración o la actualización simultáneas de varias instancias de vCenter Server. Si no proporciona un identificador de la operación, la CLI genera un identificador único universal (UUID) que se puede utilizar para identificar las diferentes instancias de vCenter Server y el estado de instalación o actualización.
--verify-template-only Realiza la comprobación de plantilla básica sin instalar Upgrade Runner, ejecutar comprobaciones previas ni actualizar o migrar vCenter Server Appliance.
--precheck-only Instala Migration Assistant en la máquina virtual de origen de vCenter Server y ejecuta un conjunto completo de comprobaciones previas sin realizar la migración.
--acknowledge-ceip Confirma que el usuario acepta participar en el programa de mejora de la experiencia de cliente (CEIP) de VMware. Este argumento se necesita si ceip.enabled está establecido en el valor true (verdadero) en la plantilla de actualización.
Código de salida Descripción
0 Comando ejecutado correctamente
1 Error de tiempo de ejecución
2 Error de validación
3 Error en la plantilla