Saltar al contenido principal

Actualización de Unraid

Actualizar el sistema operativo Unraid garantiza que dispongas de las características más recientes, actualizaciones de seguridad y soporte para hardware. Esta página describe el proceso estándar de actualización, junto con consejos para solucionar problemas y opciones de actualización manual.

Prerequisites

Antes de comenzar la actualización, asegúrate de crear una copia de seguridad completa de tu dispositivo USB. Para más detalles, consulta Respaldar tu dispositivo flash.

Best prácticas antes de la actualización
  1. Hacer una copia de seguridad de su unidad flash y cualquier dato importante.
  2. Lea las notas de la versión para la versión que planea instalar.
  3. Actualice todos los complementos a sus versiones más recientes.
  4. Opcionalmente, detenga el array antes de proceder.
  5. Actualice Unraid OS utilizando la página Herramientas → Actualizar OS.
  6. Reinicie su servidor para completar la actualización.

Proceso de actualización estándar

La actualización de Unraid se realiza usando la nueva herramienta Actualizar OS con una interfaz fácil de usar:

  1. En el WebGUI, haga clic en el menú desplegable de arriba a la derecha y seleccione Buscar actualizaciones o navegue a Herramientas → Actualizar OS.
  2. Elija el canal Estable para versiones estables o el canal Siguiente para betas y RCs.
  3. Haz clic en Ver Registro de Cambios para Comenzar la Actualización. El Registro de Cambios aparecerá para que lo revises antes de presionar Continuar.
  4. Haga clic en Confirmar y comenzar actualización para aplicar la última versión estable.
  5. Cuando se le pida, reinicie su servidor para completar la actualización.
nota

Es posible que deba iniciar sesión en su cuenta Unraid para acceder a las actualizaciones, especialmente para lanzamientos de la rama "Siguiente".

ZFS advertencias de actualización de pool

Al actualizar a Unraid 7.x, puede ver advertencias sobre actualizaciones de características del pool ZFS durante el arranque o en el WebGUI. Estas advertencias no son un signo de un problema; simplemente indican que su pool de ZFS está utilizando características de una versión anterior de ZFS.

No es urgente actualizar tu grupo, pero si decides hacerlo, ten en cuenta que podría no funcionar con versiones anteriores de Unraid. Esto significa que es posible que no puedas volver a una versión anterior de Unraid después de actualizar.

Como siempre, recuerde hacer una copia de seguridad de sus datos antes de actualizar sus pools ZFS.


Solución de problemas de actualización

Si encuentra problemas después de la actualización, consulte la sección relevante a continuación para obtener asistencia.

Los contenedores del array o de Docker tardan en iniciarse después de la actualización - Haga clic para expandir/contraer

Podría ser necesario migrar contenedores de Docker una sola vez tras ciertas actualizaciones. Este proceso puede llevar tiempo, especialmente si tienes muchas imágenes. Sé paciente durante este proceso; el rendimiento debería normalizarse después del inicio inicial.

Los contenedores de Docker no funcionan correctamente después de la actualización - Haga clic para expandir/contraer

Si encuentras errores como "las capas del manifiesto no coinciden con la configuración de la imagen," puede que necesites reconstruir tu archivo de imagen de Docker. Aquí se explica cómo hacerlo:

  1. Vaya a Configuración → Docker y detenga el servicio Docker.
  2. Marque la casilla para eliminar la imagen Docker y haga clic en el botón de eliminar.
  3. Reinicie Docker para recrear la imagen.
  4. Navegue a la pestaña Aplicaciones, Aplicaciones anteriores y marque lo que desea reinstalar y haga clic en "Instalar xx Aplicaciones".
Las máquinas virtuales muestran "no se puede obtener la MTU de la interfaz" o errores de red - Haga clic para expandir/contraer

Si ha utilizado un nombre de puente personalizado para la red VM, actualice todas las VMs para usar el puente predeterminado br0 siguiendo estos pasos:

  1. Vaya a la pestaña VMs y edite cada VM (asegúrese de habilitar Vista avanzada).
  2. Configure el puente de red en br0 y haga clic en Aplicar.
  3. Navegue a Configuración → Administrador de VM (en Vista avanzada) y configure el puente predeterminado en br0.
El acceso VNC a las máquinas virtuales no funciona o es lento - Haga clic para expandir/contraer

Para las VMs más antiguas, es posible que necesites actualizar el controlador de vídeo VNC:

  1. Edite la VM desde la pestaña VMs (seleccione Vista avanzada).
  2. Establece el controlador de vídeo VNC en QXL (recomendado). Prueba con Cirrus o vmvga si tienes éxito limitado con QXL.
  3. Haga clic en Aplicar para guardar los cambios.
La máquina virtual no arranca (aparece la consola EFI) - Haga clic para expandir/contraer

Si tienes OVMF-basadas VMs creadas en versiones antiguas de Unraid, podrías encontrar un shell EFI. Puedes arrancar la VM con los siguientes comandos:

  1. Escriba fs0:.
  2. Luego escriba cd efi/boot.
  3. Finalmente, escriba bootx64.efi.

Si fs0: no funciona, puedes intentar con fs1:. Si sigues teniendo problemas, por favor visita los foros de Unraid para obtener asistencia.

Intentar iniciar mi máquina virtual da un error "Tipo de máquina inválido" - Haga clic para expandir/contraer

Para resolver esto, edita la VM en el WebGUI y haz clic en Aplicar sin realizar cambios. Esta acción actualizará el tipo de máquina a la versión más reciente compatible.

Pobre rendimiento de la máquina virtual después de la actualización - Haga clic para expandir/contraer

Si tu VM es lenta después de una actualización, ve a la configuración de la VM (en Vista avanzada) y actualiza la versión de tipo Máquina a la última revisión (por ejemplo, cambiar de i440fx-2.5 a i440fx-2.7). Asegúrate de no cambiar el prefijo (por ejemplo, no cambies de i440fx a Q35).


Actualización o degradación manual

Las actualizaciones manuales son raras, pero pueden ser necesarias si no puedes acceder al WebGUI o necesitas volver a una versión anterior. Antes de proceder, es importante hacer un respaldo de tu dispositivo USB, cuyos detalles puedes encontrar en Respaldar tu dispositivo flash.

Degradar utilizando la herramienta Downgrade OS (si el WebGUI es accesible)

Si puede acceder al WebGUI:

  1. Inicie sesión en el WebGUI.
  2. Navegue a Herramientas → Degradar OS.
  3. Su versión anterior se listará como la opción de degradación disponible.
  4. Haga clic en Degradar y siga las indicaciones.
  5. Reinicie su servidor cuando se le indique.
precaución

Ten en cuenta que bajar de versión puede generar problemas de compatibilidad con complementos o contenedores de Docker. Siempre respalda tu dispositivo USB y cualquier dato importante de antemano.

Metodos manuales (si el WebGUI es inaccesible)

Solo utilice estos métodos si no puede acceder al WebGUI:

  1. Descargue el archivo ZIP de la versión de Unraid desde el Historial de Versiones.
  2. Extraiga el archivo en su computadora.
  3. Acceda al flash share o conecte el dispositivo flash USB a su computadora.
  4. Cree un directorio previous si aún no existe.
  5. Mueva todos los archivos bz* y changes.txt al directorio previous.
  6. Copie los nuevos archivos bz* y changes.txt a la raíz de la unidad flash.
  7. Reinicie su servidor.