ADC

Install a Citrix ADC VPX instance on VMware ESX

Before installing Citrix ADC VPX instances on VMware ESX, make sure that VMware ESX Server is installed on a machine with adequate system resources. To install a Citrix ADC VPX instance on VMware ESXi, you use the VMware vSphere client. The client or tool must be installed on a remote machine that can connect to VMware ESX through the network.

This section includes the following topics:

  • Prerequisites
  • Installing a Citrix ADC VPX instance on VMware ESX

Important

You cannot install standard VMware Tools or upgrade the VMware Tools version available on a Citrix ADC VPX instance. VMware Tools for a Citrix ADC VPX instance are delivered as part of the Citrix ADC software release.

Prerequisites

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

  • Install VMware ESX on hardware that meets the minimum requirements.
  • Install VMware Client on a management workstation that meets the minimum system requirements.
  • Download the Citrix ADC VPX appliance setup files.
  • Label the physical network ports of VMware ESX.
  • Obtain VPX license files. For more information about Citrix ADC VPX instance licenses, see Licensing overview.

VMware ESX hardware requirements

The following table describes the minimum system requirements for VMware ESX servers running Citrix ADC VPX ncore virtual appliance.

Table 1. Minimum system requirements for a VMware ESX server running a Citrix ADC VPX instance

Component Requirement
- 2 or more 64-bit x86 CPUs with virtualization assist (Intel-VT) enabled. To run Citrix ADC VPX instance, hardware support for virtualization must be enabled on the VMware ESX host. Make sure that the BIOS option for virtualization support is not disabled. For more information, see your BIOS documentation.
RAM 2 GB VPX. For critical deployments, we do not recommend 2 GB RAM for VPX because the system operates in a memory-constrained environment. This might lead to scale, performance, or stability related issues. Recommended is 4 GB RAM or 8 GB RAM.
Disk space 20 GB more than the minimum server requirements from VMware for setting up ESXi. See VMware documentation for minimum server requirements.
Network One 1-Gbps NIC. Two 1-Gbps NICs recommended

For information about installing VMware ESX, see http://www.vmware.com/.

To enable SR-IOV or PCI passthrough support, ensure that the following processors are supported:

  • Intel processors support Intel-VT.
  • I/O Memory Management Unit (IOMMU) or SR-IOV is enabled in BIOS.

The following table lists the virtual computing resources that the VMware ESX server must provide for each VPX ncore virtual appliance.

Table 2. Minimum virtual computing resources required for running a Citrix ADC VPX instance

Component Requirement
Memory 2 GB
Virtual CPU (vCPU) 2
Virtual network interfaces
  1. With ESX, you can install a maximum of 10 virtual network interfaces if the VPX hardware is upgraded version to 7 or higher.
Disk space 20 GB

This is in addition to any disk requirements for the hypervisor.

For production use of VPX virtual appliance, the full memory allocation must be reserved. CPU cycles (in MHz) equal to at least the speed of one CPU core of the ESX must be reserved.

VMware vSphere client system requirements

VMware vSphere is a client application that can run on Windows and Linux operating systems. It cannot run on the same machine as the VMware ESX server. The following table describes the minimum system requirements.

Table 3. Minimum system requirements for VMware vSphere client installation

Component Requirement
Operating system For detailed requirements from VMware, search for the “vSphere Compatibility Matrixes” PDF file at http://kb.vmware.com/.
CPU 750 MHz; 1 gigahertz (GHz) or faster recommended
RAM 1 GB. 2 GB recommended
Network Interface Card (NIC) 100 Mbps or faster NIC

OVF Tool 1.0 system requirements

OVF Tool is a client application that can run on Windows and Linux systems. It cannot run on the same machine as the VMware ESX server. The following table describes the minimum system requirements.

Table 4. Minimum system requirements for OVF tool installation

Component Requirement
Operating system For detailed requirements from VMware, search for the “OVF Tool User Guide” PDF file at http://kb.vmware.com/.
CPU 750 MHz minimum, 1 GHz or faster recommended
RAM 1 GB Minimum, 2 GB recommended
Network Interface Card (NIC) 100 Mbps or faster NIC

For information about installing OVF, search for the “OVF Tool User Guide” PDF file at http://kb.vmware.com/.

Downloading the Citrix ADC VPX setup files

The Citrix ADC VPX instance setup package for VMware ESX follows the Open Virtual Machine (OVF) format standard. You can download the files from the Citrix website. You need a Citrix account to log on. If you do not have a Citrix account, access the home page at http://www.citrix.com, click the New Users link, and follow the instructions to create a new Citrix account.

