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 $