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>
               Enable authentication mode: unix, hostname, address, ticket, kerberos, or globus.

        -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) 2022 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)