Advisory · Projects · Speaking LinkedIn GitHub Credly IT EN

Access · Citrix

Citrix ADC VPX on NUTANIX AHV

While refreshing my lab, I also needed to migrate the Citrix ADC installations, which were previously running on VMware, to NUTANIX AHV.

Below I walk you, step by step, through what you need to do to install a Citrix ADC VPX on NUTANIX.

The first step is to download the Citrix ADC VPX image in the version built for KVM.

Citrix ADC VPX for KVM

In the lab I’m interested in testing what’s new in the latest Citrix ADC version which, as of today, is version 13.0 Build 52.24; in production, on the other hand, I recommend sticking with x.1 versions, for example 12.1 (they are the versions considered the most stable).

Extract the .tgz file, which contains a .qcow2 file, an .xml file and a checksum.txt.

Files contained in the .tgz

Log in to Prism (or Prism Central, if you have it) and go to the image management section. For example, in Prism Central, this is where it is:

Click “Virtual Infrastructure–>Images”
Click Add Image
Select the .qcow2 file
Click “Save”

Now you need to wait for the image to upload, and you can check its progress here:

Running task

When the upload is complete, we need to create a new virtual machine and attach the disk we just uploaded to it. So we can go back to Prism and create the new VM:

Fill in the VM settings
Click “Add New Disk”
Select Bus Type: IDE

Remove the CD-ROM, which is there by default, and change the Boot configuration:

Add the NICs you need (in my case two, one on the local network and one in the DMZ) and create the VM.

If you need to create NICs with specific MAC addresses (for example to reuse a pre-assigned Citrix license), you have to create the NICs with the following command (run over SSH from a CVM):

acli vm.nic_create <vm name> network=<network name> mac=<new MAC address>
VM created

You can’t power on the newly created VM yet.
Connect over SSH to a CVM in the cluster and run the following command (replacing <vm_name> with the name of the virtual machine, enclosed in “”):

acli vm.serial_port_create <vm_name> type=kServer index=0

This command adds a virtual serial port to the VM you just created. Without the virtual serial port, the VM may not boot properly and may hang during power-on.

When you start the VM now, you can choose the type of console access: VNC or via the serial stream (COM1):

Console access type for the Citrix ADC VM
Wait for the firmware to load…

And here we are with a new Citrix ADC VPX instance, ready to be configured:

To assign an NSIP address, which you’ll use to reach the Citrix ADC web interface, you need to run the following commands from the console (after logging in as nsroot/nsroot):

  • set ns config -IPAddress <ip_addr> -netmask <netmask>
  • show ns config
  • add route 0 0 <gateway IP address>
  • show route
  • save config
  • reboot

At this point, once the reboot is complete, you can access the new Citrix ADC VPX instance from the web: