Product Documentation
ADC
14.1 - Current Release 13.1 13.0 12.1
View PDF

Configuring Video Optimization over UDP

August 20, 2024
Contributed by: 
C C S

To optimize QUIC ABR video traffic over UDP, begin by enabling the video optimization feature. After you complete the configuration, the appliance detects QUIC based ABR video traffic and applies the optimization bit rate that is configured on the appliance.  

Configuring video optimization for QUIC by using the CLI

To configure video optimization for QUIC video traffic over UDP, you must perform the following tasks:

  1. Enable Video Optimization.
  2. Create a QUIC service.
  3. Create a QUIC load balancing virtual server.
  4. Bind QUIC web service to the loading balancing virtual server.
  5. Create video optimization policy for pacing QUIC based UDP traffic.
  6. Bind optimization policy to a QUIC based load balancing virtual server.

Enabling video optimization for QUIC traffic

If you want the Citrix ADC appliance to detect, optimize, and report video traffic, you must enable the Video Optimization feature and set optimization ON.

Note

If you want to use video optimization for QUIC traffic, you must enable the load balancing and AppFlow features.

To enable the video optimization

 At the command prompt, type the following command:

enable ns feature VideoOptimization
<!--NeedCopy-->

Creating a service for QUIC traffic

A Citrix ADC appliance uses a QUIC service for the load balancing virtual server to connect to the egress router in the static routing mode.

Note

Currently, dynamic routing is not supported.

To create a load balancing web service for QUIC video traffic

At the command prompt, type:

add service <name> <router-IP> <serviceType> <port> -usip yes -useproxyport  [yes | no]
<!--NeedCopy-->

Example:

add service svc-quic 10.102.29.200 QUIC 443 –usip yes –useproxyport no

where IP address is the internet router address.
<!--NeedCopy-->

Creating a load balancing virtual server for QUIC traffic

A Citrix ADC appliance uses a load balancing virtual server for detecting and optimizing QUIC video traffic over UDP.

To create a load balancing virtual server for QUIC video traffic

At the command prompt, type:

add lb vserver <name> <serviceType> <ip> <port> -m MAC
<!--NeedCopy-->

Example:

add lb vserver vs-quic QUIC * 443 -persistenceType NONE -m MAC -cltTimeout 120
<!--NeedCopy-->

Binding a QUIC web service to the load balancing virtual server

After you have created the web services and load balancing virtual server for QUIC traffic, you must bind the services to the virtual server.

To bind a web service to load balancing virtual server for QUIC video traffic

At the command prompt, type:

bind lb vserver <name> <serviceName>
<!--NeedCopy-->

Example:

bind lb vserver vs-quic svc-quic
<!--NeedCopy-->

Creating Video Optimization Policy for QUIC based UDP traffic

To optimize QUIC based UDP traffic, you have to configure optimization pacing policies and its actions. You must then, bind the policies to QUIC based load balancing virtual servers. For each policy, create an action first so that you can associate it to the policy.

To add an optimization action

At the command prompt, type:

add videooptimization pacingaction <action Name> -rate <integer> [-comment <string>]
<!--NeedCopy-->

Where, the rate parameter specifies the rate in Kbps at which to send the traffic (the pacing rate).

Example:

set videooptimization parameter -QUICPacingRate 1000
<!--NeedCopy-->

where 1000 represents the desired pacing rate in Kbits/sec.

To add an optimization policy

At the command prompt, type:

add videooptimization pacingpolicy <name> -rule <expression> -action <string>
<!--NeedCopy-->

Example:

add videooptimization pacingpolicy myOptPolicy2000 -rule TRUE -action MyOptAct2000
<!--NeedCopy-->

Binding Optimization Policies to a QUIC Load Balancing Virtual Server

To optimize QUIC video traffic over a UDP connection, you must bind the optimization policies to a QUIC load balancing virtual server.

To bind an optimization policy to a QUIC Load Balancing virtual server

At the command prompt, type the following command:

bind lb vserver <name> -policyName <policy_name> -priority <positive_integer> -type (REQUEST)
<!--NeedCopy-->

Note

The pacing policies must be bound to a QUIC load balancing virtual server only at request time.  

Example:

bind lb vserver vs-quic -policyName myOptPolicy2000 -priority 3400 -type  REQUEST
<!--NeedCopy-->

Configuring video optimization for QUIC by using the GUI

To configure the feature on the appliance through the GUI, you must perform the following tasks:

  1. Enable video optimization
  2. Configure a QUIC servers
  3. Configure QUIC service
  4. Configure a QUIC load balancing virtual server
  5. Bind the QUIC web service to the load balancing virtual server
  6. Create optimization policy.
  7. Create optimization action.
  8. Configuring optimization pacing parameter.
  9. Bind optimization policy to load balancing virtual server for QUIC traffic.

