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 $