Manual

Instalación

La instalación convierte una máquina física en un Host de hv con un Pool inicial, un SR local y servicios de gestión. Destruye el disco seleccionado. Antes de empezar, identifique ese disco, conserve los datos necesarios, anote la configuración de red y prepare acceso a una consola que siga disponible si falla la red de gestión.

Preparar el medio de instalación

Obtenga la ISO de la versión y su suma de comprobación de quien distribuye hv. Descargue la imagen de la versión que desea instalar y compare su suma con el valor publicado. Si no coinciden, deténgase y obtenga la imagen correcta antes de escribir ningún medio. Conserve los datos de la versión junto con las notas de instalación para identificarla después.

Puede escribir la ISO en un USB o montarla como medio virtual mediante un proveedor de servidores físicos o el BMC del servidor. El medio virtual resulta útil cuando no tiene acceso físico al equipo. En ambos casos, seleccione arranque UEFI y mantenga disponible la consola durante el primer reinicio.

Escribir un USB en Linux

La escritura destruye todo el contenido del dispositivo seleccionado. Identifique el USB por modelo y capacidad y desmonte sus particiones montadas antes de escribir. Use el dispositivo completo, no una partición. En este ejemplo, hv-release.iso es la imagen descargada y /dev/sdX representa el dispositivo USB. Sustituya ambos tras comprobarlos; elegir el disco del sistema de su equipo destruiría su contenido.

sudo dd if=hv-release.iso of=/dev/sdX bs=4M conv=fsync
sync

Espere a que dd termine correctamente y a que finalice sync antes de retirar el USB. Un error o una escritura interrumpida indican que el medio no está preparado. Revise el destino y la imagen y repita la escritura únicamente sobre el USB confirmado. La referencia de la CLI explica los argumentos y distingue los comandos del equipo de trabajo de los del Host.

Escribir un USB en macOS

Use el listado de discos para identificar el número del USB. Desmonte el disco USB completo antes de escribir, pero manténgalo conectado. /dev/diskN y /dev/rdiskN representan el mismo USB; sustituya N por el número comprobado. Son marcadores, no un destino recomendado.

diskutil list
diskutil unmountDisk /dev/diskN
sudo dd if=hv-release.iso of=/dev/rdiskN bs=4m
sync
diskutil eject /dev/diskN

Continúe con el comando siguiente solo si el anterior terminó correctamente. La escritura borra el dispositivo completo. Espere a que terminen la escritura y la sincronización antes de expulsarlo. También puede utilizar una herramienta gráfica de escritura de imágenes: seleccione la ISO, compruebe el USB de destino y escriba la imagen. Copiar la ISO a una carpeta del USB no crea el medio de instalación.

Montar medios virtuales

Abra la consola del proveedor o la del BMC, seleccione su función de medios virtuales y conecte la ISO descargada. Elija ese CD/DVD virtual como dispositivo de arranque UEFI. Mantenga el medio conectado mientras el instalador lo lee; desconéctelo al terminar, antes de arrancar desde el disco instalado. Si el servidor vuelve al instalador tras reiniciar, revise el orden de arranque y los medios conectados antes de confirmar cualquier acción que pueda borrar otra vez el disco.

Ejecutar el instalador interactivo

El cuestionario aparece en tty1. La consola serie puede mostrar el arranque sin mostrar el cuestionario; tty2 y la consola serie ofrecen acceso de recuperación.

1. Seleccione el disco, el nombre de host y la zona horaria.
2. Elija la NIC de gestión por número, nombre o MAC. Revise la concesión DHCP mostrada. Configure DHCP o IPv4 estática, una VLAN opcional e IPv6 si hace falta.
3. Indique la credencial de root. Es el acceso a dom0, distinto de una cuenta de hv.
4. Elija public o private. El valor predeterminado es público. Indique los datos del primer administrador o deje vacío el correo para obtener un token en el primer arranque.
5. Revise el repositorio de versiones y el canal. Conservar los de la ISO evita una nueva decisión de confianza. Otra URL exige la huella de su clave raíz y conectividad antes de modificar el disco.
6. Revise el modo dom0, el tamaño del SR local y la creación o incorporación a un Pool. Confirme el borrado solo después de comprobar la selección completa.
7. Espere a que termine, retire la ISO o el USB y arranque desde el disco instalado. Continúe con primer arranque.

