3 Installation Instructions

You do not need administrator privileges. All directory locations are meant as examples only; adjust them to suit your site. <NDDSHOME> is described in 1 Paths Mentioned in Documentation.

3.1 Installing License-Managed (LM) Version

1. Install the LM ("lm") bundle as described in Installing RTI Connext, in the RTI Connext Installation Guide.

To use Real-Time WAN Transport in the LM bundle, you need a valid license for Real-Time WAN Transport. See License Management, in the RTI Connext Installation Guide.

The installer places files into an rti_connext_dds-7.x.y directory, including the Real-Time WAN Transport functionality. Unlike with the commercial version, the LM version does not require the installation of a separate Real-Time WAN Transport package.

2. If not already included, add <NDDSHOME>\lib\<architecture> to your Path environment variable. For example (enter this on one line):

On Linux and macOS systems:

export PATH=<NDDSHOME>/lib/<architecture>:${PATH}

On Windows systems:

set PATH=<NDDSHOME>\lib\<architecture>;%PATH%

These commands set your Path environment variable temporarily. To set your path longer term, consult your operating system's documentation.

3. See Enabling Real-Time WAN Transport, in the RTI Connext Core Libraries User's Manual.

See also RTI Real-Time WAN Transport, in the RTI Connext Core Libraries User's Manual. Find an example here: https://github.com/rticommunity/rticonnextdds-examples/tree/master/examples/connext_dds/real_time_wan_transport.

3.2 Installing a Commercial Version

3.2.1 Installing on Windows Systems

1. Install the Real-Time WAN Transport host and target .rtipkg files on top of RTI Connext.

There are two ways to install these files: from RTI Launcher or from the command line.

To install from RTI Launcher:

1. Start RTI Launcher:

cd <NDDSHOME>

bin\rtilauncher

1. From the Configuration tab, click on Install RTI Packages.
2. Use the + sign to add the .rtipkg files that you want to install.
3. Click Install.

To install from the command line:

cd <NDDSHOME>\bin

.\rtipkginstall <path to .rtipkg file>

This will install files into the existing rti_connext_dds-7.x.y directory. The installer will put the Real-Time WAN Transport libraries in <NDDSHOME>\lib\<architecture>.

2. If not already included, add <NDDSHOME>\lib\<architecture> to your Path environment variable. For example (enter this on one line):

set PATH=<NDDSHOME>\lib\<architecture>;%PATH%

This command sets your Path environment variable temporarily. To set your path longer term, consult your operating system's documentation.

3. To verify your installation, find the Real-Time WAN Transport library (nddsrwt) in <install dir>\lib\<target architecture>.

See Enabling Real-Time WAN Transport, in the RTI Connext Core Libraries User's Manual for more information.

See also the RTI Connext Core Libraries Platform Notes for a list of the Real-Time WAN Transport libraries for your platform and RTI Real-Time WAN Transport, in the RTI Connext Core Libraries User's Manual. You can also find an example here: https://github.com/rticommunity/rticonnextdds-examples/tree/master/examples/connext_dds/real_time_wan_transport.

3.2.2 Installing on Linux and Other Systems

1. Install the Real-Time WAN Transport host and target .rtipkg files on top of RTI Connext.

There are two ways to install these files: from RTI Launcher or from the command line.

To install from RTI Launcher:

1. Start RTI Launcher:

cd <NDDSHOME>/bin

./rtilauncher

1. From the Configuration tab, click on Install RTI Packages.
2. Use the + sign to add the .rtipkg files that you want to install.
3. Click Install.

To install from the command line:

cd <NDDSHOME>/bin

./rtipkginstall <path to .rtipkg file>

This will install files into the existing rti_connext_dds-7.x.y directory. The installer will put the Real-Time WAN Transport libraries in <NDDSHOME>/lib/<architecture>.

2. If the following are not already included in your path:
   1. Add <NDDSHOME>/bin to your PATH environment variable:

   export PATH=<NDDSHOME>/bin:$PATH

   2. Add <NDDSHOME>/lib/<architecture> to your library search path (pointed to by the LD_LIBRARY_PATH environment variable on Linux systems, DYLD_LIBRARY_PATH on macOS systems).

   For example (enter this on one line):

   export LD_LIBRARY_PATH=<NDDSHOME>/lib/<architecture>:${LD_LIBRARY_PATH}

   These commands set your paths temporarily. To set them longer term, consult your operating system's documentation.

3. To verify your installation, find the Real-Time WAN Transport library (libnddsrwt) in <install dir>/lib/<target architecture>.

See Enabling Real-Time WAN Transport, in the RTI Connext Core Libraries User's Manual for more information.

See also the RTI Connext Core Libraries Platform Notes for a list of the Real-Time WAN Transport libraries for your platform and RTI Real-Time WAN Transport, in the RTI Connext Core Libraries User's Manual. You can also find an example here: https://github.com/rticommunity/rticonnextdds-examples/tree/master/examples/connext_dds/real_time_wan_transport.

3.3 Installing Cloud Discovery Service (Optional)

If you have installed the commercial version (in 3.2 Installing a Commercial Version), you can optionally install Cloud Discovery Service from RTI Launcher or the command line just as you did above. For details, see the "Installation" chapter of the RTI Cloud Discovery Service documentation.

If you are installing a license-managed ("lm") bundle, it already includes Cloud Discovery Service. Follow the instructions in Installing RTI Connext, in the RTI Connext Installation Guide, regarding how to install the LM bundle.

To use Cloud Discovery Service in the LM bundle, you need a valid license for Cloud Discovery Service. See License Management, in the RTI Connext Installation Guide.