scc-summary(1)
NAME
scc-summary - summarize SCC-snapshots
RELEASE
scc-srv 1.7.5
SYNOPSIS
scc-summary [ -d <scc_web_path> ] [ -f ] <dir>
DESCRIPTION
This program extracts certain data from collected snapshots and log files
to produce html-files summarizing changes and properties of the systems
where SCC-snapshots have been collected.
The mode of the new files and the owner/group are derived from <dir>.
For the permissions, only the read-attributes are considered.
The summaries are only generated after new scc-data has arrived for the
realm. When a realm does not receive new scc-data, scc-update does not
run any command for the realm.
Force immediate update by using: scc-update -f
OPTIONS
-d <scc_web_path> Path for SCC-data under DocumentRoot,
Default is: "", meaning SCC-data resides
in the document-root of the web server.
-f Force update. Regenerate list of top-level
classifications.
ARGUMENTS
<dir> The directory with collected snapshots, where the
summaries are produced.
EXTERNAL INFLUENCES
This program calls scc-rules to check the (optional) rules for the
realm.
Note that the current version of the program is incompatible with
releases 1.5.16 and earlier of scc-srv. Refer to scc-srv(5) how to
change the apache configuration when upgrading scc-srv from an
incompatible version.
DIAGNOSTICS
This program writes the following messages to stderr:
Syntax error, use: scc-summary [ -d <scc_web_path> ] [ -f ] <dir>
A syntax error has been detected.
scc-summary: Syntax error, missing argument for option: <option>
The argument for <option> is missing.
scc-summary: directory <dir> does not exist
The base directory of the realm, does not exist.
COPYRIGHT
scc-summary is free software under the terms of the GNU General Public
License. Copyright (C) 2001-2004 Open Challenge B.V.,
2004-2005 OpenEyeT Professional Services, 2005-2009 QNH.
FILES
/var/opt/scc-srv/tmp - directory for temporary files
<dir> - directory for snapshots and log files
scc-summary.data - general data extracted from snapshots
scc-rules.data - output from scc-rules
index.html - main access to <dir>
scc-summary-*.html - summary of snapshots sorted by category
scc-log-index.html - main-index to changes per day
scc-log-<day>.html - changes for <day> (yyyy-mm-dd)
scc.<hostname>.cur - snapshots
scc.<hostname>.log - logbooks
<dir>/custom/scc-logo.png - logo to customize HTML-output
<dir>/custom/scc-realm.conf - configuration for <dir>
optional background color can be specified in this file
by means of: BG_COLOR=<value>
<dir>/custom/scc-smt-select - configuration file for scc-smt
when this file is absent, the index.html of the realm
does not contain an entry for SMT.
SEE ALSO
scc-baseline(1), scc-pull(1), scc-realm(1), scc-receive-mail(1),
scc-rules(1), scc-smt(1), scc-summary(1), scc-syscmp(1),
scc-transfer(1), scc-update(1), scc-wrapper.cgi(1), scc.cgi(1),
scc-srv(5)
VERSION
$Revision: 1.108 $