1. Upgrade Overview

1.1. Upgrade Path

This document describes how to upgrade from RTI® Connext® DDS release 5.3.1 to Connext 6. For instructions on migrating from releases older than 5.3.1 to Connext 6, see the Compatibility and Migration chapters of the 5.3.1 Core Libraries Release Notes and other products as needed on the 5.3.1 Community Portal. Then return to this document for additional considerations for migrating from 5.3.1 to Connext 6.

Upgrade Overview

Figure 1.1 Migrate Step-Wise
  1. For information on upgrading to 5.3.1 from any previous release, see the 5.3.1 Core Libraries Release Notes.
  2. For information on upgrading from 5.3.1 to 6.0.0, see Section 3.
  3. For information on upgrading from 6.0.0 to 6.0.1, see Section 2.

Whether you will keep some of your legacy Connext DDS systems or migrate entirely to Connext 6, read this guide to see what settings or other changes you may need to make before you upgrade all or part of your system to Connext 6. You may also want to see What’s New in 6.0.1 and What’s New in 6.0.0, as well as the Core Libraries Release Notes, for other new or changed features in Connext 6. This guide describes only those changes that may break old behavior.

Note

If you are migrating from 5.3.1 directly to Release 6.0.1, read this entire Migration Guide: both 6.0.0 (Section 3) and 6.0.1 (Section 2) sections apply to you. If you are migrating from Release 6.0.0, read just the 6.0.1 section (Section 2).

1.2. Upgrade Steps

Whether you are upgrading to 6.0.0 or 6.0.1 (including upgrading from 6.0.0 to 6.0.1), you will need to perform the following steps. You will need to regenerate the type-specific code that was generated from your IDL, XML, or XSD definitions with the new version of rtiddsgen, and then recompile and re-link your applications with the new versions of the Connext DDS libraries.

  1. Make the changes required for your system, based on the compatibility issues described in this guide:

    • See the Product-Specific Compatibility sections (Section 3.2 and Section 2.2).

    • See the General Compatibility sections (Section 3.1 and Section 2.1).

      The General Compatibility sections are particularly important if you will have older and Connext 6 releases coexisting.

    • See Section 4 for any regressions that may apply to you.

  2. Regenerate code as described in Section 3.2.1.3.1.

  3. Recompile your source as described in Section 3.2.1.1.

If you need help with your upgrade, contact RTI Support: log into the Customer Portal, send email to support@rti.com, or call the telephone number provided for your region.

Note

If you had early access to a pre-release version of Connext 6, delete (or move or rename) the rti_workspace/<6.0.0 or 6.0.1> directory before installing.