Deploying Citrix NetScaler on Nutanix AHV

Citrix NetScaler VPX, the virtual appliance, is available for XenServer, VMWare ESX, Microsoft Hyper-V and KVM hypervisors. Since Nutanix AHV is based on KVM, it is possible to run your NetScaler VPX on the Nutanix native Acropolis hypervisor AHV.

NetScaler Gateway VPX is a virtual NetScaler Gateway appliance that is hosted on a hypervisor. NetScaler Gateway VPX supports all the features and functionality of the physical NetScaler Gateway appliance.

Kees Baggerman (@KBaggerman) wrote an article, published on his blog some time ago. With the latest release of Citrix NetScaler 12.0 and a couple of Nutanix releases later, I was wondering if this is still working and if we can simplify the deployment steps needed. My facit is yes it works, and yes it has become easier. Here is my how-to deploy Citrix NetScaler 12.0 on Nutanix AHV.

  1. As a first step you need to download the NetScaler VPX for KVM Build from

    Download the NetScaler VPX Appliance for KVM Build
  2. The download is a .tgz archive. We need to extract the disk image from this file. I used 7-Zip to grab the NSVPX-KVM-12.0-41.16_nc.qcow2 file. That’s all we need to deploy our NetScaler VPX on Nutanix Acropolis Hypervisor.

    Extract the Disk Image
  3. Now we need to upload this disk image to the Image Configuration within Nutanix Prism. Place the image in the container where you also want sit your NetScaler VPX disk.

    Create Image
    Upload the Disk Image to the Image Configuration
  4. Create the NetScaler VM with at least 2 vCPUs and 4 GB memory, remove the CDROM  from the disk section and add a NIC sitting in your desired VLAN.

    Create VM, Remove CDROM, Add NIC
  5. Add a disk by cloning from Image Services and selecting your uploaded disk image from step 1. Make sure to choose IDE as bus type. Save your settings and create the VM.

    Add IDE Disk, Clone from Image Service
  6. To make our NetScaler VM bootable it is still necessary to add a serial port to the VM. This can be done only through CLI, so we have to connect to the Nutanix CVM and execute the following command. Replace with the name of your NetScaler VM created in step 3.

    acli vm.serial_port_create <VM Name> type=kServer index=0

    Add a serial port to the VM
  7. Now we are ready and can power on the VM. If everything works as expected, the NetScaler VPX will boot and we can move on with the initial IP configuration through command line.

    Boot the NetScaler VPX VM
  8. Log in to the NetScaler CLI with the default user / password, which is nsroot / nsroot. From here you can do the initial IP configuration by entering config ns.

    config ns

    Setup NetScaler’s IP adress and Netmask
  9. Probably the IP of your NetScaler will not be in the same Subnet as your management station, so you also have to set a default gateway. This is done  via CLI.

    add route . X.X.X.X

    Set the Default Gateway

    Don’t forget to save your config.

    save ns config

    Reboot your NetScaler.


  10. After the reboot you can browse to the NetScaler IP and log into the management interface to set up and configure all the shiny NetScaler features.
    Log into the NetScaler Management Interface

    Start your NetScaler fun

10 thoughts on “Deploying Citrix NetScaler on Nutanix AHV”

  1. Great guide but when I try to login with nsroot/nsroot I get this message> nsnet_connect: No such file or directory – Do you have any suggestions to why that message appears? I’m using this NS build: on a Nutanix CE


    1. Hi Andreas, thanks for the feedback! Try to delete the by default created cdrom before adding the KVM file and Image creation service in step 5. If you leave the cdrom it takes up ide 0 and the disk gets ide 1. Make sure your NS image runs on ide 0, this should help with your issue.


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: