Citrix Hypervisor

Solución de problemas de VM

Importante:

La actualización acumulativa 1 de Citrix Hypervisor 8.2 llega al final de su vida útil el 25 de junio de 2025. Planifique su actualización a XenServer 8 ahora para garantizar una transición fluida y un soporte continuo. Para obtener más información, consulte Actualizar.

Si utiliza los archivos de licencia de Citrix Virtual Apps and Desktops para licenciar los hosts de Citrix Hypervisor 8.2 Cumulative Update 1, estos archivos de licencia no son compatibles con XenServer 8. Antes de actualizar, debe adquirir los archivos de licencia de socket de XenServer Premium Edition para utilizarlos con XenServer 8. Estos archivos de licencia de socket están disponibles como un derecho de las suscripciones de Citrix para Private Cloud, Citrix Universal Hybrid Multi-Cloud, Citrix Universal MSP y Citrix Platform License para ejecutar sus cargas de trabajo de Citrix. Los clientes de Citrix que aún no hayan realizado la transición a estas nuevas suscripciones pueden solicitar participar en una promoción gratuita de 10.000 licencias de socket de XenServer Premium Edition. Para obtener más información, consulte XenServer.

Si no obtiene una licencia compatible para XenServer 8 antes de actualizar, cuando actualice sus hosts, estos volverán a la edición de prueba de 90 días. La Edición de Prueba ofrece las mismas características que la Edición Premium con algunas limitaciones. Para obtener más información, consulte Descripción general de las licencias de XenServer 8.

Citrix ofrece dos formas de asistencia:

  • Soporte gratuito de autoayuda en el Sitio web de Citrix
  • Servicios de soporte de pago, que puede comprar en el Sitio de soporte.

Con el servicio de asistencia técnica de Citrix, puede abrir un caso de asistencia en línea o ponerse en contacto con el centro de asistencia por teléfono si experimenta dificultades técnicas.

El Asistencia técnica de Citrix El sitio aloja varios recursos que pueden ser útiles para usted si experimenta un comportamiento inusual, bloqueos u otros problemas. Los recursos incluyen: foros de soporte, artículos de la base de conocimientos y documentación de productos.

Si observa un comportamiento inusual de la máquina virtual, esta sección tiene como objetivo ayudarle a resolver el problema. En esta sección se describe dónde se encuentran los registros de aplicaciones y otra información que puede ayudar a su proveedor de soluciones de Citrix Hypervisor a rastrear y resolver el problema.

Importante:

Siga la información de solución de problemas de esta sección solo bajo la guía de su proveedor de soluciones de Citrix Hypervisor o del equipo de soporte.

Actualizaciones de proveedores: mantenga sus máquinas virtuales actualizadas con las actualizaciones proporcionadas por el proveedor del sistema operativo. Es posible que el proveedor haya proporcionado correcciones para la máquina virtual bloqueada y otros errores.

Bloqueos de VM

Si experimenta bloqueos de máquinas virtuales, es posible que un volcado de memoria del kernel pueda ayudar a identificar el problema. Reproduzca el bloqueo, si es posible, y siga este procedimiento. Consulte a su proveedor de SO invitado para obtener más información sobre este problema.

El comportamiento de volcado de memoria de las máquinas virtuales se puede controlar mediante el comando acciones-después-de-choque parámetro. Los siguientes son los valores posibles:

Valor Descripción
preserve Deje la máquina virtual en un estado de pausa. (Para análisis)
restart Sin volcado de núcleo, reinicie la máquina virtual. (Esta es la opción predeterminada)
destroy Sin volcado de núcleo, deje la máquina virtual detenida.

