How to submit a bug report

To submit a useful bug report you need to provide as much information as you can. Including

  • Your Server OS (Linux/FreeBSD/Solaris/MacOSX)
  • CPU/Processor family (32bit/64bit)
  • If you think LSWS does not work properly with a certain feature, you should provide as detailed information as possible on the feature and how you use it, so we can reproduce the problem in our lab.
  • If lshttpd crashed, LSWS Enterprise users should switch to the debug build of lshttpd, then submit the debug report generated and a core file if possible.

How to switch to the debug build of LSWS Enterprise

For 4.x version, there are two versions of the lshttpd binary shipped in the LSWS Enterprise package. One is the release build. The other is the debug build. The debug build is not normally used when you run LSWS, but, when debugging, the GDB stack backtrace and core file generated by the debug build are the most useful information you can provide for fixing the bug.

For latest version such as 5.0.x or 5.1.x, the binary installed is debug info enabled by default hence no separate debug build version required. It has no impact for your server performance.

How to download debug build of LSWS Enterprise

For 4.x version, if there is no debug build of lshttpd binary in your current installation, you can download the related version and arch of debug build from our website. For example:

/usr/local/lsws/admin/misc/ -d -f -v <your_lsws_version>

Once you have debug version installed, reproduce your problem and submit a bug report.

For 5.0.x, 5.1.x, you do not need to switch to debug build anymore since the binary installed is debug info enabled by default. It has no impact for your server performance.

How to enable a core dump


By default, core dumping is disabled in LSAPI PHP external applications. To enable it, you need to add an environment variable to your LSPHP external application configuration (WebAdmin console > Configuration > External App > your external application > Environment):



If you only need a particular program to be troubleshooted, you can use soft limits.

ulimit -S -c

Edit /etc/security/limits.conf and add the following line entry at the bottom of the file (before # End of file)

* soft core unlimited

Check ulimit core file size value. It should be unlimited.

ulimit -c
-> unlimited

Core dumping is generally disabled by default on Linux. The following guide will lead you through the steps necessary to enable it: How to enable core dump for Linux

Where to send the bug report

Bug reports can be sent to our bug report email.

We recommend that Enterprise customers use our ticket system (accessible from the client area) for their bug reports.

litespeed_wiki/config/bug-reporting.txt · Last modified: 2017/06/08 12:41 by Eric Leu