Cómo solucionar problemas de TrueNas Core

 Le pedimos a Gemini, la inteligencia artificial de Google cómo solucionar problemas de TrueNas Core

Explicanos detalladamente cómo solucionar problemas de TrueNas Core

Es crucial recordar que TrueNAS CORE (anteriormente FreeNAS ) es un sistema operativo completo basado en FreeBSD, y no una aplicación sobre Linux. Los problemas se centran en el almacenamiento ZFS, la conectividad de red y los servicios de compartición (SMB, NFS, iSCSI).

La solución de problemas se realiza principalmente a través de la Interfaz Web (Web UI) y la Consola de FreeBSD/SSH. 

Aquí tienes una guía detallada para diagnosticar y solucionar los problemas más comunes de TrueNAS CORE.

1. Problemas Críticos de Almacenamiento ( ZFS )

La salud del Pool de ZFS es la prioridad máxima. Los errores aquí pueden llevar a la pérdida de datos.

A. Pool Degradado o Fallido (Degraded/Faulted)

Diagnóstico: El Dashboard o la sección Storage muestran el Pool con un estado DEGRADED, OFFLINE, o FAULTED.

Causa: Uno o más discos virtuales (vdevs) o discos físicos han fallado o han sido desconectados.

Solución (Web UI):

Identificar el Disco: Ve a Storage (Almacenamiento) > Pools. Haz clic en el engranaje del Pool y selecciona Status (Estado).

Identifica el disco con el estado FAULTED o UNAVAIL.

Sustitución: Si tu Pool es redundante (Mirror, RAIDZ), debes sustituir físicamente el disco fallido por uno nuevo de igual o mayor tamaño.

Reemplazo ZFS (Replace): Una vez que el nuevo disco esté conectado, vuelve a Status del Pool. Haz clic en el disco fallido (o en el slot vacío si el disco fue retirado) y selecciona Replace (Reemplazar), eligiendo el nuevo disco como reemplazo. ZFS iniciará la reconstrucción de los datos (resilver).

B. Corrupción de Datos o Errores de Lectura (Read Errors)

Diagnóstico: Los archivos están inaccesibles o muestran errores de lectura/escritura.

Causa: Corrupción silenciosa o errores de hardware detectados durante el Scrub.

Solución (Web UI):

Ejecutar Scrub Manual: Ve a Storage (Almacenamiento) > Pools. Haz clic en el engranaje del Pool y selecciona Scrub (Limpieza). El scrub verifica y autocorrige errores de ZFS si el Pool es redundante.

Verificar S.M.A.R.T.: Revisa Tasks (Tareas) > S.M.A.R.T. Tests. Si los resultados indican fallos, el disco debe ser reemplazado.

2. Problemas de Conectividad de Red y DNS

Si el servidor TrueNAS no está en línea o no puede resolver nombres de dominio.

A. El Servidor No Responde en la Red

Diagnóstico: No puedes hacer ping al servidor ni acceder a la Web UI.

Causa: Configuración IP incorrecta o conflicto de IP.

Solución (Consola Física/SSH):

Reconfigurar IP: Accede a la consola física del servidor. Selecciona la Opción 1 (Configure Network Interfaces) y vuelve a ingresar la dirección IP, máscara y gateway estáticos para asegurar que no haya errores tipográficos.

Verificar Duplicados: Asegúrate de que otro dispositivo en tu red no esté utilizando la misma dirección IP.

B. Fallo en la Resolución de Nombres (DNS)

Diagnóstico: TrueNAS no puede actualizar su firmware, enviar correos electrónicos de alerta o descargar plugins (ej., Plex).

Causa: DNS no configurado o inalcanzable.

Solución (Web UI):

Configuración General: Ve a System (Sistema) > General.

Asegúrate de que los campos Nameserver 1 y Nameserver 2 contengan direcciones IP válidas de servidores DNS (ej., el IP de tu router local o servidores públicos como 1.1.1.1 o 8.8.8.8).

3. Problemas de Compartición (SMB, NFS, iSCSI)

El cliente Linux (o Windows) no puede acceder a los archivos aunque el servidor esté en línea.

A. Fallo de Conexión SMB (Windows Shares)

Diagnóstico: El cliente recibe un error de "Acceso Denegado" o "Contraseña Inválida".

Causa: El servicio SMB está inactivo o los permisos de usuario/carpeta no coinciden.

Solución (Web UI):

Estado del Servicio: Ve a Services (Servicios) y verifica que SMB esté Running y configurado para Start Automatically.

Permisos de Carpeta: Ve a Storage (Almacenamiento) > Pools. Localiza el Dataset compartido. Haz clic en el menú y selecciona Edit Permissions (Editar Permisos).

Asegúrate de que el User (Usuario) y Group (Grupo) asignados tengan permisos de Read/Write/Execute correctos.

B. Fallo de Montaje NFS (Linux Shares)

Diagnóstico: El comando mount -t nfs en Linux falla o muestra errores de permiso.

Causa: La Lista de Exportación NFS no incluye la IP o subred del cliente Linux.

Solución (Web UI):

Estado del Servicio: Ve a Services (Servicios) y verifica que NFS esté Running.

Verificar Exportación NFS : Ve a Sharing (Compartición) > Unix Shares (NFS).

Edita la exportación y revisa la sección Authorized Networks (Redes Autorizadas) o Authorized Hosts (Hosts Autorizados). La IP del equipo Linux debe estar incluida o ser parte de la subred listada.

4. Soluciones Avanzadas y Mantenimiento

A. Problemas de Configuración y Archivos Corruptos

Diagnóstico: La interfaz web es inaccesible o muestra errores internos después de una actualización o un cambio de configuración.

Solución (Consola Física):

Opción 9 ( Shell ): Accede al shell de FreeBSD.

Revertir Configuración: TrueNAS guarda un historial de configuraciones. Puedes restaurar una versión funcional anterior desde la Web UI (System > General > Upload Config) o, en casos extremos, usar la consola para buscar y restaurar la configuración desde /data/freenas-v1.db.

B. Recolección de Logs de Diagnóstico

Diagnóstico: Necesitas proporcionar información detallada al soporte o a la comunidad.

Solución (Web UI):

Debug File: Ve a System (Sistema) > Advanced (Avanzado).

Haz clic en Save Debug (Guardar Depuración). Esto genera un archivo .txz que contiene todos los logs del sistema, el estado de ZFS, y la configuración de red y servicios.