Windows installer#
The following instructions will guide you through the Connext installation steps, setting up a license file, and running a hello world 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 in your email,
rti_license.dat.
Existing customers
If you have already purchased a Connext bundle, please follow the installation instructions here instead.
2. Run the installer#
Double click on 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"
And set up the license file as follows:
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.
When you run your Connext applications, the license file needs to be accessible. We will show that in the next section.
4. Run a Hello World#
We will generate and run a simple Connext application to verify the installation.
First, we’ll open a command prompt and configure the environment to use Connext. From RTI Launcher, go to “Utilities” and click on “Connext DDS Professional Terminal” or alternatively, open a system prompt and run the following command:
> "<installation directory>\resource\scripts\rtisetenv_x64Win64VS2017.bat"
Define the a data type for the topic we will publish and subscribe to.
Create a file named HelloWorld.idl with the following content:
struct HelloWorld {
int32 value;
};
Now we’ll generate the code to use that type in an example application for a target language. Choose the programming language you’d like to use:
Run the 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, or
alternatively copy the rti_license.dat file to the current directory.)
You should see a 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 the 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, or
alternatively copy the rti_license.dat file to the current directory.)
You should see a subscriber output similar to:
::HelloWorld subscriber sleeping up to 1 sec...
[value: 1]
::HelloWorld subscriber sleeping up to 1 sec...
[value: 2]
...
Run the 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, or
alternatively copy the rti_license.dat file to the current directory.)
You should see a subscriber output similar to:
HelloWorld subscriber sleeping for 4 sec...
Received data
value: 0
Received data
value: 1
Run the 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, or
alternatively copy the rti_license.dat file to the current directory.)
You should see a subscriber output similar to:
HelloWorld subscriber sleeping for 4 sec...
value: 0
HelloWorld subscriber sleeping for 4 sec...
value: 1
Run the 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 a 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.
