Saltar al contenido principal

Problemas de Instalación

La Carga del Módulo Falla​

Problema: El archivo zip del módulo no se carga a través del panel de administración de Perfex.

Causas y Soluciones:

CausaSolución
El tamaño del archivo excede el límite de carga de PHPAumenta upload_max_filesize y post_max_size en php.ini a al menos 64M
Tiempo de espera del servidor agotado durante la cargaAumenta max_execution_time en php.ini a 300
Problema de permisosVerifica que el directorio modules/ tenga permisos de escritura (chmod 755)

Alternativa: Carga mediante FTP/SFTP en su lugar:

  1. Extrae el zip en tu computadora
  2. Sube la carpeta extraída a your-perfex/modules/
  3. Activa desde Setup → Modules en el panel de administración

El Módulo No Aparece Después de la Carga​

Problema: Cargaste el módulo pero no aparece en Setup → Modules.

Soluciones:

  1. Asegúrate de que la estructura de carpetas sea correcta: modules/saas/ (no modules/saas-module/ ni modules/saas/saas/)
  2. Verifica que todos los archivos se hayan cargado completamente (compara el número de archivos)
  3. Borra la caché de tu navegador y actualiza la página
  4. Verifica los permisos de archivos: todo el directorio modules/saas/ debe ser legible por el servidor web

La Verificación de MySQL Falla​

Problema: Al hacer clic en "Click here to verify server settings" se muestra un error.

Error: "Access denied for user"​

Causa: Nombre de usuario o contraseña de MySQL incorrectos.

Solución:

  1. Verifica nuevamente tus credenciales de MySQL
  2. Si usas cPanel, intenta usar tu nombre de usuario y contraseña de cPanel
  3. Prueba las credenciales manualmente:
mysql -u your_username -p -h localhost
# Ingresa tu contraseña cuando se te solicite
# Si puedes iniciar sesión, las credenciales son correctas

Error: "Can't connect to MySQL server"​

Causa: MySQL no está ejecutándose o el host/puerto es incorrecto.

Solución:

  1. Verifica si MySQL está ejecutándose: sudo systemctl status mysql
  2. Confirma que el host sea correcto (generalmente localhost)
  3. Confirma que el puerto sea correcto (generalmente 3306)
  4. Si MySQL está en un servidor diferente, usa la dirección IP de ese servidor

Error: "CREATE command denied"​

Causa: El usuario de MySQL no tiene permisos para crear bases de datos.

Solución:

-- Inicia sesión en MySQL como root:
GRANT ALL PRIVILEGES ON *.* TO 'your_username'@'localhost' WITH GRANT OPTION;
FLUSH PRIVILEGES;

O en cPanel: Ve a MySQL Databases → User Privileges → Marca "ALL PRIVILEGES"

Página en Blanco Después de la Activación​

Problema: Después de activar el módulo, ves una página en blanco.

Soluciones:

  1. Revisa los registros de errores de PHP: Mira en /var/log/apache2/error.log (Apache) o /var/log/nginx/error.log (Nginx)
  2. Habilita la visualización de errores temporalmente: Agrega a tu .htaccess o index.php: 
    ini_set('display_errors', 1);
    error_reporting(E_ALL);
  3. Verifica la versión de PHP: Asegúrate de estar ejecutando PHP 7.4 o superior
  4. Verifica el límite de memoria: Establece memory_limit = 256M en php.ini

El Formulario de Registro No Se Muestra​

Problema: La página de destino no muestra un formulario de registro.

Soluciones:

  1. Asegúrate de haber creado al menos un plan en SaaS Management → Plans
  2. Verifica que los registros estén habilitados en SaaS Management → SuperAdmin Settings → Tenants Settings
  3. Confirma que la URL de la página de destino sea correcta en Landing Page Settings
  4. Intenta seleccionar una plantilla de página de destino diferente
  5. Borra la caché de tu navegador

Los Correos Electrónicos No Se Envían​

Problema: Los correos de bienvenida, verificación o facturas no se envían.

Soluciones:

  1. Configura SMTP en Perfex CRM: Ve a Setup → Email → Email Settings
  2. Servicios SMTP recomendados:
    • Gmail SMTP (gratuito para hasta 500 correos/día)
    • SendGrid (nivel gratuito: 100 correos/día)
    • Mailgun (nivel gratuito: 5,000 correos/mes)
  3. Prueba el envío de correos desde Setup → Email → Send Test Email
  4. Revisa tu carpeta de spam — los correos podrían estar llegando ahí
info

¡SMTP es crucial! Sin SMTP configurado, no se enviará ningún correo desde tu plataforma — incluyendo correos de verificación, bienvenida y facturas. ¡Configura esto primero!

La Base de Datos del Inquilino No Se Crea​

Problema: El inquilino se registra pero su base de datos no se crea.

Soluciones:

  1. Verifica las credenciales de MySQL en la Configuración de SaaS (haz clic en el botón de verificación)
  2. Comprueba si tu usuario de MySQL tiene el privilegio CREATE DATABASE
  3. Si estás en hosting compartido, verifica si has alcanzado el límite de bases de datos
  4. Revisa el Registro de Actividad de SaaS para obtener detalles del error
  5. Revisa los registros de errores de PHP para errores específicos de MySQL

Error "Maximum database connections"​

Problema: Error sobre demasiadas conexiones a la base de datos.

Soluciones:

  1. Aumenta max_connections de MySQL en my.cnf: 
    [mysqld]
    max_connections = 200
  2. Reinicia MySQL: sudo systemctl restart mysql
  3. Considera optimizar tu servidor (más RAM) si tienes muchos inquilinos
tip

¿Problema resuelto? Si sigues teniendo problemas, consulta Problemas de Dominio y DNS o contacta con Soporte.