scc-pull(1)



NAME


	scc-pull - pull scc-data from clients

RELEASE


	scc-srv	1.7.5

SYNOPSIS


	scc-pull [ -B <bin> ] [ -D <data> ] [ -d <delay> ] [ -I <ident> ]
		[-c <remark> ] [ -n ] [ -p <prog> ] [ -s <dest> ]
		[ -e <module> ] [ -m <max> ] [ -u <user> ]
		[ -R <realm> | -L <list> | -S <systems> ]

DESCRIPTION


	This program pulls scc-data from clients using scp/rcp. This is done
	by executing scc on clients and pulling the files to the server. 
	Finally scc-update is called to update the realms with the new files.
	By default, scc is started in the background on the clients. The
	program waits some specified time and then pulls the files from the
	clients.

	In case of errors when running scc on the clients, the stdout and stderr
	is recorded on the clients in the file /var/opt/scc/data/scc-pull.log
	When the -D option is used, the path changed accordingly.

	Doug Probst provided the initial version of this program.

OPTIONS


	The following options control the execution/retrieval:
	-B <bin>        Use <bin> to start scc on the clients. By default the
	                path is based on /opt/scc-srv/bin, where scc-srv is
	                replaced by scc.
	-c <remark>     Add a remark to the logbook(s), indicating a "specific" 
	                reason to run scc.
	-D <data>       Use <data> to retrieve the data from the clients. By
	                default this is based on /var/opt/scc-srv/data/transfer,
	                where scc-srv is replaced by scc.
	-d <delay>      After starting scc on the clients in the background,
	                wait <delay> seconds before retrieving the files. 
	                Thus, the delay should be long enough for all clients
	                to finish their run of scc.
	                Default delay is 600 seconds. When you specify delay 0,
	                scc is not started in the background on the clients.
	                and scc is run sequential on all hosts.
	-I <ident>      Full path of identity file for scp; implies "-p scp".
	-n              Do not start scc on the clients, retrieve the scc-files
	                immediately. To be used when the clients use specific
	                scheduling.
	-p <prog>       Use <prog> to communicate with the client. Supported
	                values are: ssh, rsh and ovdeploy. By default ssh is used.
	                Test "-p ssh" option in an interactive session to capture 
	                messages and to check for required passwords.
	-s <dest>       Full path of local destination directory for the copied
			files, by default /var/opt/scc-srv/data/transfer/cp.
	-u <user>       Files are retrieved by <user>, not by root. Remote start
	                of scc is done by root, but the -u option is handed to
	                scc client to give the files that have to be transferred
	                the proper ownership. File retrieval from the clients is
	                done by user <user> when this option is used. When the 
	                program is not run by root, the option -u <user> are 
	                impied. This option is also passed to the client.

	The -u option and the following options are passed to the clients when 
	running scc, note that the values are not checked by scc-pull:
	-e <mod>        Specifies which modules to execute on the client. 
	                By default only system modules are executed.
	-m <max>        Entries in the log-file, that are older than <max> 
	                months are deleted.

	The following options control from which clients to pull the files:
	-L <list>       File <list> contains a list of systems. Empty and 
	                comment lines (starting with "#") are ignored.
	                Requires full path of file.
	-R <realm>      Use all cur-files in realm <realm> to determine the
	                clients. By default realm All is used.
	-S <systems>    Comma separated list of clients.

ARGUMENTS


	None.

DIAGNOSTICS


	This program writes the following messages to stderr:

	Syntax error, use: scc-pull [ -B <bin> ] [ -c <remark> ] [ -D <data> ]
	                [ -d <delay> ] [ -I <ident> ] [ -n ] [ -p <prog> ]
			[ -s <dest> ] [ -e <module> ] [ -m <max> ] [ -u <user> ]
			[ -R <realm> | -L <list> | -S <systems> ]
	A syntax error has been detected.

	scc-pull: Syntax error, missing argument for option: <option>
	The argument for <option> is missing.

	scc-pull: cannot find realm <realm>
	The directory indicated with the -B option cannot be found in
	/var/opt/scc-srv/data/www.

	scc-pull: cannot find directory <dir>
	The directory indicated with the -s option cannot be found.

	scc-pull: cannot find file <file>
	The file indicated with the -L/-I option cannot be found.

	scc-pull: cannot find ovdeploy
	The indicated transfer program (Open View Operations 8) cannot be found.

	scc-pull: unsupported method: <prog>
	The value provided with the -p option is not supported.

	scc-pull: missing data for <host>
	The host did not produce the scc-data. When the -d options has been used
	and the client has not yet completed it's run. Without the -d option,
	the server waits for the client to complete and missing data indicates
	an internal error in the client.

EXTERNAL INFLUENCES


	This program calls scc-update to update the realms with the new files.

RETURN VALUE

	The possible exit values are:
		0: success
		1: syntax error
		2: general runtime error
		3: missing snapshot after delay

COPYRIGHT


	scc-pull 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.

EXAMPLES


	To pull all files for the realm All using ssh and default client and
	server install, use:

		scc-pull

	When you install scc on a new system and want it to be become part of 
	realm All, use the following command once:

		scc-pull -S <sys>

	Now scc runs on the system and the scc-files are transferred to the 
	server where <sys> becomes part of realm All. From now on, using
	scc-pull (without options) will also approach this system.

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.25 $