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

Syntax

31       ethscpall [-p] [-r] [-f  hostfile] [-h 'hosts'] [-u  user]
32       source_file ... dest_file
33
34
35
36       ethscpall [-t] [-p] [-f  hostfile] [-h 'hosts'] [-u  user]
37       [ source_dir [ dest_dir]]
38
39
40

Options

42       --help
43
44                 Produces full help text.
45
46       -p
47
48                 Performs copy in parallel on all hosts.
49
50       -r
51
52                 Performs recursive copy of directories.
53
54       -t
55
56                 Performs optimized recursive copy of directories  using  tar.
57                 dest_dir  is  optional.  If dest_dir is not specified, it de‐
58                 faults to the current directory name. If both source_dir  and
59                 dest_dir are omitted, they both default to the current direc‐
60                 tory name.
61
62
63       -h hosts
64
65                 Specifies the list of hosts to copy to.
66
67       -f hostfile
68
69                 Specifies  the  file  with  hosts  in  cluster.  Default   is
70                 /etc/eth-tools/hosts file.
71
72       -u user
73
74                 Specifies  the  user  to  perform copy to. Default is current
75                 user code.
76
77       source_file
78
79                 Specifies the file or list of source files to copy.
80
81
82       source_dir
83
84                 Specifies the name of the source directory to copy. If  omit‐
85                 ted. is used.
86
87
88       dest_file or dest_dir
89
90                 Specifies  the  name  of the destination file or directory to
91                 copy to. If more than one source file, this must be a  direc‐
92                 tory. If omitted current directory name is used.
93
94

Example

96       # efficiently copy an entire directory tree
97
98       ethscpall -t -p /usr/src/eth/mpi_apps /usr/src/eth/mpi_apps
99
100
101
102       # copy a group of files
103
104       ethscpall a b c /root/tools/
105
106
107
108       # copy to an explitly specified set of hosts
109
110       ethscpall -h 'arwen elrond' a b c /root/tools
111
112       HOSTS='arwen elrond' ethscpall a b c /root/tools
113

Environment Variables

115       The following environment variables are also used by this command:
116
117       HOSTS
118
119                 List of hosts; used if -h option not supplied.
120
121
122       HOSTS_FILE
123
124                 File containing list of hosts; used in absence of -f and -h.
125
126
127       FF_MAX_PARALLEL
128
129                 When the -p option is used, maximum concurrent operations are
130                 performed.
131
132
133
134Copyright(C) 2020-2021         Intel Corporation                  ethscpall(8)
Impressum