Red Hat Training

A Red Hat training course is available for Red Hat Virtualization

17.6. ISO 上传工具

17.6.1. ISO Uploader

ISO uploader 是一个把 ISO 镜像上传到 ISO 存储域的工具。它会作为 Red Hat Virtualization Manager 的一部分被安装。
ISO uploader 的命令是 engine-iso-uploader。您需要以 root 用户的身份登录到 Red Hat Virtualization 环境中后才可以使用这个命令。engine-iso-uploader -h 会显示这个命令的帮助信息,并包括了 engine-iso-uploader 命令的所有可用参数的列表。

17.6.2. engine-iso-uploader 命令语法

ISO uploader 命令的基本语法是:
engine-iso-uploader [options] list
engine-iso-uploader [options] upload [file].[file]...[file]
ISO uploader 命令支持两种操作 - listupload
  • list 操作列出 ISO 文件可以被上传到的存储域列表。Red Hat Virtualization Manager 会在安装的过程中在所安装的机器上产生这个列表。
  • upload 操作会把一个或多个(以空格分隔)ISO 文件上传到指定的 ISO 存储域中。默认的方式是通过 NFS,但也可以选择使用 SSH。
当使用这个命令时,需要选择以上操作中的一个。如需进行 upload 操作,还需要指定最少一个本地文件。
engine-iso-uploader 命令包括了其它的一些参数。

常规选项

--version
显示 ISO uploader 命令的版本。
-h, --help
显示 ISO uploader 命令的使用信息。
--conf-file=[PATH]
[PATH] 是这个命令要使用的配置文件。默认的配置文件是 /etc/ovirt-engine/isouploader.conf
--log-file=[PATH]
[PATH] 是命令要写入的日志文件。/var/log/ovirt-engine/ovirt-iso-uploader/ovirt-iso-uploader[date].log 是默认的日志文件。
--cert-file=[PATH]
[PATH] 是用来验证引擎的证书。默认值是 /etc/pki/ovirt-engine/ca.pem
--insecure
不需要验证引擎。
--nossl
连接到引擎的时候不使用 SSL
--quiet
把命令设为“安静”模式,从而把控制台的输出减到最小。
-v, --verbose
把命令设为 verbose 模式,从而可以提供详细的控制台输出信息。
-f, --force
当要上传的源文件的文件名和目标 ISO 域中的文件名相同时,可以使用强制模式,它会使用上传文件强制把目标 ISO 域中的同名文件覆盖。

Red Hat Virtualization Manager 选项

-u [USER], --user=[USER]
指定这个命令所要使用的用户信息。[USER] 的格式为 [username]@[domain]。这个用户必须存在于指定的域中,并可以被 Red Hat Virtualization Manager 识别。
-r [FQDN], --engine=[FQDN]
指定镜像文件将要被上传到的 Red Hat Virtualization Manager 的 IP 地址或全局域名。系统会假设镜像上传程序是从 Red Hat Virtualization Manager 所在的同一个机器上运行的。它的默认值是 localhost:443

ISO 存储域选项

以下选项指定了镜像要被上传到的 ISO 域。这些选项不能同时使用,您只能使用 -i-n
-i, --iso-domain=[ISODOMAIN]
把存储域 [ISODOMAIN] 设为上传的目标域。
-n, --nfs-server=[NFSSERVER]
[NFSSERVER] 设置为上传目标的 NFS 服务器路径。

连接选项

ISO uploader 使用 NFS 作为文件上传的默认方法。这些选项指定了使用 SSH 进行文件传输的设置。
--ssh-user=[USER]
[USER] 设置为用来上传的 SSH 用户名。它的默认值是 root.
--ssh-port=[PORT]
[PORT] 设置为 SSH 连接所使用的接口。
-k [KEYFILE], --key-file=[KEYFILE]
[KEYFILE] 设为用来进行 SSH 验证的公共密钥。如果没有设置密钥,您将会被提示输入 --ssh-user=[USER] 所指定的用户的密码。

17.6.3. 指定一个 NFS 服务器

例 17.5. 上传到一个 NFS 服务器

# engine-iso-uploader --nfs-server=storage.demo.redhat.com:/iso/path upload RHEL6.0.iso

17.6.4. ISO Uploader 的基本使用方法

以下实例演示了 ISO uploader 以及 list 参数的使用方法。第一个命令列出可用 ISO 存储域,因为在命令中没有指定用户名,用户 admin@internal 将被使用。第二个命令使用 NFS 将 ISO 文件上传到指定的 ISO 域中。

例 17.6. 显示域列表并上传镜像

# engine-iso-uploader list
Please provide the REST API password for the admin@internal oVirt Engine user (CTRL+D to abort):
ISO Storage Domain Name   | Datacenter          | ISO Domain Status
ISODomain                 | Default             | active
# engine-iso-uploader --iso-domain=[ISODomain] upload [RHEL6.iso]
Please provide the REST API password for the admin@internal oVirt Engine user (CTRL+D to abort):

17.6.5. 把 VirtIO 和客户端工具程序镜像文件上传到 ISO 存储域中

以下实例把 virtio-win.isovirtio-win_x86.vfdvirtio-win_amd64.vfdrhev-tools-setup.iso 镜像文件上传到 ISODomain 域。

例 17.7. 上传 VirtIO 和客户端工具程序镜像文件

# engine-iso-uploader --iso-domain=[ISODomain] upload /usr/share/virtio-win/virtio-win.iso /usr/share/virtio-win/virtio-win_x86.vfd /usr/share/virtio-win/virtio-win_amd64.vfd /usr/share/rhev-guest-tools-iso/rhev-tools-setup.iso

17.6.6. VirtIO 和客户端工具程序镜像文件

virtio-win ISO、Virtual Floppy Drive (VFD) 镜像(包括了 Windows 虚拟机的 VirtIO 驱动)、rhev-tools-setup ISO(包括了 Windows 虚拟机的 Red Hat Virtualization 客户端工具程序)在安装和配置 ISO 存储域的时候被复制到这个域中。
这些镜像所包括的软件可以被安装到虚拟机上,从而提高虚拟机的性能和可用性。最新的 virtio-winrhev-tools-setup 文件位于 Red Hat Virtualization Manager 文件系统上的以下位置:
  • /usr/share/virtio-win/virtio-win.iso
  • /usr/share/virtio-win/virtio-win_x86.vfd
  • /usr/share/virtio-win/virtio-win_amd64.vfd
  • /usr/share/rhev-guest-tools-iso/rhev-tools-setup.iso
这些镜像文件必须被手动上传到 ISO 存储域中(不能是在安装过程中创建的本地存储域)。使用 engine-iso-uploader 命令把这些镜像上传到您的 ISO 存储域中。在上传完成后,这些镜像文件就可以被虚拟机使用。