To enable video optimization

  1. Log on to the Citrix ADC appliance and navigate to System > Settings.
  2. On the details page, select Configure Advanced Features link.
  3. On the Configure Advanced Features page, select the Video Optimization check box.

To create a QUIC servers

  1. Log on to the Citrix ADC appliance and navigate to the Traffic Management > Load Balancing > Servers screen.
  2. In the details pane, click Add.
  3. On the Create Server page, set the following parameters:
    1. Name. Name of the QUIC server.
    2. IP address. IP address of the QUIC server
    3. Traffic Domain. Domain name of the server.
    4. Enabling after creating. Initial state of the server.
    5. Comments. Brief information about the server.
  4. Click Create.

To create a QUIC service

  1. Log on to the Citrix ADC appliance and navigate to the Traffic Management > Load Balancing > Services screen.
  2. In the details pane, click Add.
  3. On the Load Balancing Service page, set the following parameters:
    1. Service Name. Name of the QUIC service.
    2. IP address. IP address assigned to the QUIC service.
    3. Protocol. Select protocol as QUIC.
    4. Port. Port number of the web service.
  4. Click OK to continue. You can then configure other, optional, parameters. For more, see Configuring Services.
  5. Once you configure the optional parameters, click OK and Close.

To create a load balancing virtual server

  1. Log on to the Citrix ADC appliance and navigate to the Traffic Management > Load Balancing > Virtual Servers screen.
  2. In the details pane, click Add.
  3. On the Load Balancing Virtual Server page, set the following parameters:
    1. Name. Name of the load balancing virtual server.
    2. Protocol. The protocol used by the service to send QUIC requests.
    3. IP Address Type. IP address type: IPv4 or IPv6.
    4. IP Address. IP 4 or IP6 IP address assigned to the virtual server.
    5. Port. Port number of the virtual server.
  4. Click OK to continue with the configuration of other, optional, parameters. For more information, see Creating a Virtual Server.

To bind a load balancing virtual server to a QUIC service

  1. Navigate to Traffic Management > Load Balancing > Virtual Servers, and select a virtual server.
  2. Click Services and Service Groups to access the Load Balancing Virtual Server Service Binding screen.
  3. Select a QUIC based web service and click Bind.
  4. Click Done.

To bind a load balancing virtual server to a QUIC service

  1. Navigate to Traffic Management > Load Balancing > Virtual Servers, and select a virtual server.
  2. Click Services and Service Groups  to access the Load Balancing Virtual Server Service Binding screen.
  3. Select a QUIC based web service and click Bind.
  4. Click Done.

To create a video optimization action for QUIC traffic

  1. Log on to the Citrix ADC appliance and navigate to Configuration > Optimization > Video Optimization > Pacing > Actions.
  2. In the details pane, click Add.
  3. On the Create Video Optimization Pacing Action page, set the following parameters.
    1. Name. Name of the optimization action.
    2. ABR Optimization Rate (Kbps). Pacing rate at which to send the ABR video traffic. The default rate for ABR optimization is 1000 Kbps. The minimum value is 1, and the maximum value is 2147483647.
    3. Comment. A short description of the action.
  4. Click Create and Close.

To create a video optimization policy for QUIC traffic

  1. Log on to the Citrix ADC appliance and navigate to Configuration > Optimization > Video Optimization > Pacing > Policies.
  2. In the details pane, click Add.
  3. On the Create Video Optimization Pacing Policy page, set the following parameters.
    1. Name. Name of the optimization policy
    2. Expression. Custom regrex expressions that implement the policy.
    3. Action. Optimization action associated with the policy to handle the incoming video traffic.
    4. UNDEF Action. Undefined event if the incoming request does not match the optimization policy.
    5. Comment. A short description of the policy.
    6. Log Action. Select the audit log action that creates the desired log messages.
  4. Click Create, and then click Close.

To bind a video optimization policy to an QUIC load balancing virtual server

  1. Log on to the Citrix ADC appliance and navigate to Configuration > Optimization > Video Optimization.
  2. On the Video Optimization page, click the Video Optimization Pacing Policy Manager link.
  3. On the Video Optimization Policy Manager page, set the following parameters.
    1. Bind Point. The point at which to apply the optimization policy during request processing. Note: The pacing policies must be bound to a QUIC load balancing virtual server only at request time.
    2. Connection Type.  Connection type as Request or Response.
    3. Virtual Server. The load balancing virtual server to which to bind the policy.
  4. Click Continue.
  5. In the Bind Point section, do one of the following:
    1. Select a policy from the list.
    2. Click Add Binding to access the Policies Binding slider.
      1. Select an existing policy or add a new policy.
      2. Enter binding details and click Bind.
  6. Click Close.
Configuring Video Optimization over UDP
August 20, 2024
Contributed by: 
C C S
August 20, 2024
Contributed by: 
C C S

In this article

Site feedback | Your privacy choices footer linkYour Privacy Choices | Privacy and legal terms | Cookie preferences | Consent settings | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.