virt-xml - クラウド上のオンライン

プログラム：

NAME

virt-xml - コマンド ライン オプションを使用して libvirt XML を編集します。

SYNOPSIS

virt-xml ドメイン XML アクション XML オプション [出力オプション] [MISC オプション] ...

DESCRIPTION

virt-xml 明示的なコマンドラインを使用して libvirt XML を編集するためのコマンドラインツールです
オプション。 すぐに始めるには、このドキュメントの最後にある「例」セクションを参照してください。

各 virt-xml 呼び出しには 3 つのものが必要です: 変更する既存のドメインの名前 (または XML)
標準入力に渡されます)、XML に対するアクション、および行う XML 変更。 アクションは次のいずれかです。

--add-device: 新しいデバイス定義を XML に追加します。 --remove-device: デバイスを削除します。
既存のデバイス定義 --edit: 既存の XML ブロックを編集します --build-xml:
XML ブロックを要求し、それを印刷します (ここではドメインや入力 XML は必要ありません)。

XML 変更は、virt-xml によって提供される XML オプションの XNUMX つのインスタンスです。たとえば、
--disk または --boot。

virt-xml 呼び出しごとに許可されるアクションと XML のペアは XNUMX つだけです。 複数作る必要がある場合は
編集する場合は、コマンドを複数回呼び出します。

OPTIONS

-c URI
- 接続=URI
デフォルト以外のハイパーバイザーに接続します。 見る 仮想インストール(1) 詳細はこちら

ドメイン
ドメインは、既存の VM の名前、UUID、または ID です。 を使用する場合、これは省略できます
--build-xml、または XML が標準入力で渡される場合。

ドメインが指定されている場合、VM が
ランニング。 実行中の VM 構成を更新するには、 --update オプションを追加します (ただし、すべてではありません)
オプション/デバイスは、実行中の VM 構成の更新をサポートします)。

XML が標準入力で渡される場合、デフォルトの出力は --print-xml です。

XML ACTIONS

--編集 [編集オプション]
指定された XML ブロックを編集します。 編集オプションで伝える virt-xml どのブロックを編集するか。 タイプ
編集している XML の内容は、に渡される XML オプションによって決まります。 virt-xml。 もしそうなら
--disk が渡され、EDIT-OPTIONS でどのディスクを選択するか編集するブロック。

--cpu、--security、などの特定の XML オプションは、単一の XML ブロックにのみマップされます。
--boot、--クロック、その他いくつか。 そういった場合には、 virt-xml なら文句は言わないだろう
対応する XML ブロックがまだ存在しない場合は、自動的に作成されます。

ほとんどの XML オプションは、特別な値「clearxml=yes」をサポートしています。 --edit と組み合わせると、
要求された内容を適用する前に、編集中の XML ブロックを完全に空白にします。
変化します。 これにより、XML ブロックを完全に再構築できます。 いくつかの使用法については「例」を参照してください。

編集オプションの例:

--編集
オプションを指定しない --edit は、「最初のブロックを編集する」ことを意味します。 したがって、「--edit --disk」
DISK-OPTIONS」は「最初のディスクを編集」を意味します'。

前述の単一 XML ブロック オプションの場合は、何も付けずにプレーン '--edit' を使用します。
options は常に使用したいものです。

--編集 #
指定した XML ブロック番号を選択します。 したがって、「--edit 2 --disk DISK-OPTS」は「編集」を意味します。
二番目'。 このオプションは実際にはデバイス XML にのみ適用されます。

--編集 を
XML オプション タイプのすべての XML ブロックを変更します。 したがって、「--すべて編集 --disk DISK-OPTS」
「今までに編集」を意味しますブロック'。 このオプションは実際にはデバイス XML にのみ適用されます。

--編集 デバイスオプション
渡されたデバイス オプションに一致するすべての XML ブロックを変更します。 デバイスのオプション
XML オプションに渡されるものと同じ形式です。

したがって、「--edit path=/tmp/foo --disk DISK-OPTS」は「すべてを編集」を意味します。 パス付き
/tmp/foo'。 このオプションは実際にはデバイス XML にのみ適用されます。

- デバイスを追加
指定された XML オプションを XML に追加しますリスト。 例: '--デバイスの追加
--disk DISK-OPTIONS' は新しいディスクを作成しますブロックして XML に追加します。

このオプションは、デバイス以外の XML オプションと一緒に指定するとエラーになります (--edit セクションを参照)
部分的なリストの場合)。

- デバイスを削除
指定されたデバイスを XML から削除します。 削除するデバイスは XML によって選択されます
--edit と同じ形式の引数を受け取るオプション。 例

- デバイスを削除 --ディスク2
XNUMX番目のディスクデバイスを取り外します

- デバイスを削除 --ネットワークすべて
すべてのネットワークデバイスを削除します

- デバイスを削除 --サウンド PCSPK
model='pcspk' を使用してすべてのサウンド デバイスを削除します

このオプションは、デバイス以外の XML オプションと一緒に指定するとエラーになります (--edit セクションを参照)
部分的なリストの場合)。

--build-xml
指定した XML を構築し、標準出力に出力するだけです。 入力ドメインまたは入力 XML はありません。
必須。 例: 「--build-xml --disk DISK-OPTIONS」は、新しいファイルを出力するだけです。
デバイス。

このオプションは、適切にマップされない XML オプションと一緒に指定するとエラーになります。
--vcpus や --memory などの特定の XML ブロック。

出力 OPTIONS

これらのオプションは、XML を変更した後に実行するアクションを決定します。 よくあるケースではこれら
「XML アクション」はデフォルトの出力アクションを意味するため、指定する必要はありません。
上で詳しく説明しました。 これらは、デフォルトの出力を変更する場合にのみ必要です。

