Product Documentation

Installing SD-WAN Virtual Appliances on XenServer

Oct 24, 2017

To install Citrix NetScaler SD-WAN virtual appliances on Citrix XenServer, you must first install XenServer on a machine with adequate system resources. To perform the SD-WAN VPX installation, you use Citrix XenCenter, which must be installed on a remote machine that can connect to the XenServer host through the network.

Before you begin installing a virtual appliance, do the following:

  • Install a supported version of XenServer® on hardware that meets the minimum requirements. See the SD-WAN release notes for the supported versions of XenServer.
  • Install XenCenter® on a management workstation that meets the minimum system requirements.
  • Obtain VPX license files.

With the prerequisites met, you are ready to import the virtual appliances and configure them.

To import a SD-WAN virtual appliance to XenServer by using XenCenter

  1. Start XenCenter on your workstation.
  2. On the Server menu, click Add.
  3. In the Add New Server dialog box, in the Server text box, enter the IP address or DNS name of the XenServer server that you want to connect to.
  4. In the User Name and Password text boxes, type the administrator credentials, and then click Add.  The XenServer name appears in the navigation pane with a green circle, which indicates that the XenServer is connected.


localized image

            5. In the navigation pane, click the name of the XenServer server on which you want to install SD-WAN VPX-SE.

            6. Right-click the XenServer to import the VM and click Import.

            7. In the Import dialog box, in Import file, browse to the location at which you saved the SD-WAN VPX-SE .xva image file. Make sure that the Exported VM option is selected, and then click Next.

           8. Select the XenServer server on which you want to install the virtual appliance, and then click Next


localized image

localized image

localized image

        9. Select the local storage repository in which to store the virtual appliance, and then click Import to begin the import process.

        10. Add, modify, or delete virtual network interfaces as required. Attach virtual network interfaces, interface 0 and interface 1 to the two different virtual adapters (called Networks on this screen). These two interfaces are used as the accelerated bridge of the virtual appliance. If virtual network interface interface 2 exists, it can be assigned as well, and used as a management interface (equivalent to the Primary port). When finished, click Next.

        11. Click the Start VM after Import check box.

        12. Click Finish to complete the import process. The newly created virtual machine appears under the server list in the XenCenter interface.

localized image

localized image

localized image


Do not attach both virtual adapters to the same network . Doing so creates forwarding loops, which can cause network outages. Also, do not attach the two physical Ethernet ports associated with SD-WAN VPX to the same Ethernet switch.

To configure the virtual SD-WAN appliance

  1. In XenCenter, select the icon for the SD-WAN VPX virtual machine. Then, on the Storage tab, select Properties and, in the Properties dialog box , adjust the disk allocation to the desired level.
  2. Right-click the SD-WAN VPX icon and select the Properties option. Under CPU, select the number of VCPUs and under memory select the amount of VM memory corresponding to a supported configuration.
  3. Set the basic network parameters. Depending on which release you are running, do one of the following:
  4. After the virtual machine starts, go to the SD-WAN VPX console, login with admin user account.
  5. Type the command management_ip.
  6. Type the command set interface <ip_address> <subnet mask> <gateway>.
  7. Type the ** command “apply”. Verify/confirm the configuration.
  8. Ater the SD-WAN VPX has restarted, log on to the browser-based web management interface (GUI) (Default credentials: admin and password ) at the IP address that you assigned to apA.  
  9. Complete the configuration. 

localized image

localized image

localized image


Changing the disk allocation on the SD-WAN VPX virtual machine resizes and reinitializes the compression history. Any accumulated history is lost.

Do not attempt to change resource allocation while SD-WAN VPX is running.

Do not use the Force Shutdown or Force Reboot commands. They might not work and can cause problems. Use the Shutdown and Reboot commands instead.