Usar el comando run de Set-ToolsRepo

En este artículo se muestra cómo usar el comando Set-ToolsRepo run de principio a fin, cómo descargar y alojar la versión de GuestStore correcta del archivo ZIP de VMware Tools y cómo validar que el proceso se ha completado correctamente.

Cuándo usar el comando run de Set-ToolsRepo

Use el Set-ToolsRepo comando run cuando desee:

• Haga que una versión específica de VMware Tools esté disponible para la instalación y actualización de las herramientas de invitado de máquina virtual en una nube privada de Azure VMware Solution.
• Publique de forma centralizada la versión GuestStore del archivo ZIP de VMware Tools en la ubicación central de vSAN para que todos los hosts pertinentes puedan hacer referencia al paquete.

Prerrequisitos

• Dirección URL HTTP o HTTPS accesible públicamente que apunta a la versión GuestStore del archivo ZIP de VMware Tools. La dirección URL debe ser accesible desde el entorno de ejecución para Azure VMware Solution ejecutar comandos.
• Permiso para ejecutar paquetes de comandos de ejecución de Azure VMware Solution en el portal de Azure para la nube privada de destino.

Contenido ZIP esperado

El archivo ZIP que cargue debe:

• Incluya un directorio de carga de VMware Tools en el diseño esperado.
• Incluya la carpeta versionada en la sección vmware/apps/vmtools/windows64/vmtools-<version>/. El nombre de la carpeta debe seguir el formato vmtools-<version> (por ejemplo, vmtools-12.4.0).

-Validar opción

La -Validate opción habilita un modo de auditoría de solo lectura para el repositorio de VMware Tools. Al especificar esta opción, Set-ToolsRepo inspecciona los archivos de metadatos del almacén de datos actuales sin realizar ningún cambio en el entorno.

Cuándo usar la opción -Validate

• Antes de ejecutar Set-ToolsRepo, como comprobación inicial
• Después de ejecutar Set-ToolsRepo, para confirmar que todo está sincronizado
• Si sospecha un problema de sincronización o repositorio y desea una comprobación rápida de solo lectura

Qué comprueba la opción -Validate

• Identifica todos los datastores de vSAN del centro de datos definido por software (SDDC)
• Lee los metadatos del repositorio (top-level-metadata.json y version-metadata.json)
• Comprueba que los metadatos y el estado del almacén de datos son coherentes y sincronizados.

Resultados de la opción -Validate

• PASS: las versiones coinciden y los almacenes de datos están sincronizados.
• FAIL: Se detecta una discrepancia o incoherencia.

Errores comunes de la opción -Validate

• Error de coincidencia de metadatos: vuelva a ejecutar Set-ToolsRepo con una dirección URL ZIP válida de VMware Tools (sin la -Validate opción) para volver a implementar o reparar el repositorio. A continuación, ejecute Set-ToolsRepo -Validate para confirmar que los metadatos están sincronizados.
• Ruta de acceso de GuestStore no encontrada: es posible que falte o no se pueda acceder al repositorio. Implemente o reinicialice mediante la ejecución Set-ToolsRepo con una dirección URL ZIP válida (sin la -Validate opción). A continuación, ejecute Set-ToolsRepo -Validate para comprobar que el repositorio está presente y sincronizado.

URL del archivo ZIP de VMware Tools

El comando Set-ToolsRepo run acepta una URL HTTP o HTTPS de acceso público de la versión GuestStore del archivo ZIP de VMware Tools, que se publicará en la ubicación central de vSAN para VMware Tools.

Antes de que el comando realice cualquier cambio, se produce la validación de estos elementos:

• La dirección URL usa HTTP o HTTPS y es un vínculo de descarga directa.
• El archivo es accesible sin autenticación interactiva y se puede descargar de un extremo a otro.

Flujo de trabajo de un extremo a otro

1. Descargue la versión de VMware Tools necesaria.

   Obtenga la versión GuestStore del archivo ZIP de VMware Tools para la versión específica que desea publicar en la ubicación central de vSAN para VMware Tools.

2. Hospede el ARCHIVO ZIP en una dirección URL HTTP o HTTPS accesible públicamente. Por ejemplo, use cualquier servidor web o almacenamiento de objetos que pueda servir el archivo sin autenticación interactiva.

   A continuación, proporcione esa dirección URL de descarga directa para su uso con el comando run.

   Importante

   La dirección URL debe ser un vínculo de descarga directa y ser accesible sin autenticación interactiva para que el comando run pueda recuperar el archivo ZIP.

3. Ejecute el comando de ejecución de Azure VMware Solution Set-ToolsRepo. Proporcione la dirección URL ZIP del paso 2.

   Cuando finaliza el comando, su salida indica que se ha realizado correctamente o se proporciona un mensaje de error.

