Le pedimos a Gemini, la inteligencia artificial de Google cómo solucionar problemas de TrueNas Core
Explicanos detalladamente cómo solucionar problemas de TrueNas CoreEs 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.
