In NetScaler 12.0
In Citrix ADC
In All products
Product Documentation
In NetScaler 12.0
In Citrix ADC
In All products
NetScaler 12.0 NetScaler 11.1 NetScaler 11.0 NetScaler 10.5 NetScaler 10.1 NetScaler 10.0
View PDF

Configure a high-availability setup with a single IP address and a single NIC

January 6, 2019
Contributed by:  C

In a Microsoft Azure deployment, a high-availability configuration of two NetScaler VPX instances is achieved by using the Azure load balancer, which distributes the client traffic across the virtual servers configured on both the VPX instances.

Note

For a Citrix VPX high availability deployment on Azure cloud to work, you need a floating public IP (PIP) that can be moved between the two NetS high availability nodes. The Azure Load Balancer (ALB) provides that floating PIP, which is moved to the second node automatically in the event of a failover.

Two types of Azure load balancers are available for high availability:

  • Azure external load balancer: If the client traffic originates from the Internet, you have to deploy the external load balancer between the Internet and the NetScaler VPX instances to distribute client traffic.
  • Azure internal load balancer: If the client traffic originates from within the virtual network, or is forwarded by a gateway or firewall within the virtual network, you have to deploy the internal load balancer to distribute client traffic.

To achieve high availability on Azure, you must add the two VPX instances as a load balanced set and configure the NSG.

When two NetScaler VPX instances are configured in active-active mode, both instances must have the same configuration. The client traffic is distributed across the virtual servers in both the instances by the Azure load balancer. The VIP addresses in both the instances are different and should match the NSIP of that VPX instance.

The active-passive mode provides failover capability. In this mode, the VPX instances synchronize their configuration states. When the primary instance fails, the secondary instance takes over.

For information about high availability in NetScaler appliances, see High availability.

Before you begin

Note the following before you begin configuring the VPX instances in high availability mode in the Azure virtual network.

  • The two NetScaler VPX instances that you want to add to a load balanced set should be provisioned in the same virtual network.
  • A load balanced set applies only to a VM’s default NIC. Therefore the VIP has to be configured on the default NIC of the VPX instance.
  • In an active-passive deployment, the Azure load balancer monitors both the primary and the secondary VPX instance by sending them TCP probes. These TCP probes are sent on port 9000.

Summary of steps to configure a NetScaler VPX instance in a high-availability Mode

  1. Configure a resource group
  2. Configure a network security group
  3. Configure virtual network and its subnets
  4. Configure a storage account
  5. Configure an availability set
  6. Configure a NetScaler VPX instance
  7. Configure internal and external load balancers
  8. Configure health probes
  9. Configure backend pools
  10. Configure NAT rules
  11. Configure load balancing rules

After configuring all the resources, you can configure the VMs in high availability mode with either an external load balancer or with an internal load balancer.

This article provides procedures to configure resources specific to high availability mode. For procedures to configure the other resources, see Configure a NetScaler VPX standalone instance.

You need to set up two NetScaler VPX instances for high availability mode. To set up a NetScaler VPX instance, see the “Configuring a NetScaler VPX Instance” section in Configure a NetScaler standalone instance .

Configure internal and external load balancers

Create a load balancer to distribute traffic between the vidtaul machines that are part of the same virtual network. The load balancing features can load balance level 4 traffic and support only TCP and UDP traffic.

Configure an internal load balancer

  1. Click +New > Networking > Load Balancer.
  2. In the Create load balancer pane, enter the following details:
    • Name of the load balancer
    • Scheme - select Internal to configure an internal load balancer
    • Virtual network - select the newly created virtual network from the drop-down list
    • Subnet - select the associated subnet
    • IP address assignment - select Static
    • Private IP address - assign a private IP address for the internal load balancer
    • Resource group - select the newly created resource group from the drop-down list
  3. Click Create.

localized image

Configuring an external load balancer

  1. To create an external load balancer, follow similar steps as creating an internal load balancer with the following differences:
    • Schema - select Public
    • Public IP address - assign a public IP address to the external load balancer
  2. Click Create.

localized image

Configure a health probe on the load balancer

Create custom TCP or HTTP probes to monitor the health of the various server instances. When the VM fails to respond to the probe for three consecutive times, the Azure load balancer will not send the traffic to the nonresponsive VM.

  1. Click All resources and search for the load balancer that you created by typing the name in the search box.
  2. In the Settings pane, click Probes.

localized image

3.  Click +Add and in the Add probe pane, enter the following details:

  • Name of the health probe
  • Protocol - select TCP
  • Port - type 9000
  • Set the Interval and Unhealthy threshold limits

4.  Click OK.

localized image

Configure a backend pool on the load balancer

