Solucionado: Error de File Manager en cPanel “’tech_domains’ array…”
Si administras servidores con cPanel/WHM, seguro te has topado alguna vez con un error que te deja perplejo. Estás intentando acceder a una herramienta tan fundamental como el Administrador de Archivos (File Manager) y, de repente, te recibe una pared de texto críptico que te impide continuar.
Uno de los errores más comunes y frustrantes es este:
’tech_domains’ array in /etc/cpanel/ea4/ea4-metainfo.json contained only invalid or empty entries.
at /usr/local/cpanel/Cpanel/IP/AutoDomain/TemporaryDomain/Check.pm line 66.
…
A primera vista, parece un problema grave. Pero no te preocupes, la solución es sorprendentemente rápida y sencilla. En este artículo, te guiaré paso a paso para que puedas resolverlo en menos de un minuto.
¿Qué Significa Este Error? El Origen del Problema
Antes de correr a la solución, entendamos qué está pasando. El error nos da una pista clave: el archivo /etc/cpanel/ea4/ea4-metainfo.json.
Este archivo JSON es vital para EasyApache 4 (el sistema que gestiona PHP y Apache en cPanel). Contiene metadatos de configuración, incluyendo dominios técnicos que cPanel usa para funciones internas. Cuando el error dice que el array 'tech_domains' está “inválido o vacío”, significa que el archivo se ha dañado, está en blanco o tiene un formato incorrecto.
Esto puede ocurrir por diversas razones, como una actualización de sistema que no se completó del todo o un problema puntual en el disco.
La Solución Paso a Paso: Reconstruyendo la Configuración
Para arreglarlo, no necesitamos editar el archivo manualmente. Simplemente lo quitaremos de en medio y le pediremos a cPanel que lo genere de nuevo, esta vez de forma correcta.
Requisito: Necesitarás acceso root a tu servidor a través de SSH.
Paso 1: Conéctate a tu Servidor
Abre tu terminal o cliente SSH favorito y accede a tu servidor como usuario root.
Paso 2: Renombra el Archivo Dañado (Backup Seguro)
En lugar de borrar el archivo, vamos a renombrarlo. Esta es una práctica recomendada que crea una copia de seguridad instantánea por si algo saliera mal. Usaremos el comando mv.
mv /etc/cpanel/ea4/ea4-metainfo.json{,.bak}
¿Qué hace este comando? Renombra el archivo ea4-metainfo.json a ea4-metainfo.json.bak de forma rápida y eficiente.
Paso 3: Pide a cPanel que Reconstruya el Archivo
Ahora viene la magia. Ejecutaremos un script de cPanel diseñado específicamente para reconstruir este archivo de metadatos.
/usr/local/cpanel/scripts/ea-profiles --rebuild-ea4-metainfo
Este script detectará que el archivo original no existe y creará uno nuevo, limpio y con la configuración correcta basada en el estado actual de tu servidor. La ejecución es casi instantánea.
Paso 4: ¡Verifica la Solución!
¡Eso es todo! Vuelve a cPanel en tu navegador e intenta abrir el Administrador de Archivos. El error debería haber desaparecido y la herramienta cargará con normalidad.
¿Y si esto no funciona? Un Paso Adicional
En la gran mayoría de los casos, los pasos anteriores son suficientes. Sin embargo, si el problema persiste, el artículo de soporte oficial de cPanel recomienda un paso adicional: reinstalar las herramientas de EasyApache.
# Primero, elimina el registro del paquete de la base de datos de RPM
rpm -e --justdb --nodeps ea-cpanel-tools
# Luego, reinstálalo con yum
yum install ea-cpanel-tools -y
Nota: Si al ejecutar yum te encuentras con errores de “Timeout”, es probable que tengas un problema de red o un bloqueo en el firewall de tu servidor. Eso es un tema aparte que deberás diagnosticar, usualmente contactando a tu proveedor de hosting.
Conclusión
Un error que parece complejo a menudo tiene una solución simple si sabes dónde buscar. El error 'tech_domains' array es un claro ejemplo de un archivo de configuración dañado que cPanel puede reparar por sí mismo con el comando adecuado.
Espero que esta guía te haya ayudado a resolver el problema rápidamente. ¡No más dolores de cabeza con el Administrador de Archivos!
Etiquetas: cPanel, WHM, SysAdmin, Linux, Error, Solucionado, File Manager, EasyApache