18.3.2. engine-image-uploader コマンドの構文
イメージアップローダーコマンドの基本的な構文は以下の通りです。
engine-image-uploader[options]listengine-image-uploader[options]upload[file].[file]...[file]
イメージアップローダーコマンドは、
list および upload の 2 つのアクションをサポートします。
listアクションは、イメージをアップロードできるエクスポートストレージドメインを一覧表示します。uploadアクションは、指定したエクスポートストレージドメインにイメージをアップロードします。
イメージアップローダーコマンドを使用する場合は、上記のアクションのいずれかを指定する必要があります。さらに、
アップロード アクションを使用するには、少なくとも 1 つのローカルファイルを指定する必要があります。
engine-image-uploader コマンドをさらに絞り込むためのいくつかのパラメーターがあります。これらのパラメーターのデフォルトは、
/etc/ovirt-engine/imageuploader.conf ファイルで設定できます。
一般的なオプション
-h,--help- イメージアップローダーコマンドの使用方法に関する情報を表示します。
--conf-file=[PATH]- コマンドが使用する設定ファイルとして [PATH] を設定します。デフォルトは
etc/ovirt-engine/imageuploader.confです。 --log-file=[PATH]- [PATH] をログ出力の書き込みに使用する特定のファイル名として設定します。デフォルトは
/var/log/ovirt-engine/ovirt-image-uploader/ovirt-image-uploader-[date].logです。 --cert-file=[PATH]- [PATH] をエンジンを検証する証明書として設定します。デフォルトは
/etc/pki/ovirt-engine/ca.pemです。 --insecure- エンジンの検証を試行しないことを指定します。
--quiet- quiet モードを設定し、コンソール出力を最小限に抑えます。
-v,--verbose- verbose モードを設定し、より多くのコンソール出力を提供します。
-f,--force- アップロードするソースファイルのファイル名が宛先エクスポートドメインの既存ファイルと同じ場合は、強制モードが必要です。このオプションでは、既存のファイルを強制的に上書きします。
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です。
ストレージドメインのエクスポートオプション
次のオプションは、イメージをアップロードするエクスポートドメインを指定します。これらのオプションを一緒に使用することはできません。
-e オプションまたは -n オプションのいずれかを使用する必要があります。
-e[EXPORT_DOMAIN],--export-domain=[EXPORT_DOMAIN]- ストレージドメイン EXPORT_DOMAIN をアップロードの宛先として設定します。
-n[NFSSERVER],--nfs-server=[NFSSERVER]- アップロードの宛先として NFS パス [NFSSERVER] を設定します。
インポートオプション
次のオプションを使用すると、イメージがエクスポートドメインにアップロードされるときに、アップロードされるイメージの属性をカスタマイズできます。
-i,--ovf-id- イメージの UUID が更新されないことを指定します。デフォルトでは、コマンドはアップロードされるイメージ用に新しい UUID を生成します。これにより、アップロードするイメージの ID と環境にすでにあるイメージとの間に競合が発生しなくなります。
-d,--disk-instance-id- イメージ内の各ディスクのインスタンス ID の名前が変更されないことを指定します。デフォルトでは、コマンドはアップロードされるイメージ内のディスク用に新しい UUIDを生成します。これにより、アップロードするイメージ上のディスクと環境にすでにあるディスクとの間に競合が発生しなくなります。
-m,--mac-address- イメージ内のネットワークコンポーネントがイメージから削除されないことを指定します。デフォルトでは、コマンドは、アップロード中のイメージからネットワークインターフェイスカードを削除し、環境にある他の仮想マシンのネットワークカードとの競合を防ぎます。このオプションを使用しない場合には、管理ポータルを使用して新たにインポートされたイメージにネットワークインターフェイスカードを追加できます。また、Manager は MAC アドレスの競合がないことを確認できます。
-N [NEW_IMAGE_NAME],--name=[NEW_IMAGE_NAME]- アップロードするイメージの新しい名前を指定します。