Create backend pools, that is, a pool of IP addresses associated with the virtual machine Network Interface Cards (NIC) to which the load is distributed.

  1. Click All resources and search for the load balancer that you have created by typing the name in the search box.
  2. In the Settings pane, select Backend pools.
  3. Click +Add and in the Add backend pool pane, enter the following details:
    • Name of the backend pool
    • Availability set - select the availability set created earlier
    • Virtual machines - select the NetScaler VPX instances that are in high availability deployment. Press <Ctrl> to select multiple instances.
  4. Click OK.

localized image

Configure a NAT rule on the load balancer

Create custom NAT rules on LB to define the inbound traffic flowing through the front end IP address and distributed to the back end IP address. Make sure that no two NAT rules has the combination of same service and same target port.

Note

A front end IP address is the external IP address on the load balancer that faces the incoming traffic and a back end IP address is the VM facing IP address that receives the traffic from the load balancer.

  1. Click All resources and search for the load balancer that you have created by typing the name in the search box.
  2. In the Settings pane, select Inbound NAT rules.
  3. Click +Add and in the Add inbound NAT rule pane, add a NAT rule for each type of request. You can add multiple NAT rules.
  4. Enter the following details, and then click OK.
    • Name of the rule
    • Service - select the required service from the drop-down list
    • Port - type the correct port number
    • Target - select the NetScaler VPX that will be the target of this rule
    • Target port - the target port is automatically populated depending on the service selected

Note

Citrix recommends TCP services for the NetScaler VPX VM on port 9000.

localized image

Configure a load balancing rule on the load balancer

By creating a load balancer rule, you can define a combination of a front end IP address and port, and back end IP address and port associated with VMs.

For example, create a rule so that all HTTP requests coming on the public IP will be forwarded to the availability set on their port 80.

  1. Click All resources and search for the load balancer that you have created by typing the name in the search box.
  2. In the Settings pane, select Load balancing rules.
  3. Click +Add and in the Add load balancing rules pane, create load balancing rules for each type of incoming network traffic.
  4. Enter the following details:
    • Name of the rule
    • Protocol - select the protocol
    • Port - type the port number based on the port selected
    • Backend pool - select the backend pool from the drop-down list
    • Probe - select the health probe from the drop-down list
  5. Click OK.

localized image

Configure NetScaler VPX high availability with the Azure external load balancer

If your client traffic originates from the Internet, you have to deploy the external load balancer to create a high availability configuration of NetScaler VPX instances in a load-balanced set.

The following figure shows how high availability is achieved in active-active mode by using the external load balancer. The two VPX instances are in a load-balanced set that accepts client traffic from the Internet over port 15000. The Azure external load balancer load balances these client requests between the two virtual machines.

localized image

Before you begin configuring the load-balanced set through the Azure portal, do one of the following:

  • For an active-passive deployment, configure the NetScaler VPX instances as primary and secondary nodes by using the following command: add ha node <ID> <IP address>.
  • For an active-active deployment, configure the required services on the two NetScaler VPX instances.

Configure NetScaler VPX high availability with the Azure internal load balancer

If your client traffic originates from within the virtual network with a regional scope, you have to deploy the internal load balancer to achieve high availability of NetScaler VPX instances added to a load-balanced set.

The following figure shows how high availability is achieved in an active-active mode by using the internal load balancer. The two NetScaler VPX instances are in a load-balanced set that accepts client traffic from the Internet at port 15001. The Azure internal load balancer load balances these client requests between the two virtual machines.

localized image

Before you begin configuring the load-balanced set by using Azure PowerShell, do one of the following:

  • For an active-passive deployment, configure the NetScaler VPX instances as primary and secondary nodes by using the following command: add ha node <ID> <IP address>.
  • For an active-active deployment, configure the required services on the two NetScaler VPX instances.

You can configure the load-balanced set only by using Azure PowerShell.

Access the NetScaler VPX instance

You can access the VPX instance either through its graphical user interface (GUI) or through the command line interface (CLI). You can use the PIP to access the NetScaler VPX instance instance.

To log on to the virtual machine, use your username and password specified while creating the virtual machine.

You can change the password after you log on to the instance.

Access the VPX instance through the GUI

In a browser’s address field, type the virtual network public IP address provided by Azure during virtual machine provisioning, or type the PIP address.

Note

Make sure you have created NSG inbound or outbound rules to allow access to the private port 80 or 443 when accessing the GUI by using the virtual network IP.

Access the VPX instance through the CLI

Use any command line access tool (for example, Putty). Specify either the virtual network public IP address provided by Azure during NetScaler VPX provisioning, or specify the PIP address. Use SSH protocol with port 22.

Note

Make sure that you have created NSG inbound or outbound rules to allow access to private port 22 when accessing the CLI by using the virtual network IP.

For information about getting started with a NetScaler appliance, see the Getting started with NetScaler.

Configure a high-availability setup with a single IP address and a single NIC

January 6, 2019
Contributed by:  C

In this article

Edit this article