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.

:::note[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 Haciendo una copia de seguridad de tu dispositivo.

:::

Best prácticas antes de actualizar
  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 del grupo

Al actualizar a Unraid 7.x, puedes ver advertencias sobre las actualizaciones de características del grupo ZFS durante el inicio o en el WebGUI. Estas advertencias no son una señal de problema; simplemente indican que tu grupo 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, recuerda hacer una copia de seguridad de tus datos antes de actualizar tus grupos de 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.

El array o los contenedores Docker son lentos al arrancar después de la actualización - Haga clic para expandir/colapsar

Podría ser necesaria una migración única para los contenedores de Docker después de 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 Docker no funcionan correctamente después de la actualización - Haga clic para expandir/colapsar

Si encuentras errores como "las capas del manifiesto no coinciden con la configuración de la imagen", es posible que necesites reconstruir tu archivo de imagen de Docker. Aquí te explicamos cómo:

  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".
El array o los contenedores Docker son lentos al arrancar después de la actualización - Haga clic para expandir/colapsar

Podría ser necesaria una migración única para los contenedores de Docker después de 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.

  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.
Los contenedores Docker no funcionan correctamente después de la actualización - Haga clic para expandir/colapsar

Si encuentras errores como "las capas del manifiesto no coinciden con la configuración de la imagen", es posible que necesites reconstruir tu archivo de imagen de Docker. Aquí te explicamos cómo:

  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.
Las VMs muestran "no se puede obtener la interfaz MTU" o errores de red - Haga clic para expandir/colapsar

Si tienes OVMF-basados VMs creados en versiones anteriores de Unraid, podrías encontrar un shell EFI. Puedes arrancar el VM introduciendo 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 continúas teniendo problemas, por favor visita los foros de Unraid para obtener asistencia.

El acceso VNC a las VMs no funciona o es lento - Haga clic para expandir/colapsar

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

La VM no arranca (aparece shell EFI) - Haga clic para expandir/colapsar

Si tienes OVMF-basados VMs creados en versiones anteriores de Unraid, podrías encontrar un shell EFI. Puedes arrancar el VM introduciendo los siguientes comandos:

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.