- 更新
指定されたドメインが実行中の場合は、実行中の VM 構成の変更を試みます。 もし
--edit と組み合わせた場合、これは更新操作です。 --add-device と組み合わせると、これは
デバイスのホットプラグです。 --remove-device と組み合わせると、これはデバイスのホットアンプラグになります。

ほとんどの XML プロパティとデバイスはライブ更新操作をサポートしていないことに注意してください。
したがって、すべての場合に成功するとは期待しないでください。

- 定義
要求された XML 変更を定義します。 通常、出力オプションが指定されていない場合、これがデフォルトになります。
指定されていますが、--print オプションが指定されている場合は、強制的に --define が必要です。
変更します。

--print-diff
生成された XML 変更を統一 diff 形式で出力します。 この出力オプションのみが有効な場合、
指定すると、他のすべての出力オプションが無効になり、永続的な変更は行われません。

--print-xml
生成された XML を全体として出力します。 この出力オプションのみを指定した場合、すべての
他の出力オプションは無効になり、永続的な変更は行われません。

- 確認
ドメインを定義または更新する前に、生成された XML の差分を対話的に表示します。
確認を要求します。

XML OPTIONS

- ディスク
- 通信網
--グラフィックス
-メタデータ
- メモリー
--vcpus
- CPU
- 安全
-- ヌマチューン
- 特徴
- 時計
--午後
- ブート
- ファイルシステム
- コントローラ
- 入力
- シリアル
- 平行
- チャネル
- コンソール
--hostdev
- 音
--ウォッチドッグ
- ビデオ
- スマートカード
--redirdev
--メンバルーン
--tpm
--rng
- パニック
これらのオプションは、XML 要素の単一クラスの XML を変更します。 より完全な
ドキュメントは次の場所にあります 仮想インストールとします。

一般に、これらのオプションは libvirt XML に非常に簡単にマップされます。詳細については、次のサイトを参照してください。
<http://libvirt.org/formatdomain.html>

オプション文字列の形式は次のとおりです: --option opt=val,opt2=val2,... 例: --disk
パス=/tmp/foo、共有可能=オン。 プロパティは「--option opt=,」とともに使用できるため、クリアするには
「--disk cache=,」を使用できるディスク キャッシュ設定

どのオプションでも --option=? を使用します。 利用可能なすべてのサブオプションのリストを表示するには、例:
--ディスク=? または --boot=?

--help 出力には、いくつかの一般的な例もリストされています。 詳細については、以下の「例」セクションを参照してください。
いくつかの一般的な例。

雑則 OPTIONS

-h
- 助けて
ヘルプメッセージを表示して終了します

- バージョン
プログラムのバージョン番号を表示して終了します

-q
- 静かな
冗長な出力は避けてください。

-d
- デバッグ
デバッグ情報を出力する

例

--disk と --network が取るすべてのサブオプションのリストを参照

# virt-xml --disk=? --ネットワーク=?

変更ドメイン「例」の:

# virt-xml 例 --edit --metadata description="新しい説明"

# ドメイン「EXAMPLE」のブートデバイスメニューを有効にします。

# virt-xml 例 --edit --boot menu=on

前回をクリアドメイン「winxp」の定義を「host-model」に変更しますが、
保存する前に対話的に差分を確認します。

# virt-xml winxp --edit --cpu ホストモデル,clearxml=yes --confirm

6 番目のサウンド カードを「fedora19」の model=ichXNUMX に変更しますが、差分のみを出力します。

# virt-xml fedora19 --edit 2 --sound model=ich6 --print-diff

すべてのグラフィックス デバイスのパスワードを、実行中の VM 'rhel6' の 'foo' に更新します。

# virt-xml rhel6 --すべて編集 --graphics パスワード=foo --update

ディスク デバイス hdc からディスク パスを削除します。

# virt-xml rhel6 --edit target=hdc --disk path=

標準入力からの XML を使用して、cache=none を使用するようにタイプ「disk」のすべてのディスクデバイスを変更し、印刷します
新しい XML を標準出力にコピーします。

＃ 猫| virt-xml --edit デバイス = ディスク --ディスク キャッシュ = なし

ディスク「hda」IO をネイティブに変更し、起動ポリシーを「オプション」として使用します。

# virt-xml fedora20 --edit target=hda \
--disk io=ネイティブ、startup_policy=オプション

リモート接続上の VM 'fedora20' に対して driver_name=vfio を使用するようにすべてのホスト デバイスを変更します。

# virt-xml --connect qemu+ssh://remotehost/system \
fedora20 --すべて編集 --hostdev driver_name=vfio

ホスト USB デバイス 001.003 を実行中のドメイン「fedora19」にホットプラグします。

# virt-xml fedora19 --update --add-device --hostdev 001.003

ドメイン「winxp」にspicevmcチャネルを追加します。これは、次のVMの後に使用可能になります。
シャットダウンします。

# virt-xml winxp --add-device --channelspicevmc

10G qcow2 ディスク イメージを作成し、次回の VM 起動のために「fedora18」に接続します。

# virt-xml fedora18 --add-device \
--disk /var/lib/libvirt/images/newimage.qcow2、format=qcow2、size=10

実行中のドメイン「rhel7」からディスク vdb をホットアンプラグします。

# virt-xml rhel7 --update --remove-device --disk target=vdb

次回のシャットダウン後に、VM 'rhel7' からすべてのグラフィックス デバイスを削除します。

# virt-xml rhel7 --remove-device --graphics all

virtio コンソール デバイスの XML を生成し、stdout に出力します。

# virt-xml --build-xml --console pty,target_type=virtio

onworks.net サービスを使用してオンラインで virt-xml を使用する