Zum Hauptinhalt springen

Installationsprobleme

Modul-Upload schl�gt fehl​

Problem: Die Modul-ZIP-Datei l�sst sich nicht �ber das Perfex-Admin-Panel hochladen.

Ursachen & L�sungen:

UrsacheL�sung
Dateigr��e �berschreitet PHP-Upload-LimitErh�hen Sie upload_max_filesize und post_max_size in php.ini auf mindestens 64M
Server-Timeout beim UploadErh�hen Sie max_execution_time in php.ini auf 300
BerechtigungsproblemStellen Sie sicher, dass das modules/-Verzeichnis beschreibbar ist (chmod 755)

Alternative: Upload per FTP/SFTP:

  1. Entpacken Sie die ZIP auf Ihrem Computer
  2. Laden Sie den entpackten Ordner in your-perfex/modules/ hoch
  3. Aktivieren Sie �ber Setup ? Modules im Admin-Panel

Modul erscheint nach Upload nicht​

Problem: Sie haben das Modul hochgeladen, aber es erscheint nicht unter Setup ? Modules.

L�sungen:

  1. Stellen Sie sicher, dass die Ordnerstruktur korrekt ist: modules/saas/ (nicht modules/saas-module/ oder modules/saas/saas/)
  2. �berpr�fen Sie, ob alle Dateien vollst�ndig hochgeladen wurden (Dateianzahl vergleichen)
  3. Leeren Sie Ihren Browser-Cache und aktualisieren Sie die Seite
  4. �berpr�fen Sie Dateiberechtigungen: Das gesamte modules/saas/-Verzeichnis muss vom Webserver lesbar sein

MySQL-Verifizierung schl�gt fehl​

Problem: Beim Klicken auf "Click here to verify server settings" erscheint ein Fehler.

Fehler: "Access denied for user"​

Ursache: Falscher MySQL-Benutzername oder Passwort.

Behebung:

  1. �berpr�fen Sie Ihre MySQL-Zugangsdaten erneut
  2. Bei cPanel: Versuchen Sie Ihren cPanel-Benutzernamen und -Passwort
  3. Testen Sie die Zugangsdaten manuell:
mysql -u your_username -p -h localhost
# Enter your password when prompted
# If you can log in, the credentials are correct

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

Ursache: MySQL l�uft nicht oder falscher Host/Port.

Behebung:

  1. Pr�fen Sie, ob MySQL l�uft: sudo systemctl status mysql
  2. �berpr�fen Sie, ob der Host korrekt ist (normalerweise localhost)
  3. �berpr�fen Sie, ob der Port korrekt ist (normalerweise 3306)
  4. Wenn MySQL auf einem anderen Server l�uft, verwenden Sie die IP-Adresse dieses Servers

Fehler: "CREATE command denied"​

Ursache: Der MySQL-Benutzer hat keine Berechtigung zum Erstellen von Datenbanken.

Behebung:

-- Log in to MySQL as root:
GRANT ALL PRIVILEGES ON *.* TO 'your_username'@'localhost' WITH GRANT OPTION;
FLUSH PRIVILEGES;

Oder in cPanel: Gehen Sie zu MySQL Databases ? User Privileges ? Aktivieren Sie "ALL PRIVILEGES"

Leere wei�e Seite nach Aktivierung​

Problem: Nach der Aktivierung des Moduls sehen Sie eine leere wei�e Seite.

L�sungen:

  1. PHP-Fehlerprotokolle pr�fen: Schauen Sie in /var/log/apache2/error.log (Apache) oder /var/log/nginx/error.log (Nginx)
  2. Fehleranzeige vor�bergehend aktivieren: F�gen Sie in Ihrer .htaccess oder index.php hinzu: 
    ini_set('display_errors', 1);
    error_reporting(E_ALL);
  3. PHP-Version pr�fen: Stellen Sie sicher, dass Sie PHP 7.4 oder h�her verwenden
  4. Speicherlimit pr�fen: Setzen Sie memory_limit = 256M in php.ini

Registrierungsformular wird nicht angezeigt​

Problem: Die Landing Page zeigt kein Registrierungsformular an.

L�sungen:

  1. Stellen Sie sicher, dass Sie mindestens einen Plan unter SaaS Management ? Plans erstellt haben
  2. �berpr�fen Sie, ob Registrierungen unter SaaS Management ? SuperAdmin Settings ? Tenants Settings aktiviert sind
  3. �berpr�fen Sie, ob die Landing-Page-URL unter Landing Page Settings korrekt ist
  4. Versuchen Sie, eine andere Landing-Page-Vorlage auszuw�hlen
  5. Leeren Sie Ihren Browser-Cache

E-Mails werden nicht gesendet​

Problem: Willkommens-E-Mails, Verifizierungs-E-Mails oder Rechnungs-E-Mails werden nicht gesendet.

L�sungen:

  1. Konfigurieren Sie SMTP in Perfex CRM: Gehen Sie zu Setup ? Email ? Email Settings
  2. Empfohlene SMTP-Dienste:
    • Gmail SMTP (kostenlos bis zu 500 E-Mails/Tag)
    • SendGrid (kostenloser Tarif: 100 E-Mails/Tag)
    • Mailgun (kostenloser Tarif: 5.000 E-Mails/Monat)
  3. Testen Sie den E-Mail-Versand unter Setup ? Email ? Send Test Email
  4. �berpr�fen Sie Ihren Spam-Ordner ? E-Mails k�nnten dort landen
info

SMTP ist entscheidend! Ohne konfiguriertes SMTP werden keine E-Mails von Ihrer Plattform gesendet ? einschlie�lich Verifizierungs-E-Mails, Willkommens-E-Mails und Rechnungen. Richten Sie dies zuerst ein!

Mandanten-Datenbank wird nicht erstellt​

Problem: Der Mandant meldet sich an, aber seine Datenbank wird nicht erstellt.

L�sungen:

  1. �berpr�fen Sie die MySQL-Zugangsdaten in den SaaS-Einstellungen (klicken Sie auf die Schaltfl�che ?Verifizieren?)
  2. Pr�fen Sie, ob Ihr MySQL-Benutzer die Berechtigung CREATE DATABASE hat
  3. Bei Shared Hosting: Pr�fen Sie, ob Sie Ihr Datenbank-Limit erreicht haben
  4. �berpr�fen Sie das SaaS-Aktivit�tsprotokoll f�r Fehlerdetails
  5. �berpr�fen Sie die PHP-Fehlerprotokolle auf MySQL-spezifische Fehler

Fehler "Maximum database connections"​

Problem: Fehler wegen zu vieler Datenbankverbindungen.

L�sungen:

  1. Erh�hen Sie max_connections in MySQL in my.cnf: 
    [mysqld]
    max_connections = 200
  2. Starten Sie MySQL neu: sudo systemctl restart mysql
  3. Erw�gen Sie die Optimierung Ihres Servers (mehr RAM), wenn Sie viele Mandanten haben
tipp

Problem behoben? Wenn Sie weiterhin Probleme haben, lesen Sie Domain & DNS Issues oder kontaktieren Sie Support.