|
 |
c288c9 |
diff -ur sysstat-10.1.5.orig/man/sysstat.in sysstat-10.1.5/man/sysstat.in
|
|
|
c288c9 |
--- sysstat-10.1.5.orig/man/sysstat.in 2010-09-22 22:07:29.000000000 +0200
|
|
|
c288c9 |
+++ sysstat-10.1.5/man/sysstat.in 2014-09-01 22:50:58.614499671 +0200
|
|
|
c288c9 |
@@ -11,17 +11,99 @@
|
|
|
c288c9 |
configure sysstat logging.
|
|
|
c288c9 |
The variables and their meanings are:
|
|
|
c288c9 |
.TP
|
|
|
c288c9 |
+.B COMPRESSAFTER
|
|
|
c288c9 |
+Number of days after which daily data files are to be compressed.
|
|
|
c288c9 |
+The compression program is given in the
|
|
|
c288c9 |
+.B ZIP
|
|
|
c288c9 |
+variable.
|
|
|
c288c9 |
+
|
|
|
c288c9 |
+.TP
|
|
|
c288c9 |
.B HISTORY
|
|
|
c288c9 |
The number of days during which a daily data file or a report
|
|
|
c288c9 |
should be kept. Data files or reports older than this number of
|
|
|
c288c9 |
days will be removed by the
|
|
|
c288c9 |
.BR sa2 (8)
|
|
|
c288c9 |
shell script.
|
|
|
c288c9 |
+Data files and reports are normally saved in the @SA_DIR@ directory,
|
|
|
c288c9 |
+under the name
|
|
|
c288c9 |
+.IR saDD
|
|
|
c288c9 |
+(for data files) or
|
|
|
c288c9 |
+.IR sarDD
|
|
|
c288c9 |
+(for reports), where the DD parameter indicates the current day.
|
|
|
c288c9 |
|
|
|
c288c9 |
-.TP
|
|
|
c288c9 |
-.B COMPRESSAFTER
|
|
|
c288c9 |
-Number of days after which daily data files are to be compressed,
|
|
|
c288c9 |
-either by gzip or bzip2.
|
|
|
c288c9 |
+The number of files actually kept in the @SA_DIR@ directory may be
|
|
|
c288c9 |
+slightly higher than the
|
|
|
c288c9 |
+.B HISTORY
|
|
|
c288c9 |
+value due to the way the
|
|
|
c288c9 |
+.B sa2
|
|
|
c288c9 |
+script figures
|
|
|
c288c9 |
+out which files are to be removed (see below "How the
|
|
|
c288c9 |
+.BR sa2 (8)
|
|
|
c288c9 |
+script applies
|
|
|
c288c9 |
+.B HISTORY
|
|
|
c288c9 |
+value"). Using a value of 28 keeps a whole month's worth of data.
|
|
|
c288c9 |
+
|
|
|
c288c9 |
+How the
|
|
|
c288c9 |
+.BR sa2 (8)
|
|
|
c288c9 |
+script applies
|
|
|
c288c9 |
+.B HISTORY
|
|
|
c288c9 |
+value
|
|
|
c288c9 |
+
|
|
|
c288c9 |
+The
|
|
|
c288c9 |
+.B sa2
|
|
|
c288c9 |
+script uses the "find" command with the "-mtime" option to figure
|
|
|
c288c9 |
+out which files are to be removed. The "find" command interprets this value
|
|
|
c288c9 |
+as "N 24 hour periods", ignoring any fractional part. This means that the
|
|
|
c288c9 |
+last modified time of a given sa[r]DD data or report file, using a
|
|
|
c288c9 |
+.B HISTORY
|
|
|
c288c9 |
+of 1, has to have been modified at least two days ago before it will be
|
|
|
c288c9 |
+removed. And for a
|
|
|
c288c9 |
+.B HISTORY
|
|
|
c288c9 |
+of 28 that would mean 29 days ago.
|
|
|
c288c9 |
+
|
|
|
c288c9 |
+To figure out how a
|
|
|
c288c9 |
+.B HISTORY
|
|
|
c288c9 |
+of 28 is applied in practice, we need to
|
|
|
c288c9 |
+consider that the
|
|
|
c288c9 |
+.B sa2
|
|
|
c288c9 |
+script that issues the "find" command to remove the
|
|
|
c288c9 |
+old files typically runs just before mid-night on a given system, and since
|
|
|
c288c9 |
+the first record from
|
|
|
c288c9 |
+.B sadc
|
|
|
c288c9 |
+can also be written to the previous day's data file
|
|
|
c288c9 |
+(thereby moving its modification time up a bit), the
|
|
|
c288c9 |
+.B sa2
|
|
|
c288c9 |
+script will leave
|
|
|
c288c9 |
+30 files untouched. So for a setting of 28, and counting the data file of
|
|
|
c288c9 |
+the current day, there will always be 31 files (or 30 files, depending on the
|
|
|
c288c9 |
+number of days in a month) in the @SA_DIR@ directory during the majority
|
|
|
c288c9 |
+of a given day. E.g.:
|
|
|
c288c9 |
+
|
|
|
c288c9 |
+April 30th: 31 files (Apr 30th-1st, Mar 31th)
|
|
|
c288c9 |
+.br
|
|
|
c288c9 |
+May 1st: 30 files (May 1st, Apr 30th-2nd)
|
|
|
c288c9 |
+
|
|
|
c288c9 |
+Yet we can note the following exceptions (as inspected at Noon of the given
|
|
|
c288c9 |
+day):
|
|
|
c288c9 |
+
|
|
|
c288c9 |
+February 28th: 31 files (Feb 28th-1st, Jan 31st, 30th & 29th)
|
|
|
c288c9 |
+.br
|
|
|
c288c9 |
+March 1st: 30 files (Mar 1st, Feb 28th-2nd, Jan 31st & 30th)
|
|
|
c288c9 |
+.br
|
|
|
c288c9 |
+March 2nd: 29 files (Mar 1st & 2nd, Feb 28th-3rd, Jan. 31st)
|
|
|
c288c9 |
+.br
|
|
|
c288c9 |
+March 3rd: 28 files (Mar 1st-3rd, Feb 28th-4th)
|
|
|
c288c9 |
+.br
|
|
|
c288c9 |
+March 4th - March 28th: 28 files
|
|
|
c288c9 |
+.br
|
|
|
c288c9 |
+March 29th: 29 files
|
|
|
c288c9 |
+.br
|
|
|
c288c9 |
+March 30th: 30 files
|
|
|
c288c9 |
+.br
|
|
|
c288c9 |
+March 31st: 31 files
|
|
|
c288c9 |
+
|
|
|
c288c9 |
+(Determining the number of files in March on a leap year is left as an
|
|
|
c288c9 |
+exercise for the reader).
|
|
|
c288c9 |
|
|
|
c288c9 |
.TP
|
|
|
c288c9 |
.B SADC_OPTIONS
|
|
|
c288c9 |
@@ -34,6 +116,10 @@
|
|
|
c288c9 |
These options are used only when a new data file is created. They will be
|
|
|
c288c9 |
ignored with an already existing one.
|
|
|
c288c9 |
|
|
|
c288c9 |
+.TP
|
|
|
c288c9 |
+.B ZIP
|
|
|
c288c9 |
+Program used to compress data and report files.
|
|
|
c288c9 |
+
|
|
|
c288c9 |
.SH FILES
|
|
|
c288c9 |
.IR @SYSCONFIG_DIR@/sysstat
|
|
|
c288c9 |
|