2.3. Building Connext DDS Micro

This section is for users who are already familiar with CMake and may have built earlier versions of Connext DDS Micro. The sections following describe the process in detail and are recommended for everyone building Connext DDS Micro.

This section assumes that the Connext DDS Micro source-bundle has been downloaded and installed and that CMake is available.

  1. Make sure CMake is in the path.

  2. Run rtime-make.

    On UNIX® systems:

    cd <rti_me install directory>
    # you should see directories like doc/ lib/ rtiddsgen/ src/
    # and CMakeLists.txt
    
    resource/scripts/rtime-make --target self --name i86Linux4gcc7.3.0 \
                -G "Unix Makefiles" --build
    

    On Windows® systems:

    cd <rti_me install directory>
    # you should see directories like doc/ lib/ rtiddsgen/ src/
    # and CMakeLists.txt
    
    resource\scripts\rtime-make --target self --name i86Win32VS2015 \
                -G "NMake Makefiles" --build
    
  3. You will find the Connext DDS Micro libraries here:

    On UNIX-based systems:

    # <rti_me install directory>/lib/i86Linux4gcc7.3.0
    

    On Windows systems:

    # <rti_me install directory>\lib\i86Win32VS2015
    

NOTE: rtime-make uses the platform specified with --name to determine a few settings needed by Connext DDS Micro. Please refer to Preparing for a Build for details.

2.3.1. OpenSSL

The Connext DDS Micro builtin security plugin requires OpenSSL® 1.1.1d or a later 1.1.x version. The CMake build files will try to locate a suitable version and use a locally installed library if available. If a compatible library is not available, please check the RTI Download portal for a compatible version of OpenSSL. After installing OpenSSL, set OPENSSLHOME to its location when building.

rtime-make -DOPENSSLHOME=<path>/release

2.3.1.1. Excluding the Security Plugin from the Build

It is possible to exclude the builtin security plugin in Connext DDS Micro (the rti_me_seccore library). Set RTIME_TRUST_INCLUDE_BUILTIN to false to disable it.

rtime-make -DRTIME_TRUST_INCLUDE_BUILTIN=false

For help, use the --help option. For example, on a Linux system, enter:

resource/scripts/rtime-make --help

To list available targets, enter:

resource/scripts/rtime-make --list

For help for a specific target, except self, enter:

resource/scripts/rtime-make --target <target> --help

(On Windows systems, the commands are the same, but use \ instead of /.)