Migrar, exportar e importar una VM
Use una VM desechable sin datos de producción. Acceda al appliance XOA-HL como administrador y confirme que están disponibles los hosts, el almacenamiento y la VM. Migrar y exportar mueven o copian una VM completa; ninguna operación sustituye una prueba independiente de copia de seguridad y restauración.
xoa-image-20261022-a280852, paquete v5.113.2_e281c536-ce40 (Xen Orchestra 5.113.2). Basado en el código publicado; migración, exportación e importación aún no probadas en un laboratorio. Las versiones posteriores pueden diferir.1. Elija la operación
| Objetivo | Operación | Resultado |
|---|---|---|
| Ejecutar la misma VM en otro host de su pool | Migrate | Mismo objeto VM; los discos siguen en almacenamiento compartido o se copian a un SR seleccionado |
| Conservar un archivo portátil de una VM detenida | Export como XVA | Archivo guardado por el navegador; sin programación, retención ni comprobación de restauración |
| Crear una VM independiente desde un archivo XVA | Import | Objeto VM nuevo con identidades del invitado copiadas; aíslelo como un clon |
| Recuperarse de una pérdida | Copia de seguridad y restauración | Copia independiente validada mediante una restauración aislada |
Esta guía cubre migración entre hosts del mismo pool, exportación XVA sin compresión e importación de archivos XVA. Quedan fuera la migración entre pools, reasignación de redes, archivos OVA, importación desde URL, importación/exportación solo de discos e importación VMware. El menú HomeLab oculta la entrada de importación VMware.
Los modos adicionales revisados en el código fuente se describen en Modos de transferencia adicionales; la aceptación en una instalación sigue siendo independiente.
2. Migre una VM dentro de su pool
Requisitos que debe comprobar antes de empezar:
- El pool tiene al menos dos hosts conectados y usted tiene permiso de administración sobre la VM y el host de destino.
- El host de destino alcanza las redes y el almacenamiento de la VM. Los discos en un SR compartido no necesitan copia. Un disco en almacenamiento inaccesible desde el destino, como un SR local, se copia.
- Una ventana de mantenimiento. Un invitado en ejecución se pausa brevemente durante la migración en vivo; copiar discos tarda más y requiere capacidad libre en el SR de destino.
- Un registro del ID de la VM, host actual, cada disco y su SR, y una comprobación del invitado, como acceso por consola o una prueba de aplicación.
- Abra la VM y elija Migrate. Está disponible para VM en ejecución o detenidas, no suspendidas ni pausadas. Los usuarios de autoservicio no la ven.
- En Migrate VM, use Select a destination host: para elegir otro host del mismo pool. La lista excluye el host actual. También puede enumerar hosts de otros pools conectados; no los elija en este ejercicio.
- Lea la sección de almacenamiento. Si todos los discos están en un SR compartido, no hace falta elegir SR. De lo contrario, XO exige un SR principal (Select main SR…) y permite elegir uno por VDI. Elija SR con escritura y espacio libre suficiente; esos discos se copiarán.
- Select a migration network: es opcional dentro de un pool. XO preselecciona la red de migración configurada en el pool cuando el host de destino tiene dirección en ella. Seleccionar cualquier red hace que XO use la vía de migración de almacenamiento en vez de una migración simple del pool. Mantenga el valor propuesto salvo que el diseño del pool especifique otra red.
- Confirme y espere a que termine la tarea. No vuelva a pulsar mientras la migración esté pendiente.
- Actualice la pestaña General de la VM. Compruebe host, estado, consola, red del invitado y aplicación. Tras copiar discos, compruebe dónde reside ahora cada uno y el espacio libre en ambos SR.
Si una migración simple de pool indica que necesita un SR, XO la reintenta automáticamente como migración de almacenamiento. Entonces usa los SR conectados al host de destino o el SR predeterminado del pool. Una migración que esperaba rápida puede convertirse en una copia de discos. Si falla, conserve el error de la tarea y compruebe host, estado y discos de la VM en cada SR implicado antes de repetir. No repita con la opción de forzar.
3. Exporte una VM detenida como archivo XVA
Necesita permiso de administración sobre la VM y espacio libre suficiente en el equipo que ejecuta el navegador.
- Apague limpiamente el invitado y confirme Halted. Anote ID de VM, nombre, discos y tamaño total.
- Elija Export. Mantenga Type en
xvay Compression en Disabled, su valor predeterminado. Las otras opciones son GZIP (muy lenta) y, en hosts XCP-ng, Zstd. Importar un XVA comprimido queda fuera de esta guía. - Confirme. Download VM muestra un enlace de descarga, OK y Cancel. El enlace y OK abren la misma URL, que el mensaje describe como válida una sola vez durante un breve periodo. Use solo uno: seleccione el enlace y cierre el diálogo con Cancel. La URL contiene un token de acceso de un solo uso: trátela como secreto hasta usarla.
- El navegador guarda un archivo llamado
<date> - <VM name>.xva. Mantenga la descarga hasta que termine; cancelarla detiene la exportación. Compruebe que el tamaño es razonable frente a los tamaños de disco anotados. - En el equipo del navegador, anote una suma de comprobación, por ejemplo
sha256sum "<file>.xva". Úsela para comprobar el archivo antes de importarlo.
Por defecto se ejecutan como máximo dos exportaciones XVA simultáneas por pool. Otra descarga falla en vez de esperar. Deje terminar las activas y solicite un enlace nuevo.
Un XVA contiene discos y configuración de la VM. Almacénelo como los datos que contiene y elimínelo al acabar la prueba. Un archivo exportado no tiene programación, retención ni validación de restauración: no es una tarea de copia de seguridad.
[XO Export] <VM name>. Esta copia no es coherente a nivel de aplicación. XO elimina la instantánea al terminar la descarga. Si falla su eliminación, solo registra un aviso y la instantánea puede quedar en el SR. Tras exportar una VM en ejecución, compruebe su pestaña Snapshots. Esta guía usa una VM detenida.4. Importe el XVA como copia aislada
- Abra Import > VM (
/#/import/vm). La entrada solo aparece si puede operar al menos un pool. - Elija el pool de destino en To Pool:. To SR: propone el SR predeterminado del pool. Elija uno con escritura y espacio libre suficiente.
- Suelte el archivo
.xvaen el área Drop OVA or XVA files here to import Virtual Machines. Compruebe su nombre y tamaño en la lista. Los archivos sin extensión.xvau.ovase ignoran. Deje From URL desactivado. - Seleccione Import y mantenga abierta la pestaña hasta que termine la carga. Para un solo archivo, XO abre la página de la nueva VM tras el éxito.
- Mantenga detenida la VM importada. Anote su ID: es un objeto distinto del original incluso si conserva su nombre. Renómbrela para evitar confusiones.
- Antes del primer arranque, abra Network y quite todas las interfaces virtuales o establezca un aislamiento externo verificado. La copia contiene el mismo SO invitado, configuración IP, nombre de host, credenciales e identidades de aplicaciones que la fuente.
- Arranque la copia y compruebe su consola y los datos de prueba anotados.
XO rechaza arrancar una VM cuya MAC duplique la de otra interfaz propia o la de una VM en ejecución. El código de error es DUPLICATED_MAC_ADDRESS. No fuerce el arranque; quite o aísle antes la interfaz.
Si falla la importación (VM import failed), pueden quedar objetos. Compruebe los discos del SR de destino y la lista de VM en busca de objetos creados durante el intento antes de repetir. Elimine solo restos identificados con certeza mediante el procedimiento de eliminación de VM desechables.
5. Limpie
- Elimine la VM de prueba importada mediante el procedimiento de eliminación de VM desechables.
- Elimine el archivo XVA del equipo y de cualquier ubicación temporal.
- Confirme que la VM fuente sigue presente, en el host esperado y con sus discos y datos intactos.
Si algo no coincide, conserve los registros y comunique el problema con las versiones e identificadores saneados.
Fuentes
Contrastado con el commit de XO 5 e281c536 con los parches HomeLab publicados: barra de acciones de VM, acciones de migración, exportación e importación, diálogo de migración, red de migración predeterminada, diálogo de exportación, opciones de compresión, página de importación, API de VM, comprobaciones XAPI de migración, importación y arranque, gestión de instantáneas de exportación, exportaciones simultáneas y etiquetas de interfaz. Cambios del menú HomeLab: entrada de importación VMware.
Modos de transferencia adicionales (VM08)
Alcance: XO 5.113.2 e281c536, fuentes de XOA-HL ce40/ce47. Use un administrador y una VM desechable accesible por consola, con discos normales, una muestra con suma de comprobación ya volcada a disco, sin VIF, con los trabajos desactivados y con espacio suficiente para instantáneas e importaciones temporales. Conserve una copia de seguridad independiente. La aceptación en laboratorio es específica de cada modo.
- Exportación en ejecución: vuelque la muestra a disco, deje la VM aislada en ejecución, elija Export, tipo XVA y compresión Disabled. Descargue el archivo completo y anote su tamaño y hash. La exportación en ejecución usa una instantánea temporal
[XO Export]; compruebe su limpieza y el estado del origen tras finalizar o cancelar. No es una exportación coherente con las aplicaciones ni de la memoria. - XVA comprimido: repita con la compresión GZIP (very slow) (
native); pruebe Zstd por separado solo si el host lo ofrece. Anote la selección exacta. Mantenga la extensión.xva. Importe cada archivo completo con Import → VM en el SR desechable, como en el procedimiento XVA. No deduzca la aceptación de la importación comprimida a partir de un éxito sin compresión. - OVA: exporte la misma VM aislada con el tipo OVA; el selector de compresión XVA no se aplica. En Import → VM, seleccione el
.ovadescargado, revise el nombre, la CPU, la RAM, los discos y las redes leídos, elija el SR e importe una vez. Que la lectura funcione no demuestra el arranque del invitado ni la fidelidad. Anote cualquier error de disco o formato no admitido, sin convertir ni descartar discos en silencio para que pase. - Importación por URL: coloque un XVA completo y con hash en una URL controlada por el propietario y accesible desde el appliance. Use Import → VM → From URL, tipo XVA, la URL exacta y el SR de prueba. El appliance descarga la URL; el acceso desde el navegador no basta. No incluya credenciales en ella. Esta versión fijada rechaza las importaciones de VM por URL que no sean XVA. Una solicitud fallida puede dejar objetos: haga inventario antes de reintentar.
- Solo disco: use Import → Disk, elija el SR de prueba con escritura y un archivo
.vhd,.vmdko.rawconocido (ISO tiene sus propios requisitos de SR). Compruebe el nombre, el formato, el tamaño y el UUID del VDI resultante. Esto crea un disco, no una VM arrancable. Conéctelo a una VM de recuperación detenida en una posición libre, quite todas las VIF, arránquela y compruebe la muestra. En la pestaña Disks de la VM de origen, la acción de descarga del disco exporta un único VDI; elija un formato admitido de los ofrecidos, guárdelo, calcule su hash e impórtelo por separado para la misma comprobación. La importación de discos por URL en esta interfaz solo ofrece ISO; no es una importación general de VM por URL ni un conversor de discos arbitrario.
En cada VM importada, compruebe un UUID distinto, el número, tamaño y SR de los discos y el estado de energía. Manténgala detenida y quite todas las VIF heredadas antes de arrancarla. Compruebe el arranque por consola y la suma de comprobación de la muestra. Tras las comprobaciones, elimine solo las copias y VDI de prueba identificados. Si hay una interrupción, conserve el archivo y el error y compare los inventarios de origen, destino, instantáneas y capacidad; un nombre de archivo descargado o una notificación de éxito no es una prueba de restauración.
Implementación fijada: packages/xo-server/src/api/vm.mjs, @xen-orchestra/xapi/vm.mjs, packages/xo-server/src/xapi/index.mjs, packages/xo-web/src/xo-app/vm-import/index.js, packages/xo-web/src/xo-app/disk-import/index.js, packages/xo-web/src/xo-app/vm/tab-disks.js, packages/xo-server/src/api/disk.mjs.
Resultado de laboratorio, 3 de noviembre de 2026 (parcial, API y no navegador): Observado a través de los métodos REST y JSON-RPC de exportación e importación que usan estas páginas. Una exportación en ejecución del invitado de laboratorio (disco de 4 GiB) terminó sin compresión con 3.251.286.528 bytes. vm.export con compress en gzip y en zstd devolvió envoltorios gzip (323.244.900 bytes) y zstd (295.357.297 bytes) del archivo completo, no compresión por bloques; ambos se descomprimen a 3.251.286.528 bytes. La exportación REST solo acepta un compress booleano. La importación por URL de ambos archivos comprimidos funcionó (VM nuevas detenidas con direcciones MAC nuevas). La exportación OVA del invitado en ejecución produjo metadata.ovf y un VMDK, pero la subida de ese OVA al punto de importación se quedó bloqueada más de nueve minutos y dejó una VM parcial [Importing...], así que la importación OVA no se acepta. La importación de discos por URL solo aceptó VHD y raw; se rechazaron las importaciones por URL de VMDK y QCOW2, y una exportación QCOW2 devolvió HTTP 500 (unknown error). Un archivo VHD importado como raw creó un disco erróneo de 2 MiB, así que declare correctamente el formato. No se comprobaron el arranque del invitado ni sumas de comprobación de datos, y el modo sigue pendiente.