Once logged on, navigate the following path from the Citrix home page:

Citrix.com > Downloads > Citrix ADC > Virtual Appliances.

Copy the following files to a workstation on the same network as the ESX server. Copy all three files into the same folder.

  • NSVPX-ESX-<release number>-<build number>-disk1.vmdk (for example, NSVPX-ESX-9.3-39.8-disk1.vmdk)
  • NSVPX-ESX-<release number>-<build number>.ovf (for example, NSVPX-ESX-9.3-39.8.ovf)
  • NSVPX-ESX-<release number>-<build number>.mf (for example, NSVPX-ESX-9.3-39.8.mf)

Label the physical network ports of VMware ESX

Before installing a VPX virtual appliance, label of all the interfaces that you plan to assign to virtual appliances, in a unique format, for example, NS_NIC_1_1, NS_NIC_1_2, and so on. In large deployments, labeling in a unique format helps in quickly identifying the interfaces that are allocated to the VPX virtual appliance among other interfaces used by other virtual machines, such as Windows and Linux. Such labeling is especially important when different types of virtual machines share interfaces.

To label the physical network ports of VMware ESX server, follow these steps:

  1. Log on to the VMware ESX server by using the vSphere client.
  2. On the vSphere client, select the Configuration tab, and then click Networking.
  3. At the top-right corner, click Add Networking.
  4. In the Add Network Wizard, for Connection Type, select Virtual Machine, and then click Next.
  5. Scroll through the list of vSwitch physical adapters, and choose the physical port that maps to interface 1/1 on the virtual appliances.
  6. Enter the label of the interface, for example, NS_NIC_1_1 as the name of the vSwitch that is associated with interface 1/1 of the virtual appliances.
  7. Click Next to finish the vSwitch creation. Repeat the procedure, beginning with step 2, to add any additional interfaces to be used by your virtual appliances. Label the interfaces sequentially, in the correct format (for example, NS_NIC_1_2).

Install a Citrix ADC VPX instance on VMware ESX

After you have installed and configured VMware ESX, you can use the VMware vSphere client to install virtual appliances on the VMware ESX server. The number of virtual appliances that you can install depends on the amount of memory available on the hardware that is running VMware ESX.

To install Citrix ADC VPX instances on VMware ESX by using VMware vSphere Client, follow these steps:

  1. Start the VMware vSphere client on your workstation.
  2. In the IP address / Name text box, type the IP address of the VMware ESX server that you want to connect to.
  3. In the User Name and Password text boxes, type the administrator credentials, and then click Login.
  4. On the File menu, click Deploy OVF Template.
  5. In the Deploy OVF Template dialog box, in Deploy from file, browse to the location at which you saved the Citrix ADC VPX instance setup files, select the .ovf file, and click Next.
  6. Map the networks shown in the virtual appliance OVF template to the networks that you configured on the ESX host. Click Next to start installing a virtual appliance on VMware ESX. When installation is complete, a pop-up window informs you of the successful installation.
  7. You are now ready to start the Citrix ADC VPX instance. In the navigation pane, select the Citrix ADC VPX instance that you have installed and, from the right-click menu, select Power On.
  8. After the VM is booted, from the console, configure the Citrix ADC IP, Netmask, and Gateway addresses. When you complete the configuration, select the Save and Quit option in the console.
  9. If you want to install another virtual appliance, repeat through step 6.

Note

By default, the Citrix ADC VPX instance uses E1000 network interfaces.

After the installation, you can use vSphere client or vSphere Web Client to manage virtual appliances on VMware ESX.

For the VLAN tagging feature to work, on the VMware ESX, set the port group’s VLAN ID to 1–4095 on the vSwitch of VMware ESX server. For more information about setting a VLAN ID on the vSwitch of VMware ESX server, see http://www.vmware.com/pdf/esx3_vlan_wp.pdf.

Migrate a Citrix ADC VPX instance by using VMware vMotion

You can migrate a Citrix ADC VPX instance by using VMware vSphere vMotion.

Follow these usage guidelines:

  • VMware does not support the vMotion feature on virtual machines configured with PCI Passthrough and SR-IOV interfaces.
  • Supported interfaces are E1000 and VMXNET3. To use vMotion on your VPX instance, ensure that the instance is configured with a supported interface.
  • For more information about how to migrate an instance by using VMware vMotion, see VMware documentation.
Install a Citrix ADC VPX instance on VMware ESX