4. Se publica el paquete de VMware Tools.

   La versión solicitada está disponible en la ubicación central de vSAN para VMware Tools para la nube privada.

5. Los hosts están configurados para usar el repositorio vSAN.

   Como parte del comando run, los hosts ESXi pertinentes en la nube privada se actualizan para usar la ubicación central de vSAN como origen de VMware Tools.

Validation

Después de ejecutar correctamente el Set-ToolsRepo comando run, siga estos pasos de validación:

1. Vaya al cliente de vCenter y examine el almacén de datos vSAN. Confirme que la carpeta de versión existe en GuestStore/vmware/apps/vmtools/windows64/.

2. Confirme que la versión correcta de VMware Tools está disponible para instalar o actualizar desde una máquina virtual de prueba de invitado (VM).

3. Si se produce algún problema con VMware Tools después de una operación de comando de ejecución correcta, capture la salida del comando y abra una solicitud de soporte técnico.

Solución de problemas

Si se produce un error en el comando de ejecución, las causas más comunes del lado cliente son:

• La dirección URL no es accesible públicamente como vínculo de descarga directa.
• El archivo ZIP no contiene la estructura de carpetas esperada.

Use el mensaje de error junto con los pasos de solución de problemas siguientes.

Problemas de dirección URL o descarga

• Dirección URL no accesible o descarga errónea. Confirme que la dirección URL se abre desde una red externa y es un vínculo de descarga directa. Confirme también que la dirección URL no requiere inicio de sesión, autenticación multifactor ni tokens de tiempo limitado.
• Error de TLS/SSL. Asegúrese de que el punto de conexión HTTPS admite TLS moderno y presenta un certificado válido.

Problemas de estructura ZIP

• No se encontró la carpeta esperada. Asegúrese de que el archivo ZIP contiene vmware/apps/vmtools/windows64/vmtools-<version> (incluido el directorio inicial vmware/ ).
• Varias versiones en un archivo ZIP. Hospede un archivo ZIP que contenga solo la versión única que quiere publicar, con una vmtools-<version> carpeta.

Problemas del almacén de datos

• Error de configuración o publicación del lado del servicio. Si la dirección URL y la estructura ZIP son correctas, pero el comando run sigue fallando, capture la salida completa del comando y abra una solicitud de soporte técnico.
• Errores intermitentes. Vuelva a intentar el comando run después de confirmar que la dirección URL del archivo ZIP sigue siendo válida y accesible.

La opción de actualización de VMware Tools no está disponible y no está en la versión actual

Es posible que la opción Instalación o actualización de VMware Tools esté disponible (aparece atenuada) para las máquinas virtuales de vCenter. Esta situación puede producirse cuando los metadatos del repositorio de VMware Tools en el almacén de datos de vSAN son incoherentes o incorrectos.

Para la resolución, use los procedimientos siguientes.

Comprobación de los metadatos del repositorio en GuestStore

1. Vaya a vSAN Datastore>GuestStore>vmware>apps>vmtools>windows64.

   

2. Compruebe los siguientes archivos:

   • Metadatos de nivel superior: windows64/metadata.json.

     

   • Metadatos específicos de la versión: windows64/vmtools-<version>/metadata.json.

     

Validar la coherencia de los metadatos

El archivo de nivel superior metadata.json y el archivo específico de la versión metadata.json deben:

• Coincide con la misma versión de VMware Tools.
• Mantén la coherencia entre ellos (como se muestra en las capturas de pantalla de referencia).

Si coinciden, los metadatos son coherentes. Si no coinciden, los metadatos son incoherentes.

Corregir la falta de coincidencia de metadatos (si se identifica)

Si el archivo de nivel superior es incorrecto:

1. Eliminar windows64/metadata.json (por ejemplo, vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/metadata.json).

2. Sube el archivo windows64/metadata.json correcto del paquete de VMware Tools de mayor versión que hayas subido.

Si el archivo específico de la versión es incorrecto:

1. Eliminar windows64/vmtools-<version>/metadata.json (por ejemplo, vSAN Datastore/GuestStore/vmware/apps/vmtools/windows64/vmtools-<version>/metadata.json).

2. Suba el archivo correcto windows64/vmtools-<version>/metadata.json del paquete de VMware Tools de versión más reciente que haya subido.

Asegúrese también de que ambos archivos de metadatos coincidan con la versión de VMware Tools.

Esperar a la actualización del host

Espere tiempo para que el cambio se propague entre hosts. Esto puede tardar hasta 24 horas.

Comprobación de la resolución

Vuelva a comprobar la máquina virtual en vCenter. La opción Instalar o actualizar de VMware Tools ahora debe estar disponible.

Confirmación de la coherencia (opcional)

Ejecute Set-ToolsRepo -Validate para confirmar la coherencia de los metadatos.

Contenido relacionado

• Para más información sobre los comandos de ejecución, consulte Uso de comandos de ejecución.