UDT

UDT is a high performance data transfer protocol based on the User Datagram Protocol (UDP). It is a new generation protocol that can transfer large files for a short time like UDP but with its own reliability control and congestion control mechanisms. In addition, multiple UDT flows can share a single UDP port, thus a firewall can open only one UDP port for all UDT connections.

MassTransit UDT transfer mode can give you better performance than TCP/IP in some network environments (mainly wide area networks – WAN). Parameters including latency, packet loss, and bandwidth – all can be factors in the improved performance, possible with UDT transfer mode.

To determine if using UDT is beneficial, it is best to compare the transfer speeds between UDT and TCP/IP in your real world situation with typical file size transfers.

Note: UDT communication method is available in MassTransit HP only.

Configuring UDT Incoming Calls


To receive an incoming UDT call on your MassTransit HP Server, you need to configure an UDT Listen.

Info: In MassTransit HP 7.0.1, there is a new option available to prevent "File Transfer Failed" actions firing (if configured) when Receive Files From User or Send Files To User general privileges are disabled.

When Send Files To User or Receive Files From User privileges are disabled and there are files for sending or receiving on TCP/IP connections, a warning is logged. This warning causes actions with File Transfer Fails trigger condition to fire. This behavior can be disabled by setting the "LOG_SEND_RECV_PRIVILEGE_AS_WARNING" parameter in the MassTransitEngine.cfg file (the file is located in the MassTransit installation directory) to false as shown below:
    LOG_SEND_RECV_PRIVILEGE_AS_WARNING = FALSE
This will cause the messages to be logged as "Info" instead of "Warning", which will prevent the "File Transfer Fails" actions from firing. You must restart the MassTransit service for changes to apply.

Info: For information about available additional configurations, see the Additional Configurations section on this page.

Configuring an UDT Listen

Note: MassTransit allows you to configure multiple UDT listens.

To receive an incoming UDT call, you first need a UDT Listen:

  1. In MassTransit Administrator, open the Setup window by clicking on the Setup button from the Navigation Bar or select the Setup... option from the Window main menu.
  2. In the Incoming Calls tab, click on the Add... button.
  3. The "Add Incoming Call" window appears. From the Method drop-down menu, select the UDT option.
  4. The Configure UDT for Incoming Calls window appears. Select the IP address you want MassTransit to listen on from the IP Address to listen on for incoming calls drop-down menu. MassTransit will use only that address to listen on.

    Note: You can set the UDT listen to the same IP address and port number as set in one of the TCP/IP listens. In that case, if a Web client contact uses UDT as a default communication method and an error occurs with the UDT connection, the Web client contact will automatically failover to TCP/IP communication. In case the Web client contact uses an older version of the MassTransit Assistant, that does not support UDT, the connection will also be switched to TCP/IP.

  5.  Enter the port number that will be used for the UDT connection in the Port field, or leave the default setting.

    Note: If you or the calling party have/has a firewall, it must be set to allow traffic on this port.

  6. Click on the OK button to save the changed settings. The configured UDT method should appear as active in the Setup window.
  7. Click on the OK button in the Setup window.

You should be able to receive incoming UDT calls now.

Enabling and Disabling the Listen

In the "Incoming Calls" tab of the Setup window, all created listens are listed. In the first column of the list, there is an indicator showing whether the listen is enabled or not.