これは、Ubuntu Online、Fedora Online、Windows オンライン エミュレーター、MAC OS オンライン エミュレーターなど、複数の無料オンライン ワークステーションのいずれかを使用して、OnWorks 無料ホスティング プロバイダーで実行できるコマンド virsh です。
プログラム：
NAME
virsh - 管理ユーザーインターフェース
SYNOPSIS
おとなしい [オプション] ... [コマンド文字列]
おとなしい [オプション] ... COMMAND [ARG] ...
DESCRIPTION
当学校区の おとなしい プログラムは、virsh ゲスト ドメインを管理するためのメイン インターフェイスです。 プログラムは
ドメインの作成、一時停止、およびシャットダウンに使用されます。 現在のリストを表示するためにも使用できます。
ドメイン。 Libvirt は、最近の仮想化機能と対話するための C ツールキットです。
Linux (およびその他の OS) のバージョン。 GNU Lesser の下で利用可能なフリー ソフトウェアです。
一般公衆ライセンス。 Linux オペレーティング システムの仮想化とは、
単一のハードウェア システム上でオペレーティング システムの複数のインスタンスを同時に実行する
基本的なリソースは Linux インスタンスによって駆動されます。 ライブラリは、長い時間を提供することを目的としています
用語安定した C API。 現在、Xen、QEMU、KVM、LXC、OpenVZ、VirtualBox および
VMware ESX。
ほとんどの virsh 使用法の基本構造は次のとおりです。
virsh [オプション]... [ARG]...
場所 command 以下にリストされているコマンドの XNUMX つです。 ドメイン 数値のドメイン ID、または
ドメイン名、またはドメイン UUID。 と ARGS コマンド固有のオプションです。 いくつかあります
問題のコマンドがすべてのドメインで機能する場合のこの規則の例外、
マシン全体、または xen ハイパーバイザーに直接。 これらの例外は明確になります
それらの各コマンド。 注: ドメインに数値の名前を付けることは許可されています。
ただし、そうすると、ドメイン ID でしか識別できないドメインになります。 の
つまり、数値が指定された場合、それはドメイン ID としてではなく、ドメイン ID として解釈されます。
名前。
当学校区の おとなしい プログラムはいずれかを実行するために使用できます COMMAND コマンドとそのコマンドを与えることによって、
シェルコマンドラインの引数、または コマンド文字列 これは単一のシェル引数です
複数からなる COMMAND アクションとその引数は空白で結合され、
コマンド間はセミコロンで区切ります。 内で コマンド文字列、virsh は
シェルと同じ単一、二重、およびバックスラッシュのエスケープですが、別のエスケープを追加する必要があります
単一のシェル引数を作成する際にエスケープするシェルの層。 コマンドが指定されていない場合は、
コマンドライン、 おとなしい 次に、コマンドを待機する最小限のインタープリターを開始します。
と やめます コマンドはプログラムを終了します。
当学校区の おとなしい プログラムは次のことを理解します OPTIONS.
-c, - 接続 URI
指定された場所に接続します URI、まるで 接続する デフォルトの代わりにコマンド
接続。
-d, - デバッグ LEVEL
整数でデバッグメッセージを有効にする LEVEL 以上。 LEVEL 0から4の範囲で指定できます
（デフォルト）。 のドキュメントを参照してください。 VIRSH_DEBUG 以下の環境変数
それぞれの説明 LEVEL.
-e, - エスケープ string
の代替エスケープ シーケンスを設定します コンソール 指図。 デフォルトでは、telnet の ^] 使用されている。
ハット表記を使用する場合に使用できる文字は、英字、@、[、]、\、^、
_.
-h, - 助けて
他のすべての引数を無視し、次のように動作します。 助けます 代わりにコマンドが与えられました。
-k, --キープアライブ間隔 INTERVAL
セット INTERVAL (秒単位) キープアライブ メッセージを送信して、
サーバーへの接続はまだ有効です。 間隔を 0 に設定すると、クライアントが無効になります
キープアライブ メカニズム。
-K, --キープアライブ数 COUNT
キープアライブ メッセージを送信しても応答がない場合の回数を設定します。
接続が切れているとマークせずにサーバー。 この設定には影響はありません
ケース INTERVAL 0に設定されます。
-l, - ログ FILE
ロギングの詳細を出力する FILE.
-q, - 静かな
余分な情報メッセージは避けてください。
-r, -読み取り専用
かのように、初期接続を読み取り専用にします。 -読み取り専用 オプションの 接続する
-t, - タイミング
各コマンドの経過時間情報を出力します。
-v, --バージョン[=短い]
他のすべての引数を無視し、libvirt ライブラリ virsh のバージョンを出力します。
から来る
-V, --version=ロング
他のすべての引数を無視し、libvirt ライブラリ virsh のバージョンを出力します。
から来て、どのオプションとドライバーがコンパイルされているか。
注意事項
ブリッジ おとなしい 操作は、すでに接続できる libvirt ライブラリに依存しています。
libvirtd サービスを実行しています。 これは通常、次のコマンドを使用して実行できます。 呼び出し-rc.d libvirtd
start.
ブリッジ おとなしい 通信チャネルが使用されるため、コマンドを実行するには root 権限が必要です。
ハイパーバイザーと対話します。 root 以外で実行すると、エラーが返されます。
ブリッジ おとなしい コマンドは、shutdown、setvcpus、および setmem を除いて、同期的に動作します。 の
それらの場合、 おとなしい プログラムが返されましたが、アクションが完了したことを意味しない場合があります
また、定期的にポーリングして、ゲストが操作を完了したことを検出する必要があります。
おとなしい 下位互換性に努めています。 しかし、 助けます コマンドは、
の古いバージョンの場合、コマンドの優先使用法 おとなしい 別のスペルをサポート
コマンドまたはオプションの -- トンネリング -- トンネリング)、次に使用するスクリプト
その古いスペルは引き続き機能します。
いくつかの おとなしい コマンドは、オプションでスケーリングされた整数を取ります。 スケールが指定されていない場合、
デフォルトはコマンドにリストされています (歴史的な理由から、一部のコマンドはデフォルトで
バイト、他のコマンドのデフォルトはキビバイト)。 次の大文字と小文字は区別されません
接尾辞を使用して、特定のスケールを選択できます。
b、バイト バイト 1
KB キロバイト 1,000
k、KiB キビバイト 1,024
MB メガバイト 1,000,000
M、MiB メビバイト 1,048,576
GB ギガバイト 1,000,000,000
G、GiB ギビバイト 1,073,741,824
TB テラバイト 1,000,000,000,000
T、TiB テビバイト 1,099,511,627,776
PB ペタバイト 1,000,000,000,000,000
P、PiB ペビバイト 1,125,899,906,842,624
EB エクサバイト 1,000,000,000,000,000,000
E、EiB エクスビバイト 1,152,921,504,606,846,976
ジェネリック コマンド
次のコマンドは一般的なもので、ドメインに固有のものではありません。
助けます [コマンドまたはグループ]
これにより、各 virsh コマンドが一覧表示されます。 オプションなしで使用すると、すべてのコマンドは
リストされ、XNUMX 行に XNUMX つずつ、関連するカテゴリにグループ化され、それぞれのキーワードが表示されます
グループ。
特定のグループのコマンドのみを表示するには、そのグループのキーワードを
オプション。 例えば：
virsh # ホストのヘルプ
ホストとハイパーバイザー (ヘルプ キーワード「ホスト」):
能力能力
cpu-models は、アーキテクチャの CPU モデルを表示します
ハイパーバイザーに接続 (再) 接続
フリーセル NUMA フリーメモリ
hostname ハイパーバイザーのホスト名を出力します
qemu-attach 既存の QEMU プロセスにアタッチ
qemu-monitor-command QEMU 監視コマンド
qemu-agent-command QEMU ゲスト エージェント コマンド
sysinfo ハイパーバイザーの sysinfo を出力します
uri ハイパーバイザーの正規 URI を出力します
特定のコマンドの詳細情報を表示するには、その名前をオプションとして指定します
代わりに。 例えば：
virsh # ヘルプ一覧
NAME
list - ドメインのリスト
SYNOPSIS
リスト [--非アクティブ] [--すべて]
DESCRIPTION
ドメインのリストを返します。
OPTIONS
--inactive 非アクティブなドメインをリストします
--all 非アクティブおよびアクティブなドメインを一覧表示します
やめます, 終了する
この対話型端末を終了します
バージョン [- デーモン]
これが何から構築されたかについてのメジャーバージョン情報を出力します。 もしも - デーモン is
指定すると、libvirt デーモンのバージョンが出力に含まれます。
例:
$ virsh バージョン
ライブラリに対してコンパイル: libvirt 1.2.3
使用ライブラリ: libvirt 1.2.3
API の使用: QEMU 1.2.3
実行中のハイパーバイザー: QEMU 2.0.50
$ virsh バージョン --デーモン
ライブラリに対してコンパイル: libvirt 1.2.3
使用ライブラリ: libvirt 1.2.3
API の使用: QEMU 1.2.3
実行中のハイパーバイザー: QEMU 2.0.50
デーモンに対して実行: 1.2.6
cd [ディレクトリにジョブを開始します。]
現在のディレクトリをに変更します ディレクトリにジョブを開始します。。 のデフォルトのディレクトリ cd command
ホーム ディレクトリです。存在しない場合は、 ホーム 環境内の変数、ルート
ディレクトリにあります。
このコマンドは対話モードでのみ使用できます。
pwd 現在のディレクトリを出力します。
接続する [URI] [-読み取り専用]
(再)-ハイパーバイザーに接続します。 シェルが最初に起動されると、これは自動的に
と一緒に走る URI コマンドラインの「-c」オプションで要求されたパラメーター。 の URI
パラメーターは、ハイパーバイザーへの接続方法を指定します。 のドキュメントページ
<http://libvirt.org/uri.html> サポートされている値をリストしますが、最も一般的なものは次のとおりです。
xen:///
これは、ローカルの Xen ハイパーバイザーに接続するために使用されます
qemu:///システム
QEMU および KVM ドメインを監視するデーモンに root としてローカルに接続します
qemu:///セッション
自分の QEMU および KVM ドメインのセットに通常のユーザーとしてローカルに接続する
lxc:///
ローカル Linux コンテナーに接続する
現在使用されている URI を確認するには、 URI コマンドは以下に記載されています。
リモート アクセスについては、次のドキュメント ページを参照してください。http://libvirt.org/uri.html> どのようにして
URI を作成します。 の -読み取り専用 オプションにより、読み取り専用接続が可能になります
URI ハイパーバイザーの正規 URI を出力します。シェル モードで役立ちます。
hostname
ハイパーバイザーのホスト名を出力します。
SYSINFO
利用可能な場合、ハイパーバイザーの sysinfo の XML 表現を出力します。
ノード情報
CPU の数とタイプ、ノードのサイズなど、ノードに関する基本情報を返します。
物理メモリ。 出力は virNodeInfo 構造に対応します。 具体的には、
「CPU ソケット」フィールドは、NUMA セルあたりの CPU ソケットの数を意味します。 情報
libvirt の表示は、各アーキテクチャが提供するものによって異なります。
ノードポンプマップ [- かわいい]
ノードの CPU の合計数、オンライン CPU の数、および CPU のリストを表示します。
オンライン CPU。
自律的AI - かわいい オンラインの CPU は、リストではなく範囲として出力されます。
ノードcpustats [CPU] [- パーセント]
ノードの CPU 統計を返します。 もしも CPU が指定されている場合、指定された cpu が表示されます
統計のみ。 もしも - パーセント が指定されている場合、これは各種類のパーセンテージを出力します
1秒間のCPU統計の。
ノードメム統計 [セル]
ノードのメモリ統計を返します。 もしも セル が指定されている場合、これは指定されたものを出力します
セル統計のみ。
ノードサスペンド [ターゲット] [デュレーション]
ノード (ホスト マシン) をシステム全体のスリープ状態にし、ノードの
によって指定された時間の経過後にノードを再開するためのリアルタイムクロック割り込み
デュレーション 出ています。 ターゲット ホストがサスペンドされる状態を指定します。
「mem」（RAM にサスペンド）、「disk」（ディスクにサスペンド）、または「hybrid」（サスペンドに）のいずれかです。
RAM とディスクの両方)。 デュレーション を秒単位で指定します。
ホストを一時停止する必要があります。少なくとも 60 秒は必要です。
ノードメモリチューン [shm-スキャンするページ] [shm-スリープ-ミリ秒] [shm-マージ-クロス-ノード]
ノード メモリ パラメータを表示または設定できます。 shm-スキャンするページ することができます
共有メモリ サービスが実行される前にスキャンするページ数を設定するために使用されます。
睡眠; shm-スリープ-ミリ秒 共有するミリ秒数を設定するために使用できます
メモリ サービスは、次のスキャンの前にスリープする必要があります。 shm-マージ-クロス-ノード かどうかを指定します
異なる numa ノードのページをマージできます。 0 に設定すると、
同じ NUMA ノードのメモリ領域に物理的に存在するノードをマージできます。 1 に設定すると、
すべてのノードのページをマージできます。 デフォルトは 1 です。
注意: 現在、「共有メモリ サービス」は KSM (Kernel Samepage Merging) のみを意味します。
機能
現在のハイパーバイザーの機能を説明する XML ドキュメントを印刷します。
に接続されています。 これには、CPU および CPU に関するホスト機能に関するセクションが含まれます。
機能、および仮想化できるゲストの種類ごとの説明のセット。
より完全な説明については、以下を参照してください。
<http://libvirt.org/formatcaps.html> XML には NUMA トポロジ情報も表示されます
可能な場合は。
ドム機能 [仮想タイプ] [エミュレータビン] [アーチ] [機械]
ハイパーバイザーのドメイン機能を説明する XML ドキュメントを印刷します。
既存のドメインから提供された、または取得した情報を使用して接続されている
おとなしい 機能 出力。 これは、新しいドメインを作成する場合に役立ちます。
たとえば、ドメインを作成して VFIO を利用できるかどうかに興味があります。
特定のエミュレーターとアーキテクチャーを備えたハイパーバイザー。
各ハイパーバイザーには、必要なオプションに関するさまざまな要件があります
およびオプションです。 ハイパーバイザーは、次のいずれかのデフォルト値の提供をサポートできます
オプション。
当学校区の 仮想タイプ オプションは、使用される仮想化タイプを指定します。 使用する値は
の「type」属性からドメインの最上位要素
XML またはそれぞれの中にある「type」属性からの要素 おとなしい
機能 出力。 The エミュレータビン オプションは、エミュレータへのパスを指定します。 の
使用する値は、 ドメイン XML の要素または おとなしい
機能 出力。 The アーチ オプションは、
ドメイン。 使用される値は、ドメインの XML の「arch」属性です。
要素とのサブ要素または「name」属性エレメント
おとなしい 能力 出力。 The 機械 のマシンタイプを指定します
エミュレータ。 使用される値は、ドメインの XML の「マシン」属性です。
要素とサブ要素またはマシンのリストからの XNUMX つ おとなしい
機能 特定のアーキテクチャとドメイン タイプの出力。
qemu ハイパーバイザーの場合、 仮想タイプ 「qemu」または「kvm」のいずれかを一緒に指定する必要があります
どちらかで エミュレータビン or アーチ デフォルトの出力を生成するために
機械. 供給 機械 値は、特定のマシンの出力を生成します。
注入-nmi ドメイン
NMI をゲストに注入します。
リスト [- 非活性 | - すべて] [-- 管理保存] [- 題名] { [- テーブル] | - 名前 | --uuid }
[- 持続的に] [--一時的な] [--管理された保存付き] [--管理保存なし] [- 自動スタート]
[--自動起動なし] [--スナップショットあり] [--スナップショットなし] [--状態実行中] [--状態-一時停止]
[--状態シャットオフ] [--状態-その他]
既存のドメインに関する情報を出力します。 オプションが指定されていない場合は、出力されます
実行中のドメインに関する情報。
リストの形式の例は次のとおりです。
おとなしい リスト
ID 名前 状態
-------------------------------------------------- -
0 ドメイン 0 実行中
2 フェドーラが一時停止
名前はドメインの名前です。 ID ドメイン数値 ID。 状態は実行状態です
（下記参照）。
州
State フィールドには、ドメインの 8 つの状態と、現在のドメインがどの状態にあるかが一覧表示されます。
ランニング
ドメインは現在 CPU 上で実行されています
アイドル
ドメインはアイドル状態であり、実行されていないか実行可能ではありません。 これは、
ドメインは IO を待機しているか (従来の待機状態)、またはスリープ状態になっています。
他に何もすることはありませんでした。
一時停止
ドメインが一時停止されました。通常は、管理者が実行しているときに発生します
おとなしい サスペンド. 一時停止状態の場合、ドメインは引き続き割り当て済みを消費します
メモリなどのリソースが含まれますが、ハイパーバイザーによるスケジューリングの対象にはなりません。
shutdown
ドメインはシャットダウン中です。つまり、ゲスト OS がシャットダウン中です。
通知を受けており、その操作を適切に停止する過程にあるはずです。
シャット OFF
ドメインが実行されていません。 通常、これはドメインがシャットダウンされたことを示します
完全に、または開始されていません。
クラッシュしました
ドメインがクラッシュしました。これは常に暴力的な結末です。 通常、この状態は
ドメインがクラッシュ時に再起動しないように構成されている場合にのみ発生します。
死にかけている
ドメインは停止中ですが、完全にシャットダウンまたはクラッシュしていません。
午後一時停止
ドメインは、s3 に入るなど、ゲストの電源管理によって一時停止されました
でのみ停止させることができます。
通常、アクティブなドメインのみがリストされます。 非アクティブなドメインを一覧表示するには、次を指定します - 非活性
or - すべて アクティブなドメインと非アクティブなドメインの両方を一覧表示します。
ドメインのリストをさらにフィルタリングするには、XNUMX つ以上のフィルタリング フラグを指定できます。
によってサポートされています リスト 指図。 これらのフラグは機能別にグループ化されています。 または
グループからの複数のフラグは、フィルター グループを有効にします。 フラグのいくつかの組み合わせに注意してください
結果が出ない場合があります。 サポートされているフィルタリング フラグとグループ:
固執
フラグ - 持続的に 返されるリストに永続ドメインを含めるために使用されます。 に
一時ドメインを含める 指定 --一時的な.
存在 of マネージド 保存 画像
管理保存イメージ指定フラグを持つドメインを一覧表示するには --管理された保存付き。 のために
管理された保存イメージが指定されていないドメイン --管理保存なし.
ドメイン 状態
次のフィルター フラグは、状態によってドメインを選択します。 --状態実行中 の
実行中のドメイン、 --状態-一時停止 一時停止中のドメインについては、 --状態シャットオフ 回した
オフドメインと --状態-その他 フォールバックとして他のすべての州の場合。
自動起動 ドメイン
自動起動ドメインを一覧表示するには、フラグを使用します - 自動スタート. これでドメインを一覧表示するには
機能無効化使用 --自動起動なし.
Snapshot 存在
スナップショット イメージを持つドメインは、フラグを使用して一覧表示できます --スナップショットあり,
スナップショットのないドメイン --スナップショットなし.
古いサーバーと通信する場合、このコマンドは一連の API 呼び出しを使用する必要があります
ドメインがリストされていないか、より多く表示される可能性がある固有の人種
リストの収集中に呼び出し間で状態が変化した場合は XNUMX 回。 新しい
サーバーにはこの問題はありません。
If -- 管理保存 が指定されている場合、保存状態を管理しているドメイン (のみ
それらが シャット OFF 状態なので、指定する必要があります - 非活性 or - すべて
実際にそれらをリストするには）代わりに次のように表示されます 保存されました リストで。 このフラグは使用可能です
デフォルトのみ - テーブル 出力。 このフラグは、次のリストをフィルタリングしないことに注意してください。
ドメイン
If - 名前 が指定されている場合、表形式のドメイン名の代わりにドメイン名が出力されます
行ごと。 もしも --uuid 名前の代わりにドメインの UUID が出力されます。 国旗
- テーブル 従来の表形式の出力を使用することを指定します。 これは
デフォルト。 これらはすべて相互に排他的です。
If - 題名 が指定されている場合、短いドメインの説明 (タイトル) が
余分な列。 このフラグは、デフォルトでのみ使用できます - テーブル 出力。
例：
おとなしい リスト --タイトル
Id 名前 状態 役職
-------------------------------------------------- ------------------------
0 Domain-0 でメールサーバー 1 を実行
2 フェドーラが一時停止
フリーセル [{ [--セルノ] セルノ | - すべて }]
マシン上または NUMA セル内で使用可能なメモリ量を表示します。 の
freecell コマンドは、使用可能なメモリの XNUMX つの異なる表示のいずれかを提供できます。
指定されたオプションに応じてマシン。 オプションを指定しないと、
マシンの空きメモリの合計。 --all オプションを指定すると、空きメモリが表示されます
各セルと、マシン上の空きメモリの合計。 最後に数字で
引数または --cellno とセル番号を使用すると、セルの空きメモリが表示されます。
指定したセルのみ。
フリーページ [{ [--セルノ] セルノ [- ページサイズ] ページサイズ | - すべて }]
NUMA セル内の使用可能なページ数を出力します。 セルノ NUMA を指します
気になるセル。 ページサイズ スケーリングされた整数です（を参照してください 注意事項 上記）。
または、 - すべて NUMA セルと NUMA セルの可能な組み合わせに関する情報
ページサイズが印刷されます。
割り当てページ [- ページサイズ] ページサイズ [--ページ数] ページ数 [[--セルノ] セルノ] [- 追加]
[- すべて]
のページ プールのサイズを変更する ページサイズ ホスト上。 もしも - 追加 が指定されている場合
ページ数 ページがプールに追加されます。 ただし、 - 追加 が指定されていない場合、
ページ数 プールの新しい絶対サイズとして取得されます (これは、一部を解放するために使用される場合があります)。
ページとプールのサイズを小さくします)。 の セルノ 修飾子を使用して、
単一のホスト NUMA セルにまで変更します。 スペクトルの反対側にある - すべて
これにより、すべての NUMA セルに対して変更が実行されます。
CPUベースライン FILE [- 特徴] [--移行可能]
で指定されたすべてのホスト CPU でサポートされるベースライン CPU を計算します。 . の
ホスト CPU のリストは、すべてを抽出することによって構築されます。 からの要素. したがって、
のセットのいずれかを含むことができます改行またはセットで区切られた要素
完全なによって印刷された要素 機能 指図。 もしも - 特徴 is
指定された場合、結果の XML 記述には、次のすべての機能が明示的に含まれます。
このオプションがないと、CPU モデルの一部である機能は使用できません。
XML 記述にリストされます。 もしも --移行可能 が指定され、ブロックする機能
移行は、結果の CPU には含まれません。
CPU比較 FILE [- エラー]
XML からの CPU 定義の比較ホスト CPU を使用。 XML 含有することができます
ホストまたはゲストの CPU 定義。 ホスト CPU の定義は、 要素と
によって印刷されたその内容 機能 指図。 ゲスト CPU の定義は、
要素とそのコンテンツをドメイン XML 定義から取得します。 ゲスト CPU の詳細については、
定義を参照してください:http://libvirt.org/formatdomain.html#elementsCPU>. もしも - エラー is
指定された CPU に互換性がない場合、コマンドはエラーを返します。
ホスト CPU と、非互換性に関する詳細を提供するメッセージが表示されます。
印刷した。
CPUモデル アーチ
指定されたアーキテクチャで知られている CPU モデルのリストを出力します。
echo [- シェル] [--xml] [argは...]
それぞれエコーバック argは、スペースで区切られます。 もしも - シェル が指定されている場合、出力は
シェル コンテキストでの再利用に適しているように、必要に応じて単一引用符で囲みます。
If --xml が指定されている場合、出力は XML で使用するためにエスケープされます。
DOMAIN コマンド
次のコマンドは、前述のほとんどのコマンドのように、ドメインを直接操作します。
ドメインを最初のパラメーターとして使用します。 の ドメイン 短い整数、名前として指定できます
または完全な UUID。
自動スタート [-無効にする] ドメイン
ブート時に自動的に開始されるようにドメインを構成します。
オプション -無効にする 自動起動を無効にします。
コンソール ドメイン [開発者名] [- 安全な] [- 力]
ゲスト用の仮想シリアル コンソールを接続します。 オプションの 開発者名 パラメーター
代替コンソール、シリアルまたはパラレル デバイスのデバイス エイリアスを参照します。
ゲスト用に構成されています。 省略した場合、プライマリ コンソールが開きます。
フラグの場合 - 安全な が指定されている場合、接続はドライバーが
コンソールの安全な取り扱いをサポートします。 このフラグは、サーバーが確認する必要があることを指定します
コンソール デバイスへの排他的アクセス。 オプションで、 - 力 フラグを指定できます。
切断された場合など、既存のセッションの切断を要求する
接続。
作ります FILE [- コンソール] [--一時停止] [--自動破棄] [--pass-fds N、M、...]
XML からドメインを作成する. XML を作成する簡単な方法を使用することです
ダンプxml コマンドを使用して、既存のゲストの定義を取得します。 ドメインは
次の場合は一時停止 --一時停止 オプションはドライバーによって使用およびサポートされています。 それ以外の場合は
走っている。 もしも - コンソール 要求されたら、作成後にコンソールにアタッチします。 もしも
--自動破棄 が要求された場合、ゲストは virsh 時に自動的に破棄されます
libvirt への接続を閉じるか、終了します。
If --pass-fds が指定されている場合、引数は開いているファイルのカンマ区切りのリストです
ゲストに渡す必要がある記述子。 ファイル記述子は再
ゲストで 3 から始まる番号が付けられます。これはコンテナ ベースでのみサポートされます。
仮想化。
例:
virsh dumpxml > ドメイン.xml
vi domain.xml (または他のテキスト エディターで変更)
virsh は、domain.xml を作成します。
定義します FILE
XML からドメインを定義する. ドメイン定義は登録されていますが、登録されていません
始めました。 ドメインがすでに実行されている場合、変更は次回の起動時に有効になります。
DESC ドメイン [[- 住む] [--config] | [[- 現在]][- 題名] [--編集] [--new-desc New
説明またはタイトル メッセージ]
ドメインの説明とタイトルを表示または変更します。 これらの値は、
ドメインを簡単に識別できるように、任意のテキストデータを保存できます。 タイトル
強制ではありませんが、短くする必要があります。 (こちらもご覧ください XMLで動作する
ベースのドメイン メタデータ)。
フラグ - 住む or --config このコマンドがライブまたは永続で機能するかどうかを選択します
ドメインの定義。 両方なら - 住む --config が指定されている場合、 --config
オプションは、現在の説明とライブ構成の両方を取得する上で優先されます
および config は、説明の設定中に更新されます。 - 現在 排他的であり、
これらのいずれも指定されていない場合は暗示されます。
フラグ --編集 現在の説明またはタイトルの内容を含むエディターを指定します
開いて、後で内容を保存する必要があります。
フラグ - 題名 説明の代わりにタイトル フィールドの操作を選択します。
どちらでもない場合 --編集 --new-desc 注または説明が表示されます
変更される代わりに。
破壊する ドメイン [--優雅な]
ドメインをすぐに終了する ドメイン. これはドメインOSにチャンスを与えません
これは、物理マシンの電源コードを引き抜くのと同じです。
ほとんどの場合、 shutdown 代わりにコマンドを実行してください。 ただし、これは
ゲストが使用するストレージ ボリュームは削除しません。また、ドメインが永続的である場合は、
後で再開できます。
If ドメイン は一時的なものであり、ゲストがアクセスすると、スナップショットのメタデータは失われます。
実行は停止しますが、スナップショットの内容はまだ存在し、同じ内容の新しいドメイン
名前と UUID を使用して、スナップショット メタデータを復元できます。 スナップショット作成.
If --優雅な が指定されている場合は、極端な手段 (SIGKILL など) に頼らないでください。
ゲストは妥当なタイムアウト後に停止しません。 代わりにエラーを返します。
ドンブルクスタット ドメイン [ブロックデバイス] [- 人間]
実行中のドメインのデバイス ブロック統計を取得します。 あ ブロックデバイス ユニークに対応
ターゲット名 ( ) またはソースファイル ( ) のいずれか
接続されているディスク デバイス ドメイン （も参照してください ドンブルリスト これらの名前をリストするため)。 の上
lxc または qemu ドメイン、省略 ブロックデバイス デバイスブロックの統計を要約して生成します
ドメイン全体。
- 人間 より人間が読める出力のために。
これらのフィールドの可用性は、ハイパーバイザーによって異なります。 サポートされていないフィールドがありません
出力から。 新しいバージョンの
libvirtd。
説明 of フィールド (フィールドは次の順序で表示されます):
rd_req - 読み取り操作の数
rd_bytes - 読み取りバイト数
wr_req - 書き込み操作の数
wr_bytes - 書き込まれたバイト数
errs - エラー数
flush_operations - フラッシュ操作の数
rd_total_times - 読み取り操作にかかった合計時間 (ns)
wr_total_times - 書き込み操作にかかった合計時間 (ns)
flush_total_times - フラッシュ操作にかかった合計時間 (ns)
<-- ハイパーバイザーによって提供されるその他のフィールド -->
ドミファード ドメイン [インタフェース] [- 満杯] [- ソース リース|エージェント]
実行中のドメインのインターフェースのリストを IP および MAC アドレスとともに取得する、または
次の場合、出力は XNUMX つのインターフェイスだけに制限されます インタフェース が指定されています。 ご了承ください インタフェース
ドライバーに依存する可能性があり、ゲスト OS 内の名前または表示される名前にすることができます
ドメイン XML で。 さらに、コマンド全体でゲストエージェントを構成する必要がある場合があります
一部のドライバー、特にqemuの下でクエリされたドメイン用。 もしも - 満杯 指定されている場合、
インターフェイスに複数のアドレスまたはエイリアスがある場合、インターフェイス名は常に表示されます。
それ以外の場合は、最初のアドレスのインターフェイス名のみを表示し、「-」を表示します。
その他。 の - ソース 引数は、住所に使用するデータ ソースを指定します。
現在、DHCP リースを読み取るための「lease」、または
エージェント。 指定しない場合、'lease' がデフォルトです。
ドミフスタット ドメイン インターフェイス デバイス
実行中のドメインのネットワーク インターフェイス統計を取得します。
ドミフセットリンク ドメイン インターフェイス デバイス 状態 [--config]
ドメインの仮想インターフェースのリンク状態を変更します。 状態の可能な値は次のとおりです。
"上下"。 もしも --config の永続的な構成のみが指定されます。
互換性のために、ドメインが変更されました。 - 持続的に の別名です --config.
インターフェイス デバイス インターフェイスのターゲット名または MAC アドレスにすることができます。
domif-getlink ドメイン インターフェイス デバイス [--config]
ドメインの仮想インターフェースのリンク状態を照会します。 もしも --config が指定され、クエリ
互換性のための永続的な構成 - 持続的に の別名です
--config.
インターフェイス デバイス インターフェイスのターゲット名または MAC アドレスにすることができます。
ドミチューン ドメイン インターフェイス デバイス [[--config] [- 住む] | [[- 現在]][-- インバウンド
平均、ピーク、バースト、フロア] [--アウトバウンド 平均、ピーク、バースト]
ドメインのネットワーク インターフェイスの帯域幅パラメータを設定またはクエリします。 インターフェイス デバイス
インターフェイスのターゲット名 ( )、または MAC アドレス。
ない場合 -- インバウンド or --アウトバウンド が指定されている場合、このコマンドは、
帯域幅の設定。 それ以外の場合は、インバウンドまたはアウトバウンドの帯域幅が設定されます。
平均、ピーク、バースト、フロア コマンドと同じです 接続インターフェース. の値
平均, ピーク 床 キロバイト/秒で表されますが、 バースト is
での単一バーストのキロバイトで表されます ピーク ネットワーク XML に記述されている速度
ドキュメントhttp://libvirt.org/formatnetwork.html#要素QoS>.
インバウンドまたはアウトバウンドの設定をクリアするには、次を使用します -- インバウンド or --アウトバウンド 丁重に
平均値ゼロ。
If - 住む が指定されている場合、実行中のゲストに影響します。 もしも --config に影響します。
永続ゲストの次のブート。 もしも - 現在 が指定されている場合、現在のゲストに影響します
州。 両方 - 住む --config フラグを指定できますが、 - 現在 排他的です。 いいえ
flag が指定されている場合、ハイパーバイザーによって動作が異なります。
ドメムスタット ドメイン [- 期間 秒] [[--config] [- 住む] | [[- 現在]]
実行中のドメインのメモリ統計を取得します。
ハイパーバイザーに応じて、さまざまな統計を返すことができます
メモリ バルーンを使用する QEMU/KVM の場合、オプションの - 期間 より大きな値に
秒単位で 0 よりも大きい値を指定すると、バルーン ドライバーは追加の統計情報を返すことができます。
以降で表示されます ドメムスタット コマンド。 の設定 - 期間 意志を0に
バルーン ドライバの収集を停止しますが、バルーンの統計はクリアしません
運転者。 ホストで実行するには、少なくとも QEMU/KVM 1.5 が必要です。
当学校区の - 住む, --config, - 現在 フラグは、 - 期間
オプションを使用して、バルーン ドライバーの収集期間を設定します。 もしも - 住む is
指定すると、実行中のゲスト収集期間のみが影響を受けます。 もしも --config is
指定すると、永続ゲストの次回の起動に影響します。 もしも - 現在 指定されている、
現在のゲストの状態に影響します。
両方 - 住む --config フラグを指定できますが、 - 現在 排他的です。 フラグがない場合
指定されている場合、ゲストの状態によって動作が異なります。
ドンブルエラー ドメイン
ブロック デバイスのエラーを表示します。 このコマンドは通常、次の場合に便利です。 ドムステート command
は、I/O エラーが原因でドメインが一時停止されたと言っています。 の ドンブルエラー コマンドはすべてを一覧表示します
エラー状態のブロック デバイスと、それぞれに見られるエラー。
ドンブルインフォ ドメイン ブロックデバイス
ドメインのブロック デバイス サイズ情報を取得します。 あ ブロックデバイス ユニークに対応
ターゲット名 ( ) またはソースファイル ( ) のいずれか
接続されているディスク デバイス ドメイン （も参照してください ドンブルリスト これらの名前をリストするため)。
ドンブルリスト ドメイン [- 非活性] [- 詳細]
に関連付けられているすべてのブロック デバイスの簡単な情報を示す表を出力します。
ドメイン。 場合 - 非活性 が指定されている場合、その上で使用されるブロック デバイスを照会します。
実行中のドメインで現在使用されているものではなく、次回の起動。 もしも - 詳細 is
指定すると、ディスクの種類とデバイスの値も出力されます。 その他のコンテキスト
ブロックデバイス名が必要です（ ドンブルインフォ or スナップショット作成 ディスク スナップショットの場合)
は、このコマンドによって出力されたターゲット名または一意のソース名を受け入れます。
ダム統計 [- 生] [--強制する] [- バッキング] [- 州] [--cpu 合計] [- バルーン] [--vcpu]
[- インターフェース] [- ブロック] [[--リストアクティブ] [--リスト-非アクティブ] [--list-persistent]
[--リスト一時的] [--リスト実行中] [--リスト一時停止] [--リスト-シャットオフ] [--リスト-その他]] |
[ドメイン ...]
複数またはすべてのドメインの統計を取得します。 引数がない場合、このコマンドは出力します
すべてのドメインで利用可能なすべての統計。
統計を収集するドメインのリストは、ドメインをリストすることによって制限できます
スペース区切りのリストとして、またはフィルタリング フラグの XNUMX つを指定して - リスト-*。 （
アプローチを組み合わせることはできません。)
デフォルトでは、返されるフィールドの一部は、より人間にわかりやすい値に変換される場合があります
きれいなプリンターのセットによって。 この動作を抑制するには、 - 生 フラグ。
個々の統計グループは、特定のフラグを介して選択できます。 デフォルトではすべて
サポートされている統計グループが返されます。 サポートされている統計グループ フラグは次のとおりです。
- 州, --cpu 合計, - バルーン, --vcpu, - インターフェース, - ブロック.
選択するとき - 州 次のフィールドが返されます: "state.state" -
VM の状態。virDomainState 列挙型「state.reason」から数値として返されます - 理由
指定された状態に入るため、virDomain*Reason 列挙型から int として返されます。
与えられた状態。
--cpu 合計 戻り値: "cpu.time" - このドメインに費やされた合計 CPU 時間 (ナノ秒単位)、
"cpu.user" - ナノ秒で費やされたユーザーの CPU 時間、"cpu.system" - 費やされたシステムの CPU 時間
ナノ秒単位
- バルーン 戻り値: "balloon.current" - 現在使用されている kiB 単位のメモリ、
"balloon.maximum" - 許容される kiB 単位の最大メモリ
--vcpu 戻り値: "vcpu.current" - オンラインの仮想 CPU の現在の数、"vcpu.maximum"
- オンライン仮想 CPU の最大数、「vcpu. .state" - 仮想 CPU の状態
、virVcpuState enum からの数値として、「vcpu. .time" - が費やした仮想 CPU 時間
仮想CPU
- インターフェース 戻り値: "net.count" - このドメインのネットワーク インターフェイスの数
"ネット。 .name" - インターフェイスの名前、「ネット。 .rx.bytes" - バイト数
受け取った、「ネット。 .rx.pkts" - 受信したパケット数、"net. .rx.errs" -
受信エラーの数、「net. .rx.drop" - ドロップされた受信パケットの数
"ネット。 .tx.bytes" - 送信されたバイト数、"net. .tx.pkts" - 数
送信されたパケット、「net. .tx.errs" - 送信エラーの数
"ネット。 .tx.drop" - ドロップされた送信パケットの数
- ブロック 各ドメインに関連付けられたディスクに関する情報を返します。 を使用して
- バッキング フラグは、バッキング チェーン内のすべてのリソースをカバーするようにこの情報を拡張します。
各ゲストのアクティブなレイヤーに情報を制限するデフォルトではなく
ディスク。 「block.count」 - 処理中のブロック デバイスの数
リストには、「ブロックします。 .name" - ブロック デバイスのターゲットの名前（同じ
複数のエントリの名前 - バッキング が存在する)、「ブロックします。 .backingIndex" - いつ
- バッキング が存在し、 ドメイン XML にリストされたインデックス
バッキング ファイルの場合は、「block. .path" - ブロック デバイスのファイル ソース、それが
ローカル ファイルまたはブロック デバイス、「block. .rd.reqs" - 読み取りリクエストの数、
"ブロック。 .rd.bytes" - 読み取りバイト数、"block. .rd.times" - 合計時間
(ns) 読み取りに費やされた、「block. .wr.reqs" - 書き込みリクエストの数
"ブロック。 .wr.bytes" - 書き込まれたバイト数、"block. .wr.times" - 合計時間
(ns) 書き込みに費やされた、「block. .fl.reqs" - フラッシュ要求の合計
"ブロック。 .fl.times" - キャッシュのフラッシュに費やされた合計時間 (ns)、"block. .エラー"
- Xen のみ: 「oo_req」値、「block. .allocation" - 書き込まれた最高値のオフセット
バイト単位のセクター、「block. .capacity" - ソース ファイルの論理サイズ (バイト単位)
"ブロック。 .physical" - ソース ファイルの物理サイズ (バイト単位)
特定の統計グループを選択しても、デーモンがその統計グループをサポートすることは保証されません。
統計の選択されたグループ。 国旗 --強制する デーモンが
は選択したグループをサポートしていません。
ドミリスト ドメイン [- 非活性]
に関連付けられているすべての仮想インターフェイスの簡単な情報を示す表を出力します。
ドメイン。 場合 - 非活性 が指定されている場合、使用される仮想インターフェイスを照会します
実行中のドメインで現在使用されているものではなく、次のブート。 その他のコンテキスト
仮想インターフェイスの MAC アドレスを必要とする (など デタッチ インターフェイス or ドミフ
セットリンク) は、このコマンドによって出力された MAC アドレスを受け入れます。
ブロックコミット ドメイン path [帯域幅] [ベース] [- 浅い] [top] [- 消去] [--相対維持]
[- 待つ [--非同期] [-詳細]][- タイムアウト 秒] [- アクティブ] [{- ピボット | --keep-overlay}]
先頭で変更をコミットすることにより、バッキング イメージ チェーンの長さを短縮します。
(スナップショットまたはデルタ ファイル) をバッキング イメージにチェーンします。 デフォルトでは、このコマンド
チェーン全体を平らにしようとします。 もしも ベース および top ファイルとして指定されます
バッキングチェーン内で、操作はそれをコミットすることに制約されます
チェーンの一部。 - 浅い の代わりに使用できます ベース 即時を指定する
コミットされる結果のトップ イメージのバッキング ファイル。 コミット中のファイル
おそらく操作が開始されるとすぐに無効になります。 を使用して - 消去
flag は、これらの無効化されたファイルを削除しようとします。
コミット操作。 とき --相対維持 フラグが使用されている場合、バッキング ファイルのパス
相対的に保たれます。
日時 top を省略したり、アクティブな画像として指定したりする場合は、指定することもできます
- アクティブ XNUMX フェーズのアクティブ コミットをトリガーします。 最初のフェーズでは、 top にコピーされます
ベース ジョブはキャンセルのみ可能で、トップにはまだベースに含まれていないデータが含まれています。
第 XNUMX フェーズでは、 top ベース への呼び出しまで同一のまま ブロックジョブ
- アボート フラグ（その時点からの変更を追跡するアクティブな画像として上部を維持します
時間) または - ピボット フラグ (base を新しいアクティブ イメージにし、top を無効にします)。
デフォルトでは、このコマンドはできるだけ早く戻り、ディスク全体のデータは
バックグラウンドでコミットされます。 操作の進行状況は、
ブロックジョブ。 しかし、 - 待つ が指定されている場合、このコマンドは
操作が完了します (または - アクティブ、第 XNUMX 段階に入る)、または操作が完了するまで
はオプションのためキャンセルされます タイムアウト 秒が経過するか、SIGINT が送信されます (通常は
"Ctrl-C" を使用)。 使用する -詳細 と一緒に - 待つ 定期的なステータスを生成します
更新します。 ジョブのキャンセルがトリガーされた場合、 --非同期 次のようにユーザーに制御を返します
そうしないと、コマンドがしばらくの間ブロックし続ける可能性があります
掃除が終わるまで。 使用する - ピボット 結合の省略形です - アクティブ
- 待つ 自動で ブロックジョブ - ピボット; と使用 --keep-overlay の略記です
結合 - アクティブ - 待つ 自動で ブロックジョブ - アボート.
path ディスクの完全修飾パスを指定します。 ユニークなターゲットに対応
名前 （ ) またはソースファイル ( ) ディスクの XNUMX つ
に接続されているデバイス ドメイン （も参照してください ドンブルリスト これらの名前をリストするため)。 帯域幅
コピー帯域幅の制限を MiB/s で指定しますが、qemu の場合はゼロ以外のみの場合があります
オンライン ドメインの場合。 負の値を指定すると、unsigned long として解釈されます
長い価値または本質的に無制限。 ハイパーバイザーは、拒否するかどうかを選択できます。
値にするか、許容される最大値に変換します。
ブロックコピー ドメイン path { dest [形式でアーカイブしたプロジェクトを保存します．] [--blockdev] | --xml file } [- 浅い]
[--再利用-外部] [帯域幅] [- 待つ [--非同期] [-詳細]] [{- ピボット | - 終了}]
[- タイムアウト 秒] [粒度] [バフサイズ]
ディスク バッキング イメージ チェーンをコピー先にコピーします。 また dest 宛先ファイルとして
名前、または --xml トップレベルを含む XML ファイルの名前でエレメント
宛先を説明する、存在する必要があります。 さらに、 dest 与えられる、 形式でアーカイブしたプロジェクトを保存します．
宛先の形式を宣言するために指定する必要があります ( 形式でアーカイブしたプロジェクトを保存します． 省略、
libvirt はソースの形式を再利用します。 --再利用-外部 なります
潜在的なセキュリティ ホールとなる可能性がある宛先形式のプローブを強制されます)。
コマンドはサポートしています - 生 ブールフラグのシノニムとして --format=生。 使用時
destの場合、宛先は通常のファイルとして扱われます。 --blockdev 信号を送るために使用されます
ブロックデバイスであること。 デフォルトでは、このコマンドはチェーン全体をフラット化します。 しかしもし
- 浅い が指定されている場合、コピーはバッキング チェーンを共有します。
If --再利用-外部 が指定されている場合、宛先が存在し、十分な
コピーを保持するスペース。 もしも - 浅い とともに使用されます --再利用-外部 その後
事前に作成されたイメージには、ゲストに表示されるものと同じゲストに表示されるコンテンツが含まれている必要があります
元のイメージのバッキング ファイルの内容。 これは、
宛先でのバッキング ファイル名。
デフォルトでは、コピー ジョブはバックグラウンドで実行され、XNUMX つのフェーズで構成されます。
最初に、ジョブはソースからすべてのデータをコピーする必要があり、この段階でジョブは
ソース ディスクに戻るためにのみキャンセルできます。
行き先。 このフェーズが完了した後、ソースと宛先の両方が残ります
への呼び出しまでミラーリング ブロックジョブ - アボート - ピボット フラグは次の場所にピボットします
コピー、またはなしの呼び出し - ピボット その忠実なコピーとして目的地を残す
時点。 ただし、 - 待つ が指定されている場合、このコマンドはまでブロックされます
ミラーリング フェーズが開始するか、オプションの場合は操作をキャンセルします。 タイムアウト すぐに
が経過するか、SIGINT が送信されます (通常は「Ctrl-C」を使用)。 使用する -詳細 と一緒に - 待つ
定期的なステータス更新を生成します。 使用する - ピボット （に似ている ブロックジョブ - ピボット）または
- 終了 （に似ている ブロックジョブ - アボート） 示す - 待つ、さらに終了します
物事をミラーリング段階に残すのではなく、きれいに仕事をしてください。 ジョブキャンセルの場合
タイムアウトまたは - 終了, --非同期 できるだけ早くユーザーに制御を返します
そうしないと、コマンドがブロックし続ける可能性があります。
ジョブは実際にキャンセルされました。
path ディスクの完全修飾パスを指定します。 帯域幅 コピーを指定します
帯域幅制限 (MiB/秒)。 負の値を指定すると、符号なしとして解釈されます
基本的には無制限ですが、オーバーフローする可能性が高い long long 値。
そのためには 0 を使用する方が安全です。 指定する 粒度 の微調整が可能
ダーティ リージョンが検出されたときにコピーされる粒度。 より大きな値
I/O オーバーヘッドは少なくなりますが、全体的により多くのデータをコピーすることになる可能性があります (デフォルト値
通常は正しい）; ハイパーバイザーは、これを XNUMX の累乗に制限するか、範囲内に収まる可能性があります。
一定の範囲。 指定する バフサイズ 同時にできるデータ量を制御します
コピー中の飛行中。 値を大きくすると、より多くのメモリが使用されますが、より高速になる可能性があります
完了 (通常はデフォルト値が正しい)。
ブロックプル ドメイン path [帯域幅] [ベース] [- 待つ [-詳細] [- タイムアウト 秒]
[--非同期]][--相対維持]
バッキング イメージ チェーンからディスクを作成します。 デフォルトでは、このコマンドは
チェーン全体; しかしもし ベース バッキングの XNUMX つの名前を含む指定
ファイルがチェーン内にある場合、そのファイルは新しいバッキング ファイルになり、
チェーンの中間部分が引っ張られます。 バッキングからすべての要求されたデータを一度
イメージ チェーンがプルされ、ディスクはバッキングのその部分に依存しなくなりました
チェーン。
デフォルトでは、このコマンドはできるだけ早く戻り、ディスク全体のデータは
バックグラウンドで引き込まれました。 操作の進行状況は、 ブロックジョブ.
ただし、 - 待つ が指定されている場合、このコマンドは操作が完了するまでブロックされます
完了するか、オプションの場合は操作をキャンセルします タイムアウト 経過秒数または
SIGINT が送信されます (通常は "Ctrl-C" を使用)。 使用する -詳細 と一緒に - 待つ 意志
定期的なステータス更新を生成します。 ジョブのキャンセルがトリガーされた場合、 --非同期 意志
できるだけ早く制御をユーザーに戻します。そうしないと、コマンドが続行する可能性があります。
ジョブのクリーンアップが完了するまで、もう少しブロックします。
使い方 --相対維持 flag は、バッキング チェーン名を相対的に保持します。
path ディスクの完全修飾パスを指定します。 ユニークなターゲットに対応
名前 （ ) またはソースファイル ( ) ディスクの XNUMX つ
に接続されているデバイス ドメイン （も参照してください ドンブルリスト これらの名前をリストするため)。 帯域幅
コピー帯域幅制限を MiB/s で指定します。 負の値を指定すると解釈されます
unsigned long long 値として、または本質的に無制限。 ハイパーバイザーが選択可能
値を拒否するか、許容される最大値に変換するか。
blkdeviotune ドメイン デバイス [[--config] [- 住む] | [[- 現在]] [[合計バイト秒] | [[読んだ-
バイト秒] [書き込みバイト秒]] [[合計 iops 秒] | [[読み取り iops 秒] [書き込み iops 秒]]
[[合計バイト秒最大] | [[読み取りバイト秒最大] [書き込みバイト秒最大]] [[合計 iops 秒最大]
| [読み取り-iops-秒-最大] [書き込み-iops-秒-最大]][サイズ-iops-秒]
のブロック デバイスのブロック ディスク io パラメータを設定またはクエリします。 ドメイン. デバイス
一意のターゲット名を指定します( ) またはソースファイル (
file='name'/>) に接続されているディスク デバイスの XNUMX つ ドメイン （も参照してください ドンブルリスト の
これらの名前をリストします)。
制限が指定されていない場合、現在の I/O 制限設定を照会します。 それ以外の場合は、変更します
これらのフラグによる制限: -- 合計バイト秒 合計スループット制限を指定します
XNUMX秒あたりのバイト数。 --読み取りバイト秒 読み取りスループット制限をバイト単位で指定します
秒。 --書き込みバイト秒 書き込みスループットの制限を XNUMX 秒あたりのバイト数で指定します。
--total-iops-sec XNUMX 秒あたりの合計 I/O 操作制限を指定します。 --read-iops-sec
XNUMX 秒あたりの読み取り I/O 操作の制限を指定します。 --write-iops-sec 書き込み I/O を指定します
XNUMX 秒あたりの操作制限。 -- 合計バイト秒最大 最大合計スループットを指定します
XNUMX 秒あたりのバイト数の制限。 --read-bytes-sec-max 最大読み取りスループットを指定します
XNUMX 秒あたりのバイト数の制限。 --write-bytes-sec-max 最大書き込みスループットを指定します
XNUMX 秒あたりのバイト数の制限。 --total-iops-sec-max 最大合計 I/O を指定します
XNUMX 秒あたりの操作制限。 --read-iops-sec-max 最大読み取り I/O を指定します
XNUMX 秒あたりの操作制限。 --write-iops-sec-max 最大書き込み I/O を指定します
XNUMX 秒あたりの操作制限。 --size-iops-sec あたりのサイズ I/O 操作の制限を指定します
秒。
古いバージョンの virsh では、これらのオプションにダッシュではなくアンダースコアしか使用できませんでした。
〜のように --total_bytes_sec.
バイト数と iops 値は独立していますが、値を XNUMX つだけ設定します (
--read-bytes-sec) は、そのカテゴリの他の 0 つを無制限にリセットします。 明示的な XNUMX
また、制限をクリアします。 特定の合計のゼロ以外の値は、非ゼロ値と混合することはできません
読み取りまたは書き込みのゼロ値。
If - 住む が指定されている場合、実行中のゲストに影響します。 もしも --config に影響します。
永続ゲストの次のブート。 もしも - 現在 が指定されている場合、現在のゲストに影響します
州。 ディスク io パラメータを両方とも設定する場合 - 住む --config フラグはあるかもしれない
与えられたが、 - 現在 排他的です。 の XNUMX つだけを照会する場合 - 住む, --config or
- 現在 指定できます。 フラグが指定されていない場合、動作は次のように異なります。
ハイパーバイザーで。
ブロックジョブ ドメイン path {[- アボート] [--非同期] [- ピボット] | [[- 情報] [- 生] [-バイト] |
[帯域幅]}
アクティブなブロック操作を管理します。 相互に排他的なモードが XNUMX つあります。 - 情報,
帯域幅, - アボート. --非同期 - ピボット 中断モードを意味します。 - 生 情報を意味する
モード; モードが指定されていない場合は、 - 情報 モードが想定されます。
path ディスクの完全修飾パスを指定します。 ユニークなターゲットに対応
名前 （ ) またはソースファイル ( ) ディスクの XNUMX つ
に接続されているデバイス ドメイン （も参照してください ドンブルリスト これらの名前をリストするため)。
In - アボート モードでは、指定されたディスク上のアクティブなジョブは中止されます。 もしも --非同期 is
も指定されている場合、このコマンドは、
キャンセル完了。 もしも - ピボット が指定されている場合、これはアクティブ コピーを要求します。
またはアクティブなコミット ジョブが新しいイメージにピボットされます。
In - 情報 モードでは、指定されたディスク上のアクティブなジョブ情報が印刷されます。 に
デフォルトでは、出力は人間が読める単一の要約行です。 この形式は変更される可能性があります
将来のバージョン。 追加する - 生 構造体の各フィールドを安定した形式でリストします。 もしも
-バイト フラグが設定されている場合、サーバーが提供できなかった場合、コマンドはエラーになります
バイト/秒の解像度; フラグを省略すると、未加工の出力は MiB/s および human-
読み取り可能な出力では、サーバーがサポートする最適な解像度が自動的に選択されます。
帯域幅 アクティブなジョブの帯域幅制限を設定するために使用できます。 を指定する
負の値は、unsigned long long 値または本質的に無制限として解釈されます。
ハイパーバイザーは、値を拒否するか、最大値に変換するかを選択できます
許容される値。
ブロックサイズ変更 ドメイン path サイズ
ドメインの実行中にドメインのブロックデバイスのサイズを変更し、 path を指定します
ブロックデバイスの絶対パス。 一意のターゲット名に対応します (
dev='name'/>) またはソースファイル ( ) ディスク デバイスの XNUMX つ
に添付 ドメイン （も参照してください ドンブルリスト これらの名前をリストするため)。
サイズ スケーリングされた整数です（を参照してください 注意事項 上記) デフォルトは KiB (1024 ブロック)
バイト) サフィックスがない場合。 バイトを取得するには、「B」のサフィックスを使用する必要があります (
歴史的な理由から、これは ボリュームリサイズ これは、デフォルトで
サフィックス）。
ドムディスプレイ ドメイン [--include-パスワード] [[- タイプ] type]
経由でドメインのグラフィカル表示に接続するために使用できる URI を出力します。
VNC、SPICE、または RDP。 特定のグラフィック表示タイプは、
type パラメータ (例: "vnc"、"spice"、"rdp")。 もしも --include-パスワード 指定されている場合、
SPICE チャネルのパスワードは URI に含まれます。
domfsinfo ドメイン
実行中のドメイン内にマウントされているファイルシステムのリストを表示します。 リストには以下が含まれます
マウントポイント、ゲストにマウントされたデバイスの名前、ファイルシステムの種類、および一意の
ドメイン XML で使用されるターゲット名 ( ）。
このコマンドには、ゲスト エージェントがドメインの
ゲスト OS。
ドムフスフリーズ ドメイン [[--マウントポイント] マウントポイント...]
実行中のドメイン内でマウントされたファイルシステムをフリーズして、一貫性のある準備をします
スナップショット。
当学校区の --マウントポイント オプションはパラメータを取ります マウントポイントのマウント ポイント パスです。
凍結するファイルシステム。 このオプションは複数回発生する可能性があります。 そうでない場合
指定すると、マウントされたすべてのファイルシステムが凍結されます。
注意： スナップショット作成 コマンドには --静止 凍結と解凍のオプション
ファイルシステムを自動的に変更して、スナップショットの一貫性を保ちます。 ドムフスフリーズ コマンドは
ユーザーがストレージ デバイスのネイティブ スナップショット機能を利用したい場合に必要
libvirt ではサポートされていません。
ドムフソー ドメイン [[--マウントポイント] マウントポイント...]
によって凍結された、実行中のドメイン内のマウントされたファイルシステムを解凍します。
domfsfreeze コマンド。
当学校区の --マウントポイント オプションはパラメータを取ります マウントポイントのマウント ポイント パスです。
解凍するファイルシステム。 このオプションは複数回発生する可能性があります。 そうでない場合
指定すると、マウントされたすべてのファイルシステムが解凍されます。
ドムストリム ドメイン [- 最小 バイト] [--マウントポイント マウントポイント]
実行中のドメイン内のすべてのマウントされたファイルシステムで fstrim コマンドを発行します。 捨てる
ファイルシステムで使用されていないブロック。 もしも - 最小 バイト 指定されている場合、それは
連続する空き範囲のゲスト カーネルの長さを示します。 これより小さいものは無視できます
(これはヒントであり、ゲストはそれを尊重しない場合があります)。 この値を大きくすることで、
fstrim 操作は、ひどく断片化された空き領域を持つファイルシステムに対してより迅速に完了します
ただし、すべてのブロックが破棄されるわけではありません。 デフォルト値はゼロです。
「すべての空きブロックを破棄します」。 さらに、ユーザーがマウント ポイントを XNUMX つだけトリミングしたい場合は、
オプションで指定可能 --マウントポイント パラメータに一致する最初のデバイスのリモートコントロール URL を返します。
ドメインホスト名 ドメイン
ハイパーバイザーがドメインを利用可能にしている場合、ドメインのホスト名を返します。
ドムインフォ ドメイン
ドメインに関する基本情報を返します。
ドムイド ドメイン名または ID
ドメイン名または ID をドメイン UUID に変換する
ドミッド ドメイン名または uuid
ドメイン名 (または UUID) をドメイン ID に変換する
ドムジョブ中止 ドメイン
現在実行中のドメイン ジョブを中止します。
ドムジョブ情報 ドメイン [--完了]
ドメインで実行中のジョブに関する情報を返します。 --完了 virsh に戻るように指示します
最近終了したジョブに関する情報。 完了したジョブの統計は
一度読み取られるか、libvirtd が再起動されると、自動的に破棄されます。 その時間に注意してください
完了した移行に対して返される情報は、両方の場合を除き、まったく無関係である可能性があります
送信元ホストと宛先ホストの時刻が同期されている (つまり、NTP デーモンが実行されている)
どちらも）。
ドム名 ドメイン ID または UUID
ドメイン ID (または UUID) をドメイン名に変換する
ドムリネーム ドメイン 新しい名前
ドメインの名前を変更します。 このコマンドは、現在のドメイン名を で指定された新しい名前に変更します。
XNUMX 番目の引数。
注意: ドメインは非アクティブで、スナップショットがない必要があります。
ドムステート ドメイン [- 理由]
ドメインに関する状態を返します。 - 理由 の理由も出力するように virsh に指示します。
でのみ停止させることができます。
ドムコントロール ドメイン
ドメインの制御に使用される VMM へのインターフェイスの状態を返します。 以外の州の場合
「ok」または「error」コマンドは、制御から経過した秒数も出力します
インターフェイスが現在の状態になりました。
ドームタイム ドメイン {[- 今] [- かわいい] [--同期] [- 時間 時間]}
ドメインのシステム時刻を取得または設定します。 引数なしで実行すると (ただし、 ドメイン),
現在のドメインのシステム時刻が出力されます。 の - かわいい 修飾子を使用できます
より人間が読める形式で時刻を出力します。
日時 - 時間 時間 が指定されている場合、ドメインの時刻は取得されず、代わりに設定されます。 の
- 今 修飾子は、のエイリアスであるかのように機能します - 時間 $今、つまり、
virsh が実行されているホストの現在の時刻。 どちらの場合も (設定と
取得)、時間は UTC の 1970-01-01 のエポックに対する相対秒数です。 の --同期
設定の動作を少し変更します: 経過した時間は無視されますが、設定する時間は
代わりにドメインの RTC から読み取ります。 一部のハイパーバイザーにはゲストが必要な場合があることに注意してください
ゲスト時間を取得または設定するために構成するエージェント。
ネイティブからの domxml 形式でアーカイブしたプロジェクトを保存します． 設定
ファイルを変換する 設定 によって命名されたネイティブゲスト構成形式で 形式でアーカイブしたプロジェクトを保存します． へ
ドメイン XML 形式。 QEMU/KVM ハイパーバイザーの場合、 形式でアーカイブしたプロジェクトを保存します． 引数は次のようにする必要があります qemu-argv。 のために
Xen ハイパーバイザー 形式でアーカイブしたプロジェクトを保存します． 引数は次のとおりかもしれません xen-xm, xen-xlまたは xen-sxpr. LXCの場合
ハイパーバイザー、 形式でアーカイブしたプロジェクトを保存します． 引数は次のようにする必要があります lxc-ツール.
domxml からネイティブへ 形式でアーカイブしたプロジェクトを保存します． XML
ファイルを変換する XML ドメイン XML 形式からネイティブ ゲスト構成形式へ
によって名付けられた 形式でアーカイブしたプロジェクトを保存します．. QEMU/KVM ハイパーバイザーの場合、 形式でアーカイブしたプロジェクトを保存します． 引数は次のようにする必要があります qemu-argv。 のために
Xen ハイパーバイザー 形式でアーカイブしたプロジェクトを保存します． 引数は次のとおりかもしれません xen-xm, xen-xlまたは xen-sxpr. LXCの場合
ハイパーバイザー、 形式でアーカイブしたプロジェクトを保存します． 引数は次のようにする必要があります lxc-ツール.
ダンプ ドメイン コアファイルパス [--バイパスキャッシュ] { [- 住む] | [[- クラッシュ] | [[-リセット] } [-詳細]
[--メモリのみ] [- フォーマット string]
分析のためにドメインのコアをファイルにダンプします。 もしも - 住む が指定されている場合、ドメイン
前もって一時停止するのではなく、コア ダンプが完了するまで実行を続けます。 もしも
- クラッシュ が指定されている場合、ドメインは単に停止するのではなく、クラッシュ状態で停止します。
休止状態のまま。 もしも -リセット が指定されている場合、ドメインは成功後にリセットされます
ごみ。 これら XNUMX つのスイッチは相互に排他的であることに注意してください。 もしも --バイパスキャッシュ is
指定すると、保存はファイル システム キャッシュを回避しますが、これにより速度が低下する場合があります。
手術。 もしも --メモリのみ が指定されている場合、ファイルはelfファイルであり、含まれるもののみ
ドメインのメモリと cpu 共通レジスタ値。 ドメインが使用している場合、非常に便利です
ホストデバイスを直接。 - フォーマット string 「メモリのみ」の形式を指定するために使用されます
ダンプし、 string それらの XNUMX つにすることができます: elf、kdump-zlib (kdump 圧縮形式
zlib-compressed)、kdump-lzo(lzo 圧縮による kdump 圧縮形式)、
kdump-snappy (snappy で圧縮された kdump 圧縮形式)。
進行状況は、次を使用して監視できます。 ドムジョブ情報 virsh コマンドでキャンセル
ドムジョブ中止 コマンド (別の virsh インスタンスによって送信されます)。 別のオプションは、SIGINT を送信することです。
(通常は「Ctrl-C」を使用) 実行中の virsh プロセスに ダンプ -詳細 ディスプレイ
ダンプの進行。
注: 一部のハイパーバイザーでは、ユーザーが手動で適切なアクセス許可を確認する必要がある場合があります。
引数で指定されたファイルとパス コアファイルパス.
ダンプxml ドメイン [- 非活性] [-- セキュリティ情報] [--更新-CPU] [--移行可能]
ドメイン情報を XML ダンプとして stdout に出力します。この形式は、
作ります 指図。 XML ダンプに影響する追加オプションを使用できます。 - 非活性
ドメインの次回の起動時に使用されるドメイン構成をダンプするように virsh に指示します。
現在のドメイン構成とは対照的です。 使用する -- セキュリティ情報 意志も
XML ダンプに機密情報を含めます。 --更新-CPU ドメインを更新
ホスト CPU に応じた CPU 要件。 と --移行可能 次の XML を要求できます。
移行に適しています。つまり、古い libvirt リリースと互換性があり、おそらく
内部実行時オプションで修正されました。 このオプションにより、他のオプションが自動的に有効になる場合があります
オプション（--更新-CPU, -- セキュリティ情報、 ...） 必要に応じて。
edit ドメイン
ドメインの XML 構成ファイルを編集します。これは、の次の起動に影響します。
ゲスト。
これは次と同等です。
virsh dumpxml --inactive --security-info ドメイン > domain.xml
vi domain.xml (または他のテキスト エディターで変更)
virsh 定義 domain.xml
ただし、いくつかのエラー チェックを行います。
使用されるエディターは、$VISUAL または $EDITOR 環境変数によって提供されます。
デフォルトは「vi」です。
イベント {[ドメイン]{ イベント | - すべて } [- ループ] [- タイムアウト 秒] [-タイムスタンプ] | - リスト}
ドメイン イベントのクラスが発生するのを待ち、イベントの適切な詳細を次のように出力します。
それらは起こります。 イベントは、オプションで次のようにフィルタリングできます。 ドメイン。 使い方 - リスト として
引数のみが可能なリストを提供します イベント このクライアントが知っている値、
ただし、接続によってこれらすべてのイベントの登録が許可されない場合があります。 それも
使用可能 - すべて イベント 可能なすべてのイベントタイプに登録するには
一度。
デフォルトでは、このコマンドはワンショットで、イベントが発生すると成功を返します。 あなた
SIGINT を (通常は "Ctrl-C" 経由で) 送信して、すぐに終了することができます。 もしも - タイムアウト is
指定すると、コマンドはイベントの待機を断念します。 秒 経過しました。 と
- ループ、コマンドは、タイムアウトまたは割り込みキーまでのすべてのイベントを出力します。
日時 -タイムスタンプ が使用されると、人間が判読できるタイムスタンプがイベントの前に出力されます。
iothreadinfo ドメイン [[- 住む] [--config] | [[- 現在]]
IOThread ID と CPU を含む基本的なドメイン IOThreads 情報を表示します
各 IOThread のアフィニティ。
If - 住む が指定されている場合、実行中のゲストから IOThreads データを取得します。 ゲストの場合
実行されていない場合、エラーが返されます。 もしも --config が指定されている場合、IOThreads データを取得します
永続ゲストの次のブートから。 もしも - 現在 指定されているか、 - 住む
--config が指定されていない場合、現在のゲストに基づいて IOThread データを取得します
でのみ停止させることができます。
iothreadpin ドメイン iothread キュピリスト [[- 住む] [--config] | [[- 現在]]
ドメイン IOThread のピニングをホスト物理 CPU に変更します。 を取得するには
すべての IOThreads のリスト、使用 iothreadinfo. ピン留めするには iothread その キュピリスト
にリストされているように、IOThread ID に必要です。 iothreadinfo 出力。
キュピリスト 物理 CPU 番号のリストです。 その構文は、カンマ区切りのリストと
「-」と「^」を使用した特別なマークアップ (例: 「0-4」、「0-3、^2」) も許可されます。 「-」
は範囲を示し、「^」は排他的であることを示します。 iothreadpin をリセットしたい場合
設定、つまり固定する iothread すべての物理 CPU に対して、単純に「r」を
キュピリスト.
If - 住む が指定されている場合、実行中のゲストに影響します。 ゲストが実行されていない場合、エラー
が返されます。 もしも --config が指定されている場合、永続ゲストの次回の起動に影響します。
If - 現在 指定されているか、 - 住む --config が指定されていない場合、電流に影響を与えます
ゲスト状態。 両方 - 住む --config 次の場合にフラグを指定できます キュピリスト 存在しますが、
- 現在 排他的です。 フラグが指定されていない場合、動作は次の条件によって異なります。
ハイパーバイザー。
注意: 式は順番に評価されるため、"0-15,^8" は
"9-14,0-7,15" ですが、"^8,0-15" とは異なります。
iothreadadd ドメイン iothread_id [[--config] [- 住む] | [[- 現在]]
指定されたを使用してドメインに新しいIOThreadを追加します iothread_id。 もし iothread_id
既に存在する場合、コマンドは失敗します。 の iothread_id ゼロより大きい必要があります。
If - 住む が指定されている場合、実行中のゲストに影響します。 ゲストがエラーを実行していない場合
が返されます。 もしも --config が指定されている場合、永続ゲストの次回の起動に影響します。
If - 現在 指定されているか、 - 住む --config が指定されていない場合、電流に影響を与えます
ゲスト状態。
iothreaddel ドメイン iothread_id [[--config] [- 住む] | [[- 現在]]
指定されたメソッドを使用して、ドメインから IOThread を削除します iothread_id. IOThread が
などを介して現在ディスク リソースに割り当てられている アタッチディスク コマンド、次に
IOThread を削除しようとすると失敗します。 もし iothread_id エラーが存在しません
発生します。
If - 住む が指定されている場合、実行中のゲストに影響します。 ゲストがエラーを実行していない場合
が返されます。 もしも --config が指定されている場合、永続ゲストの次回の起動に影響します。
If - 現在 指定されているか、 - 住む --config が指定されていない場合、電流に影響を与えます
ゲスト状態。
管理保存 ドメイン [--バイパスキャッシュ] [{- ランニング | --一時停止}] [-詳細]
実行中のドメインを保存して破棄 (停止) し、同じ状態から再開できるようにする
しばらく経って。 ときvirsh start コマンドが次にドメインに対して実行されると、
この保存された状態から自動的に開始されます。 もしも --バイパスキャッシュ 指定されている場合、
save はファイル システム キャッシュを回避しますが、操作が遅くなる可能性があります。
進行状況は、次を使用して監視できます。 ドムジョブ情報 virsh コマンドでキャンセル
ドムジョブ中止 コマンド (別の virsh インスタンスによって送信されます)。 別のオプションは、SIGINT を送信することです。
(通常は「Ctrl-C」を使用) 実行中の virsh プロセスに 管理保存 -詳細
保存の進行状況を表示します。
通常、マネージド セーブを開始すると、実行中か一時停止中かが決定されます。
保存が完了したときのドメインの状態。 どちらかを渡す - ランニング or
--一時停止 フラグは、どの状態をオーバーライドできるようにします start 使用する必要があります。
当学校区の ドムインフォ コマンドを使用して、ドメインに現在管理されているドメインがあるかどうかを照会できます
画像を保存。
管理された保存削除 ドメイン
削除する 管理保存 ドメインの状態ファイル (存在する場合)。 これにより、ドメイン
次回起動時にフルブートします。
maxvcpu [type]
この上のゲスト VM でサポートされる仮想 CPU の最大数を提供します
繋がり。 提供される場合、 type パラメータは、
XML の要素。
CPU統計 ドメイン [- 合計] [start] [カウント]
ドメインの CPU 統計情報を提供します。 ドメインが実行されている必要があります。 デフォルト
すべての CPU の統計と合計が表示されます。 使用 - 合計 合計統計のみ、 start
からの CPU の CPU ごとの統計のみ start, カウント のみ カウント CPU の統計。
ドメイン [[- 住む] [--config] | [[- 現在]][--編集] [URI] [キー] [セッションに] [- 削除する]
ドメインのカスタム XML メタデータを表示または変更します。 メタデータはユーザー定義の XML です
これにより、ドメイン定義に任意の XML データを格納できます。 複数の個別
カスタム メタデータの断片は、ドメイン XML に格納できます。 ピースは次のように識別されます。
経由で提供されるプライベート XML 名前空間 URI 口論。 (こちらもご覧ください DESC で動作します
ドメインのテキスト メタデータ)。
フラグ - 住む or --config このコマンドがライブまたは永続で機能するかどうかを選択します
ドメインの定義。 両方なら - 住む --config が指定されている場合、 --config
オプションは、現在の説明とライブ構成の両方を取得する上で優先されます
および config は、説明の設定中に更新されます。 - 現在 排他的であり、
これらのいずれも指定されていない場合は暗示されます。
フラグ - 削除する によって指定されたメタデータ要素が URI 議論すべき
更新ではなく削除されます。
フラグ --編集 によって識別されるメタデータを持つエディターを指定します。 URI 引数
開いて、後で内容を保存する必要があります。 それ以外の場合は、新しいコンテンツ
経由で提供できます。 セッションに 引数。
経由でメタデータを設定する場合 --編集 or セッションに キー 引数を指定する必要があり、使用されています
カスタム要素にプレフィックスを付けて、それらをプライベート名前空間にバインドします。
どちらでもない場合 --編集 セッションに に対応する XML メタデータが指定されている URI
名前空間は変更される代わりに表示されます。
移動します [- 住む] [- オフライン] [- 直接] [--p2p [-- トンネリング]][- 持続的に]
[--undefinesource] [- つるす] [--コピーストレージすべて] [--コピーストレージ株式会社]
[-- 変更保護] [-安全ではない] [-詳細] [-圧縮] [-- アボート・オン・エラー]
[--自動収束] ドメイン デストゥリ [移行] [グラフィックスリ] [リッスン アドレス] [dname]
[- タイムアウト 秒] [--xml file] [--移行ディスク ディスクリスト]
ドメインを別のホストに移行します。 追加 - 住む ライブ マイグレーション用。 <--p2p> の場合
ピアツーピア移行。 - 直接 直接移行の場合。 また -- トンネリング トンネル用
移行。 - オフライン ドメインを起動せずにドメイン定義を移行します
宛先であり、ソース ホストで停止することはありません。 オフライン移行を使用できます
非アクティブなドメインと一緒に使用する必要があります - 持続的に オプションを選択します。 - 持続的に
宛先ホストでドメインを永続的なままにし、 --undefinesource を定義解除します
ソース ホストのドメイン、および - つるす 宛先でドメインを一時停止したままにする
ホスト。 --コピーストレージすべて フルディスクの非共有ストレージでの移行を示します
コピー、 --コピーストレージ株式会社 増分を伴う非共有ストレージでの移行を示します
コピーします (ソースと宛先の間で共有される同じ基本イメージ)。 どちらの場合もディスク
イメージは宛先ホストに存在する必要があります。 --コピーストレージ-... オプションだけが伝える
libvirt を使用して、ソース ホスト上のイメージから、
宛先ホストの同じ場所。 デフォルトでは、非共有非読み取り専用イメージのみが
転送されました。 使用 --移行ディスク ディスクターゲットのリストを明示的に指定する
カンマ区切りで転送 ディスクリスト 引数。 -- 変更保護 それを強制する
移行中に互換性のない構成変更がドメインに加えられることはありません
進行中です。 このフラグは、ハイパーバイザーによってサポートされている場合に暗黙的に有効になりますが、
ハイパーバイザーに変更保護がない場合、移行を拒否するために明示的に使用される
サポート。 -詳細 移行の進行状況を表示します。 -圧縮 活性化する
ライブ中に繰り返し転送する必要があるメモリ ページの圧縮
移行。 -- アボート・オン・エラー ソフト エラー (I/O など) が発生した場合、移行をキャンセルします。
エラー) は、移行中に発生します。 --自動収束 ライブ中の強制収束
移行。
注意: 通常、個々のハイパーバイザーは、考えられるすべての種類の移行をサポートしているわけではありません。
たとえば、QEMU は直接移行をサポートしていません。
場合によっては、libvirt がドメインの移行を拒否することがあります。
データの破損などの潜在的な問題があるため、移行が検討されます
安全でない。 QEMU ドメインの場合、ドメインが明示的に指定せずにディスクを使用すると、これが発生することがあります。
キャッシュモードを「なし」に設定します。 このようなドメインの移行は、ディスク イメージが適切でない限り安全ではありません。
GFS2 や GPFS などの一貫したクラスター化されたファイルシステムに保存されます。 確信がある場合は、
移行が安全であるか、気にしない場合は、使用してください -安全ではない 移行を強制します。
dname 移行中にドメインの名前を新しい名前に変更するために使用されます。これは通常、
省略可能です。 同じく、 --xml file 通常は省略されますが、
より大きな変更セットを提供するために、宛先で使用する代替 XML ファイル
ネーミングのアカウンティングなど、ドメイン XML のホスト固有の部分
基礎となるストレージへのアクセスにおけるソースと宛先の違い。
- タイムアウト 秒 ライブ マイグレーションがその数を超えると、ゲストを強制的に一時停止します
数秒後、移行はオフラインで完了します。 でのみ使用できます
- 住む.
実行中の移行は、virsh を中断する (通常は「Ctrl-C」を使用) か、
ドムジョブ中止 別の virsh インスタンスから送信されたコマンド。
当学校区の デストゥリ 移行 パラメータを使用して、送信先を制御できます。
移行を使用します。 デストゥリ 管理された移行には重要ですが、直接移行には使用されません
移行; 移行 直接の移行には必要ですが、通常は
管理された移行のために自動的に決定されます。
注意： デストゥリ 通常の移行と peer2peer 移行のパラメータは異なります
セマンティクス:
・通常移行： デストゥリ から見たターゲット ホストのアドレスです。
クライアントマシン。
· peer2peer 移行: デストゥリ から見たターゲット ホストのアドレスです。
ソースマシン。
日時 移行 が指定されていない場合、libvirt は自動的にハイパーバイザーを決定します
特定の URI。 QEMU を含む一部のハイパーバイザーには、オプションの「migration_host」があります。
構成パラメーター (ホストに複数のネットワーク インターフェイスがある場合に役立ちます)。 もしも
これは指定されていません。libvirt は、ターゲット ホストの名前を検索して名前を決定します。
構成されたホスト名。
指定するいくつかのシナリオがあります 移行 役立つかもしれません：
· 構成されたホスト名が正しくないか、DNS が壊れています。 ホストにホスト名がある場合
そのパブリック IP アドレスの XNUMX つに一致するように解決されない場合、libvirt は
誤った URI を生成します。 この場合 移行 明示的にする必要があります
IP アドレスまたは正しいホスト名を使用して指定します。
· ホストには複数のネットワーク インターフェイスがあります。 ホストに複数のネットワークがある場合
インターフェイスを介して移行データ ストリームを送信することが望ましい場合があります。
セキュリティまたはパフォーマンス上の理由から、特定のインターフェイス。 この場合
移行 に関連付けられた IP アドレスを使用して、明示的に指定する必要があります。
使用するネットワーク。
· ファイアウォールは、使用できるポートを制限します。 libvirt が
移行 URI では、ハイパーバイザー固有のルールを使用してポート番号が選択されます。 いくつかの
ハイパーバイザーは、ファイアウォールで単一のポートを開くだけで済みますが、他のハイパーバイザーは
ポート番号の全範囲が必要です。 後者の場合 移行 かもしれません
デフォルトの範囲外の特定のポート番号を選択するように指定されています。
ローカル ファイアウォール ポリシーに準拠します。
見るhttp://libvirt.org/migration.html移行 URI の詳細については #uris> を参照してください。
オプション グラフィックスリ に使用される接続パラメータを自動的に上書きします
移行の最後にグラフィカル クライアントを再接続します。 省略した場合、libvirt は
ターゲット ホストの IP アドレスに基づいてパラメータを計算します。 クライアントがそうしない場合
仮想化ホストが接続されている必要があるネットワークに直接アクセスできる
プロキシ経由で接続し、 グラフィックスリ クライアントのアドレスを指定するために使用できます
に接続する必要があります。 URI は次のように形成されます。
protocol://ホスト名[:ポート]/[?パラメータ]
ここで、プロトコルは「spice」または「vnc」のいずれかで、パラメーターはプロトコルのリストです
「&」で区切られた特定のパラメータ。 現在認識されているパラメータは「tlsPort」です
および「tlsSubject」。 例えば、
スパイス://target.host.com:1234/?tlsPort=4567
オプション リッスン アドレス 宛先のハイパーバイザーがリッスン アドレスを設定します。
サイドは、着信移行のためにバインドする必要があります。 IPv4 と IPv6 の両方のアドレスが受け入れられます
ホスト名だけでなく (解決は宛先で行われます)。 一部のハイパーバイザーは
はこの機能をサポートしており、このパラメーターを使用するとエラーが返されます。
移行-setmaxdowntime ドメイン ダウンタイム
別のドメインにライブ マイグレーションするドメインの最大許容ダウンタイムを設定する
ホスト。 の ダウンタイム は、ゲストがダウンしていることを許可されるミリ秒数です。
ライブ マイグレーションの終了。
移行-compcache ドメイン [- サイズ バイト]
繰り返し圧縮するために使用されるキャッシュのサイズ (バイト単位) を設定および/または取得します
ライブ マイグレーション中に転送されたメモリ ページ。 なしで呼び出した場合 サイズ、 コマンド
圧縮キャッシュの現在のサイズを出力するだけです。 いつ サイズ 指定されている場合、
ハイパーバイザーは、圧縮キャッシュを次のように変更するように求められます サイズ バイト、次に現在の
サイズが印刷されます (結果は、要求されたサイズとは異なる場合があります。
ハイパーバイザー)。 の サイズ オプションは、ドメインが使用されている間に使用されることになっています
移行の進行状況と圧縮数の増加に対する反応としてのライブ移行
domjobinfo から取得したキャッシュ ミス。
移行-setspeed ドメイン 帯域幅
移行先のドメインの最大移行帯域幅 (MiB/秒) を設定します
別のホスト。 帯域幅 unsigned long long 値として解釈されます。 を指定する
負の値は、本質的に無制限の値が
ハイパーバイザー。 ハイパーバイザーは、値を拒否するか、値に変換するかを選択できます。
許容される最大値。
移行-getspeed ドメイン
ドメインの最大移行帯域幅 (MiB/秒) を取得します。
沼曲 ドメイン [- モード モード] [--nodeset ノードセット] [[--config] [- 住む] | [[- 現在]]
に対応するドメインの numa パラメータを設定または取得します。 の要素
ドメイン XML。 フラグがない場合、現在の設定が表示されます。
モード 「strict」、「interleave」、「preferred」のいずれか、または
デーモンがサポートしている場合は、virDomainNumatuneMemMode enum。 実行中のドメインの場合、
モードは変更できず、ノードセットはドメインが変更された場合にのみ変更できます。
`strict' のモードで開始されました。
ノードセット ホストがドメインを実行するために使用する numa ノードのリストです。 その構文
カンマ区切りのリストで、'-' は範囲を表し、'^' はノードを除外します。
If - 住む が指定されている場合、稼働中のゲストのスケジューラー情報を設定します。 もしも --config is
指定すると、永続ゲストの次回の起動に影響します。 もしも - 現在 指定されている、
現在のゲストの状態に影響します。
リブート ドメイン [- モード モードリスト]
ドメインを再起動します。 これは、ドメインに リブート から実行されるコマンド
コンソール。 コマンドは、再起動アクションを実行するとすぐに戻ります。
ドメインが実際に再起動する前に、
再起動時のドメインの正確な動作は、 再起動時 のパラメータ
ドメインの XML 定義。
デフォルトでは、ハイパーバイザーは適切なシャットダウン方法を選択しようとします。 を指定するには
代替方法、 - モード パラメータはカンマ区切りのリストを指定できます。
「acpi」、「agent」、「initctl」、「signal」、および「paravirt」が含まれます。 その順番
ドライバーが試行する各モードは定義されておらず、指定された順序とは関係ありません。
virsh。 順序を厳密に制御するには、一度に XNUMX つのモードを使用して、
リセット ドメイン
ゲストをシャットダウンせずに、すぐにドメインをリセットします。 リセット 電源リセットをエミュレートします
すべてのゲスト ハードウェアが RST ライン セットを認識し、再初期化するマシンのボタン
内部状態。
注意: ゲスト OS をシャットダウンせずにリセットすると、データが失われる危険性があります。
リストア 状態ファイル [--バイパスキャッシュ] [--xml file] [{- ランニング | --一時停止}]
からドメインを復元します。 おとなしい 保存 状態ファイル。 見る 保存 詳細はこちら
If --バイパスキャッシュ が指定されている場合、リストアはファイル システム キャッシュを回避しますが、
これにより、操作が遅くなる場合があります。
--xml file 通常は省略されますが、代替 XML ファイルを提供するために使用できます。
のホスト固有の部分のみを変更して、復元されたゲストで使用します。
ドメイン XML。 たとえば、ファイル名の違いを説明するために使用できます。
ゲストが保存された後に作成されたディスク スナップショットが原因で、基になるストレージが失われます。
通常、保存されたイメージを復元すると、保存されたイメージに記録された状態が使用されます。
実行中か一時停止中かを決定します。 どちらかを渡す - ランニング or --一時停止 フラグは
ドメインを開始する状態をオーバーライドできるようにします。
注意: ドメイン内のファイル システム コンテンツの破損を避けるため、再利用しないでください。
保存された状態ファイルを XNUMX 秒間 リストア すべてのストレージも元に戻していない限り
ボリュームは、状態ファイルが作成されたときと同じ内容に戻ります。
保存 ドメイン 状態ファイル [--バイパスキャッシュ] [--xml file] [{- ランニング | --一時停止}] [-詳細]
実行中のドメイン (RAM、ただしディスクの状態ではない) を状態ファイルに保存して、
後に復元。 保存すると、ドメインはシステム上で実行されなくなります。
ドメインに割り当てられたメモリは、他のドメインが使用できるように解放されます。 おとなしい
リストア この状態ファイルから復元します。 もしも --バイパスキャッシュ が指定されている場合、保存は
操作が遅くなる可能性がありますが、ファイル システム キャッシュは避けてください。
進行状況は、次を使用して監視できます。 ドムジョブ情報 virsh コマンドでキャンセル
ドムジョブ中止 コマンド (別の virsh インスタンスによって送信されます)。 別のオプションは、SIGINT を送信することです。
(通常は「Ctrl-C」を使用) 実行中の virsh プロセスに 保存 -詳細 ディスプレイ
保存の進行状況。
これは、実行中のコンピューターで休止状態にするのとほぼ同じです。
同じ制限。 開いているネットワーク接続は、TCP として復元時に切断される場合があります。
タイムアウトが期限切れになっている可能性があります。
--xml file 通常は省略されますが、代替 XML ファイルを提供するために使用できます。
のホスト固有の部分のみを変更して、復元されたゲストで使用します。
ドメイン XML。 たとえば、ファイル名の違いを説明するために使用できます。
ゲストが起動した後、基盤となるストレージのディスク スナップショットを介して作成される予定です。
保存されました。
通常、保存されたイメージを復元すると、実行中か一時停止中かが決定されます。
保存が完了したときのドメインの状態。 どちらかを渡す - ランニング or
--一時停止 フラグは、どの状態をオーバーライドできるようにします リストア 使用する必要があります。
ドメイン保存状態ファイルは、ディスク イメージが次の期間に変更されないことを前提としています。
作成ポイントと復元ポイント。 より完全なシステムの復元ポイントについては、ディスクが
状態はメモリ状態と一緒に保存されます。 スナップショット コマンドのファミリー。
保存イメージ定義 file XML [{- ランニング | --一時停止}]
次の場合に使用されるドメイン XML を更新します。 file で使用されます。 リストア
コマンド。 の XML 引数は、代替 XML を含むファイル名でなければなりません。
ドメイン XML のホスト固有の部分のみが変更されます。 たとえば、
のディスク スナップショットの作成に起因するファイル名の違いを説明するために使用されます。
ゲストが保存された後の基になるストレージ。
保存イメージには、ドメインを実行中または一時停止中の状態に復元する必要があるかどうかが記録されます。
州。 通常、このコマンドは記録された状態を変更しません。 どちらかを渡す
- ランニング or --一時停止 フラグは、どの状態をオーバーライドできるようにします リストア 使用する必要があります。
保存-イメージ-dumpxml file [-- セキュリティ情報]
状態ファイルを保存した時点で有効だったドメイン XML を抽出します。 file ました
で作成 保存 指図。 使用する -- セキュリティ情報 セキュリティも含まれます
機密情報。
画像編集保存 file [{- ランニング | --一時停止}]
保存された状態ファイルに関連付けられた XML 構成を編集する file によって作成されました 保存
保存イメージには、ドメインを実行中または一時停止中の状態に復元する必要があるかどうかが記録されます。
州。 通常、このコマンドは記録された状態を変更しません。 どちらかを渡す
- ランニング or --一時停止 フラグは、どの状態をオーバーライドできるようにします リストア 使用する必要があります。
これは次と同等です。
virsh save-image-dumpxml 状態ファイル > 状態ファイル.xml
vi state-file.xml (または他のテキスト エディターで変更)
virsh save-image-define 状態ファイル state-file-xml
ただし、いくつかのエラー チェックを行います。
使用されるエディターは、$VISUAL または $EDITOR 環境変数によって提供されます。
デフォルトは「vi」です。
スケジュール情報 ドメイン [[--config] [- 住む] | [[- 現在]] [[- 設定] パラメータ=値] ...
スケジュール情報 [- 重さ 数] [- キャップ 数] ドメイン
ドメイン スケジューラのパラメータを表示 (および設定) できます。 利用可能なパラメータ
各ハイパーバイザーは次のとおりです。
LXC (posix スケジューラ) : cpu_shares、vcpu_period、vcpu_quota
QEMU/KVM (posix スケジューラー): cpu_shares、vcpu_period、vcpu_quota、emulator_period、
エミュレータ_クォータ
Xen (クレジット スケジューラー): 重量、上限
ESX (割り当てスケジューラ): 予約、制限、共有
If - 住む が指定されている場合、稼働中のゲストのスケジューラー情報を設定します。 もしも --config is
指定すると、永続ゲストの次回の起動に影響します。 もしも - 現在 指定されている、
現在のゲストの状態に影響します。
注意: cpu_shares パラメータの有効な値の範囲は 0 ～ 262144 です。 負の値
正にラップされ、より大きな値は最大値に制限されます。 したがって、-1
は 262144 の便利な省略形です。Linux カーネルでは、値 0 と 1 は
自動的に最小値 2 に変換されます。
注意: weight および cap パラメータは、XEN_CREDIT スケジューラおよび
今あります 廃止.
注意: vcpu_period/emulator_period パラメータの有効な値の範囲は
1000 ～ 1000000 または 0 で、vcpu_quota/emulator_quota パラメータに有効な値がある
1000-18446744073709551 の範囲または 0 未満。どちらのパラメーターの値も 0 です。
そのパラメーターを指定しないのと同じです。
スクリーンショット ドメイン [画像ファイルパス] [- 画面 スクリーンID]
現在のドメイン コンソールのスクリーンショットを取得し、ファイルに保存します。 オプションで、
ハイパーバイザーがドメインに対してより多くのディスプレイをサポートする場合、 スクリーンID どちらを指定できますか
画面がキャプチャされます。 画面の通し番号です。 複数の場合
グラフィックス カードの場合、ヘッドはデバイスの前に列挙されます。たとえば、XNUMX つのグラフィックス カードがある場合、
どちらも 5 つのヘッドを持ち、スクリーン ID XNUMX は XNUMX 番目のカードの XNUMX 番目のヘッドに対応します。
送信キー ドメイン [--コードセット コードセット] [--ホールドタイム 保留時間] キーコード...
解析する キーコード 送信するキーストロークとしてのシーケンス ドメイン。 各 キーコード どちらか
対応するコードセットの数値または記号名になります。 もしも --ホールドタイム
が与えられると、各キーストロークはそのミリ秒の間保持されます。 デフォルトのコードセット
is linuxの、しかしの使用 --コードセット オプションを使用すると、他のコードセットを選択できます。
複数のキーコードが指定されている場合、それらはすべて同時にゲストに送信されます。
それらはランダムな順序で受信される場合があります。 個別のキープレスが必要な場合は、使用する必要があります
複数の send-key 呼び出し。
linuxの
数値は、Linux 汎用入力イベント サブシステムによって定義されたものです。
シンボリック名は、対応する Linux キー定数マクロ名と一致します。
xt 数値は、元の XT キーボード コントローラーによって定義されたものです。 いいえ
記号名が提供されます
アセット1
数値は、AT キーボード コントローラーによって定義された値であり、セット 1 (別名 XT
互換セット）。 からの拡張キーコ アセット1 拡張キーコードとは異なる場合があります
xt コードセット。 記号名は提供されません
アセット2
数値は、AT キーボード コントローラーによって定義された数値であり、セット 2 です。
記号名が提供されます
アセット3
数値は、AT キーボード コントローラーによって定義された値であり、セット 3 (別名
PS/2互換セット）。 記号名は提供されません
os_x
数値は、OS-X キーボード入力サブシステムによって定義されたものです。 の
シンボリック名は、対応する OS-X キー定数マクロ名と一致します
xt_kbd
数値は、Linux KBD デバイスによって定義されたものです。 これらはバリアントです
元の XT コードセット上にあるが、拡張用に異なるエンコーディングを使用することが多い
キーコード。 記号名は提供されません。
win32
数値は、Win32 キーボード入力サブシステムによって定義されたものです。 の
シンボリック名は、対応する Win32 キー定数マクロ名と一致します
USB 数値は、キーボードの USB HID 仕様で定義されている数値です。
入力。 記号名は提供されません
rfb 数値は、未加工の送信用に RFB 拡張によって定義されたものです。
キーコード。 これらは XT コードセットの変形ですが、拡張キーコードには
最初のバイトの上位ビットではなく、XNUMX 番目のバイト セットの下位ビット。 いいえ
記号名が提供されます。
例
# xt コードセットを使用して、XNUMX つのストローク 'k'、'e'、'y' を送信します。 これらは
# はすべて同時に押され、ゲストによって受信される場合があります
#順不同
virsh 送信キー dom --codeset xt 37 18 21
# 一筆送る 'right-ctrl+C'
virsh 送信キー dom KEY_RIGHTCTRL KEY_C
# タブを送信し、1 秒間押し続けます
virsh 送信キー --holdtime 1000 0xf
送信プロセスシグナル ドメイン ID ピッド 署名名
信号を送信する 署名名 によって識別されるプロセスに ピッド 仮想ドメインで実行中
ドメイン IDを選択します。 ピッド 仮想ドメイン名前空間のプロセス ID です。
当学校区の 署名名 引数は、整数の信号定数か、次のいずれかです。
記号名:
"nop", "hup", "int", "quit", "ill",
"trap", "abrt", "bus", "fpe", "kill",
「usr1」、「segv」、「usr2」、「パイプ」、「alrm」、
"term", "stkflt", "chld", "cont", "stop",
"tstp"、"ttin"、"ttou"、"urg"、"xcpu"、
"xfsz", "vtalrm", "prof", "winch", "poll",
「pwr」、「sys」、「rt0」、「rt1」、「rt2」、「rt3」、
「rt4」、「rt5」、「rt6」、「rt7」、「rt8」、「rt9」、
「rt10」、「rt11」、「rt12」、「rt13」、「rt14」、「rt15」、
「rt16」、「rt17」、「rt18」、「rt19」、「rt20」、「rt21」、
「rt22」、「rt23」、「rt24」、「rt25」、「rt26」、「rt27」、
「rt28」、「rt29」、「rt30」、「rt31」、「rt32」
シンボル名にはオプションで「sig」または「sig_」をプレフィックスとして付けることができ、
大文字または小文字。
例
virsh 送信プロセス信号 myguest 1 15
virsh send-process-signal myguest 1 項
virsh send-process-signal myguest 1 sigterm
virsh 送信プロセス信号 myguest 1 SIG_HUP
セットメモリ ドメイン サイズ [[--config] [- 住む] | [[- 現在]]
ゲスト ドメインのメモリ割り当てを変更します。 もしも - 住む が指定されている場合、
実行中のゲストのメモリ バルーン。 もしも --config の次の起動に影響する
永続的なゲスト。 もしも - 現在 が指定されている場合、現在のゲストの状態に影響します。 両方
- 住む --config フラグを指定できますが、 - 現在 排他的です。 フラグがない場合
指定されている場合、ハイパーバイザーによって動作が異なります。
サイズ スケーリングされた整数です（を参照してください 注意事項 その上）; デフォルトはキビバイト (1024 のブロック)
バイト) サフィックス (および古いオプション名) を指定しない限り --キロバイト が利用可能
非推奨のシノニムとして）。 libvirt は最も近いキビバイトに切り上げます。 いくつかの
ハイパーバイザーは KiB よりも大きな粒度を必要とし、リクエストは偶数ではない
複数は切り上げられます。 たとえば、vSphere/ESX はパラメータを次のように切り上げます。
メビバイト (1024 キビバイト)。
Xen の場合、実行中のドメインのメモリを調整できるのは、ドメインが次の場合のみです。
準仮想化または PV バルーン ドライバーの実行。
LXC の場合、設定される値は limit_in_bytes の cgroups 値または最大値です。
ユーザー メモリの量 (ファイル キャッシュを含む)。 内部のメモリを表示する場合
コンテナ、これは / proc / meminfo 「MemTotal」値。 から値を表示すると、
ホスト、 おとなしい メムチューン 指図。 現在使用中のメモリを表示するには、
メモリを設定できる最大値。 おとなしい ドムインフォ
ユーザーパスワードの設定 ドメイン user password [--暗号化された]
のパスワードを設定します。 user ゲスト ドメインのアカウント。
If --暗号化された が指定されている場合、パスワードはすでに暗号化されているものと見なされます。
ゲスト OS で必要なメソッド。
QEMU/KVM の場合、ゲスト エージェントを構成して実行する必要があります。
setmaxmem ドメイン サイズ [[--config] [- 住む] | [[- 現在]]
ゲスト ドメインの最大メモリ割り当て制限を変更します。 もしも - 住む is
指定すると、実行中のゲストに影響します。 もしも --config の次の起動に影響する
永続的なゲスト。 もしも - 現在 が指定されている場合、現在のゲストの状態に影響します。 両方
- 住む --config フラグを指定できますが、 - 現在 排他的です。 フラグがない場合
指定されている場合、ハイパーバイザーによって動作が異なります。
QEMU/KVM などの一部のハイパーバイザーは、ライブ変更 (特に増加) をサポートしていません。
最大メモリ制限の。 永続的な構成変更でさえ、
一部のハイパーバイザー/構成で実行されます (QEMU の NUMA が有効なドメインなど)。
複雑な構成変更の場合は、コマンドを使用します edit 代わりに）。
サイズ スケーリングされた整数です（を参照してください 注意事項 その上）; デフォルトはキビバイト (1024 のブロック)
バイト) サフィックス (および古いオプション名) を指定しない限り --キロバイト が利用可能
非推奨のシノニムとして）。 libvirt は最も近いキビバイトに切り上げます。 いくつかの
ハイパーバイザーは KiB よりも大きな粒度を必要とし、リクエストは偶数ではない
複数は切り上げられます。 たとえば、vSphere/ESX はパラメータを次のように切り上げます。
メビバイト (1024 キビバイト)。
メムチューン ドメイン [--ハードリミット サイズ] [--ソフトリミット サイズ] [--swap-ハードリミット サイズ]
[--最小保証 サイズ] [[--config] [- 住む] | [[- 現在]]
ドメイン メモリ パラメータを表示または設定できます。 フラグがなければ、現在の
設定が表示されます。 でサポートされている場合、適切な制限が調整されます。
ハイパーバイザー。 LXC および QEMU/KVM のサポート --ハードリミット, --ソフトリミット,
--swap-ハードリミット. --最小保証 ESX ハイパーバイザーでのみサポートされます。 それぞれの
これらの制限は、スケーリングされた整数です (参照 注意事項 上記）、デフォルトはキビバイト
(1024 バイトのブロック) サフィックスが存在しない場合。 libvirt は最も近いものに切り上げます
キビバイト。 一部のハイパーバイザーは、KiB よりも大きな粒度を必要とし、それを要求します。
偶数でない倍数は切り上げられます。 たとえば、vSphere/ESX は
最大メビバイト (1024 キビバイト) のパラメーター。
If - 住む が指定されている場合、実行中のゲストに影響します。 もしも --config に影響します。
永続ゲストの次のブート。 もしも - 現在 が指定されている場合、現在のゲストに影響します
州。 両方 - 住む --config フラグを指定できますが、 - 現在 排他的です。 いいえ
flag が指定されている場合、ハイパーバイザーによって動作が異なります。
QEMU/KVM の場合、パラメーターは QEMU プロセス全体に適用されます。 したがって、
それらを数えると、ゲスト RAM、ゲスト ビデオ RAM、およびいくらかのメモリを追加する必要があります。
QEMU 自体のオーバーヘッド。 最後のピースは判断が難しいため、推測が必要です。
試してください。
LXC の場合、表示される hard_limit 値は、XML または
からの結果 おとなしい セットメモリ
--ハードリミット
ゲストが使用できる最大メモリ。
--ソフトリミット
メモリ競合中に適用するメモリ制限。
--swap-ハードリミット
ゲストが使用できる最大メモリーとスワップ。 これは難しいことではありません-
制限値が提供されます。
--最小保証
ゲストに保証される最小メモリ割り当て。
これらの制限の値として -1 を指定すると、無制限と解釈されます。
ブルキオチューン ドメイン [- 重さ 重量] [-- デバイスの重み デバイスの重み]
[--device-read-iops-sec デバイス読み取り iops 秒] [--device-write-iops-sec デバイス書き込み iops-
ドライ] [--device-read-bytes-sec デバイス読み取りバイト秒] [--device-write-bytes-sec デバイス-
書き込みバイト秒] [[--config] [- 住む] | [[- 現在]]
blkio パラメータを表示または設定します。 QEMU/KVM サポート - 重さ. - 重さ 範囲内です
[100、1000]。 カーネル 2.6.39 以降では、値は [10, 1000] の範囲になる可能性があります。
デバイスの重み は、XNUMX つまたは複数のデバイス/重量のペアをリストする単一の文字列です。
/path/to/device,weight、/path/to/device,weight の形式。 各重量は範囲内です
[100, 1000]、カーネル 10 以降の [1000, 2.6.39]、またはそのデバイスを削除するための値 0
デバイスごとのリスト。 文字列にリストされているデバイスのみが変更されます。 既存の
他のデバイスのデバイスごとの重みは変更されません。
デバイス読み取り iops 秒 XNUMX つ以上の device/read_iops_sec をリストする単一の文字列です
/path/to/device,read_iops_sec,/path/to/device,read_iops_sec の形式で表されます。
各 read_iops_sec は unsigned int 型の数値で、それを削除するには値 0 です
デバイスごとのリストから。 文字列にリストされているデバイスのみが変更されます。
他のデバイスの既存のデバイスごとの read_iops_sec は変更されません。
デバイス書き込み iops 秒 XNUMX つ以上の device/write_iops_sec をリストする単一の文字列です
ペア、int の形式
/path/to/device,write_iops_sec,/path/to/device,write_iops_sec. 各 write_iops_sec は
タイプが unsigned int の数値、値 0 はそのデバイスをデシス単位から削除します
リスト。 文字列にリストされているデバイスのみが変更されます。 既存のデバイスごと
他のデバイスの write_iops_sec は変更されません。
デバイス読み取りバイト秒 XNUMX つ以上の device/read_bytes_sec をリストする単一の文字列です
ペア、int の形式
/path/to/device,read_bytes_sec,/path/to/device,read_bytes_sec. 各 read_bytes_sec は
タイプが unsigned long long の数値、値 0 でそのデバイスを per-
決定リスト。 文字列にリストされているデバイスのみが変更されます。 既存の
他のデバイスのデバイス read_bytes_sec は変更されません。
デバイス書き込みバイト秒 XNUMX つ以上の device/write_bytes_sec をリストする単一の文字列です
ペア、int の形式
/path/to/device,write_bytes_sec,/path/to/device,write_bytes_sec. 各 write_bytes_sec
タイプが unsigned long long の数値で、値 0 はそのデバイスを per-
決定リスト。 文字列にリストされているデバイスのみが変更されます。 既存の
他のデバイスの device write_bytes_sec は変更されません。
If - 住む が指定されている場合、実行中のゲストに影響します。 もしも --config に影響します。
永続ゲストの次のブート。 もしも - 現在 が指定されている場合、現在のゲストに影響します
州。 両方 - 住む --config フラグを指定できますが、 - 現在 排他的です。 いいえ
flag が指定されている場合、ハイパーバイザーによって動作が異なります。
setvcpu ドメイン カウント [- 最大] [[--config] [- 住む] | [[- 現在]][- ゲスト]
ゲスト ドメインでアクティブな仮想 CPU の数を変更します。 デフォルトでは、このコマンド
アクティブなゲスト ドメインで動作します。 非アクティブなゲスト ドメインの設定を変更するには、
使用 --config フラグ。
当学校区の カウント 値は、ホスト、ハイパーバイザー、またはサーバーからの制限によって制限される場合があります。
ゲストドメインの元の説明。 Xen の場合、仮想のみを調整できます。
ドメインが準仮想化されている場合は、実行中のドメインの CPU。
Status --config フラグが指定されている場合、保存されている XML 構成に変更が加えられます
ゲストドメイン用であり、ゲストドメインが次に起動されたときにのみ有効になります。
If - 住む が指定されている場合、ゲストドメインがアクティブである必要があり、変更が行われます
すぐに。 両方の --config - 住む フラグは一緒に指定できます
ハイパーバイザーによってサポートされています。 ゲストが終了する前にこのコマンドが実行された場合
起動すると、ゲストが変更の処理に失敗する場合があります。
If - 現在 が指定されている場合、現在のゲストの状態に影響します。
フラグが指定されていない場合、 - 住む フラグが想定され、ゲストドメインは
アクティブ。 この状況では、ハイパーバイザーが --config フラグは
も想定されているため、XML 構成が調整されているかどうかは、
永続的に変更します。
If - ゲスト が指定されている場合、CPU の数は代わりにゲストで変更されます。
ハイパーバイザー。 このフラグはライブ ドメインでのみ使用でき、ゲスト エージェントが必要になる場合があります
ゲストで構成されます。
当学校区の - 最大 フラグは、ホットプラグ可能な仮想 CPU の最大数を制御します
次にドメインが起動されたとき。 そのため、それは --config
フラグであり、 - 住む または - 現在 フラグ。
shutdown ドメイン [- モード モードリスト]
ドメインを正常にシャットダウンします。 これは、実行するドメイン OS と連携します。
正常にシャットダウンするため、成功するという保証はなく、時間がかかる場合があります。
ドメインでシャットダウンする必要があるサービスに応じて、時間の長さは可変です。
シャットダウン時のドメインの正確な動作は、 シャットダウン時 パラメーター
ドメインの XML 定義で。
If ドメイン は一時的なものであり、ゲストがアクセスすると、スナップショットのメタデータは失われます。
実行は停止しますが、スナップショットの内容はまだ存在し、同じ内容の新しいドメイン
名前と UUID を使用して、スナップショット メタデータを復元できます。 スナップショット作成.
デフォルトでは、ハイパーバイザーは適切なシャットダウン方法を選択しようとします。 を指定するには
代替方法、 - モード パラメータはカンマ区切りのリストを指定できます。
「acpi」、「agent」、「initctl」、「signal」、および「paravirt」が含まれます。 その順番
ドライバーが試行する各モードは定義されておらず、指定された順序とは関係ありません。
virsh。 順序を厳密に制御するには、一度に XNUMX つのモードを使用して、
start ドメイン名または uuid [- コンソール] [--一時停止] [--自動破棄] [--バイパスキャッシュ]
[--強制ブート] [--pass-fds N、M、...]
(以前に定義された) 非アクティブなドメインを、最後のドメインから開始します。 管理保存 状態、
または、管理保存状態が存在しない場合は、フレッシュ ブートを介して。 次の場合、ドメインは一時停止されます。
--一時停止 オプションはドライバーによって使用およびサポートされています。 それ以外の場合は実行されます。
If - コンソール 要求されたら、作成後にコンソールにアタッチします。 もしも --自動破棄 is
要求された場合、virsh がそのゲストを閉じると、ゲストは自動的に破棄されます。
libvirt への接続、またはその他の方法で終了します。 もしも --バイパスキャッシュ が指定されており、
managedsave 状態が存在する場合、復元はファイル システム キャッシュを回避します。
動作が遅くなる場合があります。 もしも --強制ブート が指定されている場合、すべての managedsave 状態
破棄され、フレッシュ ブートが発生します。
If --pass-fds が指定されている場合、引数は開いているファイルのカンマ区切りのリストです
ゲストに渡す必要がある記述子。 ファイル記述子は再
ゲストで 3 から始まる番号が付けられます。これはコンテナー ベースでのみサポートされます。
仮想化。
サスペンド ドメイン
実行中のドメインを一時停止します。 メモリに保持されますが、スケジュールされることはありません。
履歴書 ドメイン
ドメインを一時停止状態から移動します。 これにより、以前に中断された
ドメインは、基盤となるハイパーバイザーによるスケジューリングの対象になりました。
ドンプムサスペンド ドメイン ターゲット [- 間隔]
実行中のドメインをこれらの状態のいずれかにサスペンドします (可能な ターゲット 値):
S3 ACPI状態に相当するメモリ
S4 ACPI 状態に相当するディスク
ハイブリッド RAM はディスクに保存されますが、電源はオフになりません
当学校区の - 間隔 引数は、ドメインが起動されるまでの秒数を指定します
一時停止された後 (以下も参照) ドンプムウェイクアップ）。 無制限のサスペンドの場合、デフォルトは 0 です
時間。 (この機能は現在、どのハイパーバイザー ドライバーでもサポートされていません。
使用済み。）。
このコマンドには、ゲスト エージェントがドメインの
ゲスト OS。
少なくとも QEMU の場合、ドメインのプロセスはターゲットが終了すると終了することに注意してください。
ディスクが使用され、libvirt がディスクのウェイクアップを求められると、新しいプロセスが起動されます。
ドメイン。 この結果、デバイスのホットプラグやメモリなどのランタイムの変更
で変更しない限り、設定は失われます。 --config フラグ。
ドンプムウェイクアップ ドメイン
ドメインを pmsuspended 状態からウェイクアップします (dompmsuspend によって、または
ゲスト自体）。 ではなく、pmsuspended 状態のゲストにウェイクアップを挿入します。
以前に要求された期間 (ある場合) が経過するのを待つよりも。 この操作
ドメインが実行されている場合、必ずしも失敗するとは限りません。
ttyコンソール ドメイン
ドメインの TTY コンソールに使用するデバイスを出力します。 情報がない場合
利用可能な場合、プロセスは終了コード 1 を提供します。
未定義 ドメイン [-- 管理保存] [--スナップショット-メタデータ] [--nvram] [{- 保管所 ボリューム |
--すべてのストレージを削除 [--削除-スナップショット]} --ワイプストレージ]
ドメインを定義解除します。 ドメインが実行中の場合、これにより一時的なドメインに変換されます。
止めずに。 ドメインが非アクティブの場合、ドメイン構成は削除されます。
当学校区の -- 管理保存 フラグは、すべてのマネージド セーブ イメージを保証します ( 管理保存
コマンド) もクリーンアップされます。 フラグなしで、ドメインを定義解除しようとします。
管理保存イメージは失敗します。
当学校区の --スナップショット-メタデータ フラグは、すべてのスナップショットが スナップショット リスト
コマンド) も、非アクティブなドメインの定義を解除するときにクリーンアップされます。 旗がなければ、
スナップショット メタデータを使用して非アクティブなドメインを定義解除しようとすると失敗します。 もし
ドメインがアクティブな場合、このフラグは無視されます。
当学校区の --nvram フラグは、nvram (/domain/os/nvram/) ファイルが取り残されないようにします。 もし
ドメインに nvram ファイルがあり、フラグが省略されている場合、未定義は失敗します。
当学校区の - 保管所 flag はパラメータを取ります ボリュームのカンマ区切りのリストです。
削除するストレージ ボリュームのボリューム ターゲット名またはソース パス
未定義のドメイン。 ボリュームは未定義にすることができるため、非アクティブなドメインでのみ削除できます。
ボリュームの削除は、ドメインが未定義になった後にのみ試行されます。 すべてではないにしても
要求されたボリュームは削除される可能性があります。エラー メッセージにはまだ何が残っているかが示されます
後ろ。 ドメイン定義にボリューム パスが見つからない場合は、
ボリュームが正常に削除されました。 ストレージプールで libvirt によって管理されるボリュームのみが
このように削除されます。 （見る ドンブルリスト に関連付けられたターゲット名のリスト
ドメイン）。 例: --storage vda,/path/to/storage.img
当学校区の --すべてのストレージを削除 フラグは、ドメインのすべてのストレージ ボリュームが
削除する必要があります。
当学校区の --削除-スナップショット フラグは、ストレージに関連付けられたすべてのスナップショットを指定します
ボリュームも削除する必要があります。 が必要です --すべてのストレージを削除 なるフラグ
提供された。 すべてのストレージ ドライバがこのオプションをサポートしているわけではありません。現在は rbd のみです。
旗 --ワイプストレージ 前にストレージ ボリュームをワイプする必要があることを指定します。
推奨されます。
注: 非アクティブなドメインの場合、ドメイン名または UUID を使用する必要があります。 ドメイン.
vcpu カウント ドメイン [{- 最大 | - アクティブ}{--config | - 住む | - 現在}] [- ゲスト]
指定された仮想 CPU カウントに関する情報を出力します ドメイン. フラグがない場合
指定すると、考えられるすべてのカウントが表にリストされます。 それ以外の場合、出力は制限されます
要求された数値だけに。 歴史的な理由から、表には
を介して単独でクエリできる行に「現在」のラベルを付けます。 - アクティブ 国旗、
に関係するのではなく、 - 現在 フラグ。
- 最大 ドメインが追加できる vcpus の最大上限に関する情報を要求します
setvcpu一方、 - アクティブ 現在の使用状況を示します。 これら XNUMX つのフラグの両方を指定することはできません
指定。 --config 永続的なドメインを必要とし、に関する情報を要求します
次にドメインが起動されるとき、 - 住む 実行中のドメインとリストが必要です
現在の値、および - 現在 ドメインの現在の状態に応じたクエリ
（対応する - 住む 実行中の場合、または --config 非アクティブの場合); このXNUMXつのフラグは
相互に排他的。
If - ゲスト が指定されている場合、CPU のカウントは次の観点から報告されます。
お客様。 このフラグはライブ ドメインでのみ使用でき、ゲスト エージェントが必要になる場合があります。
ゲストで構成されます。
vcpuinfo ドメイン [- かわいい]
vCPU の数など、ドメインの仮想 CPU に関する基本情報を返します。
実行時間、物理プロセッサへの親和性。
自律的AI - かわいい、CPU アフィニティは範囲として表示されます。
VCPUPIN ドメイン [VCPU] [キュピリスト] [[- 住む] [--config] | [[- 現在]]
ホスト物理 CPU へのドメイン VCPU のピニングを照会または変更します。 シングルを固定するには
VCPU、指定する キュピリスト; それ以外の場合は、クエリを実行できます VCPU または省略 VCPU ですべてをリストする
一度。
キュピリスト 物理 CPU 番号のリストです。 その構文は、カンマ区切りのリストと
「-」と「^」を使用した特別なマークアップ (例: 「0-4」、「0-3、^2」) も許可されます。 「-」
は範囲を示し、「^」は排他的であることを示します。 ピン留めには VCPU すべてのフィジカルに
cpu として 'r' を指定します キュピリスト。 場合 - 住む が指定されている場合、実行中のゲストに影響します。 もしも
--config が指定されている場合、永続ゲストの次回の起動に影響します。 もしも - 現在 is
指定すると、現在のゲストの状態に影響します。 両方 - 住む --config フラグはあるかもしれない
与えられた場合 キュピリスト 存在しますが、 - 現在 排他的です。 フラグが指定されていない場合は、
ハイパーバイザーによって動作が異なります。
注意: 式は順番に評価されるため、"0-15,^8" は
"9-14,0-7,15" ですが、"^8,0-15" とは異なります。
エミュレータピン ドメイン [キュピリスト] [[- 住む] [--config] | [[- 現在]]
ホスト物理 CPU へのドメインのエミュレーター スレッドの固定を照会または変更します。
詳細はこちら： VCPUPIN の キュピリスト.
If - 住む が指定されている場合、実行中のゲストに影響します。 もしも --config に影響します。
永続ゲストの次のブート。 もしも - 現在 が指定されている場合、現在のゲストに影響します
州。 両方 - 住む --config 次の場合にフラグを指定できます キュピリスト 存在しますが、
- 現在 排他的です。 フラグが指定されていない場合、動作は次の条件によって異なります。
ハイパーバイザー。
vncディスプレイ ドメイン
VNC ディスプレイ用の IP アドレスとポート番号を出力します。 情報がない場合
利用可能な場合、プロセスは終了コード 1 を提供します。
デバイス コマンド
次のコマンドは、ドメインに関連付けられたデバイスを操作します。 の ドメイン することができます
短い整数、名前、または完全な UUID として指定します。 価値観をより理解するために
でドキュメントを読むコマンドのオプションとして許可されています
<http://libvirt.org/formatdomain.html> 取得するデバイス セクションの形式について
受け入れられた値の最も正確なセット。
接続デバイス ドメイン FILE [[[- 住む] [--config] | [[- 現在]] | [- 持続的に]]
デバイスを使用して XML ファイルのデバイス定義を使用して、デバイスをドメインに接続します。
などの定義要素また最上位要素として。 を参照してください
ドキュメントhttp://libvirt.org/formatdomain.html#elementsDevices> について学ぶ
デバイスの libvirt XML 形式。 もしも --config コマンドが指定されている
デバイスの接続が次回有効になる永続的なドメイン構成
libvirt がドメインを開始します。 CDROM およびフロッピー デバイスの場合、このコマンドは
既存のデバイス内のメディア。 使用を検討する 更新デバイス この用途に。 ために
パススルー ホスト デバイス。 nodedev-デタッチ、PCI デバイスがない場合に必要
管理モードを使用します。
If - 住む が指定されている場合、実行中のドメインに影響します。 もしも --config に影響します。
永続ドメインの次回の起動。 もしも - 現在 が指定されている場合、電流に影響を与えます
ドメイン状態。 両方 - 住む --config フラグを指定できますが、 - 現在 is
エクスクルーシブ。 フラグが指定されていない場合、レガシー API が使用され、その動作は
ハイパーバイザー ドライバー。
互換性のために、 - 持続的に のように振る舞う --config オフライン ドメインの場合、
好きな - 住む --config 実行中のドメイン用。
注意: 部分的なデバイス定義 XML ファイルを使用すると、予期しない結果が生じる可能性があります。
一部のフィールドは自動生成されるため、予期しないデバイスと一致する場合があります。
アタッチディスク ドメイン source ターゲット [[[- 住む] [--config] | [[- 現在]] | [- 持続的に]]
[--ターゲットバス バス] [- 運転者 ドライバー] [--サブドライバー サブドライバー] [--iothread iothread] [- キャッシュ
キャッシュ] [- タイプ type] [- モード モード] [- ソースの種類 ソースの種類] [- シリアル シリアル] [--wwn ｗｗｗ]
[--ラビオ] [- 住所 住所] [--多機能] [--print-xml]
新しいディスク デバイスをドメインに接続します。 source ファイルとデバイスのパスです。
ターゲット ディスクがゲスト OS に公開されるバスまたはデバイスを制御します。 それ
「論理」デバイス名を示します。 オプション ターゲットバス 属性は、
エミュレートするディスク デバイスのタイプ。 可能な値はドライバー固有であり、典型的な
価値観 IDE, SCSI, バーティオ, ゼン, USB, SATAまたは sd、省略した場合、バスの種類は
デバイス名のスタイルから推測されます (たとえば、「sda」という名前のデバイスは通常、
SCSI バスを使用してエクスポートできます)。 ドライバー することができます file, タップ or phy Xen ハイパーバイザーの場合
アクセスの種類に応じて。 また qemu QEMU エミュレータ用。 詳細は
ドライバーは次を使用して渡すことができます サブドライバー. Xenの場合 サブドライバー することができます AIO、QEMUの場合
サブドライバーは、次のようなディスク ソースの形式と一致する必要があります。 生 or qcow2.
次の場合、ハイパーバイザーのデフォルトが使用されます。 サブドライバー 指定されていません。 ただし、デフォルト
特に、正しくない可能性があります。 QEMU の場合、セキュリティ上の理由から、そうしないように構成されています
ディスクフォーマットを検出します。 type 示すことができます モン, CDROM or フロッピーディスク の代替として
ディスクのデフォルト。ただし、この使用は既存の仮想ディスク内のメディアを置き換えるだけです。
cdrom またはフロッピー デバイス。 使用を検討する 更新デバイス 代わりにこの使用法のために。 モード できる
XNUMX つの特定のモードを指定する 読み取り専用 or 共有可能. ソースの種類 タイプを示すことができます
ソース (ブロック|ファイル) キャッシュ "default"、"none"、"writethrough"、
「writeback」、「directsync」、または「unsafe」。 iothread の範囲内の数値です。
ドメイン このディスクが接続される IOThreads (QEMU のみ)。 シリアル シリアルです
ディスクデバイスの。 ｗｗｗ ディスクデバイスのwwnです。 ローオ ディスクが rawio を必要とすることを示します
能力。 住所 形式のディスク デバイスのアドレスです。
pci:domain.bus.slot.function、scsi:controller.bus.unit、ide:controller.bus.unit または
ccw:cssid.ssid.devno. Virtio-ccw デバイスでは、cssid を 0xfe に設定する必要があります。
多機能 指定された pci アドレスが多機能 pci デバイス アドレスであることを示します。
If --print-xml が指定されている場合、接続されるディスクの XML は
代わりに印刷されます。
If - 住む が指定されている場合、実行中のドメインに影響します。 もしも --config に影響します。
永続ドメインの次回の起動。 もしも - 現在 が指定されている場合、電流に影響を与えます
ドメイン状態。 両方 - 住む --config フラグを指定できますが、 - 現在 is
エクスクルーシブ。 フラグが指定されていない場合、レガシー API が使用され、その動作は
ハイパーバイザー ドライバー。
互換性のために、 - 持続的に のように振る舞う --config オフライン ドメインの場合、
好きな - 住む --config 実行中のドメイン用。 同じく、 --共有可能 のエイリアスです
- モード 共有可能.
接続インターフェース ドメイン type source [[[- 住む] [--config] | [[- 現在]] | [- 持続的に]]
[- 目標 ターゲット] [- マック MAC] [- 脚本 スクリプト] [- モデル ] [-- インバウンド
平均、ピーク、バースト、フロア] [--アウトバウンド 平均、ピーク、バースト] [--管理された] [--print-xml]
新しいネットワーク インターフェイスをドメインに接続します。
type 次のいずれかになります。
ネットワーク libvirt 仮想ネットワーク経由の接続を示すには、
ブリッジ ホスト上のブリッジ デバイス経由の接続を示すには、
直接 ホストのネットワーク インターフェイスの XNUMX つへの直接接続を示すため、または
橋、
ホスト開発者 ホスト上の PCI デバイスのパススルーを使用して接続を示します。
source 接続のソースを示します。 ソースは種類によって異なります。
インタフェース：
ネットワーク 仮想ネットワークの名前、
ブリッジ ブリッジデバイスの名前、
直接 ホストのインターフェースまたはブリッジの名前
ホスト開発者 としてフォーマットされたホストのインターフェースの PCI アドレス
ドメイン:バス:スロット.関数。
- 目標 ドメインを接続するために使用するtap/macvtapデバイスを指定するために使用されます
起源。 「vnet」で始まる名前は自動生成されたと見なされ、
インターフェイスが接続されるたびに消去/再生成されます。
- マック ネットワーク インターフェイスの MAC アドレスを指定します。 MAC アドレスが
指定すると、新しいアドレスが自動的に生成されます (そして、永続的な
コマンドラインで「--config」が指定されている場合の構成）。
- 脚本 へのアタッチ中に呼び出されるカスタムスクリプトへのパスを指定するために使用されます
ブリッジ - これはデフォルトのスクリプトの代わりに呼び出され、追加ではありません。
これは、のインターフェースに対してのみ有効です。 ブリッジ タイプであり、Xen ドメインのみ。
- モデル ドメインに提示するネットワーク デバイス モデルを指定します。
-- インバウンド --アウトバウンド インターフェイスの帯域幅を制御します。 から少なくとも XNUMX つ
平均, 床 ペアを指定する必要があります。 他の二人 ピーク バースト オプションです。
したがって、「平均、ピーク」、「平均、バースト」、「平均、、、床」、「平均」、および「、、、床」は
また合法。 の値 平均, 床 ピーク XNUMX 秒あたりのキロバイト数で表されます。
while バースト での単一バーストのキロバイト単位で表されます。 ピーク で説明されている速度
次のネットワーク XML ドキュメントhttp://libvirt.org/formatnetwork.html#要素QoS>.
--管理された にのみ使用できます ホスト開発者 と入力し、インターフェイスが必要であることを libvirt に伝えます。
つまり、libvirt によってホストから切り離され、ホストに再接続されます。
If --print-xml が指定されている場合、接続されるインターフェースの XML は次のとおりです。
代わりに印刷されます。
If - 住む が指定されている場合、実行中のドメインに影響します。 もしも --config に影響します。
永続ドメインの次回の起動。 もしも - 現在 が指定されている場合、電流に影響を与えます
ドメイン状態。 両方 - 住む --config フラグを指定できますが、 - 現在 is
エクスクルーシブ。 フラグが指定されていない場合、レガシー API が使用され、その動作は
ハイパーバイザー ドライバー。
互換性のために、 - 持続的に のように振る舞う --config オフライン ドメインの場合、
好きな - 住む --config 実行中のドメイン用。
注意: オプションのターゲット値は、バックエンドとして作成されるデバイスの名前です
ノード上。 指定されていない場合、「vnetN」または「vifN」という名前のデバイスが作成されます
自動的に。
デタッチ デバイス ドメイン FILE [[[- 住む] [--config] | [[- 現在]] | [- 持続的に]]
ドメインからデバイスを切り離し、コマンドと同じ種類の XML 記述を受け取ります
接続デバイス. パススルー ホスト デバイスについては、こちらも参照してください。 nodedev-再接続、必要な場合
デバイスは管理モードを使用しません。
注意: 提供されるデバイスの XML 記述は、そのデバイスと同じくらい具体的である必要があります。
ドメイン XML での定義。 デバイスの照合に使用される属性のセットは次のとおりです。
ドライバーの内部。 部分的な定義を使用するか、デバイスを切り離そうとしています
ドメイン XML には存在しないが、いくつかの特定の属性を XNUMX つと共有する
が存在すると、予期しない結果につながる可能性があります。
If - 住む が指定されている場合、実行中のドメインに影響します。 もしも --config に影響します。
永続ドメインの次回の起動。 もしも - 現在 が指定されている場合、電流に影響を与えます
ドメイン状態。 両方 - 住む --config フラグを指定できますが、 - 現在 is
エクスクルーシブ。 フラグが指定されていない場合、レガシー API が使用され、その動作は
ハイパーバイザー ドライバー。
互換性のために、 - 持続的に のように振る舞う --config オフライン ドメインの場合、
好きな - 住む --config 実行中のドメイン用。
古いバージョンの virsh が使用されていることに注意してください。 --config エイリアスとして - 持続的に.
ディスクの取り外し ドメイン ターゲット [[[- 住む] [--config] | [[- 現在]] | [- 持続的に]]
ドメインからディスク デバイスを切り離します。 の ターゲット ドメインから見たデバイスです。
If - 住む が指定されている場合、実行中のドメインに影響します。 もしも --config に影響します。
永続ドメインの次回の起動。 もしも - 現在 が指定されている場合、電流に影響を与えます
ドメイン状態。 両方 - 住む --config フラグを指定できますが、 - 現在 is
エクスクルーシブ。 フラグが指定されていない場合、レガシー API が使用され、その動作は
ハイパーバイザー ドライバー。
互換性のために、 - 持続的に のように振る舞う --config オフライン ドメインの場合、
好きな - 住む --config 実行中のドメイン用。
古いバージョンの virsh が使用されていることに注意してください。 --config エイリアスとして - 持続的に.
デタッチ インターフェイス ドメイン type [- マック MAC] [[[- 住む] [--config] | [[- 現在]] |
[- 持続的に]]
ドメインからネットワーク インターフェイスを切り離します。 type どちらでもかまいません ネットワーク を示すために
物理ネットワーク デバイスまたは ブリッジ デバイスへのブリッジを示します。 それをお勧めします
使用します MAC 複数のインターフェイスがある場合にインターフェイスを区別するオプション
ドメインに存在します。
If - 住む が指定されている場合、実行中のドメインに影響します。 もしも --config に影響します。
永続ドメインの次回の起動。 もしも - 現在 が指定されている場合、電流に影響を与えます
ドメイン状態。 両方 - 住む --config フラグを指定できますが、 - 現在 is
エクスクルーシブ。 フラグが指定されていない場合、レガシー API が使用され、その動作は
ハイパーバイザー ドライバー。
互換性のために、 - 持続的に のように振る舞う --config オフライン ドメインの場合、
好きな - 住む --config 実行中のドメイン用。
古いバージョンの virsh が使用されていることに注意してください。 --config エイリアスとして - 持続的に.
更新デバイス ドメイン file [- 力] [[[- 住む] [--config] | [[- 現在]] | [- 持続的に]]
関連付けられているデバイスの特性を更新します ドメイン、デバイスに基づく
XML での定義 fileを選択します。 - 力 オプションを使用して、デバイスの更新を強制することができます。
たとえば、ドメインでロック/マウントされている場合でも CD-ROM を取り出します。 を参照してください
ドキュメントhttp://libvirt.org/formatdomain.html#elementsDevices> について学ぶ
デバイスの libvirt XML 形式。
If - 住む が指定されている場合、実行中のドメインに影響します。 もしも --config に影響します。
永続ドメインの次回の起動。 もしも - 現在 が指定されている場合、電流に影響を与えます
ドメイン状態。 両方 - 住む --config フラグを指定できますが、 - 現在 is
エクスクルーシブ。 フラグを指定しないことは、指定することと同じです - 現在.
互換性のために、 - 持続的に のように振る舞う --config オフライン ドメインの場合、
好きな - 住む --config 実行中のドメイン用。
古いバージョンの virsh が使用されていることに注意してください。 --config エイリアスとして - 持続的に.
注意: 部分的なデバイス定義 XML ファイルを使用すると、予期しない結果が生じる可能性があります。
一部のフィールドは自動生成されるため、予期しないデバイスと一致する場合があります。
変更メディア ドメイン path [-イジェクト] [- 入れる] [- 更新] [source] [- 力] [[- 住む]
[--config] | [[- 現在]][--print-xml] [- ブロック]
CDROM またはフロッピー ドライブのメディアを変更します。 path 完全修飾パスまたは
一意のターゲット名 ( ) ディスク デバイスの。 source パスを指定します
挿入または更新するメディアの。 国旗 - ブロック バッキングタイプを設定できます
ファイルではなく、ブロック デバイスが CDROM またはフロッピー ドライブのメディアとして使用される場合。
-イジェクト メディアが排出されることを示します。 - 入れる メディアが
挿入されました。 source を指定する必要があります。 デバイスにソースがある場合 (例:
file='media'>)、および source 指定されていません、 - 更新 等しい -イジェクト。 もし
デバイスにソースがなく、 source 指定されている、 - 更新 等しい - 入れる。 もし
デバイスにはソースがあり、 source 指定されている、 - 更新 の組み合わせのように動作します
-イジェクト - 入れる。 どれも無い場合 -イジェクト, - 入れる, - 更新 指定されている、
- 更新 がデフォルトで使用されます。 の - 力 オプションを使用して、メディアの変更を強制できます。
If - 住む が指定されている場合、実行中のゲストのライブ構成を変更します。 もしも --config is
指定され、永続的な構成を変更し、次回の起動時に影響が観察されます。 - 現在
のいずれかまたは両方を指定できます ライブ 設定、ハイパーバイザーの実装に依存します。
両方 - 住む --config フラグを指定できますが、 - 現在 排他的です。 フラグがない場合
指定されている場合、ハイパーバイザーによって動作が異なります。 もしも --print-xml is
指定すると、メディアを変更するために使用される XML が変更される代わりに出力されます。
メディア。
ノードデブ コマンド
次のコマンドは、パススルーされるホスト デバイスを操作します。
経由のゲストドメインドメインの要素セクション。 ノード デバイス キー
通常、バス名とそのアドレスによって指定され、その間にアンダースコアが使用されます。
pci_0000_00_02_1、usb_1_5_3、net_eth1_00_27_13_6a_fe_00 などのすべてのコンポーネント。 の
ノード開発リスト libvirt に認識されているホストデバイスの完全なリストを提供しますが、これは
ゲストに割り当てることができないデバイスが含まれます (たとえば、
ゲストのディスク イメージが格納されるホストのハードディスク コントローラを制御する PCI デバイス
live では、ホスト システムがロックアップまたは再起動する可能性があります)。
ノード デバイス定義の詳細については、次を参照してください。http://libvirt.org/formatnode.html>.
パススルー デバイスは、ホストとそのゲスト ドメインで同時に使用することはできません。
一度に複数のアクティブなゲストによって。 もしPCI デバイスの説明には以下が含まれます
属性 マネージ = 'はい'であり、ハイパーバイザー ドライバーがそれをサポートしている場合、デバイスは
アクティブなゲストでそのパススルー デバイスを使用しようとすると、
のように自動的に動作します。 nodedev-デタッチ (ゲスト スタート、デバイスのホットプラグ) および ノード開発-
再接続 (ゲスト停止、デバイスのホットアンプラグ) が適切なポイントで呼び出されました。 PCI デバイスの場合
管理対象としてマークされていない場合、ゲストが使用できるようにするには、手動でデタッチする必要があります。
ホストに戻すために手動で再接続します。 また、デバイスが手動で切り離された場合、
ホストは、一致する再接続がなければ、デバイスの制御を回復しません。
ゲストは管理モードでデバイスを使用します。
ノード開発-作成 FILE
仮想マシンに割り当てることができるデバイスをホスト ノードに作成します。
通常、libvirt は使用可能なホストノードを自動的に判別できます。
ただし、これにより、libvirt では登録できなかったホスト ハードウェアの登録が可能になります。
自動的に検出します。 file トップレベルのxmlが含まれていますの説明
ノード デバイス。
ノード開発-破壊 デバイス
ホスト上のデバイスを破棄 (停止) します。 デバイス のデバイス名または wwn ペアのいずれかです。
「wwnn,wwpn」形式 (現在、vHBA でのみ機能)。 これにより libvirt が終了することに注意してください
ホスト デバイスを管理し、そのデバイスを残りのデバイスで使用できなくすることさえあります。
再起動するまで物理ホスト。
nodedev-デタッチ ノード開発 [- 運転者 バックエンドドライバー]
デタッチ ノード開発 ホストから、ゲストが安全に使用できるように
パススルー。 これは nodedev-再接続、および自動的に行われます
管理対象デバイス。 互換性のために、このコマンドのスペルも
nodedev-デタッチ.
異なるバックエンド ドライバーは、デバイスが異なるダミー デバイスにバインドされることを想定しています。
たとえば、QEMU の「kvm」バックエンド ドライバー (デフォルト) は、デバイスがバインドされていることを想定しています。
ただし、その「vfio」バックエンド ドライバーは、デバイスが vfio-pci にバインドされていることを想定しています。
当学校区の - 運転者 パラメータを使用して、目的のバックエンド ドライバを指定できます。
ノードdev-dumpxml デバイス
ダンプそのようなものを含む、指定されたノード デバイスの XML 表現
デバイス名、デバイスを所有するバス、ベンダーおよび製品 ID などの情報
libvirt で使用可能なデバイスの機能 (デバイスのリセットが有効かどうかなど)
サポートされています）。 デバイス デバイス名または "wwnn,wwpn" 形式の wwn ペアのいずれかです (
HBA で動作します)。
ノード開発リスト キャップ - 木
libvirt によって認識される、ノードで使用可能なすべてのデバイスを一覧表示します。 キャップ 使用されている
リストを機能タイプでフィルタリングするには、タイプをカンマで区切る必要があります。
--cap pci,scsi, 有効な機能タイプには、'system'、'pci'、'usb_device'、'usb'、
「ネット」、「scsi_host」、「scsi_target」、「scsi」、「ストレージ」、「fc_host」、「vports」、
「scsi_generic」。 もしも - 木 を使用すると、出力はツリー形式でフォーマットされます。
各ノードの親。 キャップ - 木 相互に排他的です。
nodedev-再接続 ノード開発
それを宣言する ノード開発 どのゲストにも使用されておらず、ホストが再開できること
デバイスの通常の使用。 これは、マネージド モードの PCI デバイスに対して自動的に行われます。
および USB デバイスに一致するように明示的に行う必要があります。 nodedev-デタッチ.
nodedev-リセット ノード開発
デバイスのリセットをトリガーする ノード開発間でノード デバイスを転送する前に役立ちます。
ゲスト パススルーまたはホスト。 Libvirt は、多くの場合、このアクションを暗黙的に実行します。
必要ですが、このコマンドは必要に応じて明示的なリセットを許可します。
バーチャル NETWORK コマンド
次のコマンドは、ネットワークを操作します。 libvirt には仮想を定義する機能があります
これはドメインによって使用され、実際のネットワーク デバイスにリンクされます。 多くのための
この機能の詳細については、次のドキュメントを参照してください。
<http://libvirt.org/formatnetwork.html> . 仮想ネットワークのコマンドの多くは、
ドメインに使用されるものと似ていますが、仮想ネットワークに名前を付ける方法は次のいずれかです
その名前または UUID。
ネット自動起動 ネットワーク [-無効にする]
起動時に自動的に開始されるように仮想ネットワークを構成します。 の -無効にする オプション
自動起動を無効にします。
ネット作成 file
XML から一時的な (一時的な) 仮想ネットワークを作成する file そしてインスタンス化します
（開始）ネットワーク。 次のドキュメントを参照してください。http://libvirt.org/formatnetwork.html>
libvirt が使用する XML ネットワーク形式の説明を取得します。
ネット定義 file
非アクティブな永続的な仮想ネットワークを定義するか、既存の永続的な仮想ネットワークを変更します
XML から file.
ネット破壊 ネットワーク
名前で指定された特定の一時的または永続的な仮想ネットワークを破棄 (停止) します
またはUUID。 これはすぐに有効になります。
ネットダンプxml ネットワーク [- 非活性]
仮想ネットワーク情報を XML ダンプとして stdout に出力します。 もしも - 非活性 is
指定されている場合、物理機能は関連付けられた仮想に拡張されません
機能します。
ネット編集 ネットワーク
ネットワークの XML 構成ファイルを編集します。
これは次と同等です。
virsh net-dumpxml -- 非アクティブ ネットワーク > network.xml
vi network.xml (または他のテキスト エディターで変更)
virsh net-define network.xml
ただし、いくつかのエラー チェックを行います。
使用されるエディターは、$VISUAL または $EDITOR 環境変数によって提供されます。
デフォルトは「vi」です。
ネットイベント {[ネットワーク] イベント [- ループ] [- タイムアウト 秒] [-タイムスタンプ] | - リスト}
ネットワークイベントのクラスが発生するのを待ち、イベントの適切な詳細を出力します
彼らが起こるように。 イベントは、オプションで次のようにフィルタリングできます。 ネットワーク。 使い方 - リスト as
唯一の引数は可能なリストを提供します イベント このクライアントが知っている値、
ただし、接続によってこれらすべてのイベントの登録が許可されない場合があります。
デフォルトでは、このコマンドはワンショットで、イベントが発生すると成功を返します。 あなた
SIGINT を (通常は "Ctrl-C" 経由で) 送信して、すぐに終了することができます。 もしも - タイムアウト is
指定すると、コマンドはイベントの待機を断念します。 秒 経過しました。 と
- ループ、コマンドは、タイムアウトまたは割り込みキーまでのすべてのイベントを出力します。
日時 -タイムスタンプ が使用されると、人間が判読できるタイムスタンプがイベントの前に出力されます。
ネット情報 ネットワーク
に関する基本情報を返します。 ネットワーク オブジェクト。
ネットリスト [- 非活性 | - すべて] { [- テーブル] | - 名前 | --uuid } [- 持続的に]
[<--一時的>] [- 自動スタート] [<--自動起動なし>]
アクティブなネットワークのリストを返します。 - すべて が指定されており、これにも含まれます
定義されているが非アクティブなネットワーク - 非活性 非アクティブなものだけが指定されます
リストされます。 返されたネットワークを次のようにフィルタリングすることもできます。 - 持続的に リストする
しつこいもの、 --一時的な 一時的なものをリストするには、 - 自動スタート リストする
自動起動が有効になっているもの、および --自動起動なし 自動起動するものをリストする
無効にする。
If - 名前 が指定されている場合、表形式のネットワーク名の代わりにネットワーク名が出力されます
行ごと。 もしも --uuid 指定すると、名前の代わりにネットワークの UUID が出力されます。 国旗
- テーブル 従来の表形式の出力を使用することを指定します。 これは
デフォルト。 これらはすべて相互に排他的です。
注: 古いサーバーと通信する場合、このコマンドは一連の API の使用を強制されます。
プールがリストされていないか、より多く表示される可能性がある、固有のレースを持つ呼び出し
リストの収集中に呼び出し間で状態が変化した場合は、XNUMX 回以上。 新しい
サーバーにはこの問題はありません。
ネット名 ネットワーク-UUID
ネットワーク UUID をネットワーク名に変換します。
ネットスタート ネットワーク
(以前に定義された) 非アクティブなネットワークを開始します。
ネット未定義 ネットワーク
永続的なネットワークの構成を未定義にします。 ネットワークがアクティブな場合は、ネットワークを作成します
一時的な。
ネット UUID ネットワーク名
ネットワーク名をネットワーク UUID に変換します。
ネット更新 ネットワーク command XML [--親インデックス index] [[- 住む] [--config] |
[- 現在]]
変更を加えて、既存のネットワーク定義の特定のセクションを更新します
必要に応じて、すぐに有効になり、破棄して再起動する必要はありません
ネットワーク。
command "add-first"、"add-last"、"add" (add-last と同義)、"delete"、
または「変更」。
「ブリッジ」、「ドメイン」、「ip」、「ip-dhcp-host」、「ip-dhcp-range」のいずれかです。
「forward」、「forward-interface」、「forward-pf」、「portgroup」、「dns-host」、「dns-txt」、または
「dns-srv」、各セクションは xml 要素階層の連結によって名前が付けられます
変更される要素につながります。 たとえば、「ip-dhcp-host」は
内に含まれる要素内の要素の要素
ネットワーク。
XML 変更されるタイプの完全な xml 要素のテキスト (例:
"
完全な xml 要素。 あいまいさは、最初の文字を見ることによって行われます
提供されたテキスト - 最初の文字が「<」の場合は xml テキスト、最初の文字が「<」の場合は xml テキスト
"<" ではなく、使用する xml テキストを含むファイルの名前です。
当学校区の --親インデックス オプションは、いくつかの親要素のどれを指定するために使用されます
要求された要素は (0 ベース) です。 たとえば、dhcp 要素は任意の場所にある可能性があります
複数のうちのXNUMXつネットワーク内の要素; 親インデックスが提供されていない場合、
"最適な" 要素が選択されます (通常、既に選択されている要素のみが選択されます)。
があります要素)、しかし場合 --親インデックス が与えられ、その特定のインスタンス
修正を取得します。
If - 住む 実行中のネットワークに影響を与えます。 もしも --config 指定され、影響を与える
永続的なネットワークの次の起動。 もしも - 現在 に影響します。
現在のネットワーク状態。 両方 - 住む --config フラグを指定できますが、 - 現在 is
エクスクルーシブ。 フラグを指定しないことは、指定することと同じです - 現在.
net-dhcp-リース ネットワーク [MAC]
指定された仮想ネットワークに接続されているすべてのネットワーク インターフェイスの dhcp リースのリストを取得します
ネットワーク または、XNUMX つのインターフェイスのみの出力が制限されている場合 MAC 指定されています。
INTERFACE コマンド
次のコマンドは、ホスト インターフェイスを操作します。 多くの場合、これらのホスト インターフェイスは、
ドメイン内で名前によって使用される要素 (システムで作成されたブリッジなど)
インターフェイス)、ただし、ホスト インターフェイスを特定のインターフェイスに関連付ける必要はありません。
ゲスト構成 XML はまったくありません。
ホスト インターフェイスのコマンドの多くは、ドメインに使用されるものと似ています。
インターフェイスに名前を付ける方法は、名前または MAC アドレスのいずれかです。 ただし、MAC を使用して
のアドレス アイフェイス 引数は、そのアドレスが一意である場合にのみ機能します (インターフェイスと
ブリッジが同じ MAC アドレスを共有している場合 (これはよくあることです)、その MAC アドレスを使用します。
あいまいさのためにエラーが発生するため、代わりに名前を使用する必要があります)。
iface ブリッジ インタフェース ブリッジ [--no-stp] [遅らせる] [--開始しない]
という名前のブリッジ デバイスを作成します。 ブリッジ、既存のネットワーク デバイスを接続します。 インタフェース
新橋へ。 新しいブリッジはデフォルトで、STP が有効な状態ですぐに開始されます
および 0 の遅延。 これらの設定は、 --no-stp, --開始しない、および
の整数秒数 遅らせる. のすべての IP アドレス構成 インタフェース なります
新しいブリッジ デバイスに移動しました。
参照 iface アンブリッジ この操作を元に戻すため。
iface 定義 file
非アクティブな永続的な物理ホスト インターフェイスを定義するか、既存の永続的なホスト インターフェイスを変更します。
XML からの XNUMX つ file.
iface-破壊 インタフェース
「if-down」を実行して無効にするなど、特定のホスト インターフェイスを破棄 (停止) します。
アクティブな使用からのインターフェイス。 これはすぐに有効になります。
iface-dumpxml インタフェース [- 非活性]
ホスト インターフェイス情報を XML ダンプとして stdout に出力します。 もしも - 非活性 is
指定されている場合、出力はインターフェイスの永続的な状態を反映します。
次回起動時に使用します。
iface 編集 インタフェース
ホスト インターフェイスの XML 構成ファイルを編集します。
これは次と同等です。
virsh iface-dumpxml iface > iface.xml
vi iface.xml (または他のテキスト エディタで変更)
virsh iface-define iface.xml
ただし、いくつかのエラー チェックを行います。
使用されるエディターは、$VISUAL または $EDITOR 環境変数によって提供されます。
デフォルトは「vi」です。
iface リスト [- 非活性 | - すべて]
アクティブなホスト インターフェイスのリストを返します。 もしも - すべて これも指定されます
定義済みだが非アクティブなインターフェイスが含まれます。 もしも - 非活性 非アクティブのみが指定されます
ものがリストされます。
iface 名 インタフェース
MAC アドレスがホスト インターフェイス間で一意である場合、ホスト インターフェイスの MAC をインターフェイス名に変換します。
ホストのインターフェース。
インタフェース インターフェイスの MAC アドレスを指定します。
iface-mac インタフェース
ホストインターフェース名をMACアドレスに変換します。
インタフェース インターフェース名を指定します。
iface スタート インタフェース
「if-up」を実行するなどして、(以前に定義された) ホスト インターフェイスを開始します。
iface アンブリッジ ブリッジ [--開始しない]
という名前のブリッジデバイスを破棄します。 ブリッジ、その基礎となるインターフェイスを解放して、
通常の使用法で、すべての IP アドレス設定をブリッジ デバイスからブリッジ デバイスに移動します。
基礎となるデバイス。 そうでない限り、基礎となるインターフェイスが再起動されます。 --開始しない is
現在; このフラグは対称性のために存在しますが、一般には推奨されません。
参照 iface ブリッジ 橋を作るため。
iface-未定義 インタフェース
非アクティブなホスト インターフェイスの構成を定義解除します。
iface-begin
現在のホスト インターフェイス設定のスナップショットを作成します。これは後でコミットできます。
(iface コミット) または復元 (iface ロールバック）。 スナップショットがすでに存在する場合、これは
前のスナップショットがコミットまたは復元されるまで、コマンドは失敗します。
外部のホスト インターフェイスに外部変更が加えられた場合、未定義の動作が発生します。
スナップショットの開始から最終的なコミットまでの間の libvirt API の変更、または
ロールバック。
iface コミット
前回以降のすべての変更を宣言します iface-begin 動作しているとして、ロールバックを削除します
点。 インターフェイス スナップショットがまだ開始されていない場合、このコマンドは
失敗します。
iface ロールバック
すべてのホスト インターフェイス設定を、最後に記録された状態に戻します。 iface-begin.
インターフェイス スナップショットがまだ開始されていない場合、このコマンドは失敗します。
ホストの再起動は、暗黙的なロールバック ポイントとしても機能します。
STORAGE POOL コマンド
次のコマンドはストレージ プールを操作します。 Libvirt には次のような管理機能があります。
ファイル、RAW パーティション、ドメイン固有のフォーマットなどのさまざまなストレージ ソリューション
仮想マシン内のデバイスとして認識できるストレージ ボリュームを提供するために使用されます。 多くのための
この機能の詳細については、次のドキュメントを参照してください。
<http://libvirt.org/formatstorage.html> 。 プール用のコマンドの多くは次のように似ています。
ドメインに使用されるもの。
ストレージプールソースの検索 type [ソーススペック]
使用可能なすべての利用可能なストレージ プール ソースを記述する XML を返します。
特定のストレージ プールを作成または定義する type。 場合 ソーススペック が提供されている場合、それは
XML を含むファイルを使用して、プールのクエリをさらに制限します。
すべてのストレージ プールがこの方法での検出をサポートしているわけではありません。 さらに、そうする人にとっては、
検出をサポートします。有効な値を返すには特定の XML 要素のみが必要です。
データは無視されますが、他の要素や一部の要素の属性さえも無視されます。
検索基準に基づいてプールを見つける必要はありません。 以下のリスト
サポートされている type オプションと、実行に使用される予想される最小限の XML 要素
検索。
「netfs」または「gluster」プールの場合、予想される最小限必要な XML は次のとおりです。
使用する IP アドレスまたはホスト名を記述する「name」属性を持つ要素
プールを見つけてください。 「port」属性は、他の提供された XML と同様に無視されます。
の要素 ソーススペック.
「論理」プールの場合、 ソーススペック ファイルは無視されますが、
ただし、ファイルが少なくとも存在している必要があります。
「iscsi」プールの場合、最低限必要な XML は次のとおりです。 要素
プールの検索に使用される IP アドレスまたはホスト名を記述する「name」属性
(iSCSI サーバーのアドレス)。 オプションで「port」属性を指定できますが、
デフォルトは 3260 です。オプションで、 「名前」を含む XML 要素
属性を指定して、iSCSI ターゲットの検索を特定のターゲットにさらに制限することもできます。
マルチ IQN iSCSI ストレージ プールのイニシエーター。
ストレージ プール ソースの検索 type [host] [ポート] [イニシエータ]
提供するのではなく、 ソーススペック XMLファイル ストレージプールソースの検索 このコマンドを使用します
オプションを使用して virsh にクエリ XML ファイルを生成させるためのオプション
引数。 このコマンドは、次と同じ出力 XML を返します。 ストレージプールソースの検索.
host netfs などのネットワークストレージに使用する特定のホストを記述するには、
gluster、および iscsi type プール。
ポート 次の場合に、接続に使用するネットワーク ポートをさらに制限します。
iscsi などの特定のストレージ バックエンドで必要となります。
イニシエータ iSCSIをさらに制限するには type 特定のターゲットに対するプール検索
イニシエーター。
プールの自動起動 プールまたは UUID [-無効にする]
かどうかを設定します。 プール 起動時に自動的に開始されるはずです。
プール構築 プールまたは UUID [-上書き] [-いいえ-上書きしません]
指定されたプールを構築します。
オプション -上書き -いいえ-上書きしません にのみ使用できます プール構築 ファイルシステムまたは
ディスクプール。 ファイル システム プールの場合、どちらも指定されていない場合、 プール構築 MAKES
ディレクトリ。 もしも -いいえ-上書きしません が指定されている場合、ファイルシステムが
ターゲットデバイス上にすでに存在しており、存在する場合はエラーを返すか、mkfs を使用して
そうでない場合は、ターゲットデバイスをフォーマットします。 もしも -上書き を指定するとmkfsが常に実行される
ターゲットデバイス上の既存のデータは無条件に上書きされます。 ディスクの場合
プール、どちらも指定されていない場合、または -いいえ-上書きしません 指定されている、 プール構築 意志
「parted --print」を使用して、事前にディスクにすでにラベルがあるかどうかを確認します。
作成しようとしています。 ディスクにまだラベルがない場合にのみ、ラベルが付けられます。
作成した。 もしも -上書き が指定されているか、ディスクがそうでないと判断されました
すでに持っている場合は、「parted mklabel」を使用して次の形式のラベルを作成します
プールのソース形式タイプ、またはプールに指定されていない場合は「dos」によって指定されます。
プールの作成 file [- 建てる] [[-上書き] | [[-いいえ-上書きしません]]
XML からプール オブジェクトを作成して開始する file.
[- 建てる] [[-上書き] | [[-いいえ-上書きしません]]を実行します プール構築 作成後
プールを構築するためのフォローアップ コマンドの必要性をなくすためです。 の -上書き
-いいえ-上書きしません フラグは以下と同じルールに従います プール構築。 もしも - 建てる is
提供されたら、 プール構築 フラグなしで呼び出されます。
プールの作成名 名 type [--print-xml] [--ソースホスト hostname] [--ソースパス path]
[--source-dev path] [--ソース名 名] [- 目標 path] [--ソース形式 形式でアーカイブしたプロジェクトを保存します．]
[--認証タイプ 認証タイプ --認証ユーザー名 ユーザ名 --秘密の使用法 使用] [[--アダプター名
名] | [[--アダプター-wwnn --アダプター-wwpn] [--アダプターの親 親]][- 建てる]
[[-上書き] | [[-いいえ-上書きしません]]
プール オブジェクトを作成して開始する 名 生のパラメータから。 もしも --print-xml is
指定した後、プールを作成せずにプール オブジェクトの XML を出力します。
それ以外の場合、プールには指定された type。 使用時 プールの作成名 のプール用
type 「disk」、上にある既存のパーティション。 --source-dev path に使用されます
ディスクプールにデータを追加します。 したがって、使用することをお勧めします プール定義として プール-
ビルド -上書き ディスクプールを適切に初期化するために。
[--ソースホスト hostname] は、ストレージによってバックアップされたプールのソース ホスト名を提供します。
リモート サーバー (プール タイプ netfs、iscsi、rbd、sheepdog、gluster)。
[--ソースパス path] は、バックアップされたプールのソース ディレクトリ パスを提供します。
ディレクトリ (プールタイプ dir)。
[--source-dev path] は、物理デバイスによってバックアップされるプールのソース パスを提供します
(プール タイプは fs、論理、ディスク、iscsi、zfs)。
[--ソース名 名] は、名前付きのストレージによってバックアップされたプールのソース名を提供します。
要素 (プール タイプ論理、rbd、シープドッグ、gluster)。
[- 目標 path] は、ストレージ プールをホスト ファイルにマッピングするためのパスです。
システム。
[--ソース形式 形式でアーカイブしたプロジェクトを保存します．] では、プールの形式 (プール タイプ) に関する情報を提供します。
fs、netfs、ディスク、論理）。
[--認証タイプ 認証タイプ --認証ユーザー名 ユーザ名 --秘密の使用法 使用』を提供します。
ストレージ プールの認証資格情報を生成するために必要な要素。 の
認証タイプ iscsi のいずれかのチャプタです type rbd のプールまたは ceph type プール。
[--アダプター名 名] scsi_host に使用される scsi_hostN アダプター名を定義します。
アダプタータイプのプール。
[--アダプター-wwnn --アダプター-wwpn [--アダプターの親 親]] は、wwnn と wwpn を次のように定義します。
fc_host アダプター タイプ プールに使用されます。 親はオプションで次の名前を提供します。
vHBA に使用される scsi_hostN ノード デバイス。
[- 建てる] [[-上書き] | [[-いいえ-上書きしません]]を実行します プール構築 作成後
プールを構築するためのフォローアップ コマンドの必要性をなくすためです。 の -上書き
-いいえ-上書きしません フラグは以下と同じルールに従います プール構築。 もしも - 建てる is
提供されたら、 プール構築 フラグなしで呼び出されます。
プール定義 file
非アクティブな永続ストレージ プールを定義するか、既存の永続ストレージ プールを変更します。
XML file.
プール定義として 名 type [--print-xml] [--ソースホスト hostname] [--ソースパス path]
[--source-dev path] [--ソース名 名] [- 目標 path] [--ソース形式 形式でアーカイブしたプロジェクトを保存します．]
[--認証タイプ 認証タイプ --認証ユーザー名 ユーザ名 --秘密の使用法 使用] [[--アダプター名
名] | [[--アダプター-wwnn --アダプター-wwpn] [--アダプターの親 親]]
プール オブジェクトを作成しますが、開始はしません 名 生のパラメータから。 もしも --print-xml
が指定されている場合は、プールを定義せずにプール オブジェクトの XML を出力します。
それ以外の場合、プールには指定された type.
と同じ引数を使用します プールの作成名、を除いて - 建てる, -上書き,
-いいえ-上書きしません オプション。
プール破壊 プールまたは UUID
与えられたものを破壊（停止）する プール 物体。 Libvirt はストレージを管理しなくなります
プール オブジェクトによって記述されますが、プールに含まれる生データは変更されません。
後で復元できます プールの作成.
プールの削除 プールまたは UUID
指定されたリソースが使用するリソースを破棄します プール 物体。 この操作は回復できません。
当学校区の プール このコマンドを実行した後もオブジェクトはまだ存在しており、新しいオブジェクトを作成する準備ができています。
ストレージボリューム。
プールダンプxml [- 非活性] プールまたは UUID
に関する XML 情報を返します。 プール オブジェクト。 - 非活性 ヴァーシュにダンプするように言う
プール構成とは対照的に、次回のプールの開始時に使用されます。
現在のプール構成。
プール編集 プールまたは UUID
ストレージ プールの XML 構成ファイルを編集します。
これは次と同等です。
virsh pool-dumpxml プール > pool.xml
vi pool.xml (または他のテキスト エディターで変更を加えます)
virsh プール定義 pool.xml
ただし、いくつかのエラー チェックを行います。
使用されるエディターは、$VISUAL または $EDITOR 環境変数によって提供されます。
デフォルトは「vi」です。
プール情報 プールまたは UUID
に関する基本情報を返します。 プール オブジェクト。
プールリスト [- 非活性] [- すべて] [- 持続的に] [--一時的な] [- 自動スタート] [--自動起動なし]
[[- 詳細][ 】
libvirt が認識しているプール オブジェクトをリストします。 デフォルトでは、アクティブなプールのみがリストされます。
- 非活性 非アクティブなプールのみをリストします。 - すべて すべてのプールをリストします。
さらに、フィルタリング フラグのセットがいくつかあります。 - 持続的に を列挙することです
永続的なプール、 --一時的な 一時プールをリストすることです。 - 自動スタート リスト
自動開始プール、 --自動起動なし に、自動起動が無効になっているプールのリストを示します。
次を使用して、指定したタイプのプールを一覧表示することもできます。 type、プールの種類は次のとおりです。
--type dir,disk のようにカンマで区切ります。 有効なプール タイプには、「dir」、「fs」、
「netfs」、「logical」、「disk」、「iscsi」、「scsi」、「mpath」、「rbd」、「sheepdog」、「gluster」。
当学校区の - 詳細 オプションは、virsh にプールの永続性をさらに表示するように指示します。
利用可能な場合は、容量関連の情報。
注: 古いサーバーと通信する場合、このコマンドは一連の API の使用を強制されます。
プールがリストされていないか、より多く表示される可能性がある、固有のレースを持つ呼び出し
リストの収集中に呼び出し間で状態が変化した場合は、XNUMX 回以上。 新しい
サーバーにはこの問題はありません。
プール名 ウイド
変換 ウイド プール名に。
プールリフレッシュ プールまたは UUID
に含まれるボリュームのリストを更新します。 プール.
プールスタート プールまたは UUID [- 建てる] [[-上書き] | [[-いいえ-上書きしません]]
ストレージを開始する プール、以前に定義されていますが、非アクティブです。
[- 建てる] [[-上書き] | [[-いいえ-上書きしません]]を実行します プール構築 先立って プールスタート
を実行する必要はなく、プール環境が期待どおりの状態であることを確認します。
起動前に build コマンドを実行します。 の -上書き -いいえ-上書きしません フラグはそれに続きます
と同じルール プール構築。 もしも - 建てる が提供されている場合、 プール構築 で呼び出されます
フラグはありません。
注意: 「iscsi」や (v)HBA などのリモート リソースに依存するストレージ プール
バックアップされた「SCSI」プールをすべての状態にするには、複数回リフレッシュする必要がある場合があります。
ボリュームが検出されました (「 プールリフレッシュ）。 これは、対応するボリュームデバイスが
プールの最初の起動時または
現在のリフレッシュ試行。 更新の再試行回数はネットワークによって異なります。
接続と、ホストが対応するデバイスをエクスポートするのにかかる時間。
プールの未定義 プールまたは UUID
非アクティブな構成の定義を解除します プール.
プール UUID プール
指定された名前の UUID を返します。 プール.
VOLUME コマンド
ボリューム作成 プールまたは UUID FILE [--prealloc-メタデータ]
XMLからボリュームを作成する。 プールまたは UUID ストレージの名前または UUID です
ボリュームを作成するプール。 FILE XMLですボリューム定義を使用します。 アン
XMLを簡単に作成する方法を使用することです vol-dumpxml を取得するコマンド
既存のボリュームの定義。 [--prealloc-メタデータ] メタデータを事前に割り当てます (
完全割り当てをサポートしていない qcow2 イメージ)。 このオプションはまばらなイメージを作成します
ファイルにメタデータが含まれているため、メタデータが含まれていない画像と比較してパフォーマンスが向上します。
事前割り当てと、初期ディスク容量の使用量がわずかに多くなるだけです。
例:
virsh vol-dumpxml --pool storagepool1 appvolume1 > newvolume.xml
vi newvolume.xml (または他のテキスト エディタで変更を加えます)
virsh vol-create Differentstoragepool newvolume.xml
vol-create-from プールまたは UUID FILE [--inputpool プールまたは UUID] ボリューム名またはキーまたはパス
[--prealloc-メタデータ] [--reflink]
別のボリュームを入力として使用して、ボリュームを作成します。 プールまたは UUID の名前または UUID です
ボリュームを作成するストレージ プール。 FILE XMLですボリュームのある
定義。 --inputpool プールまたは UUID ストレージプールの名前またはuuidです。
ソースボリュームが入っています。 ボリューム名またはキーまたはパス ソースの名前、キー、またはパスです
音量。 [--prealloc-メタデータ] メタデータを事前に割り当てます (メタデータを事前に割り当てない qcow2 イメージの場合)
完全割り当てをサポートします)。 このオプションは、メタデータを含むスパース画像ファイルを作成します。
その結果、事前割り当てのみを行ったイメージと比較してパフォーマンスが向上します。
初期ディスク容量の使用量がわずかに多くなります。 いつ --reflink が指定されている場合は、COW を実行します
軽量コピー。データ ブロックは変更された場合にのみコピーされます。 そうでない場合
コピーが失敗する可能性があります。
vol-create-as プールまたは UUID 名 容量 [- 割り当て サイズ] [- フォーマット string]
[--バッキングボリューム ボリューム名またはキーまたはパス] [--バッキングボリュームフォーマット string]
[--prealloc-メタデータ]
一連の引数からボリュームを作成します。 プールまたは UUID の名前または UUID です。
ボリュームを作成するストレージ プール。 名 は新しいボリュームの名前です。 ディスクの場合
プール。これは、プールのソース デバイスから決定されたパーティション名と一致する必要があります。
パスと次に使用可能なパーティション。 たとえば、ソース デバイス パスは /dev/sdb です。
ディスク上にパーティションがない場合、名前は次の名前の sdb1 にする必要があります。
sdb2などです。 容量 作成されるボリュームのサイズです。
整数 (参照 注意事項 上記)、サフィックスがない場合はデフォルトでバイトになります。 - 割り当て
サイズ ボリュームに割り当てられる初期サイズ (スケーリングされた整数)
デフォルトはバイトです。 - フォーマット string ファイルベースのストレージプールで指定するために使用されます。
使用するボリューム ファイル形式。 raw、bochs、qcow、qcow2、vmdk、qed。 拡張して使用する
拡張パーティションを作成するためのディスクストレージプール (他の値は有効です)
チェックされますが、libvirtd の再起動時またはプールの更新時には保存されません)。
--バッキングボリューム ボリューム名またはキーまたはパス 次の場合に使用されるソース バッキング ボリュームです。
既存のボリュームのスナップショットを取得します。 --バッキングボリュームフォーマット string のフォーマットです
スナップショットバッキングボリューム。 raw、bochs、qcow、qcow2、qed、vmdk、host_device。 これらは
ただし、ファイルベースのストレージプールを対象としています。 [--prealloc-メタデータ] 事前割り当て
メタデータ (完全割り当てをサポートしていない qcow2 イメージ用)。 このオプションにより作成されるのは、
メタデータを含むスパース画像ファイルにより、画像と比較してパフォーマンスが向上します
事前割り当てはなく、初期ディスク容量の使用量がわずかに増えるだけです。
ボリュームクローン [--プール プールまたは UUID] ボリューム名またはキーまたはパス 名 [--prealloc-メタデータ]
[--reflink]
既存のボリュームのクローンを作成します。 強力ではありませんが、入力しやすいバージョンの vol-create-
from. --プール プールまたは UUID を作成するストレージ プールの名前または UUID です。
ボリュームイン。 ボリューム名またはキーまたはパス ソース ボリュームの名前、キー、またはパスです。
名 は新しいボリュームの名前です。 [--prealloc-メタデータ] メタデータを事前に割り当てます (
完全割り当てをサポートしていない qcow2 イメージ)。 このオプションはまばらなイメージを作成します
ファイルにメタデータが含まれているため、メタデータが含まれていない画像と比較してパフォーマンスが向上します。
事前割り当てと、初期ディスク容量の使用量がわずかに多くなるだけです。 いつ --reflink is
指定されている場合は、COW 軽量コピーを実行します。データ ブロックは次の場合にのみコピーされます。
変更されました。 これが不可能な場合、コピーは失敗します。
ボリューム削除 [--プール プールまたは UUID] ボリューム名またはキーまたはパス [--削除-スナップショット]
指定されたボリュームを削除します。 --プール プールまたは UUID ストレージ プールの名前または UUID です。
ボリュームは入っています。 ボリューム名またはキーまたはパス は、ボリュームの名前、キー、またはパスです。
削除します。
当学校区の --削除-スナップショット フラグは、ストレージに関連付けられたすべてのスナップショットを指定します
ボリュームも削除する必要があります。 すべてのストレージ ドライバーがこのオプションをサポートしているわけではありません。
現在はrbdのみです。
ボリュームアップロード [--プール プールまたは UUID] [- オフセット バイト] [- 長さ バイト] ボリューム名またはキーまたはパス
ローカルファイル
のコンテンツをアップロードします ローカルファイル ストレージボリュームに。 --プール プールまたは UUID は
ボリュームが存在するストレージ プールの名前または UUID。 ボリューム名またはキーまたはパス は
ファイルがアップロードされるボリュームの名前、キー、またはパス。 - オフセット は
データの書き込みを開始するストレージ ボリューム内の位置。 値は 0 でなければなりません
以上。 - 長さ アップロードするデータ量の上限です。 否定的
value は、基本的にすべてを含む unsigned Long Long 値として解釈されます。
オフセットからボリュームの終わりまで。 の場合はエラーが発生します。 ローカルファイル is
指定された長さを超えています。 libvirt の説明を参照してください。
ターゲット ボリュームとプールの変更の可能性に関する詳細については、virStorageVolUpload API
アップロード試行時のプール更新の結果として。
vol-ダウンロード [--プール プールまたは UUID] [- オフセット バイト] [- 長さ バイト] ボリューム名またはキーまたは-
path ローカルファイル
ストレージボリュームの内容をダウンロードします ローカルファイル. --プール プールまたは UUID は
ボリュームが存在するストレージ プールの名前または UUID。 ボリューム名またはキーまたはパス は
ダウンロードするボリュームの名前、キー、またはパス。 - オフセット での位置です。
データの読み取りを開始するストレージ ボリューム。 値は 0 以上である必要があります。
- 長さ ダウンロードするデータ量の上限です。 負の値は
unsigned long long 値として解釈され、基本的に以下のすべてが含まれます。
ボリュームの最後までのオフセット。
ボリュームワイプ [--プール プールまたは UUID] [- アルゴリズム アルゴリズム] ボリューム名またはキーまたはパス
ボリュームをワイプし、ボリューム上の以前のデータが今後の読み取りでアクセスできないようにします。
--プール プールまたは UUID ボリュームが存在するストレージ プールの名前または UUID です。 vol-
名前またはキーまたはパス ワイプするボリュームの名前、キー、またはパスです。 可能です
ボリュームをゼロで書き直す代わりに、別のワイプ アルゴリズムを選択します。 これ
を介して行うことができます - アルゴリズム スイッチ。
サポート アルゴリズム
ゼロ - すべてのゼロを 1 パスします
nnsa - 4 パス NNSA ポリシーレター NAP-14.1-C (XVI-8) 用
リムーバブルおよび非リムーバブル ハードディスクのサニタイズ:
ランダム x2、0x00、検証。
dod - 4 パス DoD 5220.22-M セクション 8-306 手順
消毒用取り外し可能および取り外し不可能な硬質
ディスク: ランダム、0x00、0xff、検証。
bsi - ドイツのセンターが推奨する 9 パス法
情報技術におけるセキュリティ
(http://www.bsi.bund.de): 0xff、0xfe、0xfd、0xfb、
0xf7、0xef、0xdf、0xbf、0x7f。
putmann - で説明されている標準的な 35 パス シーケンス
ガットマンの論文。
schneier - Bruce Schneier によって説明された 7 パス法
「応用暗号」(1996): 0x00、0xff、
ランダム×5。
pfitzner7 - Roy Pfitzner の 7 ランダム パス メソッド: ランダム x7。
pfitzner33 - Roy Pfitzner の 33 ランダム パス メソッド: ランダム x33。
ランダム - 1 パス パターン: ランダム。
注意: 利用可能なアルゴリズムは、「スクラブ」のバージョンによって制限される場合があります。
ホストにインストールされたバイナリ。
vol-dumpxml [--プール プールまたは UUID] ボリューム名またはキーまたはパス
ボリューム情報を XML ダンプとして標準出力に出力します。 --プール プールまたは UUID は
ボリュームが存在するストレージ プールの名前または UUID。 ボリューム名またはキーまたはパス 名前です
XML を出力するボリュームのキーまたはパス。
ボリューム情報 [--プール プールまたは UUID] ボリューム名またはキーまたはパス
指定されたストレージ ボリュームに関する基本情報を返します。 --プール プールまたは UUID は
ボリュームが存在するストレージ プールの名前または UUID。 ボリューム名またはキーまたはパス 名前です
情報を返すボリュームのキーまたはパス。
ボリュームリスト [--プール プールまたは UUID] [- 詳細]
指定されたストレージ プール内のボリュームのリストを返します。 --プール プールまたは UUID 名前です
またはストレージプールのUUID。 の - 詳細 このオプションは、virsh にさらに次のことを指示します。
可能な場合は、ボリュームのタイプと容量に関連する情報を表示します。
ボリュームプール [--uuid] ボリュームキーまたはパス
指定されたボリュームのプール名または UUID を返します。 デフォルトでは、プール名は次のとおりです。
戻ってきた。 もし --uuid オプションが指定されている場合は、代わりにプール UUID が返されます。 ボリュームキー-
またはパス プール情報を返すボリュームのキーまたはパスです。
ボリュームパス [--プール プールまたは UUID] ボリューム名またはキー
指定されたボリュームのパスを返します。 --プール プールまたは UUID の名前または UUID です。
ボリュームが存在するストレージ プール。 ボリューム名またはキー は、ボリュームの名前またはキーです。
のパスを返します。
ボリューム名 ボリュームキーまたはパス
指定されたボリュームの名前を返します。 ボリュームキーまたはパス ボリュームのキーまたはパスです
の名前を返します。
音量キー [--プール プールまたは UUID] ボリューム名またはパス
指定されたボリュームのボリューム キーを返します。 --プール プールまたは UUID の名前または UUID です
ボリュームが存在するストレージ プール。 ボリューム名またはパス ボリュームの名前またはパスです
のボリュームキーを返します。
ボリュームリサイズ [--プール プールまたは UUID] ボリューム名またはパス プールまたは UUID 容量 [- 割り当てる]
[- デルタ] [- 縮む]
指定されたボリュームの容量をバイト単位で変更します。 --プール プールまたは UUID 名前ですか、それとも
ボリュームが存在するストレージ プールの UUID。 ボリューム名またはキーまたはパス 名前またはキーです
またはサイズ変更するボリュームのパス。 そうでない限り、新しい容量はまばらになる可能性があります。 - 割り当てる
と指定されている。 通常は、 容量 は新しいサイズですが、 - デルタ が存在する場合、それは
既存のサイズに追加されます。 ボリュームを縮小しようとすると失敗します。
- 縮む 存在します。 容量 そうでない限り、負にすることはできません - 縮む が提供されていますが、
マイナス記号は必要ありません。 容量 スケーリングされた整数です（を参照してください 注意事項 上記）、
サフィックスがない場合、デフォルトはバイトになります。 このコマンドはストレージに対してのみ安全です
アクティブなゲストによって使用されていないボリューム。 こちらも参照 ブロックサイズ変更 ライブリサイズ用。
SECRET コマンド
次のコマンドは「シークレット」（パスワード、パスフレーズ、暗号化など）を操作します。
キー）。 Libvirt は、シークレットをその使用や他のオブジェクト (例:
ボリュームまたはドメイン）は、暗号化または場合によってはその他の用途のためにシークレットを参照できます。
シークレットは UUID を使用して識別されます。 見るhttp://libvirt.org/formatsecret.html>のために
シークレットのプロパティを表すために使用される XML 形式のドキュメント。
秘密の定義 file
で指定されたプロパティを使用してシークレットを作成します。 file、関連付けられたシークレットなし
値。 場合 file UUID は指定されていないため、自動的に選択されます。 もしも file 指定する
既存のシークレットの UUID。そのプロパティを、で定義されたプロパティで置き換えます。 file,
シークレット値には影響を与えません。
シークレットダンプxml 秘密
の出力プロパティ 秘密 (UUID で指定) XML ダンプとして標準出力に出力されます。
シークレットセット値 秘密 base64
に関連付けられた値を設定します 秘密 (UUID で指定) を値に
Base64でエンコードされた値 base64.
シークレット取得値 秘密
に関連付けられた値を出力します 秘密 (UUID で指定) エンコードされた stdout へ
Base64を使用します。
秘密-未定義 秘密
削除する 秘密 (UUID で指定)、関連する値があればそれも含みます。
シークレットリスト [--一時的な] [--一時的なものではありません] [- プライベート] [--プライベートなし]
シークレットのリストを返します。 返されたシークレットをフィルタリングすることもできます。
--一時的な 一時的なものを列挙すると、 --一時的なものではありません 一時的ではないものをリストするには、
- プライベート プライベートなものをリストアップし、 --プライベートなし 非プライベートなものをリストします。
概要 コマンド
次のコマンドはドメインのスナップショットを操作します。 スナップショットはディスク、メモリ、
ある時点でのドメインのデバイス状態を保存し、将来の使用に備えて保存します。 彼らはたくさん持っています
OS イメージの「クリーン」コピーの保存から、再インストール前のドメインの状態の保存までを使用します。
潜在的に破壊的な操作。 スナップショットは一意の名前で識別されます。 見る
<http://libvirt.org/formatsnapshot.html> に使用される XML 形式のドキュメントについては、
スナップショットのプロパティを表します。
スナップショット作成 ドメイン [xmlファイル] {[--再定義 [- 現在]] | [--no-メタデータ] [-停止]
[--ディスクのみ] [--再利用-外部] [--静止] [-アトミック] [- 住む]}
ドメインのスナップショットを作成する ドメイン で指定されたプロパティを使用して xmlファイル.
通常、ドメイン スナップショットに設定できるプロパティは次のとおりです。 と
要素だけでなく、 もしも --ディスクのみ 与えられます。 残りの部分
フィールドは無視され、libvirt によって自動的に入力されます。 もしも xmlファイル 完全に
省略した場合、libvirt はすべてのフィールドの値を選択します。 新しいスナップショットは、
にリストされているように、最新のものになります。 スナップショット-現在の.
If -停止 が指定されている場合、ドメインはその後非アクティブな状態のままになります。
スナップショットが作成されます。
If --ディスクのみ が指定されている場合、スナップショットにはディスクの状態のみが含まれます。
VM 状態の通常のシステム チェックポイント。 ディスクのスナップショットはシステム全体よりも高速です
ただし、ディスク スナップショットに戻すには fsck またはジャーナルの再生が必要になる場合があります。
これは、電源コードが突然抜かれた時点のディスク状態に似ているためです。
そして混ぜる -停止 --ディスクのみ 時にディスクにフラッシュされなかったデータは失われます。
時間。
If --再定義 が指定されている場合、次によって生成されるすべての XML 要素 スナップショット-dumpxml
有効; これは、スナップショット階層をあるマシンから別のマシンに移行するために使用できます。
一時的なドメインが削除され、後で使用される場合に備えて階層を再作成します。
同じ名前と UUID で再作成するか、スナップショットにわずかな変更を加える
メタデータ (スナップショットに埋め込まれたドメイン XML のホスト固有の側面など)。
このフラグが指定されると、 xmlファイル 引数は必須であり、ドメインの
現在のスナップショットは、 - 現在 フラグも与えられます。
If --no-メタデータ が指定されている場合、スナップショット データは作成されますが、メタデータは作成されません。
すぐに破棄されます (つまり、libvirt はスナップショットを最新のものとして扱いません。
そうでない場合はスナップショットに戻ることはできません --再定義 後で libvirt に教えるために使用されます
メタデータをもう一度)。
If --再利用-外部 が指定されており、スナップショット XML が外部スナップショットを要求します。
既存のファイルの宛先を使用する場合、宛先は存在し、事前に作成されている必要があります。
正しい形式とメタデータで作成されました。 その後、ファイルは再利用されます。 それ以外の場合は、
既存のファイルの内容が失われないようにするために、スナップショットは拒否されます。
If --静止 が指定されている場合、libvirt はゲスト エージェントを使用してフリーズおよびフリーズ解除を試みます。
ドメインのマウントされたファイル システム。 ただし、ドメインにゲスト エージェントがない場合は、スナップショット
作成は失敗します。 現在、これには次のことが必要です --ディスクのみ も渡されること。
If -アトミック が指定されている場合、libvirt はスナップショットが成功することを保証します。
何も変更せずに失敗します。 すべてのハイパーバイザーがこれをサポートしているわけではありません。 このフラグが存在しない場合は、
指定した場合、一部のハイパーバイザーはアクションを部分的に実行した後に失敗する可能性があります。
ダンプxml 部分的な変更が発生したかどうかを確認するには、これを使用する必要があります。
If - 住む が指定されている場合、libvirt はゲストの実行中にスナップショットを取得します。 これ
外部チェックポイントのメモリ イメージのサイズが増加します。 これは現在、
外部チェックポイントでのみサポートされます。
スナップショット メタデータが存在すると、次のような試みが妨げられます。 未定義 永続的なドメイン。
ただし、一時的なドメインの場合、スナップショットのメタデータは、ドメインが削除されると自動的に失われます。
(次のようなコマンドによるかどうかに関係なく) 実行を終了します。 破壊する または内部ゲストアクションによって）。
スナップショットの作成名 ドメイン {[--print-xml] | [[--no-メタデータ] [-停止] [--再利用-外部]}
[名] [説明] [--ディスクのみ [--静止]][-アトミック] [[- 住む] [--memspec メンスペック]]
[--ディスクスペック] ディスクスペック] ...
ドメインのスナップショットを作成する ドメイン 与えられたものと一緒にと; どちらかであれば
値が省略されている場合、libvirt が値を選択します。 もしも --print-xml を指定してから XML
に適しています スナップショット作成 実際にスナップショットを作成するのではなく、出力されます。
そうでなければ、 -停止 を指定すると、ドメインはその後非アクティブな状態のままになります。
スナップショットが作成され、 --ディスクのみ が指定されている場合、スナップショットは作成されません
VM の状態が含まれます。
当学校区の --memspec オプションを使用して、チェックポイントが内部であるか、チェックポイントであるかを制御できます。
外部の。 の --memspec フラグは必須であり、その後に メンスペック フォームの
[ファイル=]名前[,スナップショット=タイプ]、タイプは いいえ, 内部または 外部。 含める
リテラルのカンマ ファイル=名前、XNUMX 番目のカンマでエスケープします。 --memspec 使用できません
とともに --ディスクのみ.
当学校区の --ディスクスペック オプションを使用して方法を制御できます --ディスクのみ および外部チェックポイント
外部ファイルを作成します。 このオプションは、数に応じて複数回発生する可能性があります。
のドメイン XML 内の要素。 各形になっています
ディスク[,スナップショット=タイプ][,ドライバー=タイプ][,ファイル=名前]に直接影響を与えます。健全とされるのは ディスクスペック ディスク用に提供する必要があります
libvirt はブロック デバイスのファイル名を自動生成しないため、ブロック デバイスによってバックアップされます。 に
リテラルのカンマを含める ディスク または ファイル=名前、XNUMX 番目のカンマでエスケープします。 あ
リテラル --ディスクスペック それぞれの前に置く必要があります ディスクスペック XNUMXつすべてがない限り、 ドメイン, 名,
説明 も存在します。 たとえば、ディスク仕様は
「vda,snapshot=external,file=/path/to,,new」の結果は次の XML になります。
If --再利用-外部 が指定されており、ドメイン XML または ディスクスペック オプションは、
既存のファイルの宛先を持つ外部スナップショットの場合、宛先は次のとおりである必要があります。
存在し、正しい形式とメタデータで事前に作成されている必要があります。 その後、ファイルは再利用されます。
それ以外の場合、既存のファイルの内容が失われるのを避けるために、スナップショットは拒否されます。
If --静止 が指定されている場合、libvirt はゲスト エージェントを使用してフリーズおよびフリーズ解除を試みます。
ドメインのマウントされたファイル システム。 ただし、ドメインにゲスト エージェントがない場合は、スナップショット
作成は失敗します。 現在、これには次のことが必要です --ディスクのみ も渡されること。
If --no-メタデータ が指定されている場合、スナップショット データは作成されますが、メタデータは作成されません。
すぐに破棄されます (つまり、libvirt はスナップショットを最新のものとして扱いません。
そうでない場合はスナップショットに戻ることはできません スナップショット作成 後で libvirt を教えるために使用されます
メタデータについてはもう一度説明します)。 このフラグは以下と互換性がありません --print-xml.
If -アトミック が指定されている場合、libvirt はスナップショットが成功することを保証します。
何も変更せずに失敗します。 すべてのハイパーバイザーがこれをサポートしているわけではありません。 このフラグが存在しない場合は、
指定した場合、一部のハイパーバイザーはアクションを部分的に実行した後に失敗する可能性があります。
ダンプxml 部分的な変更が発生したかどうかを確認するには、これを使用する必要があります。
If - 住む が指定されている場合、libvirt はゲストの実行中にスナップショットを取得します。 これ
外部チェックポイントのメモリ イメージのサイズが増加します。 これは現在、
外部チェックポイントでのみサポートされます。
スナップショット-現在の ドメイン {[- 名前] | [[-- セキュリティ情報] | [[スナップショット名]}
無し スナップショット名、これにより、ドメインの現在のスナップショット XML が出力されます。
スナップショット (存在する場合)。 もしも - 名前 が指定されている場合は、代わりに現在のスナップショット名のみが指定されます。
完全な XML。 それ以外の場合は、 -- セキュリティ情報 セキュリティに配慮したものも含まれます
XML 内の情報。
自律的AI スナップショット名、これは、既存の名前付きスナップショットを
ドメインを元に戻さずに、現在のスナップショットを取得します。
スナップショット編集 ドメイン [スナップショット名] [- 現在] {[-名前を変更] | [[- クローン]}
XML 設定ファイルを編集します。 スナップショット名 ドメインの。 両方の場合 スナップショット名
- 現在 が指定されている場合は、編集されたスナップショットも強制的に現在のスナップショットになります。
スナップショット。 もしも スナップショット名 省略された場合 - 現在 を編集するには、指定する必要があります
現在のスナップショット。
これは次と同等です。
virsh snapshot-dumpxml dom 名 > snapshot.xml
vi snapshot.xml (または他のテキスト エディターで変更を加えます)
virsh snapshot-create dom snapshot.xml --redefine [--current]
ただし、いくつかのエラー チェックを行います。
使用されるエディターは、$VISUAL または $EDITOR 環境変数によって提供されます。
デフォルトは「vi」です。
If -名前を変更 が指定されている場合、編集によりスナップショット名を変更できます。 もしも - クローン is
指定した場合、スナップショット名を変更するとスナップショットのクローンが作成されます
メタデータ。 どちらも指定されていない場合、編集によってスナップショット名が変更されてはなりません。
スナップショット名の変更は注意して行う必要があります。
単一の qcow2 ファイル内の内部スナップショットなどのスナップショットには、
元の名前から。
スナップショット情報 ドメイン {スナップショット | - 現在}
名前付きの基本情報を出力します、または現在のスナップショット
- 現在.
スナップショット リスト ドメイン [-メタデータ] [--no-メタデータ] [{- 親 | - ルーツ | [{- 木 |
- 名前}]}] [{[- から] スナップショット | - 現在} [- 子孫]][- 葉] [--葉なし]
[- 非活性] [- アクティブ] [--ディスクのみ] [- 内部] [- 外部の]
指定されたドメインで使用可能なすべてのスナップショットをリストします。デフォルトでは列が表示されます。
スナップショット名、作成時間、ドメインの状態。
If - 親 が指定されている場合は、出力テーブルに列を追加して、
各スナップショットの親。 もしも - ルーツ が指定されている場合、リストは次のものにフィルターされます。
親のないスナップショット。 もしも - 木 を指定すると、出力はツリーになります。
形式で、スナップショット名のみをリストします。 これら XNUMX つのオプションは相互に排他的です。 もしも
- 名前 を指定すると、スナップショット名のみが出力されます。 このオプションは相互に
と排他的 - 木.
If - から が提供されている場合は、指定されたスナップショットの子であるスナップショットのリストをフィルターします。
スナップショット; または - 現在 が提供されている場合は、現在のスナップショットから開始します。 で使用する場合
隔離または - 親、リストは直接の子に限定されます。
- 子孫 も存在します。 と一緒に使用する場合 - 木、 の用法 - 子孫 is
暗示的に。 このオプションは互換性がありません - ルーツ。 の開始点に注意してください。
- から or - 現在 以下の場合を除き、リストには含まれません。 - 木 オプションも
プレゼント。
If - 葉 が指定されている場合、リストはフィルタリングされて、何も含まれていないスナップショットのみが表示されます。
子供。 同様に、次の場合も --葉なし が指定されている場合、リストは次のものにフィルターされます。
子ども達とのスナップ写真。 (両方のオプションを省略するとフィルタリングが行われないことに注意してください。
両方のオプションを指定すると、同じリストが生成されるか、状況に応じてエラーが発生します。
サーバーがフラグを認識するかどうか)。 フィルタリング オプションには互換性がありません
- 木.
If -メタデータ を指定すると、リストは以下を含むスナップショットのみにフィルターされます。
libvirt メタデータを使用するため、 未定義 永続的なドメインが失われるか、
on 破壊する 一時的なドメインの。 同様に、次の場合も --no-メタデータ が指定されている場合、リスト
libvirt メタデータを必要とせずに存在するスナップショットのみにフィルターされます。
If - 非活性 を指定すると、リストは作成されたスナップショットにフィルターされます。
ドメインが遮断されたとき。 もしも - アクティブ が指定されている場合、リストは次のようにフィルター処理されます。
ドメインの実行中に取得されたスナップショットと、そのスナップショットに含まれるスナップショット
メモリ状態を実行状態に戻します。 もしも --ディスクのみ 指定されている場合、
リストはドメインの実行中に取得されたスナップショットにフィルターされますが、
ここで、スナップショットにはディスク状態のみが含まれます。
If - 内部 が指定されている場合、リストは内部スナップショットを使用するスナップショットにフィルターされます。
既存のディスクイメージのストレージ。 もしも - 外部の が指定されている場合、リストは次のようになります
ディスクイメージまたはメモリ状態に外部ファイルを使用するスナップショットにフィルタリングされます。
スナップショット-dumpxml ドメイン スナップショット [-- セキュリティ情報]
という名前のドメインのスナップショットのスナップショット XML を出力します。 スナップショット。 使い方
-- セキュリティ情報 セキュリティ上の機密情報も含まれます。 使用 snapshot-
現在 現在のスナップショットの XML に簡単にアクセスできます。
スナップショットの親 ドメイン {スナップショット | - 現在}
指定されたスナップショットの親スナップショットがある場合は、その名前を出力します。 スナップショット、または
現在のスナップショット - 現在.
スナップショットの復元 ドメイン {スナップショット | - 現在} [{- ランニング | --一時停止}] [- 力]
指定されたドメインを、指定されたスナップショットに戻します。 スナップショット、または現在まで
スナップショット - 現在。 これは破壊的なアクションであることに注意してください。 何らかの変化が
最後にスナップショットが作成されてからのドメインは失われます。 状態にも注意してください
スナップショットの復元が完了した後のドメインの状態は、その時点のドメインの状態になります。
元のスナップショットが取得された時刻。
通常、スナップショットに戻すと、ドメインはその時点の状態のままになります。
スナップショットは作成されましたが、VM 状態のないディスク スナップショットはそのまま残ります。
ドメインが非アクティブな状態です。 どちらかを通過すると、 - ランニング or --一時停止 フラグは
追加の状態変更 (非アクティブなドメインの起動、ドメインの一時停止など) を実行します。
実行中のドメイン)。 一時的なドメインを非アクティブにすることはできないため、次を使用する必要があります。
一時的なドメインのディスク スナップショットに戻すときに、これらのフラグのいずれか。
スナップショットの復元に余分なリスクが伴うケースが XNUMX つあります。
使用 - 力 続行します。 XNUMX つは、完全なドメインが欠落しているスナップショットの場合です。
構成を元に戻すための情報 (libvirt より前に作成されたスナップショットなど)
0.9.5); libvirt は現在の設定が設定内容と一致することを証明できないため、
スナップショット時に使用し、提供する - 力 libvirt がスナップショットを作成することを保証します。
現在の構成と互換性がある (互換性がない場合、ドメインはおそらく
実行に失敗します）。 もう XNUMX つは、実行中のドメインからアクティブなドメインに戻す場合です。
既存のハイパーバイザーを再利用するのではなく、新しいハイパーバイザーを作成する必要がある状態
ハイパーバイザーは、既存の VNC や Spice を破壊するなどの欠点を意味するため、
接続。 この状況は、証明可能なスナップショットを使用するアクティブなスナップショットで発生します。
互換性のない構成、および非アクティブなスナップショットが結合されている場合
- 始める or - 一時停止 フラグ。
スナップショットの削除 ドメイン {スナップショット | - 現在} [-メタデータ] [{- 子供 |
--子供のみ}]
という名前のドメインのスナップショットを削除します。 スナップショット、または現在のスナップショット
- 現在。 このスナップショットに子スナップショットがある場合、このスナップショットからの変更は
子供たちに融合しました。 もしも - 子供 が渡された場合は、このスナップショットとその他のスナップショットを削除します。
このスナップショットの子。 もしも --子供のみ が渡された場合は、その子をすべて削除します
ただし、このスナップショットはそのままにしておきます。 これら XNUMX つのフラグは相互に
排他的。
If -メタデータ が指定されている場合は、によって維持されているスナップショット メタデータのみを削除します。
libvirt。外部ツールによるアクセスのためにスナップショットの内容はそのまま残ります。
それ以外の場合、スナップショットを削除すると、その時点のデータ内容も削除されます。
NWフィルター コマンド
次のコマンドはネットワーク フィルターを操作します。 ネットワーク フィルターを使用すると、
仮想マシンとの間で送受信されるネットワーク トラフィック。 個々のネットワークトラフィック
フィルタは XML で記述されており、他のネットワーク フィルタへの参照が含まれる場合があります。
トラフィック フィルタリング ルール、または両方を含めます。 ネットワークフィルターは仮想によって参照されます
インターフェース記述内からマシンを削除します。 ネットワーク フィルタは次の方法で参照できます。
複数の仮想マシンのインターフェイス。
nwfilter-define xmlファイル
新しいネットワーク フィルターを libvirt に認識させます。 同じ名前のネットワークフィルターがある場合
すでに存在する場合は、新しい XML に置き換えられます。 実行中の任意の仮想マシン
このネットワーク フィルタを参照すると、そのネットワーク トラフィック ルールが適応されます。 の場合
何らかの理由で、ネットワーク トラフィック フィルタリング ルールをどのインスタンスによってもインスタンス化できない
仮想マシンを実行している場合、新しい XML は拒否されます。
nwfilter-undefine nwフィルター名
ネットワークフィルターを削除します。 実行中の仮想マシンが存在する場合、削除は失敗します。
現在このネットワーク フィルタを使用しています。
nwフィルターリスト
使用可能なネットワーク フィルターをすべてリストします。
nwfilter-dumpxml nwフィルター名
ネットワークフィルターXMLを出力します。
nwフィルター編集 nwフィルター名
ネットワークフィルターのXMLを編集します。
これは次と同等です。
virsh nwfilter-dumpxml myfilter > myfilter.xml
vi myfilter.xml (または他のテキスト エディターで変更を加えます)
virsh nwfilter-define myfilter.xml
ただし、いくつかのエラーチェックが行われます。 新しいネットワーク フィルタは拒否される可能性があります。
で述べたのと同じ理由で nwfilter-define.
使用されるエディターは、$VISUAL または $EDITOR 環境変数によって提供されます。
デフォルトは「vi」です。
ハイパーバイザー固有 コマンド
注: 次のコマンドの使用は、 強く 落胆した。 これらは libvirt に次のような問題を引き起こす可能性があります。
混乱してその後の操作で間違った操作をしてしまう可能性があります。 これらを使い終えたら、
コマンドを使用する場合は、libvirt 開発者に問題を報告しないでください。 報告書は
無視されました。 これらのコマンドが何かを達成する唯一の方法であることがわかった場合は、
通常の第一級市民として機能を追加するように要求する方がよいでしょう。
libvirtライブラリ。
qemu-attach ピッド
外部で起動された QEMU プロセスを libvirt QEMU ドライバーに接続します。 QEMU
プロセスは、UNIX ドライバーを使用したモニター接続で作成されている必要があります。
理想的には、プロセスには「-name」引数も指定されています。
$ qemu-kvm -cdrom ~/demo.iso \
-monitor unix:/tmp/demo,server,nowait \
-name foo \
-uuid cece4f9f-dff0-575d-0e8e-01fe380f12ea &
$ QEMUPID=$!
$ virsh qemu-attach $QEMUPID
libvirt のすべての機能が、
外部で起動された QEMU プロセス。 ゲスト ABI の変更に問題が発生する可能性があります
移行とデバイスのホットプラグまたはホットアンプラグが機能しない可能性があります。 付属環境
主に読み取り専用であると考えてください。
qemu-monitor-コマンド ドメイン {[--hmp] | [[- かわいい]} command...
任意の監視コマンドを送信 command ドメインへ ドメイン qemuモニター経由。
コマンドの結果は標準出力に出力されます。 もしも --hmp コマンドが渡されると、
これは人間の監視コマンドとみなされ、libvirt が自動的に変換します。
必要に応じて QMP に入力します。 その場合、結果も QMP から逆変換されます。 もしも
- かわいい が与えられ、モニターが QMP を使用すると、出力はきれいに印刷されます。
複数の引数が指定された場合 command、スペースで連結されます
単一のコマンドをモニターに渡す前に。
qemu-エージェント-コマンド ドメイン [- タイムアウト 秒 | --非同期 | - ブロック] command...
任意のゲストエージェントコマンドを送信する command ドメインへ ドメイン qemuエージェント経由。
- タイムアウト, --非同期 - ブロック オプションは排他的です。 - タイムアウト タイムアウトが必要です
秒 秒 そしてそれはポジティブでなければなりません。 いつ --aysnc が与えられると、コマンドは待機します。
成功しても失敗してもタイムアウトになります。 そしていつ - ブロック が与えられると、コマンドは待機します
ブロッキングタイムアウトで永久に。
qemu-モニター-イベント [ドメイン] [- イベント イベント名] [- ループ] [- タイムアウト 秒] [- かわいい]
[-正規表現] [--ケースなし] [-タイムスタンプ]
任意の QEMU モニター イベントが発生するのを待ち、イベントの詳細を出力します。
彼らが起こるように。 イベントは、オプションで次のようにフィルタリングできます。 ドメイン or イベント名を選択します。
「query-events」QMP コマンドは次の方法で使用できます。 qemu-monitor-コマンド どのような出来事があるのかを知るために
サポートされています。 もしも -正規表現 使用されている、 イベント名 代わりに基本的な正規表現です
リテラル文字列の。 もしも --ケースなし 使用されている、 イベント名 大文字と小文字を区別せずに一致します。
デフォルトでは、このコマンドはワンショットで、イベントが発生すると成功を返します。 あなた
SIGINT を (通常は "Ctrl-C" 経由で) 送信して、すぐに終了することができます。 もしも - タイムアウト is
指定すると、コマンドはイベントの待機を断念します。 秒 経過しました。 と
- ループ、コマンドはタイムアウトまたは割り込みキーが発生するまですべてのイベントを出力します。 もしも - かわいい
が指定されている場合、JSON イベントの詳細は読みやすくするためにきれいに印刷されます。
日時 -タイムスタンプ を使用すると、人間が判読できるタイムスタンプがイベントの前に印刷されます。
QEMU によって提供されるタイミング情報は省略されます。
lxc-enter-namespace ドメイン -- /path/to/binary [arg1, [arg2, ...]]
の名前空間を入力してください ドメイン そしてコマンド「/path/to/binary」を実行して、
要求された引数。 バイナリ パスは、コンテナのルート ファイル システムを基準とした相対パスであり、
ホストのルート ファイルシステム。 バイナリは環境変数/コンソールを継承します。
ヴァーシュには見える。 このコマンドは、LXC ハイパーバイザー ドライバーに接続されている場合にのみ機能します。
このコマンドは、「/path/to/binary」の終了ステータスが 0 の場合にのみ成功します。
ENVIRONMENT
次の環境変数を設定して、「virsh」の動作を変更できます。
VIRSH_DEBUG=<0 ～ 4>
virsh コマンドの詳細デバッグを有効にします。 有効なレベルは次のとおりです
· VIRSH_DEBUG=0
デバッグ - すべてのレベルのメッセージがログに記録されます
· VIRSH_DEBUG=1
INFO - INFO、NOTICE、WARNING、ERROR レベルのメッセージをログに記録します
· VIRSH_DEBUG=2
NOTICE - NOTICE、WARNING、ERROR レベルでメッセージをログに記録します
· VIRSH_DEBUG=3
WARNING - WARNING および ERROR レベルのメッセージをログに記録します
· VIRSH_DEBUG=4
ERROR - ERROR レベルのメッセージのみがログに記録されます。
VIRSH_LOG_FILE="ログファイル"
virsh デバッグ メッセージを記録するファイル。
VIRSH_DEFAULT_CONNECT_URI
デフォルトで接続するハイパーバイザー。 これを次と同じ形式で URI に設定します。
によって受け入れられた 接続する オプション。 この環境変数は非推奨になりました。
グローバル LIBVIRT_DEFAULT_URI 同じ目的を果たす変数。
LIBVIRT_DEFAULT_URI
デフォルトで接続するハイパーバイザー。 これを次と同じ形式で URI に設定します。
によって受け入れられた 接続する オプション。 これは、クライアントに設定されているデフォルトの URI をオーバーライドします。
config ファイルを削除し、libvirt によるドライバーの探索を防止します。
ビジュアル
が使用するエディタ edit および関連オプション。
環境変数EDITOR
が使用するエディタ edit 「VISUAL」が設定されていない場合、および関連オプション。
VIRSH_HISTSIZE
コマンド履歴に記憶するコマンドの数。 デフォルト値は 500 です。
LIBVIRT_DEBUG=レベル
すべての libvirt API 呼び出しの詳細デバッグを有効にします。 有効なレベルは次のとおりです
· LIBVIRT_DEBUG=1
DEBUG 以上のレベルのメッセージ
· LIBVIRT_DEBUG=2
INFO 以上のレベルのメッセージ
· LIBVIRT_DEBUG=3
WARNING 以上のレベルのメッセージ
· LIBVIRT_DEBUG=4
ERROR 以上のレベルのメッセージ
デバッグ オプションの詳細については、こちらを参照してください。
"http://libvirt.org/logging.html"
onworks.net サービスを使用してオンラインで virsh を使用する
