> 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/learn-the-platform/es/modulo-6-maquinas-virtuales/04-vm-migration-import.md). # Migración e importación de máquinas virtuales ## Resumen Migrar las cargas de trabajo existentes a VergeOS es una de las actividades de Día 1 más comunes para nuevas implementaciones. Ya sea que estés migrando desde VMware vSphere, Microsoft Hyper-V, KVM/QEMU o incluso servidores bare-metal, VergeOS ofrece múltiples rutas de importación, cada una optimizada para distintos escenarios, cantidades de VM y tolerancias de tiempo de inactividad. Esta página cubre todos los métodos de migración compatibles, los formatos de archivo que VergeOS acepta, la planificación previa a la migración, la optimización posterior a la importación y cómo exportar VM fuera de la plataforma cuando sea necesario. ```mermaid flowchart LR subgraph sources["Plataformas de origen"] VMW["VMware vSphere"] HV["Hyper-V"] KVM["KVM / QEMU"] PM["Máquinas físicas"] end subgraph methods["Métodos de importación"] CONN["Conector de VMware"] FILE["Carga de archivos"] NAS["Importación de volumen NAS"] CLONE["Utilidad de clonación"] CIRRUS["Cirrus Data"] end subgraph vergeos["VergeOS"] VM["VM en ejecución"] end VMW --> CONN VMW --> FILE HV --> FILE KVM --> FILE HV --> NAS KVM --> NAS VMW --> NAS PM --> CLONE PM --> CIRRUS VMW --> CIRRUS CONN --> VM FILE --> VM NAS --> VM CLONE --> VM CIRRUS --> VM ``` ## Métodos de migración VergeOS ofrece cinco rutas de importación distintas. La elección correcta depende de tu plataforma de origen, la cantidad de VM y cuánto tiempo de inactividad puedes tolerar. ### Conector de VMware (migración en vivo) La **Conector de VMware** es el método recomendado para entornos VMware de producción. Crea una conexión API directa con vSphere y realiza copias de seguridad completas + incrementales usando el **seguimiento de bloques modificados (CBT)**. **Cómo funciona:** 1. **Crea un servicio de VMware** en VergeOS: esto establece una conexión con vCenter (o con un host ESXi) usando credenciales de administrador, DNS/IP y el puerto 443. 2. **Activa el servicio** y actualiza las VM para descubrir el inventario de origen. 3. **Crea programaciones de copia de seguridad** con tareas de copias completas e incrementales. 4. **Asigna programaciones a las VM** — se pueden aplicar distintas programaciones a diferentes VM (por ejemplo, producción vs. desarrollo/pruebas). 5. **Ejecuta las copias completas iniciales**, luego las copias incrementales capturan solo los bloques cambiados mediante CBT. 6. **Conmutación** una vez que las duraciones de las copias incrementales se estabilicen (lo que indica una mínima variación de datos), y luego importa las VM desde los trabajos de copia de seguridad. **Capacidades clave:** * Migración en vivo desde entornos VMware en ejecución: las VM de origen permanecen operativas durante la transferencia * Compatibilidad con copias incrementales mediante VMware CBT para un uso eficiente del ancho de banda * Importación por lotes de varias VM simultáneamente * Cantidad de copias de seguridad concurrentes configurable (predeterminado: 4) * Programación integrada para la copia de seguridad/DR continua de entornos VMware * Las VM importadas pueden encenderse directamente en VergeOS a partir de los datos de copia de seguridad {% hint style="success" %} **Mejores prácticas del Conector de VMware** * Conéctate al **clúster vSphere** en lugar de a un host ESXi individual * Deja "Habilitar automáticamente el seguimiento de cambios por VM" **activada** (la opción predeterminada) para garantizar que las copias diferenciales funcionen correctamente * Incluye en tu programación tanto tareas de copias completas como diferenciales: copias completas semanales y diferenciales en los días intermedios * Usa copias de seguridad completamente aprovisionadas (thick) para la retención a largo plazo {% endhint %} {% hint style="warning" %} **Requisitos de red del Conector de VMware** El conector se comunica con vCenter a través del **puerto 443**, pero los datos del disco se extraen directamente de los hosts ESXi mediante el protocolo NFC en el **puerto 902**. Para que las migraciones tengan éxito, VergeOS necesita: * **Acceso directo de red a cada host ESXi** — no solo a vCenter. El servicio de VMware llega a vCenter por el 443 para enumerar el inventario y luego se conecta al host ESXi individual que aloja cada VM por el 902 para transferir los datos del disco. * **Puerto 443** abierto a vCenter (o al host ESXi independiente) y **puerto 902** abierto a cada host ESXi. * **Valores MTU coincidentes** de extremo a extremo. Los MTU no coincidentes (por ejemplo, tramas jumbo habilitadas en un lado pero no en el otro) hacen que las copias de seguridad se detengan, agoten el tiempo de espera o fallen durante la transferencia de datos. Confirma que el MTU sea coherente en VergeOS, los switches físicos y los puertos vmkernel de ESXi. {% endhint %} {% hint style="info" %} El servicio de VMware almacena las copias de seguridad/snapshots de las VM de VMware que recupera en **vSAN (VergeFS)** almacenamiento. Dimensiona la capa de destino para los datos de copias completas e incrementales de cada VM de VMware que planees migrar: este consumo se suma al almacenamiento que usarán las VM importadas en ejecución. {% endhint %} ### Importar desde archivos cargados Para VM individuales o entornos mixtos, puedes cargar directamente los archivos de configuración y de disco de la VM al vSAN (VergeFS) e importarlos. **Dos enfoques:** 1. **Importación completa de la configuración** — Sube tanto los archivos de configuración (VMX, OVF) como los archivos de disco (VMDK, VHDX, QCOW2), y luego selecciona "Importar desde archivos" al crear una nueva VM. VergeOS lee el archivo de configuración para rellenar automáticamente los ajustes de la VM. 2. **Importación de shell de VM + disco** — Crea una VM personalizada con las especificaciones deseadas (CPU, RAM, NICs), luego añade unidades usando "Importar disco" y selecciona los archivos de disco cargados. Esto es útil cuando el formato de configuración de origen no es compatible directamente (por ejemplo, XML de Hyper-V). **Pasos para la importación completa de la configuración:** 1. Carga los archivos de configuración + disco al vSAN mediante el administrador de archivos 2. Vaya a **Máquinas virtuales → + Nueva VM → Importar desde archivos** 3. Selecciona el archivo de configuración (`.vmx`, `.ovf`) de entre los archivos disponibles 4. Opcionalmente, personaliza el nombre de la VM y la conservación de la dirección MAC 5. Selecciona la capa de almacenamiento preferida 6. Envía la solicitud: la VM se crea con las unidades asignadas a partir de los archivos de disco ### Importación de volumen NAS Cuando los archivos de VM se almacenan en un almacenamiento accesible por red (comparticiones NFS o CIFS), puedes importarlos directamente sin cargarlos primero al vSAN. La importación de volumen NAS requiere **VMX o OVF** archivos de configuración; los demás formatos deben usar la carga de archivos. **Cómo funciona:** 1. Crea o usa un **servicio NAS** dentro de VergeOS 2. Crea un **volumen remoto** para montar la compartición externa NFS/CIFS 3. Vaya a **Máquinas virtuales → + Nueva VM → Importar desde volumen** 4. Selecciona una o más carpetas que contengan archivos de VM (las VM también se importan desde subdirectorios de las carpetas seleccionadas) 5. Opcionalmente, cambia el nombre del trabajo de importación, activa o desactiva la conservación de la dirección MAC y selecciona una capa de almacenamiento preferida 6. Envía y supervisa el progreso desde el **Trabajos de importación** panel Este método es ideal para migraciones por lotes en las que los archivos de VM ya están centralizados en un servidor de archivos o en una exportación SAN. ### Utilidad de clonación de VergeOS (P2V / V2V) La utilidad de clonación proporciona **migración a nivel de bloque** para conversiones de físico a virtual (P2V) y de virtual a virtual (V2V) desde cualquier plataforma. **Cómo funciona:** 1. Descarga el `vergeOS-clone.iso` desde el panel de VergeOS 2. Arranca la máquina de origen (física o virtual) desde la ISO 3. Configura el nombre de la VM, los ajustes de la dirección MAC y selecciona los discos que se incluirán 4. La utilidad realiza una transferencia de datos a nivel de bloque al entorno VergeOS 5. Una vez finalizada la transferencia, enciende la VM en VergeOS Este enfoque funciona independientemente del hipervisor de origen y es especialmente útil para servidores físicos que no pueden exportar a formatos de VM estándar. ### Integración de Cirrus Data (Enterprise) Para migraciones empresariales a gran escala que requieren **un tiempo de inactividad casi nulo**, VergeOS se integra con **de Cirrus Data** los productos Compute Migration y MigrateOps. Esta solución de terceros admite migraciones complejas multiplataforma con gestión avanzada del ancho de banda y servicios profesionales. ## Formatos de archivo compatibles VergeOS admite una amplia gama de formatos de disco y configuración de VM: | Formato | Plataforma de origen | Descripción | | ---------------- | -------------------- | --------------------------------------------------- | | **VMX / VMDK** | VMware | Archivos nativos de configuración y disco de VMware | | **OVF / OVA** | VMware, VirtualBox | Formato de virtualización abierto (estándar) | | **VHD / VHDX** | Hyper-V | Formatos de virtualización de Microsoft | | **QCOW / QCOW2** | QEMU, KVM | Imágenes de disco copy-on-write de QEMU | | **VDI** | VirtualBox | Imágenes de disco de VirtualBox | | **IMG / RAW** | Varios | Formatos de imagen de disco sin procesar | ## Cómo elegir el método adecuado ### Conector de VMware Entornos VMware de producción en los que las VM de origen deben seguir en ejecución durante la migración. Aprovecha CBT para transferencias incrementales eficientes. ### Carga de archivos VM individuales de cualquier plataforma. Máximo control sobre el proceso de importación. Ideal cuando las VM de origen pueden apagarse para exportación. ### Importación de volumen NAS Importaciones por lotes desde almacenamiento en red. Archivos de VM ya ubicados en comparticiones NFS/CIFS. No se necesita paso de carga. ### Utilidad de clonación Migraciones de físico a virtual (P2V). V2V multiplataforma desde cualquier hipervisor. Eficiencia a nivel de bloque. ## Planificación previa a la migración ### Preparación del entorno de origen Antes de migrar, prepara el entorno de origen: * **Documenta las especificaciones de la VM** — cantidad de CPU, RAM, tamaños de disco, ajustes de red, asignaciones de VLAN * **Elimina las herramientas específicas del hipervisor** — Desinstala VMware Tools, Hyper-V Integration Services o agentes equivalentes * **Apagado limpio** para importaciones sin conexión: garantiza la consistencia del sistema de archivos * **Verifica la conectividad de red** entre los entornos de origen y VergeOS (especialmente para el Conector de VMware y las importaciones NAS) ### Preparación del entorno VergeOS * **Verifica la capacidad de almacenamiento** en las capas adecuadas para los discos de VM entrantes * **Configura los segmentos de red** para que coincidan con las VLAN del entorno de origen * **Planifica las asignaciones de direcciones IP** y las configuraciones de DNS * **Revisa la compatibilidad del SO invitado** — VergeOS admite Windows, Linux, BSD y otros sistemas operativos mediante KVM ### Reasignación de red Las VM de origen suelen estar conectadas a vSwitches de VMware, conmutadores virtuales de Hyper-V o bridges de Linux. En VergeOS, estos se corresponden con **redes internas**: | Concepto de origen | Equivalente en VergeOS | | ---------------------------------- | ---------------------- | | VMware vSwitch / dvSwitch | Red interna | | Conmutador virtual de Hyper-V | Red interna | | Bridge de Linux | Red interna | | Grupo de puertos con etiqueta VLAN | Red interna + VLAN | Después de la importación, conectarás la(s) NIC de cada VM a la red interna adecuada de VergeOS. Si conservas las direcciones MAC durante la importación, las reservas DHCP se trasladan automáticamente. ## Optimización posterior a la importación ### Instala los controladores VirtIO VirtIO proporciona el mejor rendimiento de disco y red en VergeOS. Después de importar una VM: * **Windows:** Descarga e instala la `virtio-win` ISO de herramientas de invitado. Adjúntalo como un CD-ROM virtual y luego instala los controladores. * **Linux:** La mayoría de las distribuciones modernas incluyen los controladores VirtIO de forma nativa: no se necesita ninguna instalación adicional. {% hint style="success" %} **Solución temporal para problemas de arranque** Si una VM no arranca después de la importación, cambia la interfaz de disco de **VirtIO-SCSI** a **SATA** o **IDE**. Una vez que el sistema operativo arranque, instala los controladores VirtIO y luego vuelve a VirtIO-SCSI para un rendimiento óptimo. {% endhint %} ### Asignación de hardware virtual Las VM importadas pueden necesitar ajustes para alinearse con el hardware virtual de VergeOS: * **Interfaces de disco** — Cambia de IDE/SATA a VirtIO-SCSI después de instalar los controladores * **Modelo de NIC** — VirtIO-net proporciona el mejor rendimiento * **Adaptador de pantalla** — QXL o VGA para acceso a la consola * **EFI vs. BIOS** — Asegúrate de que el tipo de firmware coincida con la configuración de la VM de origen * **Secure Boot** — Compatible con VM basadas en UEFI; verifica que la configuración coincida con la de origen ### Pasos adicionales 1. **Verifica la conectividad de red** y asignaciones de IP 2. **Actualiza DNS y DHCP** reservas según sea necesario 3. **Instala el agente invitado QEMU** para una supervisión mejorada, apagado controlado y snapshots en quiescencia 4. **Configura las políticas de copia de seguridad** usando los snapshots nativos de VergeOS 5. **Prueba la funcionalidad de la aplicación** de extremo a extremo antes de retirar las VM de origen ## Exportación de VM desde VergeOS VergeOS admite dos mecanismos de exportación para portabilidad e integración con copias de seguridad de terceros. ### Descarga directa de disco Los discos individuales de la VM se pueden descargar en formato **.raw** directamente desde la interfaz de VergeOS: 1. Navega al panel de la VM → **Unidades** 2. Selecciona la unidad → **Descargar** 3. El disco se descarga como un archivo `.raw` compatible con la mayoría de los hipervisores 4. Convierte al formato de destino (`.qcow2`, `.vmdk`, etc.) usando herramientas como `qemu-img convert` ### Volumen de exportación de VM (basado en NAS) Para exportaciones programadas y automatizadas de varias VM, VergeOS proporciona un **Volumen de exportación de VM** dedicado en el servicio NAS: 1. **Activa "Permitir exportación"** en cada VM que quieras incluir 2. **Crea un volumen NAS** con el tipo de sistema de archivos configurado en **Verge.io VM Export** 3. Elige el formato de configuración de exportación: * **Máquina virtual de Verge.io (.ybvm)** — Formato nativo de VergeOS basado en JSON * **Formato de virtualización abierto (.ovf)** — Estándar de la industria, compatible con plataformas de terceros 4. **Ejecuta la exportación** manualmente o prográmala mediante el motor de tareas 5. **Accede a los datos exportados** mediante comparticiones CIFS o NFS, o sincronízalos con almacenamiento externo usando sincronizaciones de volumen Cada exportación crea una carpeta con marca de tiempo que contiene snapshots de la VM. Una carpeta "current" siempre apunta a la exportación más reciente y proporciona una ruta estable para herramientas de copia de seguridad externas. {% hint style="info" %} **¿Vienes de VMware o Nutanix?** Ambas rutas de migración están integradas en la plataforma: sin appliance separado ni convertidor de terceros. {% endhint %} | Fuente | Ruta | Notas | | --------------- | ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | VMware vSphere | **Conector de VMware** — migración directa mediante API con copias incrementales basadas en CBT | VergeOS gestiona la migración de VMware de forma nativa mediante el Conector de VMware integrado: no se requiere convertidor separado, appliance de replicación ni herramientas V2V de terceros. | | Nutanix AHV | **Carga de archivos o importación de volumen NAS** | Una vez que tus VM se exportan en un formato compatible (QCOW2, OVF, etc.), VergeOS las importa de forma nativa mediante Carga de archivos o Importación de volumen NAS: no se requiere un appliance de migración separado. | | Ruta de retorno | **Volumen de exportación de VM** produciendo OVF | Carpeta "current" estable para herramientas de copia de seguridad externas o para mover VM de vuelta a vSphere. | ## Solución de problemas comunes | Síntoma | Causa probable | Resolución | | ------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | La VM no arranca después de la importación | Faltan los controladores VirtIO | Cambia la interfaz de disco a SATA/IDE, arranca, instala los controladores VirtIO y vuelve a cambiar | | Windows "Dispositivo de arranque inaccesible" | Incompatibilidad del controlador de disco | Cambia de VirtIO-SCSI a SATA, instala los controladores y luego revierte | | Sin conectividad de red | Controlador de la NIC o asignación de red | Verifica que los controladores VirtIO-net estén instalados; comprueba que la NIC esté conectada a la red interna correcta | | Rendimiento lento del disco | Uso de interfaz IDE/SATA | Instala los controladores VirtIO y cambia a VirtIO-SCSI | | Error de arranque EFI | Incompatibilidad del tipo de firmware | Asegúrate de que la VM esté configurada en UEFI si el origen usaba EFI; verifica los ajustes de Arranque seguro | | El Conector de VMware muestra "Error" | Problema de conexión o credenciales | Verifica la IP/DNS de vCenter, **puerto 443** el acceso, las credenciales de administrador y la configuración del certificado SSL | | La importación/copia de seguridad de VMware falla o se detiene durante la transferencia del disco | No hay acceso directo a los host(s) ESXi en el puerto 902 | Asegúrate de que VergeOS tenga **acceso directo de red a cada host ESXi** (no solo a vCenter) a través de **puerto 902** (NFC), además del puerto 443 hacia vCenter | | Las copias de seguridad de VMware son lentas, agotan el tiempo de espera o se interrumpen | Desajuste de MTU entre VergeOS y los hosts ESXi | Coincidir **Valores de MTU** de extremo a extremo (VergeOS, conmutadores físicos y puertos vmkernel de ESXi); un desajuste de tramas jumbo es una causa común | ## Resumen VergeOS facilita la migración de cargas de trabajo con cinco rutas de importación distintas que cubren cada plataforma de origen y escenario de migración. El Conector de VMware gestiona migraciones en vivo de producción con un tiempo de inactividad mínimo, las cargas de archivos ofrecen la máxima flexibilidad para entornos mixtos, las importaciones de volúmenes NAS permiten operaciones por lotes, la Utilidad de Clonación gestiona conversiones P2V y la integración de Cirrus Data admite proyectos a escala empresarial. Combinado con un amplio soporte de formatos de archivo y el Volumen de Exportación de VM para portabilidad saliente, VergeOS garantiza que la movilidad de las cargas de trabajo nunca sea una barrera para la adopción. --- # 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/learn-the-platform/es/modulo-6-maquinas-virtuales/04-vm-migration-import.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.