Windows installer#
The following instructions guide you through the Connext installation steps, setting up a license file, and running a Hello World program to verify the installation.
1. Download Connext#
Get a free evaluation version of Connext at https://www.rti.com/free-trial .
After filling out a brief form, you will get:
An installer, such as
rti_connext_dds-<version>-eval-x64Win64VS2017.exe.A license file,
rti_license.dat, in your email.
Existing customers
If you have already purchased a Connext bundle, follow the installation instructions here instead.
2. Run the installer#
Double-click the installer and follow the installation instructions.
Choose an installation directory or accept the default one,
C:\Program Files\rti_connext_dds-<version>.
The installation includes:
The SDK to build your distributed applications.
Tools that help you design, visualize, and debug your system.
Infrastructure Services that perform dedicated functions in your system, such as recording, bridging, and persisting data.
To develop Python applications, you also need to install the Connext Python API with
pip as follows:
> pip install rti.connext
3. Set up the license file#
To set up the license file, you can use RTI Launcher, a graphical tool that also helps you explore and run Connext tools and utilities.
Open RTI Launcher by clicking on its shortcut, or by running:
> "<installation directory>\bin\rtilauncher"
To set up the license file, go to the Configuration tab and select
the rti_license.dat file in the License Information field:
Alternatively, you can copy your license file to <installation directory>\rti_license.dat,
or set the environment variable RTI_LICENSE_FILE to point to your license file.
With the evaluation bundle, the license file needs to be accessible when you run your Connext applications. We will show that in the next section.
4. Run a Hello World program#
Generate and run a simple Connext application to verify the installation.
First, you’ll open a command prompt to configure the Connext environment. In RTI Launcher, select the Utilities tab and click Connext DDS Professional Terminal. Or open a system prompt and run the following command:
> "<installation directory>\resource\scripts\rtisetenv_x64Win64VS2017.bat"
To define a data type for the Topic you will publish and subscribe to,
create a file named HelloWorld.idl with the following content:
struct HelloWorld {
int32 value;
};
Next, generate the code to use that type in an example application for a target language. Select the programming language you’d like to use:
Run RTI Code Generator:
> rtiddsgen -ppDisable -language python -example universal HelloWorld.idl
In one terminal, run the subscriber:
> python HelloWorld_subscriber.py
In another terminal, run the publisher:
> python HelloWorld_publisher.py
(Make sure you have configured the environment as shown above for each shell;
alternatively, copy the rti_license.dat file to the current directory.)
You should see subscriber output similar to:
Hello World subscriber sleeping for 1 seconds...
Received: HelloWorld(value=0)
Hello World subscriber sleeping for 1 seconds...
Received: HelloWorld(value=1)
Hello World subscriber sleeping for 1 seconds...
Run RTI Code Generator:
> rtiddsgen -ppDisable -language c++11 -example x64Win64VS2017 HelloWorld.idl
Open the generated Visual Studio solution, HelloWorld-x64Win64VS2017.sln, and build it.
You may be prompted to re-target the solution for your version of Visual C++.
In one terminal, run the subscriber:
> objs\x64Win64VS2017\HelloWorld_subscriber
In another terminal, run the publisher:
> objs\x64Win64VS2017\HelloWorld_publisher
(Make sure you have configured the environment as shown above for each shell;
alternatively, copy the rti_license.dat file to the current directory.)
You should see subscriber output similar to:
::HelloWorld subscriber sleeping up to 1 sec...
[value: 1]
::HelloWorld subscriber sleeping up to 1 sec...
[value: 2]
...
Run RTI Code Generator:
> rtiddsgen -ppDisable -language c -example x64Win64VS2017 HelloWorld.idl
Open the generated Visual Studio solution, HelloWorld-x64Win64VS2017.sln, and build it.
You may need to re-target the solution for your version of Visual Studio.
In one terminal, run the subscriber:
> objs\x64Win64VS2017\HelloWorld_subscriber
In another terminal, run the publisher:
> objs\x64Win64VS2017\HelloWorld_publisher
(Make sure you have configured the environment as shown above for each shell;
alternatively, copy the rti_license.dat file to the current directory.)
You should see subscriber output similar to:
HelloWorld subscriber sleeping for 4 sec...
Received data
value: 0
Received data
value: 1
Run RTI Code Generator:
> rtiddsgen -ppDisable -language c# -example net8 HelloWorld.idl
(If necessary, replace net8 with the version of .NET you are using.)
Delete the file NuGet.Config (this file points to the installation directory, but for this evaluation we will download the NuGet packages from nuget.org):
> del NuGet.Config
Open the generated C# project, HelloWorld.csproj, with Visual Studio
or build it with the .NET CLI:
> dotnet build
In one terminal, run the subscriber:
> dotnet run -- --sub
In another terminal, run the publisher:
> dotnet run -- --pub
(Make sure you have configured the environment as shown above for each shell;
alternatively, copy the rti_license.dat file to the current directory.)
You should see subscriber output similar to:
HelloWorld subscriber sleeping for 4 sec...
value: 0
HelloWorld subscriber sleeping for 4 sec...
value: 1
Run RTI Code Generator:
> rtiddsgen -ppDisable -language java -example x64Win64VS2017 HelloWorld.idl
Build the applications (you’ll need a Java JDK installed):
> set CLASSPATH=%CONNEXTDDS_DIR%\lib\java\nddsjava.jar;.
> javac *.java
In one terminal, run the subscriber:
> java HelloWorldSubscriber
In another terminal, run the publisher:
> java HelloWorldPublisher
(Make sure you have configured the environment as shown above for each shell.)
You should see subscriber output similar to:
No data after 1 seconds.
Received:
value: 0
Received:
value: 1
...
Congratulations! You have successfully installed Connext.
Next steps#
Now you’re ready to build your own Connext distributed applications.