Una instalación fallida no restaura el contenido anterior del disco. Conserve el paso que falló y su diagnóstico; no ejecute dos instaladores sobre el mismo disco.

Instalación desatendida

Use un archivo de respuestas preparado para la misma versión de hv y revisado para este Host concreto. Conserve una copia privada y sustituya todos los valores de demostración antes de usarlo. Hacen falta disco, nombre de host, zona horaria, credencial de root y selección de red. La tabla opcional [admin] prepara la primera cuenta de hv; omítala para usar el token de configuración. No reutilice las credenciales de ejemplo.

El archivo de respuestas autoriza el borrado de su disco: no hay una confirmación adicional en modo desatendido. Desde la consola de recuperación del medio, detenga el instalador automático antes de ejecutar otra instancia:

rc-service hv-installer-live stop
hv-installer --answers /root/answers.toml --dry-run
hv-installer --answers /root/answers.toml

Ejecute el último comando solo tras revisar el plan. El modo dry-run valida respuestas y muestra los pasos, pero no demuestra que exista la NIC ni que el sistema vaya a arrancar. reboot es false por defecto. Si se activa, cambie el orden de arranque para evitar una reinstalación con las mismas respuestas.

También se admiten hv.answers=SOURCE y hv.answers_sha256=HEX en la línea de arranque. Use un archivo local o un origen HTTPS de confianza; nunca incluya credenciales en una URL. La descarga de respuestas necesita conectividad en el entorno de instalación, cuya red puede diferir de la configuración estática final.

Servidores públicos con una NIC e incorporación a pools

Use la MAC y el direccionamiento asignados por el proveedor. Con prefijo estático 32, la puerta de enlace puede estar fuera de la subred; el servicio instalado de puerta de enlace on-link crea la ruta necesaria. IPv6 se configura además de IPv4. No suponga un nombre de interfaz ni conecte MAC de VM a una red que no las permita.

El perfil public sitúa la administración en el puerto 8443 por defecto. No completa la cesión de la NIC al Edge. Para un servidor público nuevo, la ruta documentada es instalar su Pool inicial y después usar el código de incorporación de la consola; consulte añadir Hosts. El esquema también acepta [pool] mode = "join", dirección y acceso al coordinador, pero la admisión pública sigue necesitando el procedimiento con código. Use la incorporación interactiva posterior a la instalación para los Hosts públicos.

Tras arrancar, compruebe dirección, rutas, servicios, pertenencia al Pool y SR local. Si falta el disco o la NIC, resuelva primero el soporte de controladores o firmware. Si falla el acceso, use la consola y la resolución de problemas, no otro borrado del disco.

Comprobar la instalación terminada

Por ejemplo, después de instalar hv-01 en 192.0.2.10, use la URL de gestión que muestra ese Host en lugar de deducirla del perfil de otro servidor. Inicie sesión, compruebe que hv-01 pertenece a su Pool inicial y revise el SR local. Primer arranque explica la configuración de la cuenta y las comprobaciones de servicios. Complételas antes de añadir el servidor a otro Pool o crear cargas de trabajo.

El disco de instalación contiene dos raíces para actualizaciones de plataforma, estado de gestión compartido y almacenamiento local de VM. Cada zona tiene una función distinta en la recuperación. Revertir una raíz no restaura el contenido original del disco ni los datos de los invitados. Prepare las copias de seguridad después de instalar y antes de guardar datos irremplazables en el Host.

Si la URL de gestión no responde, vuelva a la consola del servidor y revise dirección y rutas. Compárelas con los datos anotados, incluida la VLAN de gestión o la puerta de enlace del proveedor. Un servidor accesible con un inicio de sesión fallido necesita recuperar la cuenta; una dirección inaccesible requiere diagnosticar la red o los servicios. Ninguno de los dos problemas exige reinstalar como primera medida.