目次
virsh による仮想マシンの操作
ゲストの一覧表示
$ sudo virsh list --all
Id 名前 状態 ---------------------------------------------------- - CentOS_6_x86_64_001 シャットオフ - CentOS_6_x86_64_002 シャットオフ - Fedora_17_x86_64_001 シャットオフ
ゲストの自動起動
$ sudo virsh autostart CentOS_6_x86_64_001
ドメイン CentOS_6_x86_64_001 が自動起動に設定されました
ゲストの自動起動解除
$ sudo virsh autostart --disable CentOS_6_x86_64_001
ドメイン CentOS_6_x86_64_001 が自動起動設定が解除されました
ゲストの起動
$ sudo virsh start CentOS_6_x86_64_001
ドメイン CentOS_6_x86_64_001 が起動されました
ゲストの休止
$ sudo virsh suspend CentOS_6_x86_64_001
ドメイン CentOS_6_x86_64_001 は一時停止されました
ゲストの復帰
$ sudo virsh resume CentOS_6_x86_64_001
ドメイン CentOS_6_x86_64_001 が再開されました
ゲストの状態を保存して停止
$ sudo virsh save CentOS_6_x86_64_001 savefile
ドメイン CentOS_6_x86_64_001 が savefile に保存されました
ゲストを保存ファイルから復帰
$ sudo virsh restore savefile
ドメインが savefile から復元されました
ゲストのシャットダウン
$ sudo virsh shutdown CentOS_6_x86_64_001
ドメイン CentOS_6_x86_64_001 をシャットダウンしています
ゲストの再起動
$ sudo virsh reboot CentOS_6_x86_64_001
ドメイン CentOS_6_x86_64_001 を再起動しています
ゲストの強制停止
$ sudo virsh destroy CentOS_6_x86_64_001
ドメイン CentOS_6_x86_64_001 は強制停止されました
ドメインのディスプレイ接続URI
$ sudo virsh domdisplay CentOS_6_x86_64_001
spice://localhost:5906
ドメインの編集
$ sudo virsh edit CentOS_6_x86_64_001
ハイパーバイザーの変更
kvm → qemu
<domain type='kvm'> <name>CentOS</name> <uuid>bb538efe-0218-4be1-ac29-fc74138dcf85</uuid> <memory unit='KiB'>2097152</memory>
<domain type='qemu'> <name>CentOS</name> <uuid>bb538efe-0218-4be1-ac29-fc74138dcf85</uuid> <memory unit='KiB'>2097152</memory>
CPU モデルの表示 [cpu-models]
$ virsh cpu-models x86_64
486 pentium pentium2 pentium3 pentiumpro coreduo n270 core2duo qemu32 kvm32 cpu64-rhel5 cpu64-rhel6 qemu64 kvm64 Conroe Penryn Nehalem Nehalem-IBRS Westmere Westmere-IBRS SandyBridge SandyBridge-IBRS IvyBridge IvyBridge-IBRS Haswell-noTSX Haswell-noTSX-IBRS Haswell Haswell-IBRS Broadwell-noTSX Broadwell-noTSX-IBRS Broadwell Broadwell-IBRS Skylake-Client Skylake-Client-IBRS Skylake-Client-noTSX-IBRS Skylake-Server Skylake-Server-IBRS Skylake-Server-noTSX-IBRS Cascadelake-Server Cascadelake-Server-noTSX Icelake-Client Icelake-Client-noTSX Icelake-Server Icelake-Server-noTSX Cooperlake Snowridge athlon phenom Opteron_G1 Opteron_G2 Opteron_G3 Opteron_G4 Opteron_G5 EPYC EPYC-IBPB EPYC-Rome EPYC-Milan Dhyana
ヘルプ [help]
$ virsh help
グループ別コマンド:
Domain Management (ヘルプのキーワード 'domain'):
attach-device XML ファイルによるデバイスの接続
attach-disk ディスクデバイスの接続
attach-interface ネットワークインターフェースの接続
autostart ドメインの自動起動
blkdeviotune ブロックデバイスの I/O チューニングパラメーターの設定・取得
blkiotune ブロック I/O パラメーターの取得・設定
blockcommit ブロックのコミット操作の開始
blockcopy ブロックコピー操作の開始
blockjob 実行中のブロック操作の管理
blockpull バッキング・イメージからのディスクの配置
blockresize ドメインのブロックデバイスの容量変更
change-media CD またはフロッピードライブのメディアの変更
console ゲストのコンソールへの接続
cpu-stats ドメインの CPU 統計情報の表示
create XML ファイルによるドメインの作成
define XML ファイルによるドメインの定義(起動なし)
desc ドメインの説明・タイトルの表示・設定
destroy ドメインの強制停止
detach-device XML ファイルによるデバイスの切断
detach-device-alias detach device from an alias
detach-disk ディスクデバイスの切断
detach-interface ネットワークインターフェースの切断
domdisplay ドメインのディスプレイ接続 URI
domfsfreeze Freeze domain's mounted filesystems.
domfsthaw Thaw domain's mounted filesystems.
domfsinfo Get information of domain's mounted filesystems.
domfstrim ドメインのマウント済みファイルシステムにおける fstrim の呼び出し
domhostname ドメインのホスト名の表示
domid ドメイン名または UUID からドメイン ID への変換
domif-setlink 仮想インターフェースのリンクステートの設定
domiftune 仮想インターフェースのパラメーターの取得・設定
domjobabort ドメインの実行中ジョブの中止
domjobinfo ドメインのジョブ情報
domlaunchsecinfo Get domain launch security info
domsetlaunchsecstate Set domain launch security state
domname ドメイン ID または UUID からドメイン名への変換
domrename rename a domain
dompmsuspend 電源管理機能を使用したドメインの穏やかな一時停止
dompmwakeup ドメインのサスペンド状態からの再開
domuuid ドメイン名または ID からドメイン UUID への変換
domxml-from-native ネイティブ設定からドメイン XML への変換
domxml-to-native ドメイン XML からネイティブ設定への変換
dump 解析用ファイルへのドメインのコアダンプ
dumpxml XML 形式のドメイン情報
edit ドメインの XML 設定の編集
event Domain Events
get-user-sshkeys list authorized SSH keys for given user (via agent)
inject-nmi ゲストへの NMI の送信
iothreadinfo view domain IOThreads
iothreadpin control domain IOThread affinity
iothreadadd add an IOThread to the guest domain
iothreadset modifies an existing IOThread of the guest domain
iothreaddel delete an IOThread from the guest domain
send-key ゲストへのキーコードの送信
send-process-signal シグナルのプロセスへの送信
lxc-enter-namespace LXC ゲストの参加名前空間
managedsave ドメインの状態の管理保存
managedsave-remove ドメインの管理保存の削除
managedsave-edit edit XML for a domain's managed save state file
managedsave-dumpxml Domain information of managed save state file in XML
managedsave-define redefine the XML for a domain's managed save state file
memtune メモリーのパラメーターの取得・設定
perf Get or set perf event
metadata show or set domain's custom XML metadata
migrate ドメインの他ホストへのマイグレーション
migrate-setmaxdowntime 最大許容停止時間の設定
migrate-getmaxdowntime get maximum tolerable downtime
migrate-compcache 圧縮キャッシュの容量の取得・設定
migrate-setspeed マイグレーションの最大帯域の設定
migrate-getspeed マイグレーションの最大帯域の取得
migrate-postcopy Switch running migration from pre-copy to post-copy
numatune NUMA パラメーターの取得・設定
qemu-attach QEMU 接続
qemu-monitor-command QEMU モニターコマンド
qemu-monitor-event QEMU Monitor Events
qemu-agent-command QEMU ゲストエージェントコマンド
guest-agent-timeout Set the guest agent timeout
reboot ドメインの再起動
reset ドメインのリセット
restore ファイルの保存状態からドメインの復元
resume ドメインの再開
save ドメインの状態のファイルへの保存
save-image-define ドメインの状態保存ファイル向け XML の再定義
save-image-dumpxml XML 形式の状態保存されたドメイン情報
save-image-edit ドメインの状態保存ファイル向け XML の編集
schedinfo スケジューラーのパラメーターの表示・設定
screenshot カレントドメインのコンソールのスクリーンショット取得およびファイル保存
set-lifecycle-action change lifecycle actions
set-user-sshkeys manipulate authorized SSH keys file for given user (via agent)
set-user-password set the user password inside the domain
setmaxmem 最大メモリーの上限の変更
setmem メモリー割り当て量の変更
setvcpus 仮想 CPU 数の変更
shutdown ドメインの穏やかな停止
start 停止状態の(定義済み)ドメインの起動
suspend ドメインの一時停止
ttyconsole TTY コンソール
undefine ドメインの定義解除
update-device XML ファイルによるデバイスの更新
update-memory-device update memory device of a domain
vcpucount ドメインの仮想 CPU 数
vcpuinfo ドメインの仮想 CPU 情報の表示
vcpupin ドメインの仮想 CPU アフィニティーの制御・表示
emulatorpin ドメインのエミュレーターアフィニティの制御・確認
vncdisplay VNC ディスプレイ
guestvcpus query or modify state of vcpu in the guest (via agent)
setvcpu attach/detach vcpu or groups of threads
domblkthreshold set the threshold for block-threshold event for a given block device or it's backing chain element
guestinfo query information about the guest (via agent)
domdirtyrate-calc Calculate a vm's memory dirty rate
Domain Monitoring (ヘルプのキーワード 'monitor'):
domblkerror ブロックデバイスにおけるエラーの表示
domblkinfo ドメインのブロックデバイス容量の情報
domblklist ドメインの全ブロックの一覧表示
domblkstat ドメインのデバイスブロックの状態取得
domcontrol ドメイン制御インターフェース状態
domif-getlink 仮想インターフェースのリンクステートの取得
domifaddr Get network interfaces' addresses for a running domain
domiflist すべてのドメインの仮想インターフェースの取得
domifstat ドメインのネットワークインターフェースの状態取得
dominfo ドメインの情報
dommemstat ドメインのメモリー統計情報の取得
domstate ドメインの状態
domstats get statistics about one or multiple domains
domtime domain time
list ドメインの一覧表示
Host and Hypervisor (ヘルプのキーワード 'host'):
allocpages Manipulate pages pool size
capabilities ケイパビリティ
cpu-baseline ベースライン CPU の計算
cpu-compare XML ファイルに記載された CPU とホスト CPU の比較
cpu-models CPU モデル
domcapabilities domain capabilities
freecell NUMA 空きメモリー
freepages NUMA free pages
hostname ハイパーバイザーのホスト名の表示
hypervisor-cpu-baseline compute baseline CPU usable by a specific hypervisor
hypervisor-cpu-compare compare a CPU with the CPU created by a hypervisor on the host
maxvcpus 接続先の最大仮想 CPU 数
node-memory-tune ノードメモリーパラメーターの取得・設定
nodecpumap ノード CPU マップ
nodecpustats ノードの CPU 統計情報の表示
nodeinfo ノード情報
nodememstats ノードのメモリー統計の表示
nodesevinfo node SEV information
nodesuspend 指定された時間だけホストデバイスの一時停止
sysinfo ハイパーバイザーのシステム情報の表示
uri ハイパーバイザーの正規化 URI の表示
version バージョンの表示
Checkpoint (ヘルプのキーワード 'checkpoint'):
checkpoint-create Create a checkpoint from XML
checkpoint-create-as Create a checkpoint from a set of args
checkpoint-delete Delete a domain checkpoint
checkpoint-dumpxml Dump XML for a domain checkpoint
checkpoint-edit edit XML for a checkpoint
checkpoint-info checkpoint information
checkpoint-list List checkpoints for a domain
checkpoint-parent Get the name of the parent of a checkpoint
Interface (ヘルプのキーワード 'interface'):
iface-begin 現在のインターフェース設定のスナップショット作成、後からコミット (iface-commit) または復元 (iface-rollback) 可能
iface-bridge ブリッジデバイスの作成、および既存ネットワークデバイスへの接続
iface-commit iface-begin 後の変更のコミット、および復元ポイントの開放
iface-define define an inactive persistent physical host interface or modify an existing persistent one from an XML file
iface-destroy 物理ホストインターフェイスの停止("if-down" による無効化)
iface-dumpxml XML 形式のインターフェース情報
iface-edit 物理ホストインターフェイス向け XML 設定の編集
iface-list 物理ホストのインターフェイスの一覧表示
iface-mac インターフェース名からインターフェースの MAC アドレスへの変換
iface-name インターフェースの MAC アドレスからインターフェース名への変換
iface-rollback iface-begin により作成された、以前の保存された設定へのロールバック
iface-start 物理ホストインターフェイスの開始("ifup" による有効化)
iface-unbridge undefine a bridge device after detaching its device(s)
iface-undefine 物理ホストインターフェイスの定義解除(設定から削除)
Network Filter (ヘルプのキーワード 'filter'):
nwfilter-define XML ファイルによるネットワークフィルターの定義または更新
nwfilter-dumpxml XML 形式のネットワークフィルター情報
nwfilter-edit ネットワークフィルターの XML 設定の編集
nwfilter-list ネットワークフィルターの一覧表示
nwfilter-undefine ネットワークフィルターの定義解除
nwfilter-binding-create create a network filter binding from an XML file
nwfilter-binding-delete delete a network filter binding
nwfilter-binding-dumpxml XML 形式のネットワークフィルター情報
nwfilter-binding-list list network filter bindings
Networking (ヘルプのキーワード 'network'):
net-autostart ネットワークの自動起動
net-create XML ファイルによるネットワークの作成
net-define define an inactive persistent virtual network or modify an existing persistent one from an XML file
net-destroy ネットワークの強制停止
net-dhcp-leases print lease info for a given network
net-dumpxml XML 形式のネットワーク情報
net-edit ネットワークの XML 設定の編集
net-event Network Events
net-info ネットワーク情報
net-list ネットワークの一覧表示
net-name ネットワーク UUID からネットワーク名への変換
net-start 停止状態の(定義済み)ネットワークの起動
net-undefine undefine a persistent network
net-update 既存のネットワーク設定の一部分の更新
net-uuid ネットワーク名からネットワーク UUID への変換
net-port-list list network ports
net-port-create create a network port from an XML file
net-port-dumpxml network port information in XML
net-port-delete delete the specified network port
Node Device (ヘルプのキーワード 'nodedev'):
nodedev-create ノードに XML ファイルで定義されたデバイスの作成
nodedev-destroy ノードのデバイスの削除(停止)
nodedev-detach デバイスドライバーからノードデバイスの切断
nodedev-dumpxml XML 形式のノードデバイス詳細
nodedev-list ホストにあるデバイスの一覧表示
nodedev-reattach デバイスドライバーへのノードデバイスの再接続
nodedev-reset ノードデバイスのリセット
nodedev-event Node Device Events
nodedev-define Define a device by an xml file on a node
nodedev-undefine Undefine an inactive node device
nodedev-start Start an inactive node device
nodedev-autostart autostart a defined node device
nodedev-info node device information
Secret (ヘルプのキーワード 'secret'):
secret-define XML ファイルによるシークレットの定義または変更
secret-dumpxml XML 形式の secret 属性
secret-event Secret Events
secret-get-value シークレット値の出力
secret-list シークレットの一覧表示
secret-set-value シークレット値の設定
secret-undefine シークレットの定義解除
Snapshot (ヘルプのキーワード 'snapshot'):
snapshot-create XML によるスナップショットの作成
snapshot-create-as 一組の引数からのスナップショットの作成
snapshot-current カレントスナップショットの取得・設定
snapshot-delete ドメインのスナップショットの削除
snapshot-dumpxml ドメインのスナップショットの XML 形式ダンプ
snapshot-edit スナップショットの XML の編集
snapshot-info スナップショット情報
snapshot-list ドメインのスナップショットの一覧表示
snapshot-parent スナップショットの親の名前の取得
snapshot-revert ドメインのスナップショットへの復帰
Backup (ヘルプのキーワード 'backup'):
backup-begin Start a disk backup of a live domain
backup-dumpxml Dump XML for an ongoing domain block backup job
Storage Pool (ヘルプのキーワード 'pool'):
find-storage-pool-sources-as 潜在的なストレージプールソースの検索
find-storage-pool-sources 潜在的なストレージプールソースの探索
pool-autostart プールの自動起動
pool-build プールの構築
pool-create-as 一組の引数からプールの作成
pool-create XML ファイルによるプールの作成
pool-define-as 一組の引数からのプールの定義
pool-define define an inactive persistent storage pool or modify an existing persistent one from an XML file
pool-delete プールの削除
pool-destroy プールの強制停止
pool-dumpxml XML 形式のプール情報
pool-edit ストレージプールの XML 設定の編集
pool-info ストレージプール情報
pool-list プールの一覧表示
pool-name プール UUID からプール名への変換
pool-refresh プールのリフレッシュ
pool-start (以前に定義した)停止状態のプールの起動
pool-undefine 停止状態のプールの定義解除
pool-uuid プール名からプール UUID への変換
pool-event Storage Pool Events
pool-capabilities storage pool capabilities
Storage Volume (ヘルプのキーワード 'volume'):
vol-clone ボリュームのクローン
vol-create-as 一組の引数からボリュームの作成
vol-create XML ファイルによるボリュームの作成
vol-create-from 別のボリュームを入力として使用したボリュームの作成
vol-delete ボリュームの削除
vol-download ボリューム内容のファイルへのダウンロード
vol-dumpxml XML 形式のボリューム情報
vol-info ストレージボリューム情報
vol-key 任意のボリューム名またはパスのボリュームキーの表示
vol-list ボリューム一覧の表示
vol-name 任意のボリュームキーまたはパスのボリューム名の表示
vol-path 任意のボリューム名またはキーのボリュームパスの表示
vol-pool 任意のボリュームキーまたはパスのストレージプールの表示
vol-resize ボリュームの容量変更
vol-upload ファイル内容のボリュームへのアップロード
vol-wipe ボリュームの完全消去
Virsh itself (ヘルプのキーワード 'virsh'):
cd カレントディレクトリーの変更
echo echo arguments. Used for internal testing.
exit 対話式ターミナルの終了
help ヘルプの表示
pwd カレントディレクトリーの表示
quit 対話式ターミナルの終了
connect ハイパーバイザーへの(再)接続