NAME

       chirp_distribute - copy a directory from one Chirp server to one or more Chirp server(s).

SYNOPSIS

       chirp_distribute [options] <sourcehost> <sourcepath> <host1> <host2> <host3> ...

DESCRIPTION

       chirp_distribute  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 ...

       chirp_distribute  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 parrot cp, chirp_put or chirp_third_put

       chirp_distribute also can clean up replicated data using -X option.

OPTIONS

       -a, --auth=<flag>
              Require this authentication mode.

       -d, --debug=<flag>
              Enable debugging for this subsystem.

        -D, --info-transfer
              Show detailed location, time, and performance of each transfer.

       -F, --failures-file=<file>
              Write matrix of failures to this file.

       -i, --tickets=<files>
              Comma-delimited list of tickets to use for authentication.

       -N, --copies-max=<num>
              Stop after this number of successful copies.

       -p, --jobs=<num>
              Maximum number of processes to run at once (default=100)

        -R, --randomize-hosts
              Randomize order of target hosts given on command line.

       -t, --timeout=<time>
              Timeout for for each copy. (default is 3600s)

       -T, --timeout-all=<time>
              Overall timeout for entire distribution. (default is 3600).

        -v, --verbose
              Show program version.

        -X, --delete-target
              Delete data from all of the target hosts.

        -Y, --info-success
              Show confirmation of successful placements.

        -h, --help
              Show help text.

ENVIRONMENT VARIABLES

       •   CHIRP_CLIENT_TICKETS Comma delimited list of tickets to authenticate with (same as -i).

EXIT STATUS

       On success, returns zero.  On failure, returns non-zero.

EXAMPLES

       To copy a directory from server1 to server2, server3, server4 using chirp_distribute:

               chirp_distribute server1.somewhere.edu /mydata server2.somewhere.edu server3.somewhere.edu server4.somewhere.edu

       To  replicate  a  directory  from  server1  to   all  available  Chirp  server(s)  in Chirp catalog using
       chirp_distribute and chirp_status:

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

       To replicate a directory  from  server1  to   all  available  Chirp  server(s)  in  Chirp  catalog  using
       chirp_distribute and chirp_status. However stop when reach 100 copies with -N option:

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

       To clean up replicated data using chirp_distribute using -X option:

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

COPYRIGHT

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

SEE ALSO

       •   Cooperative Computing Tools Documentation

       •   Chirp User Manual

       •   chirp(1)    chirp_status(1)    chirp_fuse(1)    chirp_get(1)    chirp_put(1)    chirp_stream_files(1)
           chirp_distribute(1)  chirp_benchmark(1)  chirp_server(1)