.\" .\" *********************************************************************
.\" .\" *                                                                   *
.\" .\" *             Copyright 2020-2024, Intel Corporation                *
.\" .\" *                                                                   *
.\" .\" *                       All Rights Reserved.                        *
.\" .\" *                                                                   *
.\" .\" *********************************************************************

.TH ethuploadall 8 "Intel Corporation" "Copyright(C) 2020\-2024" "EFSFFCLIRG (Man Page)"
.SH NAME
ethuploadall


.PP
Copies one or more files from a group of hosts to this system. Since the file name is the same on each host, a separate directory on this system is created for each host and the file is copied to it. This is a convenient way to upload log files or configuration files for review. This tool can also be used in conjunction with ethdownloadall to upload a host-specific configuration file, edit it for each host, and download the new version to all the hosts.
.PP

.B NOTE:

.IP \(bu
To copy files from this host to hosts in the cluster, use ethscpall or ethdownloadall.
.IP \(bu
user@ syntax cannot be used in filenames specified.
.IP \(bu
A local directory within  \fIupload\(uldir\fR/ is created for each hostname.
.IP \(bu
Each uploaded file is copied to upload\(uldir/\fIhostname\fR/\fIdest\(ulfile\fR within the local system.
.IP \(bu
If more than one source file is specified or dest\(ulfile has a trailing / , a dest\(ulfile directory will be created.

.SH Syntax
ethuploadall [-rp] [-f  \fIhostfile\fR] [-d  \fIupload\(uldir\fR] [-h \[aq]\fIhosts\fR\[aq]] [-u  \fIuser\fR]
\fIsource\(ulfile\fR ...  \fIdest\(ulfile\fR
.SH Options

.TP 10
--help

Produces full help text.
.TP 10
-p

Performs copy in parallel on all hosts.
.TP 10
-r

Performs recursive upload of directories.
.TP 10
-f \fIhostfile\fR

Specifies the file with hosts in cluster.
.br
Default is /etc/eth-tools/hosts file.
.TP 10
-h \fIhosts\fR

Specifies the list of hosts to upload from.
.TP 10
-u \fIuser\fR

Specifies the user to perform copy to. Default is current user.
.TP 10
-d \fIupload\(uldir\fR

Specifies the directory to upload to. Default is uploads. If not specified, the environment variable \fBUPLOADS\(ulDIR\fR is used. If that is not exported, the default, uploads, is used.
.TP 10
\fIsource\(ulfile\fR

Specifies the name of files to copy to this system, relative to the current directory. Multiple files may be listed.
.TP 10
\fIdest\(ulfile\fR

Specifies the name of the file or directory on this system to copy to. It is relative to  \fIupload\(uldir\fR/\fIhostname\fR.
.SH Example
# upload two files from 2 hosts
.br

ethuploadall -h \[aq]arwen elrond\[aq] capture.tgz /etc/init.d/ipoib.cfg.
.br


.br

# upload two files from all hosts
.br

ethuploadall -p capture.tgz /etc/init.d/ipoib.cfg.
.br


.br

# upload network config files from all hosts
.br

ethuploadall capture.tgz /etc/init.d/ipoib.cfg pre-install
.SH Environment Variables

.PP
The following environment variables are also used by this command:
.TP 10
\fBHOSTS\fR

List of hosts; used if -h option not supplied.

.TP 10
\fBHOSTS\(ulFILE\fR

File containing list of hosts; used in absence of -f and -h.

.TP 10
\fBUPLOADS\(ulDIR\fR

Directory to upload to, used in absence of -d.

.TP 10
\fBFF\(ulMAX\(ulPARALLEL\fR

When the -p option is used, maximum concurrent operations are performed.
