5.1. General Compatibility 6.0.1¶
This section describes compatibility issues that affect the Connext suite in release 6.0.1. Unless noted otherwise, the issues in this section do not apply to Connext Micro.
5.1.1. Platforms¶
Note
For information on new and removed platforms in this release, see What’s New in 6.0.1. See also individual products’ Release Notes.
5.1.2. Wire Compatibility¶
5.1.2.1. RTPS Versions¶
See Section 6.1.2.1 for more information about the RTPS versions supported for each Connext release.
5.1.2.2. Fragmentation is now independent of sample serialized size¶
In 6.0.1, when using a FlowController, the fragment size for a sample should be either
(a) bytes_per_token or (b) the smallest of the message_size_max values across all
transports installed with the DataWriter, whichever is less.
In previous releases, however, if the serialized size of the sample was smaller
than or equal to the maximum message size of the transport with which the sample
was sent, minus some protocol overhead (512 bytes by default), Connext chose the
maximum message size of the transport as the fragment size, ignoring bytes_per_token,
which may be smaller.
This behavior may have led to a bursty behavior of the FlowController that resulted in not sending fragments every period but sending them only when enough tokens were accumulated to send the full sample.
This problem has been resolved. (See RTI Issue ID CORE-9287 in
“Fixes Related to Reliability Protocol and Wire Representation” in the RTI Connext Core Libraries Release Notes.)
Now when the serialized size of a sample when using a FlowController is smaller than
or equal to the maximum message size of the transport as described above, the fragment
size for the sample is the lesser of (a) bytes_per_token or (b) the smallest of the
message_size_max values across all transports installed with the DataWriter.
If you need to go back to the old behavior, before this fix, please contact support@rti.com.
5.1.3. Type System Compatibility¶
5.1.3.1. Wire representation of TypeObject¶
In 6.0.0, Connext enabled TypeObject compression by default to reduce
bandwidth usage when exchanging endpoint discovery data.
See Section 6.1.4.2. The compressed TypeObject (TypeObjectLb)
deserialization depended on the DDS_DomainParticipantResourceLimitsQosPolicy’s
type_object_max_serialized_length to control the maximum size of the buffer that
Connext uses to uncompress the received compressed TypeObject.
Starting in 6.0.1, this uncompression buffer is no longer controlled by the
DDS_DomainParticipantResourceLimitsQosPolicy’s type_object_max_serialized_length
(default value: 8192 bytes). Instead, it is controlled by the
DDS_DomainParticipantResourceLimitsQosPolicy’s type_object_max_deserialized_length
(default value: DDS_LENGTH_UNLIMITED).
As a result, you can now configure Connext to only receive (but not propagate) compressed
TypeObjects by setting type_object_max_serialized_length to zero and keeping
type_object_max_deserialized_length set to DDS_LENGTH_UNLIMITED.
5.1.3.2. Incompatibility issues for Java and .Net when using XCDR2¶
Starting in 6.0.0, Connext supports the Extended Common Data Representation (CDR) encoding version 2 (XCDR2), in addition to version 1 (XCDR). XCDR2 is supported in both Connext and Connext Micro. See Section 6.1.4.1 for details.
Support for XCDR2 introduced some bugs in 6.0.0 that were addressed in 6.0.1. (For details, see RTI Issue IDs CODEGENII-1197, CODEGENII-1198, and CODEGENII-1206 in “What’s Fixed in 3.0.1” in the Code Generator Release Notes.) Fixing those bugs broke backward compatibility with 6.0.0. Therefore, applications in Java or .Net in release 6.0.1 or above may not interoperate with applications in another language in 6.0.0, and vice-versa (applications in Java or .Net in release 6.0.0 may not interoperate with applications in another language in 6.0.1 or above).
5.1.4. Other Compatibility Issues¶
5.1.4.1. Large data support for Multichannel and TopicQuery has been disabled¶
Due to the Known Issue described in “Multichannel and TopicQuery do not Work with Large Data in Some Cases,” in the RTI Connext Core Libraries Release Notes, large data support for Multichannel and TopicQuery has been disabled in release 6.0.1. If you need this functionality enabled as it was in 6.0.0, please contact RTI support (support@rti.com). This functionality has been re-enabled in 6.1.0.