How to report crashes or hangs on linux properly

[Peter]

Hello,

here I will explain which information you should post when your ts3server crashed or hangs up. You can create a new thread with your problem then.

(1) Make sure your system is configured to write core dumps when applications crash. You can enable this by running something like

ulimit -c 500000

You can put this in your ts3 server startscript to make sure it is set on every startup

(2) When the server crashes it will now write a file called "core" or "core.NUMBER"
If the server is in a hung up state (it is not reacting to serverquery or normal client connections anymore) you can force the server to write a core by running "killall -SIGQUIT ts3server_linux_amd64" (use _x86 for x86 servers)

(3) The core alone is no use, what is also needed is a few libraries from your system, a script I wrote will gather them and put them in an archive. The script is attached [1], running it will look something like this:

tss3@laurel:~$ ./make_core_environment.sh ts3/
core_environment/
core_environment/usr/
core_environment/usr/lib/
core_environment/usr/lib/libstdc++.so.6
core_environment/lib/
core_environment/lib/libdl.so.2
core_environment/lib/libgcc_s.so.1
core_environment/lib/libc.so.6
core_environment/lib/libm.so.6
core_environment/lib/librt.so.1
core_environment/lib/libpthread.so.0
core_environment/lib64/
core_environment/lib64/ld-linux-x86-64.so.2
tss3@laurel:~$

The file "core_environment.tar.gz" is created by the script. It contains the needed libraries.

(4) Provide the log file of the incident, provide any other information you know (what was being done with the server etc.). Can you reproduce the problem? If so, tell us the steps.

(5) Bundle the core file(s), the core_environment.tar.gz in an archive an upload it to somewhere. Post a link in your report.


[1] http://ftp.4players.de/pub/hosted/ts...environment.sh