1NETDUMP-SERVER(8) System Programs NETDUMP-SERVER(8)
2
6 netdump-server - handle crash dumps over the network
7
9 netdump-server [--port portnumber]
10 [--addr address]
11 [--concurrent number]
12 [--pidfile path]
13 [--dumpdir path]
14 [--daemon]
15 [--secure <0|1>]
16 [--help] [--usage]
17
19 Listens to the network for clients that crash and uses the netdump pro‐
20 tocol to recieve a memory dump and a stack trace. The memory dump and
21 oops message are stored in a timestamped directory in /var/crash. The
22 server can also run scripts when some events happen.
23
25 --port portnumber
26 Specifies the IP port number for the netdump server to listen
27 to. The default is 6666.
28 --addr address
30 Specifies the IP address for the netdump server to listen to.
31 The default is any.
32 --concurrent number
34 You can limit the amount of concurrent dumps being done at any
35 one time. If more clients than the specified maximum connects at
36 one time the last ones will just be logged and then rebooted.
37 --dumpdir path
39 Specify the location where received vmcore files are saved.
40 Defaults to /var/crash
41 --pidfile path
43 Store a pidfile. The default service uses /var/run/netdump-
44 server.pid. The default is not to write a pidfile.
45 --daemon
47 netdump-server should background itself and run as a daemon.
48 --secure
50 Specify a 0 here to disable the client authentication bits.
51 This will enable any client to dump core to this server without
52 any credentials. If using this option, you may specify the NET‐
53 DUMPKEYEXCHANGE=none option in /etc/sysconfig/netdump on the
54 client systems.
55
57 netdump-server --daemon
58 This launches the netdump-server and puts it in the background, listen‐
59 ing for crashed clients.
60
63 Exit status is 0 for a clean exit and non-0 for a non-clean exit.
64
66 /etc/netdump.conf
67 A configuration file read by netdump-server on startup. It is a
68 "key=value" style file. Currently it supports the options: port,
69 max_concurrent_dumps, daemon, pidfile and secure.
70 /etc/init.d/netdump-server
72 An init script to start a default system installation of net‐
73 dump-server. This is normally turned off by default; use the
74 command
75 /sbin/chkconfig netdump-server on
76 to enable the netdump-server service.
77 /var/crash
79 The main directory where the crash dump files are stored. Each
80 dump is put in a subdirectory named with the ip of the crashed
81 machine and the date and time of the crash.
82 /var/crash/scripts
84 This directory can contain scripts that are run at various
85 times. The script files should be executable and owned by the
86 netdump user. They all get passed the ip of the crashing
87 machine as the first argument, and each one except netdump-start
88 gets the directory that the dump is written into as the second
89 argument.
90 netdump-start - This is called when a client connects to the
92 server to tell it that it has just started the netdump client.
93 This normally means that the machine just booted up.
94 netdump-crash - This is run when a client reports that it has
96 crashed. If it returns a non-zero value the dump request will
97 be ignored and the client will be told to reboot immediately
98 netdump-nospace - This is run when there is not enough diskspace
100 for the dump of the crashed machine. If this script exits with a
101 non-zero return value netdump-server will try once again (but
102 only once) before giving up the dump. If this script exits with
103 a zero return value, netdump-server will reboot the client with‐
104 out performing a dump.
105 netdump-reboot - This is run when netdump-server is finished
107 with a client and is about to tell the client to reboot itself.
108 The four executable scripts are run in the foreground by the
110 netdump-server, so any time-consuming task done by the scripts
111 will block the netdump-server from servicing any crash or log
112 requests from any other source. Therefore it may be advisable
113 to run any time-consuming tasks in the background, allowing the
114 script to return back to the netdump-server.
115
118 netdump(8)
119
122 Report any bugs you find to http://bugzilla.redhat.com/bugzilla
123
126 Alexander Larsson <alexl@redhat.com>
127Linux 14 Feb 2002 NETDUMP-SERVER(8)