fix link
[openafs-wiki.git] / debugging.mdwn
1 ## Debugging Servers
2
3 Servers are multithreaded, so if one hangs, it is most interesting to see what the different threads are doing. Using gdb, you can get a stack trace of all threads (provided, you compiled your server with "--enable-debug").
4
5 First, we need to get the pid and the full path of the server (e.g. fileserver):
6
7     PID=`ps -eaf | grep fileserver | grep -v grep | awk '{print $2}'`
8     SRV_PATH=`ps -eaf | grep fileserver | grep -v grep | awk '{print $9}'`
9
10 for other servers, this might be different, so double-check
11
12
13 Then we need to attach the gdb and make it display the stack of all threads :
14     
15     gdb --batch --eval-command="thread apply all where" $SRV_PATH $PID > /tmp/threads.log
16
17 After this you might use the attached script [[threadLogParser.py]] to display the intersting threads.
18
19 e.g.
20
21     threadLogParser.py -g /tmp/threads.log -e rx_GetCall
22
23 displays only threads which are not in this boring rx_GetCall (threads are waiting for a new call).
24
25
26 ## Debugging Clients
27
28 ### intermittent issues
29
30 Low-level debugging of a client can be done using "fstrace". <br/>
31 Unfortunately, this produces a lot of output, so it is not easy to catch an intermittent error-condition with "fstrace".
32
33 The attached script [[ClientTracing.py]] (presently for Unix only) gives you the opportunity to continuously run a fstrace, <br/>
34 where the output is stored in rotating log-files. 
35
36 In case of an external-event (the existence of a predefined file), it saves this log and does not overwrite it again.
37 Thus, all you need to do is to write a script which creates this predefined file, when that event happens.
38
39
40 ### defined issue
41
42 When you exactly know how to reproduce the issue, or you don't want to install python on your client, you can use the attached script [[ClientTracing.bat]] (for Windows only). It is setting up the client tracing, starting up a tshark (terminal-version of wireshark) and waits for you to tell it to stop tracing. In order to synchronize the timestamps of the wireshark log and the afsd-trace-log, a "dir \\AFS\openafs.org" is issued on startup. The logfiles are copied to a predefined directory. The script itself should be self-explanatory.]