> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/es/maquinas-virtuales/vm-guest-agent.md). # Agente invitado de VM El agente invitado es un programa instalado dentro del sistema operativo invitado que permite al host ejecutar comandos dentro de la VM. Esto permite realizar copias de seguridad coherentes y fiables al congelar el sistema de archivos del invitado antes de las instantáneas y apagar correctamente un invitado sin depender de ACPI, políticas, etc. ## Requisitos * Habilitar el agente invitado para la VM * Instalación del agente invitado (dentro del sistema operativo invitado) ## Habilitar el Agente Invitado El agente invitado debe habilitarse por VM; esto se puede hacer durante la creación de la VM o editando una VM existente. La casilla de verificación Agente Invitado en el panel de la VM indica si el agente está habilitado. ![agent-enabled-notconnected.png](/files/888da8b41e52d7163de61ac0832314715fb8bab7) ### Habilitar el Agente Invitado en una VM existente 1. Navegue al panel de la VM 2. Haga clic en **Editar** en el menú de la izquierda. 3. Haga clic para marcar **QEMU Guest Agent** casilla de verificación. 4. Haga clic en **Enviar** para guardar el cambio. ## Instalar software del agente en VMs Windows ### Para descargar/instalar el instalador de Guest Tools El instalador del agente invitado se puede descargar desde el siguiente enlace (y ejecutarse dentro del invitado): {% hint style="success" %} Durante la configuración del instalador de VirtIO, asegúrese de seleccionar el *Instalar* botón para el software del dispositivo. {% endhint %} La VM requerirá un reinicio para aplicar los cambios y conectar el agente. ### Para descargar el ISO completo de VirtIO al vSAN Las siguientes instrucciones explican cómo colocar el archivo win-virtio.iso (que contiene el software necesario del agente invitado) en el vSAN; esto permite cargar el software en la unidad de CD-ROM de una VM para una fácil instalación dentro del sistema operativo invitado. 1. Haga clic en el enlace de abajo para acceder al ISO de VirtIO. 2. Aparece el enlace Cargar desde URL, con todos los campos rellenados automáticamente; por lo general no es necesario hacer cambios; sin embargo, opcionalmente, se pueden cambiar los campos Nombre de archivo, Descripción del archivo y/o Nivel preferido, si se desea. 3. Haga clic en Enviar para descargar el archivo ISO de VirtIO al vSAN. 4. Cuando el progreso muestre 100 % completado (barra de progreso en la esquina superior derecha), el archivo estará disponible, aparecerá en la lista de Archivos y habrá una opción para seleccionarlo en cualquier unidad de CD. Consulte las instrucciones siguientes para instalar el software del agente invitado desde el ISO de VirtIO descargado. ### Para instalar el agente invitado (Windows) desde el ISO de VirtIO {% hint style="info" %} La VM debe tener un dispositivo CD-ROM {% endhint %} 1. Vaya al **de la VM**. 2. Haga clic en el botón de selección de CD-ROM (arriba a la izquierda) ![fa-eject.png](/files/2d785cae551d9b812bb7a6a8c1ec779b92915e4b) 3. Seleccione **virtio-win.iso (o nombre de archivo modificado durante la descarga)**. 4. Haga clic en **Enviar** para aplicar el cambio de CD. 5. Haga clic en **Consola remota** en el menú de la izquierda para abrir la consola del sistema operativo invitado. 6. Vaya a **Administrador de dispositivos de Windows**. 7. Haga clic derecho en **"Controladora de comunicaciones simple PCI"**. 8. Seleccione **Actualizar controlador**. 9. Busque la **ruta de la unidad de CD-ROM** que contiene el ISO descargado. 10. Navegue hasta: **vioserial\SU VERSIÓN DE WINDOWS (por ejemplo: 2k12R2, WIN10, etc.)**. 11. Haga clic en **Siguiente** para completar la actualización del controlador. 12. En el explorador de archivos de Windows, **busque la unidad de CD-ROM** con el ISO de VirtIO. 13. Navegue hasta la **guest-agent** carpeta. 14. **Haga doble clic** en el MSI correcto **(qemu-ga-x86.msi\[64-bit] o qemu-ga-1386.msi\[32-bit])** archivo para iniciar el instalador. {% hint style="success" %} Puede que sea necesario reiniciar la VM para conectar el agente al host. {% endhint %} ## Instalar software del agente en VMs Linux En VMs Linux, el **paquete qemu-guest-agent** debe instalarse. Las instrucciones de instalación variarán según la distribución/versión específica de Linux. * En sistemas que usan apt para la instalación **(basados en Debian/Ubuntu)**: ``` apt-get install qemu-guest-agent ``` * En sistemas que usan **Yum (Redhat)**: ``` yum install qemu-guest-agent ``` * Algunas distribuciones requerirán **un reinicio o inicio manual** del agente: ``` systemctl start qemu-guest-agent ``` ## Verificar la conexión del agente invitado de la VM Cuando un agente invitado se conecta correctamente, el número de versión se mostrará junto a la casilla marcada de Agente Invitado en el panel de la VM. ![agent-connected-version.png](/files/9f28d1a215b85a914c7a7de22543efba577c9f00) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/run-the-platform/es/maquinas-virtuales/vm-guest-agent.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.