Para habilitar el guardado de volcados de memoria de máquina virtual:

  1. En el servidor Citrix Hypervisor, determine el UUID de la máquina virtual deseada ejecutando el siguiente comando:

      xe vm-list name-label=<name> params=uuid --minimal
    <!--NeedCopy-->
    
  2. Cambie el acciones-después-de-choque valor mediante el uso de xe vm-param-set; Por ejemplo, ejecute el siguiente comando en DOM0:

      xe vm-param-set uuid=<vm_uuid> actions-after-crash=preserve
    <!--NeedCopy-->
    
  3. Bloquee la máquina virtual.

    1. Determine el ID de dominio de la máquina virtual ejecutando el siguiente comando en dom0:

        xe vm-param-get uuid=<vm_uuid> param-name=dom-id
      <!--NeedCopy-->
      
    2. Ejecute el comando Gatillo XL en dom0 para desencadenar el bloqueo:

        xl trigger <dom_id> nmi
      <!--NeedCopy-->
      

Comportamiento de volcado de memoria de máquinas virtuales Windows

De forma predeterminada, los volcados de memoria de Windows se colocan en %SystemRoot%\Minivolcado en la propia máquina virtual de Windows. Puede configurar el nivel de volcado de las máquinas virtuales siguiendo la ruta del menú Mi Computadora > Propiedades > Avanzado > Puesta en marcha y recuperación.

Recopilación de diagnósticos de XenServer VM Tools para Windows

Las herramientas de máquina virtual de XenServer para Windows incluyen una herramienta de diagnóstico llamada xtbugtool. Esta herramienta está disponible como un script de PowerShell, xtbugtool.ps1.

Además, proporcionamos una versión de script por lotes obsoleta para ejecutarla en versiones anteriores de Windows, xtbugtool.bat. Siempre que sea posible, se recomienda usar la versión de PowerShell.

Esta herramienta es compatible con los siguientes sistemas operativos:

  • Windows 10
  • Windows 11
  • Windows Server 2016
  • Windows Server 2019
  • Windows Server 2022

Para ayudar a diagnosticar cualquier problema con XenServer VM Tools para Windows, el script recopila la siguiente información de la máquina virtual Windows:

  • Claves del Registro relevantes para las instalaciones de XenServer VM Tools para Windows
  • MSinfo en NFO y versiones de texto
  • Registros de eventos del sistema, seguridad y aplicaciones
  • Los siguientes archivos y directorios:
    • C:\ProgramData\Citrix
    • C:\ProgramData\Citrix Systems, Inc.
    • C:\ProgramData\XenServer
    • C:\Windows\Inf\setupapi.dev.log
    • C:\Windows\Inf\setupapi.setup.log
  • El resultado de los siguientes comandos:
    • información del sistema
    • lista de tareas /NH
    • pnputil -e
    • pnputil /enum-drivers
    • winmgmt /verifyrepository
    • ipconfig /all

Ejecución del script de Powershell

Para ejecutar el script de PowerShell, siga estos pasos:

  1. En la máquina virtual Windows, abra un terminal de PowerShell como administrador.
  2. En el Empezar Tipo de menú PowerShell y seleccione, Ejecutar como administrador.
  3. Cambiar directorio a C:\Archivos de programa\XenServidor\XenTools\diagnostics
  4. Ejecute el script con el siguiente comando: xtbugtool.ps1 &lt;path_to_output_directory&gt;

    Si no proporciona un valor para la ruta de salida, el script se envía al directorio actual.

El script crea un archivo comprimido con un nombre en el formato xtbugtool-yyyyMMddHHmmss.zip en el directorio de salida que especifique.

Ejecución del script por lotes (en desuso)

Para ejecutar el script por lotes, siga estos pasos:

  1. En la máquina virtual Windows, abra un símbolo del sistema como Administrador.
  2. En el Empezar Tipo de menú Cmd y seleccione, Ejecutar como administrador.
  3. Cambiar directorio a C:\Archivos de programa\XenServidor\XenTools\diagnostics
  4. Ejecute el script con el siguiente comando:

    xtbugtool.bat <path_to_output_directory>

El script crea un archivo comprimido con un nombre en el formato xt-bugtool-YYYY.MM.DD-xxxx.zip en el directorio de salida que especifique.

Problemas de UEFI y arranque seguro

¿Cómo puedo cambiar la resolución de pantalla de la consola de XenCenter en una máquina virtual habilitada para UEFI?

