1. Installing RTI Connext

An RTI® Connext® installation includes:

• The libraries to develop applications in several programming languages (C, C++, Java, C#, Python, Ada)

• Development tools

• Infrastructure Services

• Examples and documentation

Whether you are evaluating or have purchased Connext, we recommend the Connext Developer guide for quick installation and getting started instructions. The installation instructions in this document contain full details on installing Connext.

Note that all evaluation and LM versions require a license key file to run. All use of regular, LM, and evaluation versions is subject to RTI’s Software License Agreement. You can find RTI’s Software License Agreement in your installation directory.

1.1. Installing a Regular Version

Connext distributions are provided in two types of bundles: hosts and targets.

• A host bundle contains compiler-independent files, such as documentation, header files, tools, and infrastructure services executables. The host bundle is provided in a .run, .exe, or .dmg file that will run an installer.

  Host bundles are named: rti_connext_dds-<version>-<package_type>-host-<host-platform>.<extension>

  The <package_type> is usually pro.

  Note

  The legacy core package type does not include all functionality. Please contact your local RTI sales representative or email sales@rti.com for more information.

  The <host_platform> depends on your development platform: x64Linux for Linux® systems, x64Win64 for Windows® systems, or x64Darwin or arm64Darwin for macOS® systems.

  LinuxmacOSWindows

  rti_connext_dds-<version>-<package_type>-host-<host-platform>.run

• A target bundle contains SDK libraries you will link against and any applications that have target-specific dependencies. Target packages include support to develop C, C++, and Java applications. For Python, C#, and Ada, see Installing Python, C#, or Ada Packages. If you are developing for a cross-compiled architecture, the target bundle will also include any applications that are supported for your architecture. A target bundle is an “RTI Package” (*.rtipkg) file that must be installed on top of your host bundle. After you install the host bundle, you will have a script called bin/rtipkginstall[.bat]. You can use this script to install one or more target bundles. Or you can use RTI Launcher to install the target bundles. (Launcher is installed as part of the host bundle.) See Installing the Host and Target.
  

  Target bundles are named:
  rti_connext_dds-<version>-<package_type>-target-<architecture>.rtipkg. The <architecture> depends on your target machine (where you will deploy your completed application). Your architecture is the combination of a processor, OS, and compiler version that you will use to build your application. For example, if you have a 64-bit Windows machine with Visual Studio® 2017, use x64Win64VS2017. For a 64-bit Linux machine with gcc version 7.3.0, use x64Linux4gcc7.3.0.

  To see the full list of available architectures, see the “RTI Architecture Abbreviation” columns in the RTI Connext Core Libraries Platform Notes.

  Note

  A few notes about target bundles:

  • You will need to install more than one target bundle if you are developing for multiple target architectures, such as developing for both Linux® and VxWorks® systems.

  • You must have a target bundle even if you are developing for Java®. This is because Connext requires native libraries as well as the Java SDK. If you are on a Windows system, you can generally install any Windows architecture if you plan to develop with Java.

  • A target installation is not necessary for building or running C# or Python applications, unless you’re using add-on libraries (such as the Security Plugins or Monitoring Library 2.0).

• If you are developing Python, C#, or Ada applications, see Installing Python, C#, or Ada Packages.

If you are installing a patch release (for example, a 7.3.0.x release), read Special Backup of RTI Libraries.

There are two ways to install a Connext host bundle:

• using an installer, which will prompt you for information such as where to install (see Using an Installer below), or

• using a script, which allows you to run in “unattended mode” so you will not be prompted for information while it is installing (see Running from a Script (Unattended Mode) below).

1.1.1. Installing the Host and Target

1.1.1.1. Using an Installer

Download the host and target bundles:

LinuxmacOSWindows

Download the host and target bundles to a location of your choice; for example, /home/<your user name>/Downloads.

• Example host bundle name: rti_connext_dds-7.5.0-pro-host-x64Linux.run

• Example target bundle name: rti_connext_dds-pro-target-7.5.0-x64Linux4gcc7.3.0.rtipkg

Your filenames will be different depending on your package type and architecture. See Installing a Regular Version, above.

Install the host bundle:

LinuxmacOSWindows

Install the host bundle using an installer or command line:

• Using the installer:

  Run the host bundle installer (the .run file). For example:

  /home/<your user name>/Downloads/rti_connext_<version>-dds-pro-host-<host-platform>.run
  

  Follow the on-screen prompts. You will be asked if you want to use the default installation directory (/home/<your user name>) or specify a different path. We refer to the installation directory as <NDDSHOME>, see Paths Mentioned in Documentation.

• Or, using a command prompt:

  rti_connext_dds-<version>-<package_type>-host-<host_platform>.run --mode unattended --prefix <installation path>
  

  The --prefix option allows you to specify the installation directory; if you omit this, the installer will install into a default location.

  For example (enter on one line):

  rti_connext_dds-<version>-pro-host-<host_platform>.run --mode unattended --prefix /home/user/rti_connext_dds-<version>
  

Install the target bundle using RTI Launcher or a command line:

• From RTI Launcher:

  LinuxmacOSWindows

  Start RTI Launcher in your host installation (<NDDSHOME>/bin/rtilauncher), select the Configuration tab, and click on Install RTI Packages. Add the location of your target file. Click Install.

  <NDDSHOME> refers to your Connext installation directory, rti_connext_dds-<version>. See Paths Mentioned in Documentation for more information.

  

  

  You may need to click Close or OK when the RTI Package Installer finishes.

• Or, from the command line:

  LinuxmacOSWindows

  Open a command prompt and change to the rti_connext_dds-<version>/bin directory.

  Use <NDDSHOME>/bin/rtipkginstall to install the target bundle. For example (enter on one line):

  rtipkginstall /home/<your user name>/Downloads/rti_connext_dds-<version>-pro-target-<target_platform>.rtipkg
  

After installing, see Checking What is Installed and License Management.

1.1.1.2. Running from a Script (Unattended Mode)

When running in unattended mode, the installer will use default values for its parameters unless you specify them at the command line.

Table 1.1 Command-Line Options when Installing from a Script

Parameter	Values	Meaning	Default
--mode	win32 gtk xwindows osxqt text [not available on Windows] unattended [all platforms] [not available for “eval” or “lm” package]	Should the installer display a graphical or a text-based UI? Should the installer ask for user feedback?	GUI available in your platform
--unattendedmodeui	none [not available on Windows] minimal [not available on Windows] minimalWithDialogs [Required on Windows if using –mode unattended]	If you chose --mode unattended, how much graphical feedback should the installer display?	none
--prefix	directory to install into	The installation directory the product will be placed into. Note that the installer will always place the product in a directory named rti_connext_dds-7.5.0. See Paths Mentioned in Documentation.	Platform-dependent Windows Example: “C:\program files\rti_connext_dds-7.5.0”
--disable_copy_examples	true false	Should the installer disable the copying of examples into rti_workspace during installation (true) or not (false)?	false

1.1.2. Installing Python, C#, or Ada Packages

• If you are developing C# applications, install the host package as described in Installing the Host and Target. (You don’t need to install a target, unless you’re using add-on libraries such as the Security Plugins or Monitoring Library 2.0.) Then download and install rti_dotnet_support-<version>.rtipkg, which includes the NuGet packages required for building C# applications. In Installing the Host and Target, follow the instructions for using Launcher or the command-line to install rti_dotnet_support-<version>.rtipkg into your installation directory.

• If you are developing Python applications, install the host package as described in Installing the Host and Target. Then install the Python API from your host installation directory:

  $ pip install rti.connext.activated -f <NDDSHOME>/resource/python_api
  

  <NDDSHOME> refers to your Connext installation directory, rti_connext_dds-<version>. See Paths Mentioned in Documentation for more information.

  For information on which platforms and Python versions the Python API is supported on, see Supported Platforms in the Connext Core Libraries Release Notes.

  See Troubleshooting Python API Installation if you have any trouble installing Python.

• If you are developing Ada applications, see Installation in the Ada Language Support Release Notes. (Ada Language Support is not included in every release. See the Ada Language Support Release Notes to see whether Ada Language Support is included in your release.)

After installing, see Checking What is Installed and License Management.

1.2. Installing an Evaluation or LM Version

The evaluation (“eval”) and LM (“lm”) packages include Connext Professional, RTI Real-Time WAN Transport, Cloud Discovery Service, Security Plugins, and OpenSSL® version 3.0.12. (The installer provides a prebuilt version of OpenSSL 3.0.12. If you wish to build your own version of OpenSSL 3.0.12, you can find the source code here: https://github.com/openssl/openssl.)

In most cases, the evaluation or LM package provides everything required for an evaluation. After the initial trial period, your evaluation or LM package may transition into a long-term, limited free version. See Connext Express.

Most eval/LM bundles are packaged in a single file. For example, rti_connext_dds-7.5.0-eval-x64Win64VS2017.exe combines the x64Win64 host with the x64Win64VS2017 target in a single evaluation bundle. See Installing a Single Bundle. For platforms that contain Arm or 32-bit x86 CPUs, you must download and install an extra package. See Installing Two Bundles (for Arm or 32-bit x86 CPUs).

The target architecture depends on your target machine where you will deploy your completed application. These strings are listed in the Core Libraries Platform Notes; examples are x64Win64VS2017, x64Linux4gcc7.3.0, and arm64Darwin20clang12.0.

Note

Evaluation and LM packages cannot be installed in “unattended mode.”

1.2.1. Installing a Single Bundle

Follow these steps for installing evaluation or LM bundles if your target architecture does not have an Arm or 32-bit x86 CPU:

LinuxmacOSWindows

1. Download the evaluation or LM bundle (for example: rti_connext_dds-7.5.0-eval-x64Linux4gcc7.3.0.run or rti_connext_dds-7.5.0-lm-x64Linux4gcc7.3.0.run) to a location of your choice; for example, /home/<your user name>/Downloads.
   
   

2. Run the eval/lm bundle installer (the .run file). For example:

   /home/<your user name>/Downloads/rti_connext_dds-<version>-eval-<platform>.run
   

   Follow the on-screen prompts. You will be asked if you want to use the default installation directory (/home/<your user name>) or specify a different path. We refer to the installation directory as <NDDSHOME>, see Paths Mentioned in Documentation.

3. See Checking What is Installed and License Management.

1.2.2. Installing Two Bundles (for Arm or 32-bit x86 CPUs)

Evaluation and LM distributions with an Arm or 32-bit x86 CPU require you to install two bundles:

Note

Eval/LM bundles that are not an Arm or 32-bit x86 CPU do not require installing these target packages:

• A combined host/target bundle (.run, .exe, or .dmg), such as rti_connext_dds-7.5.0-lm-x64Linux4gcc7.3.0.run or rti_connext_dds-7.5.0-eval-x64Linux4gcc7.3.0.run.

• A separate LM target package (.rtipkg) for the specific target architecture, such as rti_connext_dds-7.5.0-lm-target-armv8Linux4gcc7.3.0.rtipkg.

For example, suppose your target machine uses Ubuntu 18.04 LTS on an Arm v8 CPU. RTI does not currently provide a combined evaluation or LM host/target bundle for this architecture. So first you would install an evaluation/LM bundle for any Linux architecture, then install the LM target package for your Ubuntu 18.04 LTS target on an Arm v8 CPU.

After installing the host bundle as described in Installing a Single Bundle, follow these steps if your target architecture has an Arm or 32-bit x86 CPU:

LinuxmacOSWindows

For Linux targets with an Arm or 32-bit x86 CPU, you also need to install an LM target package.

This package will have lm-target- in the filename. You can install it on top of any evaluation or LM bundle for a Linux architecture. That is, the .run file and the .rtipkg file do not have to use the same Linux architecture string. For example, you can install rti_connext_dds-<version>-lm-target-armv8Linux4gcc7.3.0.rtipkg on top of rti_connext_dds-<version>-eval-x64Linux4gcc7.3.0.run.

There are two ways to install the LM target package, from RTI Launcher or from a command line:

• From RTI Launcher:

  LinuxmacOSWindows

  Start RTI Launcher in your host installation (<NDDSHOME>/bin/rtilauncher), select the Configuration tab, and click on Install RTI Packages. Add the location of your target file. Click Install.

  <NDDSHOME> refers to your Connext installation directory, rti_connext_dds-<version>. See Paths Mentioned in Documentation for more information.

  

  

  You may need to click Close or OK when the RTI Package Installer finishes.

• Or, from the command line:

  LinuxmacOSWindows

  Open a command prompt and change to the rti_connext_dds-<version>/bin directory. Use <NDDSHOME>/bin/rtipkginstall to install the target bundle. For example (enter on one line):

  rtipkginstall /home/<your user name>/Downloads/rti_connext_dds-<version>-lm-target-<target_platform>.rtipkg
  

After installing, see Checking What is Installed and License Management.

1.2.3. Installing Python or C# Packages

1.2.3.1. Installing Python

To install an evaluation or LM version of the Connext Python API, install it from pypi.org. This installation method requires a license file when you run your application (see License Management).

$ pip install rti.connext

The above command installs the latest version of Connext by default. To install a specific version, use this command:

$ pip install rti.connext==<version>

where <version> is any valid Connext version in the Release history at pypi.org. (The evaluation/LM version of the Connext Python API is not available in all Connext releases.)

Note that the pypi.org package allows writing Python applications without a host installation, but to use the Code Generator and other tools and services, you need the host package. See Installing a Single Bundle.

For information on which platforms and Python versions the Python API is supported on, see Supported Platforms in the Connext Core Libraries Release Notes.

See Troubleshooting Python API Installation if you have any trouble installing Python.

1.2.3.2. Installing C#

Besides the host package, no additional package needs to be installed to develop Connext applications in C#. Simply reference the Rti.Connext.Extra (or Rti.Connext) NuGet package in your C# project. .NET will automatically download the evaluation/LM NuGet package from nuget.org when you build your applications.

Note that the nuget.org packages allow writing C# applications without a host installation, but to use the Code Generator and other tools and services, you need the host package. See Installing a Single Bundle.

1.2.4. Installing with apt on Ubuntu or Debian Systems

The apt installation method is recommended for Ubuntu and Debian systems with root access. For instructions, see apt install in the Connext Developer guide for quick instructions or RTI Connext for Debian Linux for detailed instructions. For other Linux distributions, and for non-root installations, see Linux installer in the Connext Developer guide for quick instructions or Installing an Evaluation or LM Version above for detailed instructions.

1.3. Telemetry Data Collected by Evaluation Version

After installing Connext (regular, evaluation, or lm versions), you will see a TELEMETRY_DATA.json file, which contains general product usage information without any personal data or personal identifiers. If usage data sharing is enabled, this is the only file that is shared with RTI, for “eval” bundles only.

Note

Although you will see the TELEMETRY_DATA.json file in all Connext installations, usage data sharing occurs only with the evaluation bundle (bundles with “eval” in their name). See information about the Preferences Dialog in the Launcher User’s Manual to learn how to enable/disable usage data sharing in the evaluation bundle.

TELEMETRY_DATA.json is in the following locations:

LinuxmacOSWindows

/home/<your user name>/rti_workspace/<version>/.tdata/

1.4. Checking What is Installed

To find out what target libraries or add-ons you have installed, you can use the Launcher tool. See Starting Launcher, in the RTI Launcher User’s Manual. Once in Launcher, open the Configuration tab:

To check which target architectures you have installed, click on Connext Target Libraries, which will show you each installed target library and its version.

If you do not see any target libraries listed, you are missing a vital part of the Connext SDK, and you will not be able to compile your own applications. You can still run tools such as RTI Admin Console.

To check your Python API installation, run:

$ pip show rti.connext

or

$ pip show rti.connext.activated

See also License Management.

1.5. Troubleshooting Installation

1.5.1. Troubleshooting Python API Installation

1.5.1.1. resource/python_api under Connext installation directory doesn’t exist

Make sure you have installed a host package. The evaluation installers don’t include rti.connext.activated. If you have an evaluation installer, install rti.connext (see Installing Python) and make sure your evaluation license file is accessible, for example by copying rti_license.dat to the current directory, where you launch your Python application.

1.5.1.2. pip install fails with ERROR: Could not find a version that satisfies the requirement rti.connext

If you get this error while installing the Python API with pip install, you may have to upgrade pip:

$ pip install --upgrade pip

If the installation still fails after that, make sure your Python version is supported. For information on which platforms and Python versions the Python API is supported on, see Supported Platforms in the Connext Core Libraries Release Notes.

1.5.1.3. pip install fails because I don’t have permissions to install packages

You can use a virtual environment to install packages without requiring admin privileges. To create a virtual environment, run the following commands:

LinuxmacOSWindows

$ python -m venv myvenv
$ . myvenv/bin/activate
$ pip install rti.connext

For more information about installing Python packages with pip, see the Python documentation: Virtual Environments and Packages.

1.5.1.4. I get “No module named ‘rti’” when I run my Python application

Make sure you have installed the Python API for your current Python interpreter and/or virtual environment. See Installing Python, C#, or Ada Packages (for a regular installation) or Installing Python (for an eval/lm installation).

If you still get that or a similar error, try reinstalling it by adding --force-reinstall to the pip install command.

1.5.2. Troubleshooting Linux Desktop Shortcuts

On some Linux operating systems, executing the desktop shortcut for Launcher might report that the application has not been marked as trusted. This is a harmful warning that will prevent you from executing Launcher using the desktop shortcut. To remove this warning, click “Trust and Launch”:

This will mark the desktop shortcut as a trusted application, allowing you to run the application. If the warning doesn’t appear and the desktop shortcut still doesn’t run, right-click the shortcut and click “Allow Launching”:

On some Linux operating systems, the desktop shortcut might not execute and will need to be run through the terminal or in the Activities panel. In some newer versions of GNOME, the “Allow Launching” option is missing from the context menu, preventing the desktop shortcut from being run. Launcher can still be run from the Activities panel:

Or you can run Launcher through the terminal by entering the following command:

gtk-launch rtilauncher.desktop

1.6. Next Steps

Check out the following resources:

• Getting Started:

  • Visit the Connext Developer page to explore Connext concepts in short, independent modules that help you implement common distributed systems patterns (publish-subscribe, RPC, content filtering, data persistence, and so on) and design, debug, and deploy observable and secure systems.

  • See the Connext Getting Started Guide for an in-depth guided tutorial that helps you build and run your first Connext-based application while learning foundational concepts of Connext.

• Github Examples: In addition to the basic examples in your rti_workspace directory, you can find over 50 examples on how to use specific Connext features in the rticonnextdds-examples section on GitHub. Examples include asynchronous publication, compression, FlatData™, network capture, discovery (including builtin topics), DynamicData, and many more.

• Launcher: From Launcher, right-click each icon to access documentation about that component. See the Launcher User’s Manual.

• Platform Notes:

  • The RTI Connext Core Libraries Platform Notes describe how to build applications for your operating system. They include information on OS-specific limitations and features, and detail which Connext libraries you’ll need to link with your application to enable various capabilities.

  • See also the platform-specific addenda to help you get Connext up and running quickly on specific systems. Find these addenda in ../doc/manuals/connext_dds_professional/getting_started_platforms in your rti_connext_dds-<version> installation directory.

• And more: Find additional documentation and user forums on https://community.rti.com/.