[KVM] virshコマンドまとめ(おまけつき)

KVMをCUIで管理するときに使用するvirshコマンドの使い方まとめ。(随時更新予定)
ただまとめるだけだと他の技術ブログと同じような内容になってしまうので、意味もなくOracle VM for SPARC(LDOM)のldmコマンドとも比較してみる。(ニッチ過ぎる・・・)


  • 所謂「仮想マシン」の呼び名は正式に「ゲストドメイン」です
  • 太文字は打ち込んだコマンドです
  • []で囲まれた斜体は可変値を表します

情報表示系

仮想マシンの一覧表示

KVM
# virsh list --all
  Id    名前                         状態
 ----------------------------------------------------
  1     win2000                        実行中
  -     windows8.1                     シャットオフ
 ※--allを付けないと状態が実行中の仮想マシンのみ表示される
OVM for SPARC
# ldm list-domain
 NAME             STATE      FLAGS   CONS    VCPU  MEMORY   UTIL  UPTIME
 primary          active     -n-cv-  UART    16    1984M    0.8%  2h 19m
 testvm           bound      ------  5000    32    4G

OVM for SPARCのほうが割り当てリソースなども表示されるので便利


仮想マシンの詳細表示

KVM
# virsh dominfo [仮想マシン名]
Id:             1
名前:         win2000
UUID:           0983fb9c-1040-ffaf-4e0e-e37f364df13e
OS タイプ:   hvm
状態:         実行中
CPU:            1
CPU 時間:     343.4s
最大メモリー: 1048576 KiB
使用メモリー: 1048576 KiB
永続:         はい (yes)
自動起動:   無効にする
管理済み保存: いいえ (no)
セキュリティモデル: none
セキュリティ DOI: 0

 

ストレージプールの一覧表示

KVM
# virsh  pool-list
 名前               状態     自動起動
 ----------------------------------------->
 default              動作中  はい (yes)

OVM for SPARCにはストレージプールの概念はない。


ストレージプールの情報表示

KVM
# virsh  pool-info [ストレージプール名]
名前:         default
UUID:           fad29cc4-7345-156b-3cf8-f6748d91ab25
状態:         実行中
永続:         はい (yes)
自動起動:   はい (yes)
容量:         426.76 GiB
割り当て:   30.43 GiB
利用可能:   396.34 GiB

こっちでみないとストレージプールのパスがわからない

# virsh  pool-dumpxml [ストレージプール名]
<pool type='dir'>
  <name>default</name>
  <uuid>fad29cc4-7345-156b-3cf8-f6748d91ab25</uuid>
  <capacity unit='bytes'>458231758848</capacity>
  <allocation unit='bytes'>32669159424</allocation>
  <available unit='bytes'>425562599424</available>
  <source>
  </source>
  <target>
    <path>/var/lib/libvirt/images</path>
    <permissions>
      <mode>0755</mode>
      <owner>-1</owner>
      <group>-1</group>
    </permissions>
  </target>
</pool>

 


仮想ネットワークの表示

KVM
# virsh net-list
名前               状態     自動起動  永続
--------------------------------------------------
default              動作中  はい (yes)  はい (yes)

 

 


物理マシンのインタフェース表示

 
KVM
# virsh  iface-list --all
名前               状態     MAC アドレス
--------------------------------------------
br0                  動作中  00:23:54:73:13:30
eth1                 停止状態 00:1b:21:a1:85:0c
eth2                 停止状態 00:40:26:f9:7e:ea
lo                   動作中  00:00:00:00:00:00

 

OVMforSPARC
# dladm show-dev
e1000g0         リンク: up      速度: 100   Mbps        デュプレックス: half
e1000g1         リンク: unknown 速度: 0     Mbps        デュプレックス: half
e1000g2         リンク: unknown 速度: 0     Mbps        デュプレックス: half
e1000g3         リンク: unknown 速度: 0     Mbps        デュプレックス: half
e1000g4         リンク: unknown 速度: 0     Mbps        デュプレックス: half
e1000g5         リンク: unknown 速度: 0     Mbps        デュプレックス: half

 仮想マシンの管理

正直、GUI(仮想マシンマネージャ)から管理したほうが楽ですよ。どうせ仮想マシンのGUIコンソール使うんだし。現場がSSHしかリモート接続許可していないとか、CUI萌え~な人はどうぞ。

仮想マシン用ディスク作成

 KVM
 # qemu-img create -f qcow2 [仮想ディスクファイルのパス] [サイズ]

# qemu-img create -f qcow2 /vmdata/images/test.qcow2 8G
# ls -l /vmdata/images/test.qcow2
-rw-r--r-- 1 root root 262144  8月 13 01:45 2014 /vmdata/images/test.qcow2
 OVM for SPARC
 # mkfile 64g /export/home/LDOM/testvm_vdisk1 # 仮想ディスク作成
