Using Wildcard Virtual Servers in NetScaler CPX Instance

When you provision a Citrix ADC instance, only one private IP address (single IP address) is assigned to a NetScaler 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 NetScaler 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 NetScaler CPX instance by the Docker engine.

In high availability NetScaler CPX deployments, you can add wildcard virtual servers on the primary NetScaler CPX instance. The configuration sync between nodes configures the wildcard virtual server on the secondary NetScaler CPX instance. It eliminates the need for configuring the virtual server on the NSIP assigned by the Docker engine to the NetScaler 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 NetScaler CPX Instance