Para cambiar la resolución de pantalla de la consola de XenCenter en una máquina virtual habilitada para UEFI:

  1. Abra el archivo Configuración de Windows
  2. Haga clic en el botón Actualizar & Seguridad botón
  3. En la pestaña de recuperación, presione el botón Reiniciar ahora botón.
  4. Vaya a Solución de problemas > Opciones avanzadas > Configuración del firmware UEFI.
  5. Prensa Reanudar. Durante el reinicio, se carga el menú de configuración de UEFI.
  6. Vaya a Administrador de dispositivos > Configuración de la plataforma OVMF. Esto muestra la resolución de pantalla actual.
  7. Prensa Entrar para ver las opciones de resolución de la pantalla.
  8. Utilice las teclas de flecha para seleccionar la resolución de pantalla deseada y pulse Entrar.
  9. Prensa F10 para guardar los cambios y confirmar su elección.
  10. Reinicie la máquina virtual para ver la consola de XenCenter en una resolución de pantalla actualizada.

¿Por qué no puedo crear una máquina virtual de arranque seguro UEFI?

Compruebe que el sistema operativo de la máquina virtual es compatible con el modo de arranque seguro UEFI. En Citrix Hypervisor 8.2, solo los siguientes sistemas operativos admiten el arranque seguro: Windows 10 (64 bits), Windows Server 2016, Windows Server 2019, Windows Server 2022.

Compruebe que el servidor Citrix Hypervisor se haya iniciado en modo UEFI. Solo puede crear máquinas virtuales de arranque seguro UEFI en un servidor Citrix Hypervisor que tenga presentes los certificados de arranque seguro. Los certificados de arranque seguro solo están presentes en los servidores arrancados en modo UEFI o en los servidores del mismo grupo que un servidor arrancado en modo UEFI. Para obtener más información, consulte Arranque de red.

Compruebe que el servidor Citrix Hypervisor arrancado por UEFI esté incluido en el Lista de compatibilidad de hardware. Es posible que los servidores más antiguos no incluyan los certificados de arranque seguro cuando se inician en modo UEFI.

¿Cómo puedo saber si un servidor Citrix Hypervisor tiene los certificados de arranque seguro?

Si el servidor Citrix Hypervisor se inicia en modo UEFI, los certificados de arranque seguro están disponibles en el servidor. Los servidores de Citrix Hypervisor comparten sus certificados con otros servidores del mismo grupo de recursos. Si tiene un servidor de arranque UEFI en el grupo de recursos, todos los servidores de ese grupo tienen disponibles los certificados de arranque seguro.

Ejecute el siguiente comando en un servidor Citrix Hypervisor:

  xe pool-param-get param-name=uefi-certificates uuid=<pool-uuid> | wc -c

Si devuelve un valor mayor que cero, los certificados de arranque seguro están presentes.

Para comprobar que los certificados son válidos, ejecute el siguiente comando en el servidor de Citrix Hypervisor:

  xe pool-param-get uuid=$(xe pool-list --minimal)  param-name=uefi-certificates|base64 -d|tar tv
  -rw-r--r-- root/root      1600 2019-11-11 17:09 KEK.auth
  -rw-r--r-- root/root      3212 2019-11-11 17:09 db.auth
<!--NeedCopy-->

Si no hay certificados de arranque seguro, ejecute el siguiente comando en el servidor de Citrix Hypervisor:

  ls /sys/firmware/efi/efivars | grep KEK

Si este comando se devuelve vacío, no se pueden crear máquinas virtuales de arranque seguro en ese servidor porque faltan los certificados necesarios en el firmware UEFI.

¿Por qué no se puede iniciar mi máquina virtual de arranque seguro UEFI?

Si ve los siguientes mensajes en la consola de la máquina virtual de arranque seguro UEFI y una alerta en XenCenter, el proceso de arranque seguro ha fallado y la máquina virtual no se inicia.

Salida de consola de la máquina virtual de arranque seguro UEFI que no se inicia.

Esto suele deberse a la instalación de controladores sin firmar en la máquina virtual. Investigue qué controladores se han actualizado o instalado desde el último arranque seguro correcto.

