.TH "chirp_stream_files" 1 "" "CCTools 7.1.2 FINAL" "Cooperative Computing Tools"

.SH NAME
.LP
\fBchirp_distribute\fP - copy a directory from one Chirp server to one or more Chirp server(s).

.SH SYNOPSIS
.LP
\FC\fBchirp_distribute [options] <sourcehost> <sourcepath> <host1> <host2> <host3> ...\fP\FT

.SH DESCRIPTION
.LP
\fBchirp_distribute\fP is a tool for coping commonly used data across Chirp servers. Data is originated from a Chirp server <sourcehost> <sourcepath> and is copied to a given list of Chirp server(s) <host1> <host2> <host3>, etc ...
.PP
\fBchirp_distribute\fP is a quick and simple way for replicating a directory from a Chirp server to many Chirp Servers by creating a spanning tree and then transferring data concurrently from host to host using third party transfer. It is faster than manually copying data using \fBparrot cp\fP, \fBchirp_put\fP or \fBchirp_third_put\fP
.PP
\fBchirp_distribute\fP also can clean up replicated data using -X option.
.SH OPTIONS
.LP

.LP
.TP
\fB-a\fP, \fB-\-auth\fP=\fI<flag>\fP
.
Require this authentication mode.
.TP
\fB-d\fP, \fB-\-debug\fP=\fI<flag>\fP
.
Enable debugging for this subsystem.
.TP
.B \ -D, --info-transfer
.
Show detailed location, time, and performance of each transfer.
.TP
\fB-F\fP, \fB-\-failures-file\fP=\fI<file>\fP
.
Write matrix of failures to this file.
.TP
\fB-i\fP, \fB-\-tickets\fP=\fI<files>\fP
.
Comma-delimited list of tickets to use for authentication.
.TP
\fB-N\fP, \fB-\-copies-max\fP=\fI<num>\fP
.
Stop after this number of successful copies.
.TP
\fB-p\fP, \fB-\-jobs\fP=\fI<num>\fP
.
Maximum number of processes to run at once (default=100)
.TP
.B \ -R, --randomize-hosts
.
Randomize order of target hosts given on command line.
.TP
\fB-t\fP, \fB-\-timeout\fP=\fI<time>\fP
.
Timeout for for each copy. (default is 3600s)
.TP
\fB-T\fP, \fB-\-timeout-all\fP=\fI<time>\fP
.
Overall timeout for entire distribution. (default is 3600).
.TP
.B \ -v, --verbose
.
Show program version.
.TP
.B \ -X, --delete-target
.
Delete data from all of the target hosts.
.TP
.B \ -Y, --info-success
.
Show confirmation of successful placements.
.TP
.B \ -h, --help
.
Show help text.


.SH ENVIRONMENT VARIABLES
.LP


.IP \(bu 4
\FC\fBCHIRP_CLIENT_TICKETS\fP\FT Comma delimited list of tickets to authenticate with (same as \FC-i\FT).


.SH EXIT STATUS
.LP
On success, returns zero.  On failure, returns non-zero.

.SH EXAMPLES
.LP
To copy a directory from server1 to server2, server3, server4 using \fBchirp_distribute\fP:
.fam C
.nf
.nh
.IP "" 8
chirp_distribute server1.somewhere.edu /mydata server2.somewhere.edu server3.somewhere.edu server4.somewhere.edu
.fi
.hy
.fam
.P

To replicate a directory from server1 to  all available Chirp server(s) in Chirp catalog using \fBchirp_distribute\fP and \fBchirp_status\fP:

.fam C
.nf
.nh
.IP "" 8

chirp_distribute server1.somewhere.edu /mydata \`chirp_status -s\`

.fi
.hy
.fam
.P

To replicate a directory from server1 to  all available Chirp server(s) in Chirp catalog using \fBchirp_distribute\fP and \fBchirp_status\fP. However stop when reach 100 copies with -N option:
.fam C
.nf
.nh
.IP "" 8

chirp_distribute -N 100 server1.somewhere.edu /mydata \`chirp_status -s\`

.fi
.hy
.fam
.P

To clean up replicated data using \fBchirp_distribute\fP using -X option:
.fam C
.nf
.nh
.IP "" 8

chirp_distribute -X server1.somewhere.edu /mydata \`chirp_status -s\`

.fi
.hy
.fam
.P


.SH COPYRIGHT
.LP

The Cooperative Computing Tools are Copyright (C) 2005-2019 The University of Notre Dame.  This software is distributed under the GNU General Public License.  See the file COPYING for details.

.SH SEE ALSO
.LP


.IP \(bu 4
\fBCooperative Computing Tools Documentation\fP
.IP \(bu 4
\fBChirp User Manual\fP
.IP \(bu 4
\fBchirp(1)\fP  \fBchirp_status(1)\fP  \fBchirp_fuse(1)\fP  \fBchirp_get(1)\fP  \fBchirp_put(1)\fP  \fBchirp_stream_files(1)\fP  \fBchirp_distribute(1)\fP  \fBchirp_benchmark(1)\fP  \fBchirp_server(1)\fP