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. Actualiza Unraid OS utilizando la página de Herramientas → Actualizar OS.
6. Reinicie su servidor para completar la actualización.

Proceso de actualización estándar

Unraid 7.x y posteriores

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".

Unraid 6.11 a 6.12

Para las versiones de Unraid 6.11 y 6.12, siga este método de actualización tradicional:

1. En el WebGUI, vaya a Herramientas → Actualizar OS.
2. Haga clic en Buscar actualizaciones.
3. Si hay una nueva versión disponible, haga clic en Actualizar.
4. Reinicie su servidor cuando se le indique.

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.

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:

Las VMs muestran "no se puede obtener la interfaz MTU" o errores de red - 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í tienes cómo:

1. Ve a Configuraciones → Docker y detén el servicio Docker.
2. Luego escriba cd efi/boot.
3. Finalmente, escriba bootx64.efi.
4. Navegue a la pestaña Aplicaciones, Aplicaciones anteriores y marque lo que desea reinstalar y haga clic en "Instalar xx Aplicaciones".

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.

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. Navega a Configuraciones → Administrador de VM (en Vista Avanzada) y establece el puente predeterminado en br0.

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:

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:

---

Degradación manual

Las degradaciones manuales son raramente necesarias pero pueden serlo si no puedes acceder al WebGUI o necesitas volver a una versión anterior. Antes de proceder, es importante que hagas una copia de seguridad de tu dispositivo USB, cuyos detalles puedes encontrar en Copia de seguridad de tu dispositivo flash.

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

Método más simple

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.

Método de línea de comandos

precaución

Este método solo debe usarse si está cómodo con la línea de comandos de Linux, ya que los errores pueden hacer que su sistema no arranque.

1. Copie la URL del archivo ZIP de la versión deseada de Unraid desde el Historial de Versiones.

2. Inicie sesión a través de SSH o consola.

3. Ejecute los siguientes comandos uno a la vez (reemplace <URL> con el enlace copiado):

   cd /tmp
   rm -f unraid.zip
   rm -rf unraid_install
   wget -O unraid.zip <URL>
   [[ -s unraid.zip ]] && echo "OK to continue" || echo "STOP: the file was not downloaded"
   unzip -d unraid_install unraid.zip
   [[ -s unraid_install/bzroot ]] && echo "OK to continue" || echo "STOP: the file was not extracted properly"
   [[ ! -d /boot/previous ]] && mkdir /boot/previous
   mv /boot/bz* /boot/previous
   mv /boot/changes.txt /boot/previous
   cp unraid_install/bz* /boot
   cp unraid_install/changes.txt /boot
   sync -f /boot
   sleep 5
   reboot

What sucede durante el proceso de degradación

Al usar la herramienta Degradar OS (WebGUI), la herramienta manejará automáticamente lo siguiente:

1. Validación del sistema: Comprueba que la degradación sea segura de realizar.
2. Copia de seguridad de archivos: Se creará una copia de seguridad de tus archivos del sistema actuales.
3. Verificación de la versión: La herramienta se asegura de que los archivos para la versión objetivo sean válidos y completos.
4. Reemplazo de archivos: Reemplaza los archivos actuales del sistema operativo con los archivos de la versión anterior.
5. Preservación de configuraciones: Se mantendrán tus configuraciones actuales.
6. Preparación del sistema: Se preparará el sistema para la versión anterior.
7. Programación de reinicio: Se programará un reinicio para finalizar la degradación.

Verificación posterior a la degradación

Después de que la degradación esté completa y tu servidor haya reiniciado:

1. Comprueba la versión: Verifica que estés usando la versión de Unraid que esperas.
2. Prueba la funcionalidad principal: Asegúrate de que los servicios de array, Docker y VM estén funcionando correctamente.
3. Verifica los complementos: Comprueba que tus complementos instalados sean compatibles y funcionen como se espera.
4. Prueba los contenedores de Docker: Inicia tus contenedores de Docker y confirma que estén funcionando correctamente.
5. Revisa las VMs: Si tienes máquinas virtuales (VMs), asegúrate de que inicien y operen correctamente. Consulta Configuración de VM para orientación sobre configuración.
6. Monitorea los registros del sistema: Mantente atento a los registros del sistema para detectar mensajes de error. Utiliza herramientas de diagnóstico para capturar información detallada del sistema.

Resolución de problemas de degradación

Opción de degradación no disponible - Haz clic para expandir/colapsar

Si no ves una opción para degradar:

• Revisa el historial del sistema: Asegúrate de haber mejorado previamente desde una versión compatible.
• Verifica la integridad de los archivos: Los archivos de la versión anterior pueden estar dañados o desaparecer.
• Verifica la compatibilidad: La versión anterior puede no ser compatible con tu hardware actual.
• Método manual: Si es necesario, sigue los métodos de degradación manual que se describen en esta página.

La degradación falla durante el proceso - Haz clic para expandir/colapsar

Si el proceso de degradación no sale como se planeó:

1. No te alarmes: Tu sistema debería seguir funcionando con la versión actual.
2. Revisa los registros: Examina los registros del sistema para encontrar mensajes de error específicos. Utiliza herramientas de diagnóstico para un análisis de registros completo.
3. Verifica los archivos: Asegúrate de que todos los archivos necesarios para la versión objetivo estén disponibles.
4. Intenta el método manual: Si la herramienta no funciona, considera usar los métodos de degradación manual.
5. Contacta al soporte: Si los problemas persisten, comunícate con el soporte de Unraid con tus diagnósticos.

El sistema no arranca después de la degradación - Haz clic para expandir/colapsar

Si tu sistema no arranca después de la degradación:

1. Arranca desde USB: Usa otra computadora para acceder a tu dispositivo flash USB. Consulta resolución de problemas de arranque para obtener pasos detallados de recuperación.
2. Restaura desde una copia de seguridad: Copia tus archivos de respaldo de nuevo al dispositivo USB.
3. Revisa la integridad de los archivos: Asegúrate de que todos los archivos del sistema estén presentes y no estén dañados.
4. Intenta el Modo Seguro: Arranca en Modo Seguro para más resolución de problemas.
5. Recuperación manual: Si es necesario, utiliza los métodos de recuperación manual.

Complementos o contenedores de Docker no funcionarán - Haz clic para expandir/colapsar

Después de degradar, algunos complementos o contenedores pueden no funcionar correctamente:

• Actualiza los complementos: Busca actualizaciones de complementos compatibles con la versión degradada. Revisa Aplicaciones Comunitarias para encontrar versiones compatibles.
• Reconstruye Docker: Elimina y recrea tu archivo de imagen de Docker. Consulta resolución de problemas de Docker para pasos detallados.
  • Revisa las dependencias: Asegúrate de que todas las dependencias necesarias estén disponibles.
  • Compatibilidad de complementos: Algunos complementos podrían no ser compatibles con versiones anteriores de Unraid.
  • Plugins dependientes de características de UI/WebGUI: Los complementos que dependen de las nuevas características de WebGUI pueden no funcionar correctamente en versiones anteriores.
  • Plugins temáticos: Es posible que los complementos de personalización visual necesiten actualizaciones o eliminación si son incompatibles.