Puede deshabilitar el arranque seguro e iniciar la máquina virtual en modo de configuración para quitar los controladores sin firmar.

Importante:

Antes de hacerlo, haga una copia de seguridad de la máquina virtual tomando una instantánea.

Para cambiar una máquina virtual de arranque seguro UEFI en una máquina virtual de arranque UEFI, ejecute el siguiente comando en el servidor de Citrix Hypervisor que aloja la máquina virtual:

  varstore-sb-state <VM_UUID> setup

Una vez que haya corregido la máquina virtual, ejecute el siguiente comando para volver a habilitar el arranque seguro:

  varstore-sb-state <VM_UUID> user

¿El arranque seguro está causando un problema en mi máquina virtual?

Para diagnosticar si un problema en la máquina virtual se debe a que el arranque seguro está habilitado para la máquina virtual, deshabilite el arranque seguro e intente reproducir el problema.

Para inhabilitar el arranque seguro, ejecute el siguiente comando en el servidor de Citrix Hypervisor que aloja la máquina virtual:

  varstore-sb-state <VM_UUID> setup

Una vez que haya depurado el problema, puede ejecutar el siguiente comando para volver a habilitar el arranque seguro:

  varstore-sb-state <VM_UUID> user

¿Cómo ejecuto la depuración de Windows en una máquina virtual Windows de arranque seguro?

No se puede ejecutar la depuración de Windows en una máquina virtual Windows de arranque seguro. Para ejecutar la depuración de Windows en la máquina virtual, puede realizar una de las siguientes acciones:

  • Cambie la máquina virtual al modo de arranque UEFI mediante la ejecución del siguiente comando:

       xe vm-param-set uuid=<UUID> platform:secureboot=false
    

    Reinicie la máquina virtual.

    Una vez que haya depurado el problema, puede ejecutar el siguiente comando para volver a habilitar el arranque seguro:

       xe vm-param-set uuid=<UUID> platform:secureboot=auto
    

    Reinicie la máquina virtual.

  • Inhabilite el arranque seguro ejecutando el siguiente comando en el servidor de Citrix Hypervisor que aloja la máquina virtual:

       varstore-sb-state <VM_UUID> setup
    

    Una vez que haya depurado el problema, puede ejecutar el siguiente comando para volver a habilitar el arranque seguro:

       varstore-sb-state <VM_UUID> user
    

¿Por qué solo aparecen dos NIC para mi máquina virtual Windows habilitada para UEFI?

Incluso si configuró más de dos NIC al crear la máquina virtual habilitada para UEFI, cuando la máquina virtual se inicia por primera vez, solo verá dos NIC. Esta información se muestra correctamente después de que XenServer VM Tools para Windows se haya instalado en la máquina virtual.

¿Por qué mis dispositivos emulados se muestran como tipos diferentes a los esperados en una máquina virtual Windows UEFI?

Las máquinas virtuales de arranque seguro UEFI usan NVME y E1000 para dispositivos emulados. Sin embargo, cuando la máquina virtual se inicia por primera vez, los dispositivos emulados se muestran como tipos diferentes. Esta información se muestra correctamente después de que XenServer VM Tools para Windows se haya instalado en la máquina virtual.

¿Por qué no puedo convertir mis plantillas del modo BIOS al modo UEFI o al modo de arranque seguro UEFI?

Solo puede crear una plantilla de máquina virtual habilitada para UEFI a partir de una plantilla suministrada con Citrix Hypervisor.

No utilice el xe template-param-set para las plantillas que tienen algo instalado en ellas o las plantillas que ha creado a partir de una instantánea. El modo de arranque de estas instantáneas no se puede cambiar y, si intenta cambiar el modo de arranque, la máquina virtual no arranca.

¿Cómo compruebo las variables UEFI y UEFI Secure Boot?

En el servidor Citrix Hypervisor donde se aloja la UEFI o la máquina virtual de arranque seguro UEFI, ejecute los siguientes comandos:

   varstore-ls

