Using Wildcard Virtual Servers in Citrix ADC CPX Instance

When you provision a Citrix ADC instance, only one private IP address (single IP address) is assigned to a Citrix ADC CPX instance by the Docker engine. The three IP functions of a Citrix ADC instance are multiplexed onto one IP address. This single IP address uses different port numbers to function as the NSIP, SNIP, and VIPs.

The single IP address that is assigned by the Docker engine is dynamic. Add the Load Balancing (LB) or Content Switching (CS) virtual servers using the single IP address or using the 127.0.0.1 IP address. The virtual servers created using 127.0.0.1 is called as Wildcard Virtual Servers. By default, when you create a wildcard virtual server, the Citrix ADC CPX replaces the assigned IP address of the wildcard virtual server. The assigned IP address is 127.0.0.1, which is replaced with the NSIP assigned to the Citrix ADC CPX instance by the Docker engine.

In high availability Citrix ADC CPX deployments, you can add wildcard virtual servers on the primary Citrix ADC CPX instance. The configuration sync between nodes configures the wildcard virtual server on the secondary Citrix ADC CPX instance. It eliminates the need for configuring the virtual server on the NSIP assigned by the Docker engine to the Citrix ADC CPX instances.

Points to Note:

  • Ensure that the port number that you assign to the wildcard virtual server is not used by any other virtual server in the deployment.
  • Wildcard virtual server addition fails if the port number that you assign to the wildcard virtual server is already in use by the internal services.
  • The wildcard virtual server does not support the * character.

To create a wildcard load balancing virtual server, at the command prompt, enter the following command:

    add lb vserver <name> <serviceType> 127.0.0.1 <port>

    add lb vserver testlbvserver HTTP 127.0.0.1 30000
<!--NeedCopy-->

To create a wildcard content switching virtual server, at the command prompt, enter the following command:

    add cs vserver <name> <serviceType> 127.0.0.1 <port>

    add cs vserver testcsvserver HTTP 127.0.0.1 30000
<!--NeedCopy-->
Using Wildcard Virtual Servers in Citrix ADC CPX Instance

In this article