1
2ethscpall(8)                 EFSFFCLIRG (Man Page)                ethscpall(8)
3
4
5

NAME

7       ethscpall
8
9
10
11       Copies  files  or directories from the current system to multiple hosts
12       in the fabric. When copying large directory trees, use the -t option to
13       improve  performance.  This option tars and compresses the tree, trans‐
14       fers the resulting compressed tarball to each node, and  untars  it  on
15       each node.
16
17       Use this tool for copying data files, operating system files, or appli‐
18       cations to all the hosts (or a subset of hosts) within the fabric.
19
20       NOTE:
21
22
23       •      This tool can only copy from this system to a group  of  systems
24              in  the cluster. To copy from hosts in the cluster to this host,
25              use ethuploadall.
26
27       •      user@ style syntax cannot be used when specifying filenames.
28
29       •      Beware: For the -r option, when copying a single  source  direc‐
30              tory,  if  the  destination  directory does not exist it will be
31              created and the source files placed directly in it.
32
33       •      In other situations, the -r option will copy the  source  direc‐
34              tory as a directory under the destination directory.
35
36       •      The  -R option will always copy the source directory as a direc‐
37              tory under the destination directory.
38
39       •      The -t option will always place the files  found  in  source_dir
40              directly in the destination directory.
41
42

Syntax

44       ethscpall [-pq] [-r|-R] [-f  hostfile] [-h 'hosts'] [-u  user] [-B  in‐
45       terface]
46       source_file ... dest_file
47
48
49
50       ethscpall [-t] [-pq] [-Z  tarcomp]  [-f   hostfile]  [-h  'hosts']  [-u
51       user] [-B  interface]
52       [ source_dir [ dest_dir]]
53
54
55

Options

57       --help
58
59                 Produces full help text.
60
61       -p
62
63                 Performs copy in parallel on all hosts.
64
65       -q
66
67                 Don't list files being transferred.
68
69       -r
70
71                 Performs recursive copy of directories using scp.
72
73       -R
74
75                 Performs recursive copy of directories using rsync (only copy
76                 changed files).
77
78       -t
79
80                 Performs optimized recursive copy of directories  using  tar.
81                 dest_dir  is  optional.  If dest_dir is not specified, it de‐
82                 faults to the current directory name. If both source_dir  and
83                 dest_dir are omitted, they both default to the current direc‐
84                 tory name.
85
86
87       -h hosts
88
89                 Specifies the list of hosts to copy to.
90
91       -f hostfile
92
93                 Specifies  the  file  with  hosts  in  cluster.  Default   is
94                 /etc/eth-tools/hosts file.
95
96       -u user
97
98                 Specifies  the  user  to  perform copy to. Default is current
99                 user code.
100
101       -B interface
102
103                 Local network interface to use for scp or rsync Note the des‐
104                 tination hosts specified must be accessible via the given in‐
105                 terface's IP subnet. This may  imply  the  use  of  alternate
106                 hostnames or IP addresses for the destination hosts
107
108
109       -Z tarcomp
110
111                 A  simple  tar  compression  option  to  use, such as --xz or
112                 --lzip. When host list is large  better  compression  may  be
113                 preferred.  When host list is small faster compression may be
114                 preferred. -Z ' ' will not use compression. Default is -z.
115
116
117       source_file
118
119                 Specifies the file or list of source files to copy.
120
121
122       source_dir
123
124                 Specifies the name of the source directory to copy. If  omit‐
125                 ted, current working directory is used.
126
127
128       dest_file or dest_dir
129
130                 Specifies  the  name of the destination file or directory. If
131                 copying multiple files, use a directory name instead  as  the
132                 destination.  If  the  file or directory name is omitted, the
133                 source file or current directory name is used respectively.
134
135

Example

137       # efficiently copy an entire directory tree
138
139       ethscpall -t -p /usr/src/eth/mpi_apps /usr/src/eth/mpi_apps
140
141
142
143       # copy a group of files
144
145       ethscpall a b c /root/tools/
146
147
148
149       # copy to an explitly specified set of hosts
150
151       ethscpall -h 'arwen elrond' a b c /root/tools
152
153       HOSTS='arwen elrond' ethscpall a b c /root/tools
154
155
156
157       # copy to an explitly specified set of hosts over local eth2 nic
158
159       echscpall -h 'arwen elrond' -B eth2 a b c /root/tools
160

Environment Variables

162       The following environment variables are also used by this command:
163
164       HOSTS
165
166                 List of hosts; used if -h option not supplied.
167
168
169       HOSTS_FILE
170
171                 File containing list of hosts; used in absence of -f and -h.
172
173
174       FF_MAX_PARALLEL
175
176                 When the -p option is used, maximum concurrent operations are
177                 performed.
178
179
180
181Copyright(C) 2020-2022         Intel Corporation                  ethscpall(8)