.. include:: vars.rst .. _section-gsg_install: Installing |CONNEXT_DRIVE_HEADING| ---------------------------------- A |CONNEXT_DRIVE| installation typically consists of a host bundle followed by one or more target bundles. To install |CONNEXT_DRIVE|, you must first install the host bundle, then choose which target (SDK libraries) to install. For convenience, the |CONNEXT_DRIVE| host bundle includes an installation of |CONNEXT_MICRO|, RTI’s libraries optimized for environments with size, weight, and power constraints, available as source code for easy porting. See :ref:`section-safety_certified_libraries` to learn how |CONNEXT_MICRO| may be relevant for programs with safety requirements. .. note:: If you have installed a “license-managed” bundle (usually used for evaluation purposes), you do not need to install a target. License-managed bundles (usually used for evaluation purposes) combine the host, target, and some add-ons in one package. They have ``lm`` in their name, such as ``rti_connext_drive-2.0.0-lm-x64Win64VS2017.exe``. |CONNEXT_DRIVE| distributions are provided in two types of bundles: * A **host** bundle that contains files such as documentation, header files, tools, and infrastructure services executables. The host bundle is provided as a **.run**, **.dmg**, or **.exe** file that will run an installer. Host bundles are named one of the following: * ``rti_connext_drive--host-.run`` * ``rti_connext_drive--host-.dmg`` * ``rti_connext_drive--host-.exe`` The ```` depends on your development platform, such as ``x64Win64`` for a 64-bit Windows® platform. * A **target** bundle that contains SDK libraries you will link against, or an **add-on** bundle that extends the capabilities of |CONNEXT_DRIVE|. 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 or an add-on 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 :ref:`section-install_target_gui`. Target bundles are named: ``rti_connext_dds---target-.rtipkg``. Add-on bundles are named: ``rti_--.rtipkg``. The ```` 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 5.4.0, use ``x64Linux3gcc5.4.0``. To see the full list of available architectures, see the “RTI Architecture Abbreviation” columns in the :link_platform_notes:`RTI Connext DDS Core Libraries Platform Notes <>`. .. note:: A few notes about target and add-on bundles: * Download target and add-on bundles (an \*.rtipkg file) with a ```` of 6.1.1 for use with |CONNEXT_DRIVE| 2.0 host 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 QNX® 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. * However, a target installation is not necessary for building or running C# applications. The NuGet package Rti.ConnextDds contains the necessary native libraries. Installing a Host or an LM Bundle ................................. Host bundles and “license managed” bundles (LM Bundles) are applications; thus, they can be started from a GUI or command line. To install them, do either of the following: * Double-click the installer. * Run the installation script from a command prompt. See Installing RTI Connext DDS, in the :link_install_guide:`RTI Connext DDS Installation Guide `. .. note:: If your development platform already has *Connext Professional* 6.1.1 installed, you must change the default installation directory for |CONNEXT_DRIVE| 2.0 in the installation dialog **OR** uninstall |CONNEXT| *Professional* 6.1.1. In addition, please delete the following folder: ``/rti_workspace/6.1.1/user_config/launcher`` .. _section-install_target_gui: Installing a Target with a GUI .............................. After you install the host bundle, you’ll have a tool called RTI Launcher. (See Starting Launcher, in the :link_connext_launcher_usersman:`RTI Launcher User’s Manual <#launcher/users_manual/StartingLauncher.htm>`.) To install a target bundle from the Launcher tool, open the Configuration tab, and select “Install RTI Packages.” This will open a dialog that allows you to select one or more .rtipkg files that you would like to install. .. figure:: static/config_tab_launcher.png :width: 80% :align: center .. figure:: static/pkg_installer.png :width: 80% :align: center .. note:: In 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. .. image:: static/launcher_linux_warning.png :width: 60% :align: center |br| If the warning doesn't appear when executing the desktop shortcut for *Launcher*, you might need to allow the shortcut to be launched. To do so, right-click on the shortcut and click on **Allow Launching**. .. image:: static/allow-launching.png :width: 40% :align: center Installing a Target from a Command Line ....................................... To install targets from the command line, type: .. tabs:: .. group-tab:: Linux .. code-block:: none $ /bin/rtipkginstall .. group-tab:: macOS .. code-block:: none $ /bin/rtipkginstall .. group-tab:: Windows .. code-block:: none > \bin\rtipkginstall.bat Where ```` is your installation directory. .. _section-gsg_paths: Paths Mentioned in the Documentation .................................... The default top-level directory for |CONNEXT_DRIVE| 2.0.0 is rti_connext_dds-6.1.1, which corresponds to the version of |CONNEXT| *Professional* included in the bundle. This documentation refers to the following directories, depending on your operating system: .. tabs:: .. group-tab:: Linux ``$NDDSHOME``: This refers to the installation directory for Connext DDS. The default installation paths are: * Non-root user: ``/home//rti_connext_dds-`` * Root user: ``/opt/rti_connext_dds-`` ``$NDDSHOME`` is an environment variable set to the installation path. .. group-tab:: macOS ``$NDDSHOME``: This refers to the installation directory for Connext DDS. The default installation path is: ``/Applications/rti_connext_dds-`` ``$NDDSHOME`` is an environment variable set to the installation path. .. group-tab:: Windows ``%NDDSHOME%`` This refers to the installation directory for Connext DDS. The default installation paths are: * User without Administrator privileges: ``\rti_connext_dds-`` * User with Administrator privileges: ``"C:\Program Files\rti_connext_dds-""`` ``%NDDSHOME%`` is an environment variable set to the installation path. .. note:: When using a command prompt to enter a command that includes the path ``C:\Program Files`` (or any directory name that has a space), enclose the path in quotation marks. For example: ``“C:\Program Files\rti_connext_dds-version\bin\rtilauncher.bat”``. Or, if you have defined the ``NDDSHOME`` environment variable: ``"%NDDSHOME%\bin\rtilauncher.bat"``. You must set the ``NDDSHOME`` environment variable according to your selected operating system. Sometimes this documentation uses ```` to refer to the installation path. Whenever you see ```` used in a path, replace it with ``$NDDSHOME`` for Linux or macOS systems, with ``%NDDSHOME%`` for Windows systems, or with your installation path. Set the ``RTIMEHOME`` environment variable to the installation directory path for |CONNEXT_MICRO|. If you installed |CONNEXT_DRIVE| with default settings, |CONNEXT_MICRO| will be here: ``/rti_connext_dds-6.1.1/rti_connext_micro-2.4.14``. If you copied |CONNEXT_MICRO| to another place, set ``RTIMEHOME`` to point to that location. Set ``RTIME_TARGET_NAME`` to your target architecture: * If you have a |CONNEXT_DRIVE| LM bundle, set ``RTIME_TARGET_NAME`` to one of the two target architectures that are installed as part of the bundle: * ``armv8Linux4gcc7.3.0_certprofile`` * ``x64Linux4gcc7.3.0_certprofile`` * If you have a non-LM bundle, set ``RTIME_TARGET_NAME`` to the architecture of the target package you installed. .. _section-gsg-license: Setting Up a License .................... Most installations require a license file to run the tools or features included with |CONNEXT|. If your distribution requires a license file, you will receive one from RTI via e-mail. The easiest way to configure your license file is using Launcher, as shown below: .. figure:: static/license_info.png :width: 80% :align: center If you do not want to use Launcher, you can also install a license by placing it in one of these two locations: * ``/rti_license.dat`` * ``/rti_license.dat`` The workspace directory is in the locations below by default, depending on your operating system: .. tabs:: .. group-tab:: Linux ``/home//rti_workspace/`` .. group-tab:: macOS ``/Users//rti_workspace/`` .. group-tab:: Windows ``\rti_workspace\`` A third way to install a license is to configure the environment variable RTI_LICENSE_FILE to point to your license file. For more details, see the License Management section in the :link_install_guide:`RTI Connext DDS Installation Guide `. .. _section-gsg_check_install: Checking What’s Installed ......................... To find out what target libraries or add-ons you have installed, you can use the Launcher tool. See :link_connext_launcher_usersman:`Starting Launcher, in the RTI Launcher User’s Manual <#launcher/users_manual/StartingLauncher.htm>`. Once in Launcher, open the Configuration tab: .. figure:: static/config_installed_libs.png :width: 80% :align: center To check which target architectures you have installed, click on Connext Target Libraries, which will show you each installed target library and its version. .. figure:: static/target_libraries.png :width: 80% :align: center 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. Where Do I Get More Help? ......................... Advanced installation help can be found in the :link_install_guide:`RTI Connext DDS Installation Guide `, which explains: * Installer command-line options * Controlling the location of the RTI Workspace directory * Additional license management options * Special backup of RTI libraries * How to uninstall Connext DDS Continue to :doc:`intro_pubsub` to start learning about the capabilities and features of |CONNEXT|. Additional documentation for RTI products and user forums can be found on :link:`community.rti.com `. If you have additional questions or concerns, please :link:`contact your sales team `.