File: README

package info (click to toggle)
dumputils 1.0.0-1
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 184 kB
  • ctags: 175
  • sloc: ansic: 2,403; makefile: 133; sh: 88
file content (87 lines) | stat: -rw-r--r-- 3,527 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
				   
				   Dumputils

     Linux Kernel Crash Dump (LKCD) dump configuration and recovery utility
			  http://lkcd.sourceforge.net/


Dumputils is a simplified package for configuring LKCD and recovering LKCD crash
dumps. Dumputils provides two user space applications:  

	configdump: Configures the LKCD dump driver according to the parameters
	found in the dumputils configuration file in /etc/dumputils.conf.  The
	-l N option allows a level N to override the DUMP_LEVEL parameter in the
	configuration file.

	savedump: Recovers a dump by copying it from the raw dump partition
	(DUMPDEV) to the file system directory (DUMPDIR) specified in the
	configuration file.  This utility can also be used to "reset" or "erase"
	a dump in the dump partition.  

To build from source:

  -  make
  -  make install

To complete the installation manual intervention is required! 
	
1. You must manually create the appropriate symbolic link from the appropriate
   run level to /etc/init.d/dumputils! 

   Every distribution is slightly different in where and when (order) services
   are started. In general Linux utilizes the System V method of initialization
   in which run levels are utilized. As such the make install placed the
   dumputils startup script in /etc/init.d/dumputils. However, to make use of
   this script a symbolic link needs to be created in the appropriate location. 

   There are some caveats on when dumputils needs to run. 

     . If you are dumping to a swap partition dumputils needs to run before swap
       is enabled (i.e. before swapon runs). 

     . If you want to save the dump to a FTP server rather than the local file
       system you must start networking before you start dumputils. 

     . If you want to recover a dump from a swap partition and save it directly
       to a FTP server rather than the local file system you are going to have 
       to get creative and move starting swap until after networking and running
       dumputils. 

   In general you will want to do something like:

     -  cd /etc/rc3.d/
     -  ln -s /etc/init.d/dumputils S40dumputils

   Again this is distribution specific. In the above example I use S41 for
   runlevel 3, this is because on my system networking starts a S40. Since I
   dump to a dedicated partition on my hard drive I don't have to worry about
   when swap is enabled. 
                                                           
2. You must create a link to your dump partition/device.    

   You must decide where you want to LKCD to temporally save your dump files. We
   recommend using a dedicated raw (unformatted) partition for this. If you don't
   have a partition or extra disk to use for dumping you may utilize your swap
   partition. However, make sure to note that you need dumputils to run before
   you do a swapon during the boot initialization. 

   Let's say for example that I wish to use the first partition on my second
   SCSI disk drive as my dump partition. I would do the following:

      -  ln -s /dev/sdb1 /dev/vmdump 

   By setting up the link it make it less likely you will accidentally pick the
   wrong location and overwrite your filesystem. 

3. You must configure and enable LKCD by editing /etc/dumputils.conf                                   
   Edit /etc/dumputils.conf to match your configuration. You will need to set
   DUMP_ACTIVE=1 to enable LKCD. 


At this point you may either reboot or manually run "/etc/init.d/dumputils
start".


To remove / uninstall 

  -  make uninstall