Overview
This proof of concept guide is designed to provide a step-by-step method to deploy an instance of the NetScaler VPX on Nutanix AHV and prepare it for use. NetScaler VPX running on Nutanix AHV is supported through the Citrix Ready Program. This guide will assist in deploying a VPX appliance using Prism Element with some basic best practices. This guide will NOT cover the specific needs for every deployment. It is recommended that deployments and testing are conducted to define the best method for a particular need.
Nutanix Acropolis Hypervisor (AHV) is a modern and secure virtualization platform that powers VMs and containers for applications and cloud-native workloads on-premises and in public clouds that can run any application at any scale.
Prerequisites
This guide assumes the following prerequisites have been completed:
- Nutanix AHV is configured and ready for use
- Nutanix Prism Element will be used for the deployment (not Prism Central)
-
Sufficient resources are available to support the recommended VM configuration
- The NetScaler VPX requires a minimum of 2 vCPUs and 2 GB of RAM (4 GB RAM or more is recommended).
- At least one vNIC (2 or more vNICs recommended for Management and Production networks)
- At least 20 GB of disk space
- A basic understanding of Nutanix AHV
- A basic understanding of Nutanix Prism Element
- Familiarity with the Acropolis Command Line Interface (ACLI)
- Familiarity with the initial setup of a NetScaler VPX appliance.
Considerations for NetScaler VPX appliances
A proof of concept deployment is set up to try out different functions of the VPX appliance. With a POC deployment, customers can:
- Try different features
- Familiarize themselves with the environment
- Try different configurations to see how they impact performance, usability, etc.
A POC is not intended for production workloads and should only be utilized for learning and feasibility purposes.
Therefore, a virtual appliance running with (2) vCPUs, (4) GB RAM, and 20 GB of disc drive should be sufficient. In a production environment, it is recommended to provision the appliance with adequate resources for the expected workload. With a virtual appliance on Nutanix AHV, scaling up or down on resources is very easy, making the virtual appliance very flexible. To determine the required resources for your workload, use the following NetScaler Form Factors Datasheet
Deploying the NetScaler VPX
- Download the VPX virtual appliance (the example below shows the latest 14.1 version of the firmware, however other versions are available for AHV should this meet your business requirements)
- Download the “Citrix ADC VPX for KVM” file.
- On the first extraction, it will become a “tar” file. Extract that until you see the “.qcow2” and “.xml” files.
- Login to Prism Element (not Prism Central)
- From Home, select Settings
-
Choose Image Configuration
- Give the image a name
- Select the “DISK” image type
- Pick a storage container
- Choose “Upload a file” and navigate to the NetScaler VPX “.qcow2” file
- Choose “Save” to create the image
“ACTIVE”, this may take some time as Prism Element processes the image file.
8. Navigate to VM and then click Create VM
9. On the Create VM Screen, remove the CD ROM Drive
10 Add a new disk
- Select “Clone from the image service” from the drop-down menu
-
In the Bus Type, select “SCSI”
- Note: The NetScaler VPX has been deployed with PCI, SCSI, SATA, and IDE bus disks without issue
- Choose the NetScaler image that was uploaded
- Choose “Add”
recommended
14. Choose "Save"
-
To add the Serial Port
- SSH into the CVM using the username “nutanix” and the password you set for that account (You can find a list of CVM IP addresses in the “Hardware” section of the Prism Element console)
-
Enter the ACLI
acli
-
Enter the following command to create the serial port where <vmname> is the name you gave to the VPX Appliance
vm.serial_port_create <vmname> type=kServer index=0
At this point, you can snapshot the VM to be used as a template later should you wish to deploy more instances (an HA pair, for example).
Initial Configuration
- Power on the VM
- Launch the VNC console
- Watch the VM Boot
- Log in with the default credentials of nsrootnsroot You will be prompted to change the password. It is recommended that you change it at this time
-
Manually run the “config ns” command from the CLI
- Assign the IP
- Enter the NetMask
- Choose “Apply changes and exit”
When the appliance reboots, log back into the CLI and add the default route using the command below, replacing <default_route> with the default route assigned to the network that your NSIP resides on.
add route 0.0.0.0 0.0.0.0 <default_route>
- Save the configuration using the command below to ensure the default route persists during a reboot
save ns config
- Now you can connect to the GUI
After this point, the configuration proceeds like any other NetScaler setup.
Additional Considerations
High CPU usage
CPU usage will show high by default on NetScaler VPX appliances. If you desire to enable CPU sharing, then you should enable CPU Yield.
- From the GUI
set ns vpxparam -cpuyield YES
Running a pair of appliances for high availability (HA)
If you are going to run an HA pair of appliances, it is recommended that you set anti-affinity rules so the appliances will always be run on separate AHV hosts
To accomplish this:
- Login to the CVM via SSH
-
Create the VM group where <vmgroupname> is the name you give to the group of NetScalers you deployed on AHV
vm_group.create <vmgroupname>
-
Add the existing NetScalers to the group where <vmgroupname> is the name from the previous step, and <vm1name> and <vm2name> are the NetScaler VMs to be added to the group
vm_group.add_vms <vmgroupname> vm_list=<vm1name>,<vm2name>
-
Set the Anti-affinity rule where <vmgroupname> is the name given in step 2 above
vm_group.antiaffinity_set <vmgroupname>
Disaster Recovery and GSLB
Suppose multiple sites are to be used, and Global Server Load Balancing (GSLB) is utilized for access. In that case, it is recommended that an HA pair of NetScalers be deployed on AHV at both locations. You can then use Nutanix technologies such as DR replication to ensure the availability of your NetScaler pair should you experience a cluster outage. More information on Nutanix DR replication can be found here.
Resources
NetScaler Form Factors Datasheet
FAQ on Deploying a NetScaler VPX
There are no comments to display.
Create an account or sign in to comment
You need to be a member in order to leave a comment
Create an account
Sign up for a new account in our community. It's easy!
Register a new accountSign in
Already have an account? Sign in here.
Sign In Now