Protocol extensions - traffic pipeline for user defined TCP client and server behaviors

January 25, 2019

Contributed by: C

The following figure illustrates the sample protocol extension - traffic pipeline for user defined TCP client and server behaviors

localized image

Add a custom protocol by using protocol extensions

The command line interface (CLI) commands for custom protocol use the keyword “user” to signify the user defined nature of the underlying configuration entities. With the help of extension code, you can add a new user protocol to the system and add user virtual servers for user-defined protocols. The user virtual servers are in turn configurable by setting parameters. Configured values for virtual server parameters are available in the extension code.

The following example illustrates the user flow for adding support for a new protocol. The example adds MQTT protocol support to the system. MQTT is a machine-to-machine “Internet of Things” connectivity protocol. It is a lightweight publish/subscribe messaging transport. Useful for connections with remote locations, this protocol uses client and broker tools to publish messages to subscribers.

1. Import the MQTT protocol extension implementation file to Citrix ADC system. The code listing for mqtt.lua is given below. The example below imports the MQTT extension file hosted on a webserver.

import extension http://10.217.24.48/extensions/mqtt.lua mqtt_code

2. Add a new user TCP based protocol to the system using the extension.

add user protocol MQTT -transport TCP -extension mqtt_code

3. Add a user load balancing vserver and bind backend services to it.

add service mqtt_svr1 10.217.24.48 USER_TCP 1501
add service mqtt_svr2 10.217.24.48 USER_TCP 1502
add lb vserver mqtt_lb USER_TCP –lbmethod USER_TOKEN
bind lb vserver mqtt_lb mqtt_svr1
bind lb vserver mqtt_lb mqtt_svr2

4. Add a user vserver for the newly added protocol. Set the defaultlb to the LB vserver configured above.

add user vserver mqtt_vs MQTT 10.217.24.28 8765 -defaultLb mqtt_lb

5. Optionally, enable MQTT session persistence based on ClientID, set the persistence type to USERSESSION.

set lb vserver mqtt_lb -persistenceType USERSESSION

The official version of this content is in English. Some of the Citrix documentation content is machine translated for your convenience only. Citrix has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Citrix product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Citrix, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Citrix will not be held responsible for any damage or issues that may arise from using machine-translated content.

Edit this article

Protocol extensions - traffic pipeline for user defined TCP client and server behaviors

January 25, 2019

Contributed by: C

Protocol extensions - traffic pipeline for user defined TCP client and server behaviors

Add a custom protocol by using protocol extensions

Protocol extensions - traffic pipeline for user defined TCP client and server behaviors

In this article