2. Installing Protocol Buffers Extension

Warning

Protocol Buffers Extension is currently an experimental feature, and it is being made available as an “early access” release for initial testing and feedback.

RTI Connext Protocol Buffers Extension is not installed as part of RTI Connext Professional, with the exception of the required Connext code generator extensions, which are included in the RTI Connext Professional host package.

Protocol Buffers Extension must be downloaded and installed separately. There is currently one Protocol Buffers Extension package, as outlined in Table 2.1.

Table 2.1 Protocol Buffers Extension Packages

Package Name

Package Contents

Use Case

Supported Platform

rti_connext_dds-7.6.0-protobuf-sdk-x64Linux.rtipkg

The package contains the protoc plugins, file omg/dds/descriptor.proto, and a copy of this user manual.

Install this package in order to use Protocol Buffers data models with Connext.

The SDK is only supported on Linux.

There are two ways to install the Protocol Buffers Extension package: using RTI Launcher, or the rtipkginstall command-line utility.

Note

In the rest of this chapter, <installdir> refers to the installation directory for Connext.

2.1. Prerequisites

The following applications must be installed before installing Protocol Buffers Extension.

2.2. Install from RTI Launcher

To install the Protocol Buffers Extension package from RTI Launcher:

  1. Start Launcher from the Start menu, or from the command line using: <installdir>/bin/rtilauncher.

  2. From the Configuration tab, click Install RTI Packages.

  3. Use the plus (+) sign to add the rti_connext_dds-<version>-protobuf-sdk-x64Linux.rtipkg file.

  4. Click Install.

2.3. Install from the Command Line

To install the Protocol Buffers Extension package from the command-line, run:

$ <installdir>/bin/rtipkginstall /<path-to>/rti_connext_dds-<version>-protobuf-sdk-x64Linux.rtipkg