Debugging of ISPConfig 3 server actions in case of a failure

The follwing article describes the steps that can be taken to debug the ISPConfig 3 server scripts.

Enable the debug Loglevel in ISPConfig

Login to the ISPConfig intterface and set the log level to Debug under System > System > Server Config (see also chapter of the ISPConfig 3 manual) for the affected server. After one or two minutes, there should be more detailed messages in ISPConfig's system log (Monitor > System State (All Servers) > Show System-Log).

Disable the cronjob

Go to the command line of the server on which the error happens (on multiserver systems, it is often the slave and not the master) and run (as root):

crontab -e

Comment out the cron job:

#* * * * * /usr/local/ispconfig/server/ > /dev/null >> /var/log/ispconfig/cron.log

Run the server script manually to get detailed debug output

Then run the command:


This will display any errors directly on the command line which should help you to fix the error. When you have fixed the error, please don't forget to uncomment the cron job again.

5 thoughts on “Debugging of ISPConfig 3 server actions in case of a failure”

  1. I get no errors when I run the script manually, but still have numerous jobs in the jobqueue and nothing being written to disk. Please help?

    I also ran the htf script and don’t see any errors there either.
    This was a working production server prior to whatever has happened.


  2. ISPConfig is installed on Ubuntu 20.04

    The ethernet name is not eth0: but enp3s0.

    This is shown below in the extract from “ip a”

    2: enp3s0: mtu 1500 qdisc fq_codel state UP group default qlen 1000

    I am able to visibly create mailboxes but they are not receiving any emails including the ISPConfig welcome email.

  3. I am getting that output. now, what can I do.

    – WARNING – There is already a lockfile set, but no process running with this PID (20496). Continuing.
    PHP Fatal error: Uncaught Error: Call to undefined function mb_detect_encoding() in /usr/local/ispconfig/server/lib/classes/
    Stack trace:
    #0 /usr/local/ispconfig/server/lib/classes/ db->escape()
    #1 /usr/local/ispconfig/server/lib/classes/ db->_build_query_string()
    #2 /usr/local/ispconfig/server/lib/classes/ db->_query()
    #3 /usr/local/ispconfig/server/lib/classes/ db->query()
    #4 /usr/local/ispconfig/server/plugins-available/ db->queryOneRecord()
    #5 /usr/local/ispconfig/server/plugins-available/ apache2_plugin->update()
    #6 /usr/local/ispconfig/server/lib/classes/ apache2_plugin->insert()
    #7 /usr/local/ispconfig/server/mods-available/ plugins->raiseEvent()
    #8 /usr/local/ispconfig/server/lib/classes/ web_module->process()
    #9 /usr/local/ispconfig/server/lib/classes/ modules->raiseTabl in /usr/local/ispconfig/server/lib/classes/ on line 531


Leave a Comment