ethdownloadall - Man Page
Name
ethdownloadall
Copies one or more files to a group of hosts from a system. Since the file contents to copy may be different for each host, a separate directory on this system is used for the source files for each host. This can also be used in conjunction with ethuploadall to upload a host-specific configuration file, edit it for each host, and download the new version to all the hosts.
NOTE:
- The tool ethdownloadall can only copy from this system to a group of hosts in the cluster. To copy files from hosts in the cluster to this host, use ethuploadall.
- user@ syntax cannot be used in filenames specified.
Syntax
ethdownloadall [-pr] [-f hostfile] [-h 'hosts']
[-u user] [-d download_dir] source_file ... dest_file
Options
- --help
Produces full help text.
- -p
Performs copy in parallel on all hosts.
- -r
Performs recursive download of directories.
- -f hostfile
Specifies the file with hosts in cluster. Default is /etc/eth-tools/hosts file.
- -h hosts
Specifies the list of hosts to download files to.
- -u user
Specifies the user to perform the copy. Default is the current user.
- -d download_dir
Specifies the directory to download files from. Default is downloads. If not specified, the environment variable DOWNLOADS_DIR is used. If that is not exported, the default is used.
- source_file
Specifies the list of source files to copy from the system.
NOTE: The option source_file is relative to download_dir/hostname. A local directory within download_dir/ must exist for each host being downloaded to. Each downloaded file is copied from download_dir/hostname/source_file.
- dest_file
Specifies the name of the file or directory on the destination hosts to copy to.
NOTE: If more than one source file is specified, dest_file is treated as a directory name. The given directory must already exist on the destination host. The copy fails for hosts where the directory does not exist.
Example
ethdownloadall -h 'arwen elrond' irqbalance vncservers /etc
# Copies two files to 2 hosts
ethdownloadall -p irqbalance vncservers /etc
# Copies two files to all hosts
Environment Variables
The following environment variables are also used by this command:
- HOSTS
List of hosts; used if -h option not supplied.
- HOSTS_FILE
File containing list of hosts; used in absence of -f and -h.
- DOWNLOADS_DIR
Directory to download from, used in absence of -d.
- FF_MAX_PARALLEL
When the -p option is used, the maximum concurrent operations are performed.