18.5. ISO アップローダーツール

ISO アップローダーは、ISO イメージを ISO ストレージドメインにアップロードするためのツールです。このツールは Red Hat Virtualization Manager の一部としてインストールされます。

ISO アップローダーのコマンドは、engine-iso-uploader です。このコマンドを使用するには、root ユーザーとしてログインして、Red Hat Virtualization 環境の管理者の認証情報を入力する必要があります。engine-iso-uploader -h コマンドを実行すると、engine-iso-uploader コマンドの有効なオプションの全一覧など、使用方法に関する詳しい説明を表示することができます。

ISO アップローダーコマンドの基本構文は以下の形式です。

engine-iso-uploader options list
engine-iso-uploader options upload file file file

# engine-iso-uploader options list
# engine-iso-uploader options upload file file file

ISO アップローダーのコマンドは、list と upload の 2 つのアクションをサポートしています。

ISO アップローダーのコマンドを使用する際には、上記のアクションのいずれかを指定する必要があります。また、upload アクションを使用するには、ローカルファイルを少なくとも 1 つ指定する必要があります。

engine-iso-uploader コマンドをさらに詳しく指定する数多くのパラメーターがあります。

一般的なオプション

Red Hat Virtualization Manager のオプション

ISO ストレージドメインのオプション

以下のオプションは、イメージのアップロード先となる ISO ドメインを指定します。これらのオプションは、同時に使用することはできません。-i または -n のいずれかを使用する必要があります。

接続オプション

デフォルトでは、ISO アップローダーは NFS を使用してファイルをアップロードします。代わりに、以下のオプションは SSH ファイル転送を指定します。

以下は、ISO アップローダーと list パラメーターの使用例です。最初のコマンドは、使用可能な ISO ストレージドメインを表示します。コマンドでユーザー名を指定していなかったため、admin@internal が使用されます。2 番目のコマンドは、NFS 経由で指定の ISO ドメインに ISO ファイルをアップロードします。

engine-iso-uploader list

# 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]

# 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):

Windows 仮想マシン用の VirtIO ドライバーを含む virtio-win ISO イメージと Virtual Floppy Drive (VFD) イメージ、Windows 仮想マシン用の Red Hat Virtualization ゲストツールを含む rhv-tools-setup ISO は、ドメインのインストールおよび設定時に ISO ストレージドメインにコピーされます。

これらのイメージファイルで提供されるソフトウェアを仮想マシンにインストールすると、パフォーマンスやユーザビリティーを向上させることができます。最新の virtio-win と rhv-tools-setup の各イメージは、Red Hat Virtualization Manager のファイルシステム上の以下のシンボリックリンクからアクセスできます。

インストールプロセスで ISO ストレージドメインがローカルに作成されなかった場合には、これらのイメージファイルを手動でアップロードする必要があります。ISO ストレージドメインにこれらのファイルをアップロードするには engine-iso-uploader コマンドを使用します。イメージファイルのアップロードが完了すると、仮想マシンにアタッチして使用できるようになります。

以下の例は、virtio-win.iso、virtio-win_x86.vfd、virtio-win_amd64.vfd、rhv-tools-setup.iso のイメージファイルを ISODomain にアップロードするコマンドを示しています。

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/rhv-guest-tools-iso/rhv-tools-setup.iso

# 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/rhv-guest-tools-iso/rhv-tools-setup.iso