B.4.2. Syntax for engine-iso-uploader Command

⁠B.4.2. Syntax for engine-iso-uploader Command

The basic syntax for the ISO uploader command is:

engine-iso-uploader [options] list
engine-iso-uploader [options] upload [file].[file]...[file]

The two supported modes of operation are list and upload.

The list parameter lists the valid ISO storage domains available for ISO uploads. The Red Hat Enterprise Virtualization Manager sets this list on the local machine upon installation.
The upload parameter uploads single or multiple space-separated ISO files to the specified ISO storage domain. NFS is used as default; SSH is available.

The ISO uploader command requires either the list or upload parameter be included for basic usage. The upload parameter requires a minimum of one local file name to upload.

There are numerous parameters to further refine the engine-iso-uploader command.

General Options

--version: Displays the version number of the command in use and returns to prompt.
-h, --help: Displays command usage information and returns to prompt.
--conf-file=PATH: Sets PATH as the configuration file the tool is to use.
--log-file=PATH: Sets PATH as the specific file name the command should use for the log output.
--quiet: Sets quiet mode, reducing console output to a minimum. Quiet mode is off by default.
-v, --verbose: Sets verbose mode, providing more console output. Verbose mode is off by default.
-f, --force: Force mode is necessary when the source file being uploaded has an identical file name as an existing file at the destination; it forces the existing file to be overwritten. Force mode is off by default.

Red Hat Enterprise Virtualization Manager Options

-u USER, --user=USER: Sets the user associated with the file to be uploaded. The USER is specified in the format user@domain, where user is the user name and domain is the directory services domain in use. The user must exist in directory services and be known to the Red Hat Enterprise Virtualization Manager.
-r FQDN, --rhevm=FQDN: Sets the fully qualified domain name of the Red Hat Enterprise Virtualization Manager server from which to upload ISOs, where FQDN is replaced by the fully qualified domain name of the Manager. It is assumed that the ISO uploader is being run on the same client machine as the Red Hat Enterprise Virtualization Manager; the default value is localhost.

ISO Storage Domain Options

These options specify the ISO domain to which files are uploaded. They are alternatives; do not use these parameters together.

-i, --iso-domain=ISODOMAIN: Sets the storage domain ISODOMAIN as the destination for uploads.
-n, --nfs-server=NFSSERVER: Sets the NFS path NFSSERVER as the destination for uploads.

Connection Options

The ISO uploader uses NFS as default to upload files. These options specify SSH file transfer instead.

--ssh-user=USER: Sets USER as the SSH user name to use for the upload.
--ssh-port=PORT: Sets PORT as the port to use when connecting to SSH.
-k KEYFILE, --key-file=KEYFILE: Sets KEYFILE as the public key to use for SSH authentication. You will be prompted to enter the password of the user specified with --ssh-user=USER if no key is set.

See Also:

Report a bug