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

最終公開日 : Sep 25, 2026
virshプログラムは VM ゲストを管理するためのコマンドラインツールです。その機能性はVirtual Machine Managerに似ています。これによりVM Guestの状態（開始、停止、一時停止など）を変更でき、新しいGuestsおよびデバイスをセットアップして、既存の構成を編集できます。virshプログラムは、VM ゲスト管理操作のスクリプト作成にも役立ちます。
virshプログラムを使用してCitrix ADC VPXをプロビジョニングするには、次の手順に従います。
  1. tar コマンドを使用して、Citrix ADC VPXパッケージを解凍します。nsvpx-kvm-*_nc.tgz パッケージには、次のコンポーネントが含まれています。
    • VPX属性\[NSVPX-KVM-*_nc.xml\]を指定するドメイン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-*_nc.xml XML ファイルを \<DomainName>-nsVPX-KVM-*_nc.xml という名前のファイルにコピーします。\<DomainName>は、仮想マシンの名前でもあります。例:
    cp NSVPX-KVM-10.1-117_nc.xml NetScaler-VPX-NSVPX-KVM-10.1-117_nc.xml
  3. \<DomainName>-nsVPX-KVM-*_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. \&lt;DomainName>-nsVPX-KVM-*_nc.xml ファイルを編集して、ネットワークの詳細を設定します。
    • source dev - インターフェースを指定します。
    • mode - モードを指定します。デフォルトのインターフェイスは Macvtap ブリッジです。
    例:モード: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 は仮想マシンに接続された物理インターフェイスです。
  5. 次のコマンドを使用して、 \&lt;DomainName>-NSVPX-KVM-*_nc.xmlファイル内の仮想マシンの属性を定義します。virshdefine \&lt;DomainName>-NSVPX-KVM-*_nc.xml 例:
    virsh define NS-VPX-NSVPX-KVM-10.1-117_nc.xml
  6. 次のコマンドを入力して VM を起動します。 virsh start \[\&lt;DomainName>\|\&lt;DomainUUID>\] 例:
    virsh start NetScaler-VPX
  7. virshコンソールコンソールからゲスト VM を接続します \[\&lt;DomainName>\| \&lt;DomainUUID>\|\&lt;DomainID>\] 例:
    virsh console NetScaler-VPX

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

KVM上でCitrix ADC VPXをプロビジョニングした後、インターフェイスを追加できます。
インターフェイスを追加するには、次の手順を実行します。
  1. KVMで実行されているCitrix ADC VPXインスタンスをシャットダウンします。
  2. 次のコマンドを使用して \&lt;DomainName>-NSVPX-KVM-*_nc.xml ファイルを編集します。virsh edit \[\&lt;DomainName> \| \&lt;DomainUUID>\]
  3. の中に < DomainName>-NSVPX-KVM-*_nc.xml ファイルに、次のパラメータを追加します。
    1. MacVtap用
      • Interface type - インターフェイスの種類として「direct」を指定します。
      • MAC アドレス：MAC アドレスを指定し、MAC アドレスがインターフェイス全体で一意であることを確認します。
      • source dev - インターフェイス名を指定します。
      • mode-モードを指定します。サポートされているモードは、ブリッジ、VEPA、プライベート、パススルーです。
      • モデルタイプ-モデルタイプを次のように指定します。 virtio
      例:
      モード：MacVTap Pass-through
      ターゲットインタフェースを ethx、モードを ブリッジ、モデルタイプを次のように設定します。 virtio
      <interface type='direct'>
            <mac address='52:54:00:29:74:b3'/>
            <source dev='eth1' mode='passthrough'/>
            <model type='virtio'/>
       </interface>
      ここで eth1 は仮想マシンに接続された物理インターフェイスです。
    2. ブリッジモードの場合
      注：KVMホストでLinux Bridgeが構成され、Bridgeに物理インターフェイスが結合されて、BridgeがUP状態になっている必要があります。
      • Interface type - インターフェイスの種類として「bridge」を指定します。
      • MAC アドレス：MAC アドレスを指定し、MAC アドレスがインターフェイス全体で一意であることを確認します。
      • source dev - ブリッジ名を指定します。
      • モデルタイプ-モデルタイプを次のように指定します。 virtio
      例：Bridge Mode
      <interface type='bridge'>
            <mac address='52:54:00:2d:43:a4'/>
            <source bridge='br0'/>
            <model type='virtio'/>
       </interface>