.. include:: ../../router.1.0/srcDoc/vars.rst

.. _section-Install-Upgrade:


Upgrade Overview
****************

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
:link_release_notes_s:`5.3.1 Core Libraries Release Notes <5.3.1>`
and other products as needed on the
:link_rti_community_doc_s:`5.3.1 Community Portal <531>`.
Then return to this document for additional considerations for migrating from
5.3.1 to *Connext* 6.

.. list-table:: 
    :name: TableUpgradeOverview
    :widths: 50
    :header-rows: 0

    * - 
        .. figure:: static/upgrade_over_lateral.png
            :figwidth: 70 %
            :alt: Upgrade Overview
            :name: FigureUpgradeOver
            :align: center

            Migrate Step-Wise 
    * - 
            1. For information on upgrading to 5.3.1 from any previous release, 
               see the :link_release_notes_s:`5.3.1 Core Libraries Release Notes <5.3.1>`.

            2. For information on upgrading from 5.3.1 to 6.0.0, see 
               :numref:`section-index600`.

            3. For information on upgrading from 6.0.0 to 6.0.1, see 
               :numref:`section-index601`.

Whether you will keep some of your legacy |CONNEXT| 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 :link_connext_whats_new:`What's New in 6.0.1 <>` 
and :link_connext_whats_new_600:`What's New in 6.0.0 <>`, 
as well as the :link_release_notes:`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 (:numref:`section-index600`) 
    and 6.0.1 (:numref:`section-index601`) sections apply to you. 
    If you are migrating from Release 6.0.0, read just the 6.0.1 section 
    (:numref:`section-index601`).


.. _section-Install-Upgrade-Steps:

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| libraries.

   #. Make the changes required for your system, based on the compatibility issues 
      described in this guide: 
      
      * See the Product-Specific Compatibility sections (:numref:`section-Product-Index` 
        and :numref:`section-Product-Index-601`). 
        
      * See the General Compatibility sections (:numref:`section-General` and 
        :numref:`section-General-601`). 
        
        The General Compatibility sections are particularly important if you will have 
        older and *Connext* 6 releases coexisting.

      * See :numref:`section-Regressions` for any regressions that may apply 
        to you.
        |br|
        |br|

   #. Regenerate code as described in :numref:`section-Product-gen-code-compatibility`.
      |br|
      |br|

   #. Recompile your source as described in :numref:`section-Product-ABI`.

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.