Citrix SD-WAN Platforms

SD-WAN Standard Edition Virtual Appliance (VPX) in Hypervisor on HyperV 2012 R2 and 2016

January 12, 2021

Contributed by:

To install SD-WAN VPX-SE in the hypervisor on HyperV 2012 R2 and 2016:

Install HyperV Manager. For more information, see documentation at Microsoft.com.
Unzip the SD-WAN distribution that you downloaded from My Citrix.
Start Hyper-V Manager.

There are two methods to create the virtual machine.

Method 1: Import virtual machine
1. In the navigation pane, under Hyper-V Manager, select the server on which you want to install SD-WAN VPX.
2. On the Actions menu, click Import Virtual Machine.
3. In the Import Virtual Machine dialog box, in Location box, specify the path to the folder that contains the SD-WAN VPX files.
  
  Note
  
  If you received a compressed file, make sure that you extract the files into a folder before you specify the path to the folder.
4. Click Import.
5. Verify that the virtual appliance that you created is listed under Virtual Machines.
6. Right-click the virtual machine, and then click Settings.
7. In the Settings window’s navigation pane, under Hardware, select the first network adapter in the list.
8. In the Network drop-down menu, select apA1 Network. This is the LAN interface for apA1.
9. Make sure the Enable MAC address spoofing box is selected. If it is not, select it and apply the changes.
10. In the Settings window’s navigation pane, under Hardware, select the second network adapter in the list. Repeat the step 10 and step 11, and assign the adapter to apA2 Network. This is the WAN interface for apA2. Important: Do not configure the same Network for both the network adapters. Incorrect configuration creates packet loops, which can bring down the network.
11. Optionally, change the virtual hard disk size:
  - In the Settings window navigation pane, under IDE Controller 0, select Hard Drive.
  - Click Edit.
  - Follow the steps in the Edit Virtual Hard Disk Wizard to increase the allocation to one of the supported sizes, using the Expand option in the wizard.
12. Optionally, change the memory size.
  - In the Settings window’s navigation pane, under Hardware, select Memory.
  - Allocate the RAM space by adjusting the memory to one of the supported sizes.
  - Click OK.
13. Optionally, define the management port.
  - Right-click the virtual machine, and then click Settings.
  - In the Settings window navigation pane, under Hardware, select Add Hardware.
  - Select Network Adapter from the list of devices, and then click Add.
  - Name the new virtual network as Primary Network 3.
    - Make sure the Enable spoofing of MAC addresses check box is selected.
    - Click OK to apply the changes.
14. Right-click the SD-WAN VPX virtual machine and select Connect.
15. In the file menu, click Action, and then click Start to start the virtual machine.
16. When an SD-WAN VPX virtual machine is started for the first time, it automatically starts the Deployment Wizard. This wizard asks questions about the deployment mode. Select Setup Using Web UI. On the next screen, enter the IP address, netmask, and gateway for the apA interface, and click Finish.
17. After SD-WAN VPX has restarted, log on to the browser based UI ((user name: admin, password: password) at the IP address that you assigned to apA, for example: https://172.16.0.213
18. In the HyperV Manager window, go to Virtual Switch Manager, and configure interfaces in the following order; management, LAN, and WAN.
19. Download the hyperv.tgz file and untar it.
20. Import VM using the extracted VHD and assign the number of CPUs and memory accordingly. Add interfaces in the order (management, LAN, and WAN). Enable Mac spoofing on LAN and WAN interfaces. Go to Settings > Interface >Advanced features.
Method 2: New virtual machine wizard

NOTE

Select method 2 if the Hyper-V virtual machine has to connect to orchestrator.
1. Open the SD-WAN Hyper-V setup file and select Virtual Hard Disks folder.
2. Copy the hard disk image and paste it in a freshly created folder outside of the Hyper-V setup file.
3. Open the Hyper-V Manager > select the Hyper-V ID > right click and select New > Virtual Machine.
4. The Virtual Machine Wizard opens, Click Next.
5. Provide the name and you can also specify a location for the virtual machine. Select the check box to provide a different location to store the virtual machine. Click Next.
6. Select the generation for the virtual machine and click Next.
7. Specify the amount of memory to allocate to the virtual machine and click Next.
8. Select a connection from the drop-down list and click Next. The connection being selected here is for Management port.
9. To connect VHD, select the Use an existing virtual hard disk radio button, browse, and select the VHD file from the extracted zip file and click Next. The virtual hard disk can be found in below location:
  
  ** > ctx-sdw-se-vpx > Virtual Hard Disks**
10. Verify the details on the Summary page and click Finish to complete the creation of the virtual machine.

By default, the virtual machine is in Off sate. The virtual machine created so far has only 1 Interface and 1 core, you have to increase the number of cores and add 2 more Interfaces for SD-WAN to work. Perform the following procedure:

Verify that the virtual appliance that you created is listed under Virtual Machines.
Right-click the virtual machine, and then click Settings.
In the Settings window’s navigation pane, under Hardware, select the first network adapter in the list.
In the Network drop-down menu, select apA1 Network. This is the LAN interface for apA1.
Make sure the Enable MAC address spoofing box is selected. If it is not, select it and apply the changes.
In the Settings window’s navigation pane, under Hardware, select the second network adapter in the list. Repeat the step 10 and step 11, and assign the adapter to apA2 Network. This is the WAN interface for apA2. Important: Do not configure the same Network for both the network adapters. Incorrect configuration creates packet loops, which can bring down the network.
Increase Number of Virtual CPU cores.
- In the Settings window navigation pane, select Processor.
- Increase Number of virtual processors to at least 4.
- Click Apply.
Optionally, change the virtual hard disk size:
- In the Settings window navigation pane, under IDE Controller 0, select Hard Drive.
- Click Edit.
- Follow the steps in the Edit Virtual Hard Disk Wizard to increase the allocation to one of the supported sizes, using the Expand option in the wizard.
Optionally, change the memory size.
- In the Settings window’s navigation pane, under Hardware, select Memory.
- Allocate the RAM space by adjusting the memory to one of the supported sizes.
- Click OK.
Right click and select start. Once the state is changed to Running, your virtual machine is now ready to use.

Adding interfaces

SD-WAN hypervisors install

Enabling Mac spoofing on the interfaces (LAN and WAN)

SD-WAN hyper install VM

After the VM is up, assign free IP address. The VM can be accessed after assigning the IP address.

SD-WAN hypervisor install VM assign IP

Note

The qcow image downloaded must be present under the default folder /var/lib/libvirt/images. If this image is downloaded, and used in different folder in KVM, there can be issues when disk size expansion is performed.

Limitations for deploying SD-WAN VPX-SE in HyperV 2012 R2 and 2016

VLAN Tagged Trunk Deployment is not supported.

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.

Was this helpful

SD-WAN Standard Edition Virtual Appliance (VPX) in Hypervisor on HyperV 2012 R2 and 2016

January 12, 2021

Contributed by:

January 12, 2021

Contributed by:

SD-WAN Standard Edition Virtual Appliance (VPX) in Hypervisor on HyperV 2012 R2 and 2016

Adding interfaces

Enabling Mac spoofing on the interfaces (LAN and WAN)

Limitations for deploying SD-WAN VPX-SE in HyperV 2012 R2 and 2016

In this article