# ldm add-vdsdev /export/home/LDOM/testvm_vdisk1 vol1@vds0 # 制御ドメインに仮想ディスクを登録
# ldm list-services
VCC
    NAME             LDOM             PORT-RANGE
    vcc0             primary          5000-5100
VSW
    NAME             LDOM             MAC               NET-DEV   ID   DEVICE     LINKPROP   DEFAULT-VLAN-ID PVID VID                  MTU   MODE   INTER-VNET-LINK
    vsw0             primary          00:14:4f:f9:b6:f6 igb2      0    switch@0              1               1                         1500         on
    vsw1             primary          00:14:4f:f8:d9:6b igb3      1    switch@1              1               1                         1500         on
VDS
    NAME             LDOM             VOLUME         OPTIONS          MPGROUP        DEVICE
    vds0             primary          vol1                                           /export/home/LDOM/testvm_vdisk1
# ldm add-vdisk vdisk1 vol1@vds0 testvm  # 制御ドメインに登録したディスクをゲストドメインに割り当て
# ldm list-domain -o disk testvm
NAME
testvm
DISK
    NAME             VOLUME                      TOUT ID   DEVICE  SERVER         MPGROUP
    vdisk1           vol1@vds0                        0                        

※先にゲストドメインを作ってあげないといけない。
※仮想ディスクを一旦制御ドメインに登録して、制御ドメインからゲストドメインに割り当てるイメージ

 


仮想マシン作成

KVM ※実行前にブート可能なCDROMイメージを用意すること

# virt-install --connect=qemu:///system \
--name=[仮想マシン名] \
--hvm --accelerate \
--disk path=[仮想ディスクのパス],size=[仮想ディスクサイズ(GB)],device=disk,bus=virtio,format=qcow2 \
--ram=[メモリサイズ(MB)] \
--vcpus=[仮想CPU数] \
--cdrom [CDROMイメージのパス] \
--network network=[接続先仮想ネットワーク名],model=virtio \
--graphics vnc \
--vnc --os-type=linux

例 失敗してますが・・・
# virt-install --connect=qemu:///system --name=testvm --hvm --accelerate \
 --disk path=/vmdata/images/test.qcow2,size=8,device=disk,bus=virtio,format=qcow2 \
 --ram=2048 --vcpus=1 --cdrom /vmdata/ISO/CentOS-6.4-x86_64-bin-DVD1.iso --network network=default,model=virtio --vnc --os-type=linux
Starting install...
ドメインを作成中...                              |    0 B     00:00
ディスプレイをオープンできません:
Run 'virt-viewer --help' to see a full list of available command line options
Domain creation completed. You can restart your domain by running:
virsh --connect qemu:///system start testvm

成功すると仮想マシンが起動している

 # virsh list --all
 Id    名前                         状態
----------------------------------------------------
 1     win2000                        実行中
 2     testvm                         実行中
 -     windows8.1                     シャットオフ

/etc/libvirt/qemu以下に仮想マシン定義のxmlファイルができている

# ls /etc/libvirt/qemu
networks  testvm.xml  win2000.xml  windows8.1.xml
# virsh domblklist testvm
ターゲット ソース
------------------------------------------------
vda        /vmdata/images/test.qcow2
hdc        /vmdata/ISO/CentOS-6.4-x86_64-bin-DVD1.iso
# virsh domiflist testvm
インターフェース 種類     ソース  モデル   MAC
-------------------------------------------------------
-          network    default    virtio      52:54:00:8b:41:a4
OVM for SPARC
# ldm add-domain testvm
# ldm list-domain
NAME             STATE      FLAGS   CONS    VCPU  MEMORY   UTIL  UPTIME
primary          active     -n-cv-  UART    16    1984M    0.3%  1h 33m
testvm           inactive   ------
# ldm add-vcpu 32 testvm  # CPU割り当て
# ldm list-domain
NAME             STATE      FLAGS   CONS    VCPU  MEMORY   UTIL  UPTIME
primary          active     -n-cv-  UART    16    1984M    0.2%  1h 34m
testvm           inactive   ------          32
# ldm add-memory 4096M testvm # メモリ割り当て
# ldm list-domain
NAME             STATE      FLAGS   CONS    VCPU  MEMORY   UTIL  UPTIME
primary          active     -n-cv-  UART    16    1984M    0.2%  1h 34m
testvm           inactive   ------          32    4G
# ldm add-vnet id=0 vnet0 vsw0 testvm # NIC割り当て
# ldm add-vnet id=1 vnet1 vsw1 testvm # NIC 割り当て
# ldm list-domain -o network testvm
NAME
testvm
NETWORK
    NAME             SERVICE                     ID   DEVICE     MAC               MODE   PVID VID                  MTU   LINKPROP
    vnet0            vsw0                        0               00:14:4f:fb:7b:c7        1
    vnet1            vsw1                        1               00:14:4f:f8:65:42        1

 仮想マシン CUIコンソール接続

