RTI Routing Service
7.6.0
1. Introduction
1.1. How To Read This Manual
1.2. Paths Mentioned in Documentation
1.3. Files Mentioned in Documentation
2. Installation
3. Routing Data: Connecting and Scaling Systems
3.1. Routing a
Topic
between two different domains
3.1.1. Define the service configuration element
3.1.2. Specify which domains to join
3.1.3. Define a processing context
3.1.4. Define the data flow
3.2. Routing a group of
Topics
3.3. Using custom QoS Profiles
3.3.1. Defining a QoS Library
3.3.2. Specifying QoS for DDS entities
3.3.3. Applying topic filters to DDS
Inputs
and
Outputs
3.4. Traversing Wide Area Networks
3.4.1. Define a QoS profile that configures the RTI TCP transport
3.4.2. Specify the domains to join and which transport to use
3.4.3. Specify the
Topics
to be routed
3.5. Key Terms
4. Controlling Data: Processing Data Streams
4.1. Dynamic Data as a Data Representation Model
4.2. Aggregating Data From Different Topics
4.2.1. Develop a Custom
Processor
4.2.2. Create a Shared Library
4.2.3. Define a Configuration with the Aggregating
TopicRoute
4.2.3.1. Configure a plugin library
4.2.3.2. Configure a
Routing Service
with the custom routing paths
4.3. Splitting Data From a single Topic
4.3.1. Custom
Processor
implementation
4.3.2. Define a Configuration with the Splitting
TopicRoute
4.4. Periodic and Delayed Action
4.5. Simple data transformation: introduction to Transformation
4.5.1. Transformations vs Processors
4.6. What stream processing patterns can I perform?
4.7. Key Terms
5. Data Integration: Combining Different Data Domains
5.1. Unified Data Representation
5.2. Integrating a File-Based Domain
5.2.1. Develop a Custom Adapter
5.2.1.1. Implement a StreamReader for Reading Data
5.2.1.2. Implement a StreamWriter for Writing Data
5.2.2. Create a Shared Library
5.2.3. Define a Configuration that Integrates DDS with the File Adapter
5.2.3.1. Configure a Plugin Library
5.2.3.2. Define a Connection Linked to the Adapter
5.2.3.3. Define the Data Flows that Read and Write from Your Adapter
5.3. Discovery Capabilities
5.3.1. Discovery in a File-Based Domain
5.4. Key Terms
6. Remote Administration
6.1. Overview
6.1.1. Enabling Remote Administration
6.1.2. Available Service Resources
6.1.2.1. Example
6.1.3. Resource Object Representations
6.2. API Reference
6.2.1. Remote API Overview
6.2.2. Service
6.2.3. DomainRoute
6.2.4. Connection
6.2.5. Session
6.2.6. AutoRoute
6.2.7. Route
6.2.8. Input/Output
6.3. Example: Configuration Reference
6.4. The Remote Administration Shell
6.4.1. Remote Shell Commands
6.4.2. Command: add_peer
6.4.3. Command: create
6.4.4. Command: delete
6.4.5. Command: disable
6.4.6. Command: enable
6.4.7. Command: get
6.4.8. Command: load
6.4.9. Command: pause
6.4.10. Command: resume
6.4.11. Command: save
6.4.12. Command: shutdown
6.4.13. Command: unload
6.4.14. Command: update
7. Monitoring
7.1. Overview
7.1.1. Enabling Service Monitoring
7.1.2. Monitoring Types
7.2. Monitoring Metrics Reference
7.2.1. Service
7.2.2. DomainRoute
7.2.3. Session
7.2.4. AutoRoute
7.2.5. Route
7.2.6. Input/Output
8. Usage
8.1. Command-Line Executable
8.1.1. Starting Routing Service
8.1.2. Stopping Routing Service
8.1.3. Routing Service Command-Line Parameters
8.2. Routing Service Library
8.2.1. Example
8.3. Operating System Daemon
9. Configuration
9.1. Configuring Routing Service
9.2. XML Tags for Configuring RTI Routing Service
9.2.1. Routing Service Tag
9.2.1.1. Example: Specifying a configuration in XML
9.2.2. Administration
9.2.3. Monitoring
9.2.3.1. Monitoring Configuration Inheritance
9.2.4. Domain Route
9.2.4.1. Example: Mapping between Two DDS Domains
9.2.4.2. Example: Mapping between a DDS Domain and raw Sockets
9.2.5. Session
9.2.6. Route
9.2.7. Input/Output
9.2.7.1. Creation Modes
9.2.7.2. Specifying Types
9.2.7.3. Data Transformation
9.2.8. Auto Route
9.2.9. Plugins
9.3. Enabling Distributed Logger
9.4. Support for Extensible Types
9.4.1. Example: Samples Published by Two Writers of Type A and B, Respectively
9.4.2. Type Compatibility Checking
9.5. Support for RTI FlatData and Zero Copy Transfer Over Shared Memory
9.5.1. Example: Configuration to enable both FlatData and Zero Copy transfer over shared memory
9.5.2. Support for
Security Plugins
9.5.3. Example: Configuring a Routing Service Instance using Security
9.5.4. Example: Configuring Routing Service to use a Certificate Revocation List (CRL)
9.5.5. Example: Configuring Routing Service for Dynamic Certificate Renewal
9.6. Support for Application Acknowledgment
10. Software Development Kit
11. Core Concepts
11.1. Resource Model
11.1.1. Directory
11.1.2. Service
11.1.2.1. Plugin Interaction
11.1.2.2.
Service
States
11.1.3. DomainRoute
11.1.3.1. DomainRoute States
11.1.4. Connection
11.1.4.1. Plugin Interaction
11.1.4.2.
Connection
States
11.1.4.3. Type Registration
11.1.5. Session
11.1.5.1. Plugin Interaction
11.1.5.2.
Session
States
11.1.6. Route
11.1.6.1. Plugin Interaction
11.1.6.2.
Route
States
11.1.7. AutoRoute
11.1.7.1.
AutoRoute
States
11.1.8. Input
11.1.8.1. Plugin Interaction
11.1.8.2.
Input
States
11.1.9. Output
11.1.9.1. Plugin Interaction
11.1.9.2.
Output
States
11.2. Builtin plugins
11.2.1. DDS Adapter
11.2.1.1. DDS AdapterPlugin
11.2.1.2. DDS Connection
11.2.1.3. DDS Session
11.2.1.4. DDS StreamReader
11.2.1.5. DDS StreamWriter
11.2.2. Forwarding Processor
12. Advanced Use Cases
12.1. Propagating Content Filters
12.1.1. Enabling Filter Propagation
12.1.2. Filter Propagation Behavior
12.1.3. Filter Propagation Events
12.1.4. Restrictions
12.2. Topic Query Support
12.2.1. Dispatch Mode
12.2.2. Propagation Mode
12.2.3. Restrictions
13. Common Infrastructure
13.1. Configuring RTI Services
13.1.1. How to Load and Select an XML Configuration
13.1.1.1. Loading from Files
13.1.1.2. Loading from In-Memory Strings
13.1.1.3. Selecting which Configuration to Run
13.1.1.4. Default Files
13.1.1.5. XML Syntax and Validation
13.1.1.6. Listing Available Configurations
13.1.1.7. Configuration Variables
13.1.2. How to Load Default QoS Profiles
13.1.3. How to Set Logging Properties
13.1.3.1. Command-Line Options
13.1.3.2. Library API
13.1.3.3. XML Configuration
13.1.4. How to Run as an Operating System Daemon
13.1.4.1. Linux and macOS Systems
13.1.4.2. Windows Systems
13.1.5. How to use a License File with RTI Services
13.1.6. Key Terms
13.2. Application Resource Model
13.2.1. Example: Simple Resource Model of a Connext Application
13.2.2. Resource Identifiers
13.2.2.1. Escaped Identifiers
13.2.2.2. Example: Resource Identifiers of a Generic Connext Application
13.2.2.3. Example: Resource Identifiers Generated from XML Entity Model
13.3. Remote Administration Platform
13.3.1. Remote Interface
13.3.1.1. Standard Methods
13.3.1.2. Custom Methods
13.3.2. Communication
13.3.2.1. Reply Sequence
13.3.2.2. Example: Controlling services remotely from a Connext Application
13.3.3. Common Operations
13.3.3.1. Create Resource
13.3.3.2. Get Resource
13.3.3.3. Update Resource
13.3.3.4. Set Resource State
13.3.3.5. Get Resource State
13.3.3.6. Delete Resource
13.4. Monitoring Distribution Platform
13.4.1. Distribution Topic Definition
13.4.1.1. Example: Monitoring of Generic Application
13.4.2. DDS Entities
13.4.3. Monitoring Metrics Publication
13.4.3.1. Configuration Distribution Topic
13.4.3.2. Event Distribution Topic
13.4.3.3. Periodic Distribution Topic
13.4.4. Monitoring Metrics Reference
13.4.4.1. Statistic Variable
13.4.4.2. Host Metrics
13.4.4.3. Process Metrics
13.4.4.4. Base Entity Resource Metrics
13.4.4.5. Network Performance Metrics
13.4.4.6. Thread Metrics
13.5. Plugin Management
13.5.1. Shared Library
13.5.1.1. Configuration
13.5.2. Library API
14. Tutorials
14.1. Starting Shapes Demo
14.2. Example: Routing a single specific Topic
14.3. Example: Routing All Data from One Domain to Another
14.4. Example: Changing Data to a Different Topic of Same Type
14.5. Example: Changing Some Values in Data
14.6. Example: Transforming the Data’s Type and Topic with an Assignment Transformation
14.7. Example: Transforming the Data with a Custom Transformation
14.8. Example: Using Remote Administration
14.9. Example: Monitoring
14.10. Example: WAN Connectivity using the TCP transport
14.10.1. Important Considerations
14.11. Example: Using a File Adapter
14.12. Example: Using a Shapes Processor
15. Release Notes
15.1. Supported Platforms
15.2. Compatibility
15.3. What’s New in 7.6.0
15.3.1. Remote Administration remove_peer command has been implemented
15.4. What’s Fixed in 7.6.0
15.4.1. Serialization and Deserialization
15.4.1.1.
[Critical]
Unexpected error messages when Routing Service disposed of an instance while using batching and setting serialize_key_with_dispose to TRUE
15.4.2. Memory Leaks/Growth
15.4.2.1.
[Minor]
Memory leak if malformed configuration file prevents Routing Service creation
15.4.3. Crashes
15.4.3.1.
[Critical]
Possible crash if custom transformation on input returned the provided input samples or sample infos as output
15.4.4. Other
15.4.4.1.
[Critical]
Routing Service didn’t allow configuration of its internal clock
15.4.4.2.
[Minor]
Routing Service user library required inclusion in correct environment variable to be loaded
15.5. Previous Releases
15.5.1. What’s New in 7.5.0
15.5.1.1. Support for legacy Administration and Monitoring in Routing Service has been removed
15.5.2. What’s Fixed in 7.5.0
15.5.2.1. Hangs
15.5.2.2. Crashes
15.5.2.3. Vulnerabilities
15.5.3. What’s New in 7.4.0
15.5.3.1. New API in Routing Service Library API to Send Remote Commands
15.5.4. What’s Fixed in 7.4.0
15.5.4.1. Serialization and Deserialization
15.5.4.2. Dynamic Data
15.5.4.3. Crashes
15.5.4.4. Vulnerabilities
15.6. Known Issues
15.6.1. Attempting to route builtin Security Logging topic causes Routing Service crash
15.6.2. Some tags in the XML configuration must be grouped in a strict order
15.6.3. Routing Service Adapters built using Java fail on Windows machines when using OpenJDK
Copyrights and Notices
RTI Routing Service
Index
Index
A
|
C
|
D
|
E
|
F
|
I
|
L
|
O
|
P
|
R
|
S
|
T
|
X
A
Adapter
AutoTopicRoute
C
Configuration name
Configuration variable
D
Data Integration
Data Stream
Discovery Peer
DomainRoute
DynamicData
E
Entity Configuration Name
Entry Point
F
Forwarding Process
I
Info Object
Input
L
Library API
Loaned samples
O
Output
P
Periodic action
Processor
Publication Side
R
Resource model
S
Sample
Session
Shared Library or Module
Shipped executable
Stream Discovery
Stream Processing Patterns
StreamInfo
Subscription Side
T
TopicRoute
Transformation
Transport
X
XML document