virsh プログラムを使用してNetScaler VPXインスタンスをプロビジョニングする

最終公開日 : Sep 25, 2026
virsh プログラムは、VMゲストを管理するためのコマンドラインツールです。その機能はVirtual Machine Managerの機能に似ています。VMゲストのステータスを変更したり（開始、停止、一時停止など）、新しいゲストやデバイスを設定したり、既存の構成を編集したりできます。virsh プログラムは、VMゲスト管理操作のスクリプト作成にも役立ちます。
virsh プログラムを使用してNetScaler VPXをプロビジョニングするには、次の手順に従います。
  1. tarコマンドを使用してNetScaler VPXパッケージを解凍します。NSVPX-KVM-*\_nc.tgzパッケージには、次のコンポーネントが含まれています。
    • VPX属性を指定するドメインXMLファイル \[NSVPX-KVM-*\_nc.xml\]
    • NS-VMディスクイメージのチェックサム \[Checksum.txt\]
    • NS-VMディスクイメージ \[NSVPX-KVM-*\_nc.raw\]
    例:
    tar -xvzf NSVPX-KVM-10.1-117_nc.tgz
    NSVPX-KVM-10.1-117_nc.xml
    NSVPX-KVM-10.1-117_nc.raw
    checksum.txt
  2. NSVPX-KVM-&ast;\_nc.xml XML ファイルを \<DomainName\>-NSVPX-KVM-&ast;\_nc.xml という名前のファイルにコピーします。\&lt;DomainName\> は仮想マシンの名前でもあります。例:
    cp NSVPX-KVM-10.1-117_nc.xml NetScaler-VPX-NSVPX-KVM-10.1-117_nc.xml
  3. \<DomainName\>-NSVPX-KVM-&ast;\_nc.xml ファイルを編集して、次のパラメータを指定します。
    • name— 名前を指定します。
    • Mac— MACアドレスを指定します。
      注:
      ドメイン名とMACアドレスは一意である必要があります。
    • source file— ディスクイメージの絶対ソースパスを指定します。ファイルパスは絶対パスである必要があります。RAWイメージファイルまたはQCOW2イメージファイルのパスを指定できます。
      RAWイメージファイルを指定したい場合は、以下の例に示すようにディスクイメージのソースパスを指定します。
      例:
      <name>NetScaler-VPX</name>
      <mac address='52:54:00:29:74:b3'/>
      <source file='/root/NSVPX-KVM-10.1-117_nc.raw'/>
      以下の例に示すように、絶対QCOW2ディスクイメージのソースパスを指定し、ドライバータイプをqcow2として定義します。
      例:
      <name>NetScaler-VPX</name>
      <mac address='52:54:00:29:74:b3'/>
      <driver name ='qemu' type='qcow2'/>
      <source file='/root/NSVPX-KVM-10.1-117_nc.qcow'/>*
  4. ネットワークの詳細を設定するために、\<DomainName\>-NSVPX-KVM-&ast;\_nc.xmlファイルを編集します。
    • source dev — インターフェースを指定します。
    • mode — モードを指定します。デフォルトのインターフェースはMacvtap Bridgeです。
    例: モード: MacVTap Bridge ターゲットインターフェースをethx、モードをブリッジ、モデルタイプをvirtioに設定します。
    <interface type='direct'>
        <mac address='52:54:00:29:74:b3'/>
        <source dev='eth0' mode='bridge'/>
        <target dev='macvtap0'/>
        <model type='virtio'/>
        <alias name='net0'/>
        <address type='pci' domain='0x0000' bus='0x00' slot='0x03' function='0x0'/>
      </interface>
    ここで、eth0はVMに接続されている物理インターフェースです。
  5. 以下のコマンドを使用して、\<DomainName\>-NSVPX-KVM-&ast;\_nc.xmlファイルでVM属性を定義します。
    virsh define \<DomainName\>-NSVPX-KVM-\*\_nc.xml
    例:

    virsh define NS-VPX-NSVPX-KVM-10.1-117_nc.xml
  6. 以下のコマンドを入力してVMを起動します。
    virsh start \[\<DomainName\> | \<DomainUUID\>\]
    例:
    virsh start NetScaler-VPX
  7. コンソールを介してゲストVMに接続します。
    virsh console \[\<DomainName\> | \<DomainUUID\> |\<DomainID\> \]
    例:
    virsh console NetScaler-VPX

virshプログラムを使用してNetScaler VPXインスタンスにインターフェースを追加する

KVM上にNetScaler VPXをプロビジョニングした後、追加のインターフェースを追加できます。
インターフェースを追加するには、次の手順に従います。
  1. KVM上で実行中のNetScaler VPXインスタンスをシャットダウンします。
  2. 次のコマンドを使用して\<DomainName\>-NSVPX-KVM-&ast;\_nc.xmlファイルを編集します。
    virsh edit \[\<DomainName\> | \<DomainUUID\>\]
  3. \<DomainName\>-NSVPX-KVM-&ast;\_nc.xmlファイルに、次のパラメータを追加します。
    1. MacVTapの場合
      • インターフェースタイプ — インターフェースタイプを「direct」と指定します。
      • MACアドレス — MACアドレスを指定し、そのMACアドレスがすべてのインターフェースで一意であることを確認します。
      • ソースデバイス — インターフェース名を指定します。
      • モード — モードを指定します。サポートされているモードは、Bridge、VEPA、Private、およびPass-throughです。
      • モデルタイプ — モデルタイプをvirtioと指定します。
      例:
      モード: MacVTap パススルー
      ターゲットインターフェースを ethx、モードを ブリッジ、モデルタイプを virtioに設定します。
      <interface type='direct'>
            <mac address='52:54:00:29:74:b3'/>
            <source dev='eth1' mode='passthrough'/>
            <model type='virtio'/>
       </interface>
      ここでは、eth1はVMに接続されている物理インターフェースです。
    2. ブリッジモードの場合
      注:
      KVMホストでLinuxブリッジを設定し、物理インターフェースをブリッジにバインドし、ブリッジをUP状態にしていることを確認してください。
      • インターフェースタイプ— インターフェースタイプを「bridge」と指定します。
      • MACアドレス— MACアドレスを指定し、そのMACアドレスがインターフェース間で一意であることを確認します。
      • ソースブリッジ— ブリッジ名を指定します。
      • モデルタイプ— モデルタイプをvirtioと指定します。
      例: ブリッジモード
      <interface type='bridge'>
            <mac address='52:54:00:2d:43:a4'/>
            <source bridge='br0'/>
            <model type='virtio'/>
       </interface>