KVM
# virsh console [仮想マシン名]
ドメイン testvm に接続しました
エスケープ文字は ^] です

※「^]」はctrl+]
※他のセッションを奪う場合は–force オプションを付ける

OVM for SPARC ※CONS列の番号がポート番号

# ldm list-domain
NAME             STATE      FLAGS   CONS    VCPU  MEMORY   UTIL  UPTIME
primary          active     -n-cv-  UART    16    1984M    0.8%  2h 19m
testvm           bound      ------  5000    32    4G
# telnet localhost 5000

 仮想マシン停止

KVM
# virsh shutdown [仮想マシン名]
ドメイン [仮想マシン名] をシャットダウンしています

※acpiを有効にしておかないとシャットダウンできない

OVM for SPARC
# ldm stop-domain testvm
LDom testvm stopped

 

仮想マシン 強制停止

KVM
# virsh destroy [仮想マシン名]
ドメイン [仮想マシン名] は強制停止されました
※物理マシンの電源ブチ切りと同じです。良い子のみんなはしてはいけません。
※仮想マシンがフリーズしたときの最終手段

vrishコマンドのヘルプ

KVM
 # 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-baseline                   ベースライン CPU の計算
    cpu-compare                    XML ファイルに記載された CPU とホスト CPU の 比較
    cpu-stats                      ドメインの CPU 統計情報の表示
    create                         XML ファイルによるドメインの作成
    define                         XML ファイルによるドメインの定義(起動なし)
    desc                           ドメインの説明またはタイトルの表示または設定
    destroy                        ドメインの強制停止
    detach-device                  XML ファイルによるデバイスの切断
    detach-disk                    ディスクデバイスの切断
    detach-interface               ネットワークインターフェースの切断
    domdisplay                     ドメインのディスプレイ接続 URI
    domhostname                    ドメインのホスト名の表示
    domid                          ドメイン名または UUID からドメイン ID への変 換
    domif-setlink                  仮想インターフェースのリンクステートの設定
    domiftune                      仮想インターフェースのパラメーターの取得・設 定
    domjobabort                    ドメインの実行中ジョブの中止
    domjobinfo                     ドメインのジョブ情報
    domname                        ドメイン ID または UUID からドメイン名への変 換
    dompmsuspend                   電源管理機能を使用したドメインの穏やかな一時 停止
    dompmwakeup                    ドメインのサスペンド状態からの再開
    domuuid                        ドメイン名または ID からドメイン UUID への変 換
    domxml-from-native             ネイティブ設定からドメイン XML への変換
    domxml-to-native               ドメイン XML からネイティブ設定への変換
    dump                           解析用ファイルへのドメインのコアダンプ
    dumpxml                        XML 形式のドメイン情報
    edit                           ドメインの XML 設定の編集
    inject-nmi                     ゲストへの NMI の送信
    send-key                       ゲストへのキーコードの送信
    managedsave                    ドメインの状態の管理保存
    managedsave-remove             ドメインの管理保存の削除
    maxvcpus                       コネクションの最大仮想 CPU 数
    memtune                        メモリーのパラメーターの取得または設定
    migrate                        他ホストへのドメインのマイグレーション
    migrate-setmaxdowntime         最大許容停止時間の設定
    migrate-setspeed               マイグレーションの最大帯域の設定
    migrate-getspeed               マイグレーションの最大帯域の取得
    numatune                       NUMA パラメーターの取得または設定
    reboot                         ドメインの再起動
    reset                          ドメインのリセット
    restore                        ファイルの保存状態からドメインの復元
    resume                         ドメインの再開
    save                           ドメインの状態のファイルへの保存
    save-image-define              ドメインの状態保存ファイルの XML の再定義
    save-image-dumpxml             XML 形式の状態保存されたドメイン情報
    save-image-edit                ドメインの状態保存ファイルの XML の編集
    schedinfo                      スケジューラーのパラメーターの表示/設定
    screenshot                     カレントドメインのコンソールについてのスクリ ーンショットの取得およびファイルへの保存
    setmaxmem                      最大メモリー上限の変更
    setmem                         メモリー割り当て量の変更
    setvcpus                       仮想 CPU 数の変更
    shutdown                       ドメインの穏やかな停止
    start                          停止状態の(定義済み)ドメインの起動
    suspend                        ドメインの一時停止
    ttyconsole                     TTY コンソール
    undefine                       ドメインの定義解除
    update-device                  XML ファイルによるデバイスの更新
    vcpucount                      ドメインの仮想 CPU 数
    vcpuinfo                       ドメインの仮想 CPU 情報の表示
    vcpupin                        ドメインの仮想 CPU アフィニティーの制御または表示
    emulatorpin                    ドメインのエミュレーターアフィニティの制御ま たは確認
    vncdisplay                     VNC ディスプレイ
 Domain Monitoring (ヘルプのキーワード 'monitor'):
    domblkerror                    ブロックデバイスにおけるエラーの表示
    domblkinfo                     ドメインのブロックデバイス容量の情報
    domblklist                     ドメインの全ブロックの一覧表示
    domblkstat                     ドメインのデバイスブロックの状態の取得
    domcontrol                     ドメイン制御インターフェース状態
    domif-getlink                  仮想インターフェースのリンクステートの取得
    domiflist                      すべてのドメインの仮想インターフェースの取得
    domifstat                      ドメインのネットワークインターフェースの状態 取得
    dominfo                        ドメインの情報
    dommemstat                     ドメインのメモリー統計情報の取得
    domstate                       ドメインの状態
    list                           ドメインの一覧表示
 Host and Hypervisor (ヘルプのキーワード 'host'):
    capabilities                   ケイパビリティ
    freecell                       NUMA 空きメモリー
    hostname                       ハイパーバイザーのホスト名の表示
    node-memory-tune               ノードメモリーパラメーターの取得または設定
    nodecpustats                   ノードの CPU 統計情報の表示
    nodeinfo                       ノード情報
    nodememstats                   ノードのメモリー統計の表示
    nodesuspend                    指定された間ホストデバイスの一時停止
    qemu-attach                    QEMU 接続
    qemu-monitor-command           QEMU モニターコマンド
    qemu-agent-command             QEMU ゲストエージェントコマンド
    sysinfo                        ハイパーバイザーのシステム情報の表示
    uri                            ハイパーバイザーの正規化 URI の表示
    version                        バージョンの表示
 Interface (ヘルプのキーワード 'interface'):
    iface-begin                    現在のインターフェース設定のスナップショット 作成、後からコミット (iface-commit) または復元 (iface-rollback) 可能
    iface-bridge                   ブリッジデバイスの作成および既存ネットワーク デバイスへの接続
    iface-commit                   iface-begin 後の変更のコミットおよび復元ポイ ントの開放
    iface-define                   XML ファイルによる物理ホストインターフェース の定義(起動なし)
    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                 スレーブデバイスの切断後、ブリッジデバイスの 定義解除
    iface-undefine                 物理ホストインターフェイスの定義解除(設定か ら削除)
 Network Filter (ヘルプのキーワード 'filter'):
    nwfilter-define                XML ファイルによるネットワークフィルターの定 義または更新
    nwfilter-dumpxml               XML 形式のネットワークフィルター情報
    nwfilter-edit                  ネットワークフィルターの XML 設定の編集
    nwfilter-list                  ネットワークフィルターの一覧表示
    nwfilter-undefine              ネットワークフィルターの定義解除
 Networking (ヘルプのキーワード 'network'):
    net-autostart                  ネットワークの自動起動
    net-create                     XML ファイルによるネットワークの作成
    net-define                     XML ファイルによるネットワークの登録(起動な し)
    net-destroy                    ネットワークの強制停止
    net-dumpxml                    XML 形式のネットワーク情報
    net-edit                       ネットワークの XML 設定の編集
    net-info                       ネットワーク情報
    net-list                       ネットワークの一覧表示
    net-name                       ネットワーク UUID からネットワーク名への変換
    net-start                      停止状態の(定義済み)ネットワークの起動
    net-undefine                   停止状態のネットワークの登録削除
    net-update                     update parts of an existing network's configuration
    net-uuid                       ネットワーク名からネットワーク UUID への変換
 Node Device (ヘルプのキーワード 'nodedev'):
    nodedev-create                 ノードに XML ファイルで定義されたデバイスの作成
    nodedev-destroy                ノードのデバイスの削除(停止)
    nodedev-detach                 デバイスドライバーからノードデバイスの切断
    nodedev-dumpxml                XML 形式のノードデバイス詳細
    nodedev-list                   ホストにあるデバイスの一覧表示
    nodedev-reattach               デバイスドライバーへのノードデバイスの再接続
    nodedev-reset                  ノードデバイスのリセット
 Secret (ヘルプのキーワード 'secret'):
    secret-define                  XML ファイルによるシークレットの定義または変 更
    secret-dumpxml                 XML 形式の secret 属性
    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                ドメインのスナップショットへの復帰
 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                    XML ファイルによるプールの定義(起動なし)
    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 への変換
 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                             カレントディレクトリーの変更
    connect                        ハイパーバイザーへの(再)接続
    echo                           引数のエコー
    exit                           対話式ターミナルの終了
    help                           ヘルプの表示
    pwd                            カレントディレクトリーの表示
    quit                           対話式ターミナルの終了

ダメだ。ぜんぜんまとまってない・・・