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 medio de arranque​

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

precaución

Siempre respalda tu dispositivo de arranque antes de hacer cambios. Todos los ajustes específicos del usuario, incluida tu clave de licencia, se almacenan en la carpeta config. Restaurar esta carpeta después de volver a preparar tu dispositivo de arranque ayudará a preservar tu 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 de arranque de Unraid esté seleccionado como el destino 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:

3. Núcleo de Linux - Haga 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.

  • El BIOS de la placa base reconoce el dispositivo de arranque de Unraid (normalmente una unidad flash USB).
  • Configurar el dispositivo de arranque como el destino de inicio predeterminado varía según tu BIOS; consulta el manual de tu placa base para obtener orientación.
  • El volumen de arranque admite los modos de arranque legacy (CSM) y UEFI.
  • Para el arranque UEFI, asegúrate de que la carpeta EFI en el volumen de arranque no tenga un guion final (-).
4. Servicios dependientes de Flash - Haga 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.

  • Las entradas del menú de arranque se definen en el archivo syslinux/syslinux.cfg del volumen de arranque.
  • Puedes editar este archivo a través del WebGUI bajo Principal → Configuración Syslinux.
  • Memtest86+, que se incluye con las compilaciones actuales de Unraid, funciona tanto en modos heredado como UEFI. Para versiones anteriores de Unraid, obtén una versión compatible del sitio oficial de Memtest para UEFI.
  • El dispositivo flash debe estar etiquetado como UNRAID (todo en mayúsculas) para un montaje adecuado.
5. Complementos - Haga clic para expandir/contraer

Las extensiones de terceros y personalizaciones se cargan para mejorar la funcionalidad del sistema. Problemas con los complementos pueden impedir el inicio exitoso.

  • Syslinux carga el núcleo de Linux desde el volumen de arranque en la RAM.
  • Opciones de Arranque seguro pueden suprimir la carga de plugins si es necesario.
  • Los errores en esta etapa a menudo indican problemas con el dispositivo de arranque.
  • Linux detecta el hardware durante el inicio.
4. Servicios que dependen del volumen de arranque - Haga clic para expandir/contraer

El volumen de arranque se vuelve accesible y los servicios esenciales comienzan a cargarse. Esta etapa es fundamental para la configuración y el acceso a la red.

  • El volumen de arranque se monta en /boot.
  • El archivo config/go en el dispositivo flash puede ejecutar comandos de usuario antes o después de que el WebGUI comience.
  • Usa el comando df para comprobar si /boot está montado.
  • El volumen de arranque 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í.
7. Conjunto - Haga clic para expandir/contraer

Los dispositivos de almacenamiento se montan y hacen disponibles, completando el proceso de arranque. Aquí es donde tus 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).
6. WebGUI - Haga 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 volumen de arranque puede ejecutar comandos de usuario antes o después de que se inicie el WebGUI.
7. Conjunto - Haga clic para expandir/contraer

Los dispositivos de almacenamiento se montan y hacen disponibles, completando el proceso de arranque. Aquí es donde tus 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 tu servidor no arranca, la solución de problemas sistemática ayuda a identificar y resolver rápidamente la causa raíz. Sigue estos pasos en orden para no omitir problemas críticos o hacer cambios innecesarios. Cada paso se basa en el anterior, por lo que no te adelantes incluso si un paso parece no estar relacionado con tu problema específico.

  1. Utiliza un puerto USB 2.0 para el dispositivo de arranque si es posible (al arrancar desde USB). Generalmente es más confiable y menos propenso a problemas que USB 3.0.
  2. Revisa la configuración de tu BIOS/UEFI para asegurarte de que el dispositivo de arranque de Unraid esté configurado como el destino de arranque principal.
  3. Inspecciona el dispositivo de arranque en busca de errores físicos o lógicos en una computadora con Windows o macOS.
  4. Vuelve a extraer los archivos bz* de la versión de Unraid en el volumen de arranque para prevenir cualquier posible corrupción.
  5. Reconstruye el medio de arranque 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. Prueba con un nuevo medio de arranque y realiza 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 de arranque.

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

important

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.

  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 identifica los discos de datos al detectar sistemas de archivos válidos existentes. Parity drives, que carecen de un sistema de archivos, parecen no montables. Esta característica te permite distinguir los parity drives de los discos de datos después de arrancar con un nuevo medio de arranque.

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 un nuevo medio de arranque de Unraid.
  2. Arranca el servidor desde este nuevo dispositivo (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 incorporada de Unraid (método preferido) - Haz clic para expandir/contraer

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 plugin de Dispositivos no asignados - Haz clic para expandir/contraer

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 logo "WireGuard" son marcas registradas de Jason A. Donenfeld.