In Citrix ADC 12.1
In Citrix ADC
In All products
Product Documentation
In Citrix ADC 12.1
In Citrix ADC
In All products
Citrix ADC 12.1 Citrix ADC 13.0
View PDF

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

January 25, 2019
Contributed by:  C

In a Microsoft Azure deployment, a high-availability configuration of two Citrix ADC VPX instances is achieved by using the Azure Load Balancer (ALB). This is achieved by configuring a health probe on ALB, which monitors each VPX instance by sending health probe at every 5 seconds to both primary and secondary instances.

In this setup, only the primary node responds to health probes and secondary does not. Once the primary sends the response to the health probe, the ALB starts sending the data traffic to the instance. If the primary instance misses two consecutive health probes, ALB does not redirect traffic to that instance. On failover, the new primary starts responding to health probes and the ALB redirects traffic to it. The standard VPX high availability failover time is three seconds. The total failover time that might take for traffic switching can be maximum of 13 seconds

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 Citrix ADC 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 Citrix ADC 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 Network Security Group.

When two Citrix ADC VPX instances are configured in active-passive mode, both instances must have the same configuration. 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 Citrix ADC 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 Citrix ADC 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, configure the VIP 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 Citrix ADC 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 Citrix ADC 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 Citrix ADC VPX standalone instance.

For high availability mode, set up two Citrix ADC VPX instances for high availability mode. For more information, see the “Configuring a Citrix ADC VPX Instance” section in Configure a NetScaler standalone instance.

Configure internal and external load balancers

Create a load balancer to distribute traffic between the virtual 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 stops sending 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 Citrix ADC 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 have the combination of the 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 Citrix ADC VPX that is 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 Citrix ADC 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 are 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 Citrix ADC 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 Citrix ADC 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 the 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 Citrix ADC 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 Citrix ADC VPX instances.

Configure Citrix ADC 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 Citrix ADC 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 Citrix ADC 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 the 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 Citrix ADC 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 Citrix ADC VPX instances.

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

Access the Citrix ADC 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 Citrix ADC VPX 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 Network Security Group 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 Citrix ADC VPX provisioning, or specify the PIP address. Use SSH protocol with port 22.

Note

Make sure that you have created Network Security Group 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 Citrix ADC appliance, see the Getting started with Citrix ADC.

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

January 25, 2019
Contributed by:  C

In this article

Edit this article