Saltar al contenido principal

Fallas de arranque e inicio

Cuando su servidor Unraid no arranca correctamente, puede ser un desafío identificar la causa sin una comprensión clara del proceso de arranque. Siguiendo esta guía, podrá diagnosticar y resolver rápidamente la mayoría de los problemas de inicio, asegurando que su array, WebGUI y servicios estén operativos con un tiempo de inactividad mínimo.

Preparando el dispositivo flash​

Este tema está detallado en la sección Preparar tu dispositivo USB.

precaución

Siempre haga una copia de seguridad de su unidad flash antes de realizar cambios. Todos los ajustes específicos de usuario, incluida su clave de licencia, se almacenan en la carpeta config. Restaurar esta carpeta después de reconfigurar su dispositivo flash ayudará a preservar su configuración actual.

Habilitando el arranque UEFI​

Los sistemas modernos típicamente requieren modo de arranque UEFI para una seguridad mejorada y tiempos de inicio más rápidos.

Para configurar el arranque UEFI en el BIOS de tu sistema/configuración UEFI:

  1. Entra en la configuración del BIOS/UEFI de tu placa base durante el inicio (generalmente presionando F2, DEL o ESC)
  2. Localiza las opciones de arranque o configuraciones del modo de arranque
  3. Configura el modo de arranque en UEFI o UEFI con CSM desactivado
  4. Asegúrate de que el dispositivo flash de Unraid esté seleccionado como el dispositivo de arranque UEFI
  5. Guarda tus cambios y sal de la configuración

Comprender la secuencia de inicio​

La secuencia de inicio de Unraid tiene varias etapas:

1. Arranque de BIOS - Haz clic para expandir/contraer

El firmware BIOS/UEFI inicializa el hardware y localiza el dispositivo de arranque. Esta es la base de todo el proceso de arranque.

  • El BIOS de la placa base reconoce el dispositivo flash de arranque de Unraid.
  • Configurar el dispositivo flash como el dispositivo de arranque predeterminado varía según tu BIOS; revisa el manual de tu placa base para obtener orientación.
  • El dispositivo flash admite modos de arranque legado (CSM) y UEFI.
  • Para el arranque UEFI, asegúrate de que la carpeta EFI en el dispositivo flash no tenga un guion al final (-).
2. Cargador de Syslinux - Haz clic para expandir/contraer

El cargador de arranque presenta opciones de inicio y carga el núcleo de Linux en la memoria. Esta etapa determina qué sistema operativo o herramienta de diagnóstico se ejecutará.

  • Las entradas del menú de arranque están definidas en el archivo syslinux/syslinux.cfg en el dispositivo flash.
  • Puedes editar este archivo a través del WebGUI bajo Principal → Configuración Syslinux.
  • Memtest86+, que se incluye con las versiones actuales de Unraid, funciona tanto en modos heredados como en UEFI. Para versiones más antiguas de Unraid, obtenga una versión compatible del sitio oficial de Memtest para UEFI.
  • Si no se selecciona ninguna opción, el arranque predeterminado se ejecuta tras un tiempo de espera, lo cual es útil para operaciones sin cabeza.
3. Núcleo de Linux - Haz clic para expandir/contraer

El núcleo de Linux se inicializa y comienza la detección de hardware. Aquí es donde el sistema operativo toma el control del cargador de arranque.

  • Syslinux carga el núcleo de Linux desde el dispositivo flash en la RAM.
  • Verás mensajes de consola mostrando los archivos bz* cargándose.
  • Los errores en esta etapa a menudo indican problemas con el dispositivo flash.
  • Linux detecta el hardware durante el inicio.
4. Servicios dependientes del flash - Haz clic para expandir/contraer

El dispositivo flash se vuelve accesible y los servicios esenciales comienzan a cargarse. Esta etapa es crítica para la configuración y el acceso a la red.

  • El dispositivo flash se monta en /boot.
  • Si falla al montar, aún puedes ver un indicador de inicio de sesión, pero esto indica un inicio incompleto.
  • Usa el comando df para comprobar si /boot está montado.
  • El dispositivo flash debe estar etiquetado como UNRAID (todo en mayúsculas) para un montaje adecuado.
  • Controladores y firmware adicionales estarán disponibles en esta etapa.
  • La configuración se carga en la RAM.
  • Los servicios estándar de Linux, incluyendo la red y el VPN de WireGuard (si está habilitado), comienzan aquí.
5. Complementos - Haz clic para expandir/contraer

Se cargan extensiones de terceros y personalizaciones para mejorar la funcionalidad del sistema. Los problemas de complementos pueden impedir un inicio exitoso.

  • Los plugins instalados se cargan durante este paso.
  • Opciones de Arranque seguro pueden suprimir la carga de plugins si es necesario.
6. WebGUI - Haz clic para expandir/contraer

La interfaz de administración basada en la web se vuelve disponible, permitiendo la administración remota y configuración de tu servidor.

  • El WebGUI comienza en este punto.
  • El archivo config/go en el dispositivo flash puede ejecutar comandos de usuario antes o después de que el WebGUI comience.
7. Array - Haz clic para expandir/contraer

Los dispositivos de almacenamiento se montan y están disponibles, completando el proceso de arranque. Esta es la etapa en la que sus datos se vuelven accesibles.

  • Si el auto-arranque está habilitado, el array comienza aquí; de lo contrario, se requerirá un inicio manual.
  • Las unidades se montarán como /dev/diskX y /mnt/cache (si está presente).
  • Las particiones compartidas se vuelven disponibles en la red como /mnt/user/sharename.
  • Los contenedores de Docker se iniciarán en el orden especificado en la pestaña Docker, con retrasos personalizables.
  • Las máquinas virtuales de autoinicio (VMs) también se lanzarán.

