Provision the Citrix ADC VPX instance by using the virsh program

September 14, 2021

Contributed by:

S C

Thevirshprogram is a command line tool for managing VM Guests. Its functionality is similar to that of Virtual Machine Manager. It enables you to change a VM Guest’s status (start, stop, pause, and so on), to set up new Guests and devices, and to edit existing configurations. Thevirshprogram is also useful for scripting VM Guest management operations.

To provision Citrix ADC VPX by using thevirshprogram, follow these steps:

Use the tar command to untar the Citrix ADC VPX package. The NSVPX-KVM-*_nc.tgz package contains the following components:
- The Domain XML file specifying VPX attributes [NSVPX-KVM-*_nc.xml]
- Check sum of NS-VM Disk Image [Checksum.txt]
- NS-VM Disk Image [NSVPX-KVM-*_nc.raw]
Example:
```
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 
```
Copy the NSVPX-KVM-*_nc.xml XML file to a file named -NSVPX-KVM-*_nc.xml. The is also the name of the virtual machine. Example:
```
cp NSVPX-KVM-10.1-117_nc.xml NetScaler-VPX-NSVPX-KVM-10.1-117_nc.xml 
```
Edit the -NSVPX-KVM-*_nc.xml file to specify the following parameters:
- name— Specify the name.
- Mac— Specify the MAC address. Note: The domain name and the MAC address have to be unique.
- source file— Specify the absolute disk-image source path. The file path has to be absolute. You can specify the path of the RAW image file or a QCOW2 image file.
  If you want to specify a RAW image file, specify the disk image source path as shown in the following example:
  Example:
```
NetScaler-VPX   
```
  Specify the absolute QCOW2 disk-image source path and define the driver type asqcow2, as shown in the following example:
  Example:
```
NetScaler-VPX   * 
```
Edit the -NSVPX-KVM-*_nc.xml file to configure the networking details:
- source dev— specify the interface.
- mode— specify the mode. The default interface isMacvtap Bridge.
Example: Mode: MacVTap Bridge Set target interface asethxand mode as bridge Model type asvirtio
```
        
```
Here, eth0 is the physical interface attached to the VM.
Define the VM attributes in the -NSVPX-KVM-*_nc.xml file by using the following command:virshdefine -NSVPX-KVM-*_nc.xml Example:
```
virsh define NS-VPX-NSVPX-KVM-10.1-117_nc.xml 
```
Start the VM by entering the following command:virshstart [ ] Example:
```
virsh start NetScaler-VPX 
```
Connect the Guest VM through the consolevirshconsole [ ] Example:
```
virsh console NetScaler-VPX 
```

Add more interfaces to Citrix ADC VPX instance using`virsh`program

After you have provisioned the Citrix ADC VPX on KVM, you can add additional interfaces.

To add more interfaces, follow these steps:

Shut down the Citrix ADC VPX instance running on the KVM.
Edit the -NSVPX-KVM-*_nc.xml file using the command:virshedit [ ]
In the -NSVPX-KVM-*_nc.xml file, append the following parameters:
1. For MacVTap
  - Interface type— Specify the interface type as ‘direct’.
  - MAC address— Specify the MAC address and make sure the MAC address is unique across the interfaces.
  - source dev— Specify the interface name.
  - mode— Specify the mode. The modes supported are - Bridge, VEPA, Private, and Pass-through
  - model type— Specify the model type asvirtio
  Example:
  Mode: MacVTap Pass-through
  Set target interface asethx, Mode as bridge, and model type asvirtio
```
     
```
  Here eth1 is the physical interface attached to the VM.
2. For Bridge Mode
  Note: Make sure that you have configured a Linux bridge in the KVM host, bound the physical interface to the bridge, and put the bridge in the UP state.
  - Interface type— Specify the interface type as ‘bridge’.
  - MAC address— Specify the MAC address and make sure the MAC address is unique across the interfaces.
  - source bridge— Specify the bridge name.
  - model type— Specify the model type asvirtio
  Example: Bridge Mode
```
<接口类型=“桥”> < = ' 52:54:00:2 mac地址d:43:a4'/>    
```

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Provision the Citrix ADC VPX instance by using the virsh program

September 14, 2021

Contributed by:

S C

September 14, 2021

Contributed by:

S C

Provision the Citrix ADC VPX instance by using the virsh program

Add more interfaces to Citrix ADC VPX instance usingvirshprogram

In this article

Add more interfaces to Citrix ADC VPX instance using`virsh`program