18.6. ISO 上传工具
18.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
命令的所有可用参数的列表。
18.6.2. engine-iso-uploader 命令语法
ISO uploader 命令的基本语法是:
engine-iso-uploader
[options]
list
engine-iso-uploader
[options]
upload
[file].[file]...[file]
ISO uploader 命令支持两种操作 -
list
和 upload
。
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]
所指定的用户的密码。
18.6.3. 指定一个 NFS 服务器
例 18.5. 上传到一个 NFS 服务器
# engine-iso-uploader --nfs-server=storage.demo.redhat.com:/iso/path upload RHEL6.0.iso
18.6.4. ISO Uploader 的基本使用方法
以下实例演示了 ISO uploader 以及 list 参数的使用方法。第一个命令列出可用 ISO 存储域,因为在命令中没有指定用户名,用户
admin@internal
将被使用。第二个命令使用 NFS 将 ISO 文件上传到指定的 ISO 域中。
例 18.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):
18.6.5. 把 VirtIO 和客户端工具程序镜像文件上传到 ISO 存储域中
以下实例把
virtio-win.iso
、virtio-win_x86.vfd
、virtio-win_amd64.vfd
和 rhev-tools-setup.iso
镜像文件上传到 ISODomain
域。
例 18.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
18.6.6. VirtIO 和客户端工具程序镜像文件
virtio-win ISO、Virtual Floppy Drive (VFD) 镜像(包括了 Windows 虚拟机的 VirtIO 驱动)、rhev-tools-setup ISO(包括了 Windows 虚拟机的 Red Hat Virtualization 客户端工具程序)在安装和配置 ISO 存储域的时候被复制到这个域中。
这些镜像所包括的软件可以被安装到虚拟机上,从而提高虚拟机的性能和可用性。最新的 virtio-win 和 rhev-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 存储域中。在上传完成后,这些镜像文件就可以被虚拟机使用。