En este punto, el servidor Unraid está completamente operativo.

Falla de arranque​

Cuando su servidor no arranca, la solución sistemática de problemas ayuda a identificar y resolver rápidamente la causa raíz. Siga estos pasos en orden para evitar omitir problemas críticos o realizar cambios innecesarios. Cada paso se basa en el anterior, por lo que no se adelante aunque un paso parezca no estar relacionado con su problema específico.

  1. Use un puerto USB 2.0 para el dispositivo flash si es posible. Por lo general, es más confiable y menos propenso a problemas que el USB 3.0.
  2. Revisa la configuración de tu BIOS/UEFI para asegurarte de que el dispositivo flash esté configurado como el dispositivo de arranque principal.
  3. Inspecciona el dispositivo flash en busca de errores físicos o lógicos en una computadora con Windows o macOS.
  4. Reextraiga los archivos bz* de la versión de Unraid en el dispositivo flash para prevenir cualquier corrupción potencial.
  5. Reconstruye el dispositivo flash comenzando con una copia limpia de Unraid, luego restaura tu carpeta config.
  6. Intenta arrancar en Modo Seguro para verificar si hay problemas relacionados con plugins.
  7. Pruebe con un nuevo dispositivo flash y realice una instalación limpia de Unraid. Esto ayuda a determinar si hay problemas con el hardware del servidor.
  8. Si es necesario, transfiere tu licencia a un nuevo dispositivo flash.

Recuperando de una pérdida del disco de arranque y unidades de paridad desconocidas​

important

Este proceso de recuperación implica el riesgo de pérdida de datos si las unidades se asignan incorrectamente. Antes de proceder:

  1. No inicie el array hasta que estés seguro sobre la asignación de las unidades
  2. Documentar cuáles discos eran anteriormente de paridad vs. discos de datos
  3. Considera buscar ayuda en los foros de Unraid si no estás seguro

Si tienes copias de seguridad recientes o documentación de la configuración de tu array, revísalos primero.

Si su unidad de arranque de Unraid falla y no tiene una copia de seguridad reciente o no sabe qué unidades son de paridad, puede recuperar su sistema utilizando la capacidad de Unraid para reconocer unidades de datos por sus sistemas de archivos. Las parity drives no tienen un sistema de archivos válido, lo que ayuda a diferenciarlas.

Unraid identifies data drives by detecting existing valid file systems. Parity drives, which lack a file system, appear unmountable. This characteristic allows you to distinguish parity drives from data drives after booting with a new flash device.

Procedimiento de recuperación​

Este procedimiento le ayuda a restaurar la configuración de su array cuando ha perdido su unidad de arranque y no recuerda qué unidades eran de paridad frente a datos. Siga cada paso con cuidado para evitar la pérdida de datos.

  1. Crea una nueva unidad de arranque de Unraid.
  2. Arranca el servidor desde esta nueva unidad (no asignes ninguna unidad todavía).
  3. Activa una licencia, usando ya sea una de prueba o transfiriendo una existente.
  4. Identifica los parity drives usando uno de los métodos descritos a continuación.
  5. Usa Herramientas → Nueva Configuración para restablecer el array mientras retienes, si es posible, asignaciones anteriores.
  6. Asigna correctamente las unidades en la pestaña Principal, asegurándote de distinguir entre paridad y unidades de datos.
  7. Comienza el array para confirmar las asignaciones de disco.
  8. Si la parity es válida, marque la casilla de Parity is Already Valid. Si no, permita que la parity se reconstruya.
Multiple unidades de paridad

Si tiene múltiples parity drives y tuvo que identificarlas basándose en qué unidades eran no montables, no use la opción Parity is Already Valid. Hay un 50:50 de probabilidad de asignarlas incorrectamente, y si lo hace, su array puede parecer protegido pero en realidad no lo está. Siempre permita que la paridad se reconstruya en este escenario para asegurar una protección adecuada.

  1. Revisa y ajusta cualquier inclusión/exclusión de usuario para compartir con base en las nuevas indicaciones.
  2. Ejecuta una parity check para verificar la integridad, especialmente si parity no fue reconstruido.

Identificación de los discos de paridad​

Usando la capacidad integrada de Unraid (método preferido) - Haz clic para expandir/colapsar

Este método no requiere complementos, pero invalidará la paridad, lo que requerirá una reconstrucción.

Para usar este método:

  1. Asigna todas las unidades como unidades de datos e inicia el sistema.
  2. Las unidades de paridad aparecerán como no montables ya que carecen de un sistema de archivos válido.
  3. Confirma que el número de unidades no montables coincide con tu conteo de paridad.
  4. Toma nota de los números de serie de estas unidades.
  5. Si es relevante, puedes verificar las unidades de datos montadas para confirmar su orden.
Usando el complemento Unassigned Devices - Haz clic para expandir/colapsar

Este método basado en complementos preserva la validez de la paridad montando las unidades en modo de solo lectura.

Para usar este método:

  1. Instala el plugin Dispositivos no asignados desde la pestaña Aplicaciones.
  2. Monta cada disco en modo de solo lectura, uno a la vez.
  3. Las unidades que no se montan probablemente sean parity drives (no puedes diferenciar entre paridad1 y paridad2).
  4. Inspecciona las unidades de datos montadas para identificar su orden, si es necesario.

Para más información, ve el hilo del plugin Dispositivos no asignados en los foros de Unraid.

* "WireGuard" y el logotipo de "WireGuard" son marcas registradas de Jason A. Donenfeld.