File: README.patch

package info (click to toggle)
atoppatch 1%3A1.14-1
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 72 kB
  • ctags: 4
  • sloc: makefile: 43
file content (94 lines) | stat: -rw-r--r-- 3,637 bytes parent folder | download
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
88
89
90
91
92
93
94
ATOP can be used without kernel-patches. In that case no
information is available about the disk- and network-traffic on a
per-process basis. This means a.o. that the selection 'd' (show
disk-transfers per process) and 'n' (show network-transfers per
process) can not be used, and the columns shown in the generic
screen are different.

Two kernel-patches are delivered for ATOP:

  XXX-atopcnt
	This patch takes care that statistical counters are added
	to the process-administration (task_struct) and that these
	counters are incremented per process.
	The additional counters are shown via the process'
	/proc/PID/stat file as a second line of counters.
	The meaning of these counters:
	  - disk read transfers
	  - disk accumulated number of sectors read
	  - disk write transfers
	  - disk accumulated number of sectors written
	  - tcp  send requests
	  - tcp  accumulated number of bytes transmitted
	  - tcp  receive requests
	  - tcp  accumulated number of bytes received
	  - udp  send requests
	  - udp  accumulated number of bytes transmitted
	  - udp  receive requests
	  - udp  accumulated number of bytes received
	  - raw  send requests (e.g. echo requests by ping)
	  - raw  receive requests

	When this patch is installed, ATOP automatically shows
	another layout for the generic screen (including disk-
	and network-transfers for active processes). However for
	terminated process these additional counters are not shown,
	because the conventional layout of the process-accounting
	record has not been adapted.

  XXX-atopacct
	This patch takes care that the additional statistical
	counters are added to the process-accounting record (yes,
	this means an incompatible layout of this record).

	Notice that this patch is an extension of the XXX-atopcnt
	patch! This patch can not be installed on its own.

	When this patch is installed, ATOP automatically shows
	the additional counters for terminated processes as well.
	Since the pid of processes is also stored in the modified
	process-accounting record, matching this info with the
	formerly running process is less time-consuming compared to
	the conventional process-accounting record.


The following steps are needed to install these patches:

     1.	Take care that the kernel-sources are installed
	(as a subdirectory of /usr/src).

     2. Make a copy of the directory-tree with original kernel-sources
	to a new tree under /usr/src.

     3.	Make a symbolic link with the name /usr/src/linux referring to the
	copied tree. This tree will be modified with the patch(es).

     4.	Start the command to patch the new tree while you remain in the
	directory /usr/src.

	Example for kernel-version 2.6.8:

		patch -p0 < 01patch-2.6.8_atopcnt

		patch -p0 < 02patch-2.6.8_atopacct

	This will modify the kernel-sources under /usr/src/linux.

     5.	Build a new kernel and reboot.

	When the patch ..._atopacct has been installed, take care that
	the current process-accounting file (filled with the old
 	record-layout till now) is removed. This is only relevant when
 	your system permanently logs process-accounting records triggered
	by the file /etc/logrotate.d/psacct. Thus if this file is present,
	issue the following commands after you rebooted your system:

	  /usr/sbin/accton                      # switch off accounting
       	  > /var/account/pacct			# empty accounting file
       	  /usr/sbin/accton /var/account/pacct	# switch on  accounting


Disclaimer:
The authors deny any warranty for any data loss and damage whatsoever
that may be caused directly or indirectly by using this software.
This is experimental software. Use at your own risk.