Este comando enumera los GUID y los nombres de las variables disponibles. Use el GUID y el nombre en el siguiente comando:

  varstore-get <VM\_ID> <GUID> <name> | hexdump -C

¿Por qué no puedo usar un controlador de “prueba” con una máquina virtual de arranque seguro?

Si también está trabajando con un tercero para depurar y corregir problemas en su máquina virtual de arranque seguro UEFI, es posible que el proveedor de terceros proporcione controladores sin firmar con fines de prueba o verificación. Estos controladores no funcionan en una máquina virtual de arranque seguro UEFI.

Solicite un controlador firmado al tercero. O bien, puede cambiar la máquina virtual de arranque seguro UEFI al modo de configuración para que se ejecute con el controlador sin firmar.

Utilidad Xentop

La utilidad xentop muestra información en tiempo real sobre un sistema Citrix Hypervisor y dominios en ejecución en un formato semigráfico. Puede usar esta herramienta para investigar el estado del dominio asociado a una máquina virtual.

Para ejecutar la utilidad xentop:

  1. Conéctese al host de Citrix Hypervisor a través de SSH o, en XenCenter, vaya a la Consola del host.
  2. Ejecute el siguiente comando: xentop

    La consola muestra información sobre el servidor en una tabla. La información se actualiza periódicamente.

Columnas de salida

La utilidad xentop muestra las siguientes columnas en la consola:

  • NOMBRE - El nombre del dominio. “Domain-0” es el dominio de control de Citrix Hypervisor. Otros dominios pertenecen a las máquinas virtuales.
  • ESTADO - El estado del dominio. El estado puede tener uno de los siguientes valores:

    • d - el dominio se está muriendo
    • s – el dominio se está cerrando
    • B – El dominio está bloqueado
    • C – El dominio se ha bloqueado
    • p – el dominio está en pausa
    • r – el dominio se está ejecutando activamente en una de las CPU
  • CPU (seg) - El uso de la CPU del dominio en segundos
  • CPU (%) - El uso de la CPU del dominio como porcentaje
  • MEM(k) - El uso actual de la memoria del dominio en KiB
  • MEM(%) - El uso actual de la memoria del dominio como porcentaje
  • MAXMEM(k) - El uso máximo de memoria de dominio en KiB
  • MAXMEM(%) - El uso máximo de memoria del dominio como porcentaje
  • VCPUS - El número de CPU virtuales asignadas al dominio
  • REDES - El número de redes virtuales usadas por el dominio
  • NETTX(k) - La cantidad total de tx de la red en KiB
  • NETRX(k) - La cantidad total de rx de la red en KiB
  • VBDS - El número de dispositivos de bloques virtuales
  • VBD_OO - El número total de veces que el VBD ha encontrado un error de solicitudes salientes. Cuando esto ocurre, las solicitudes de E/S para el VBD se retrasan.
  • VBD_RD - El número total de solicitudes de lectura de VBD
  • VBD_WR - El número total de solicitudes de escritura de VBD
  • VBD_RSECT - Los sectores de lectura de VBD
  • VBD_WSECT - Los sectores de escritura de VBD

Parámetros de Xentop

Puede utilizar los siguientes parámetros para configurar la salida del comando xentop:

  • -h - Genere la ayuda del comando para el comando xentop.
  • -V - Genere la versión del comando xentop.
  • -d o –delay=SEGUNDOS - Establecer el número de segundos entre actualizaciones
  • -n o –redes - Generar los datos de cada red VIF asociada a un dominio
  • -x o –vbds - Salida de los datos para cada dispositivo de bloque VBD asociado a un dominio
  • -r o encabezado de repetición - Repita el encabezado de la tabla antes de cada dominio
  • -v o –vcpus - Generar los datos de cada vCPU asociada a un dominio
  • -Yo o –Iteraciones - Número de iteraciones (actualizaciones) que se mostrarán antes de que xentop salga
  • -f o –nombre-completo - Genere el nombre de dominio completo en lugar de un nombre truncado

También puede configurar la mayoría de estos parámetros desde la utilidad xentop.

Solución de problemas de VM