RTI Real-Time Connect
Total Page:16
File Type:pdf, Size:1020Kb
RTI Real-Time Connect User’s Manual Version 5.1.0 © 2006-2013 Real-Time Innovations, Inc. All rights reserved. Printed in U.S.A. First printing. Decemer 2013. Trademarks Real-Time Innovations, RTI, and Connext are trademarks or registered trademarks of Real-Time Innovations, Inc. All other trademarks used in this document are the property of their respective owners. Third Party Copyright Notices The Oracle® TimesTen® In-Memory Database and the Oracle® Database are products of Oracle. Copy and Use Restrictions No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form (including electronic, mechanical, photocopy, and facsimile) without the prior written permission of Real- Time Innovations, Inc. All software and documentation (whether in hard copy or electronic form) enclosed are subject to the license agreement. The software and documentation may be used or copied only under the terms of the license agreement. The programs in this book have been included for their instructional value. RTI does not offer any warranties or representations in respect of their fitness for a particular purpose, nor does RTI accept any liability for any loss or damage arising from their use. Technical Support Real-Time Innovations, Inc. 232 E. Java Drive Sunnyvale, CA 94089 Phone: (408) 990-7444 Email: [email protected] Website: https://support.rti.com/ Available Documentation The following documentation is available for RTI® Real-Time Connect: ❏ The Release Notes, RTI_RTC_ReleaseNotes.pdf. This document provides an overview of the cur- rent release’s features and lists changes since the previous release, system requirements, supported architectures, and compatibility with other products. ❏ The Getting Started Guide, RTI_RTC_GettingStarted.pdf. This document provides installation instructions, a short ‘Hello World’ tutorial, and troubleshooting tips. ❏ The User’s Manual, RTI_RTC_UsersManual.pdf. This document starts with an overview of RTI Real-Time Connect’s basic concepts, terminology, and unique features. It then describes how to develop and implement applications that use RTI Real-Time Connect. Additional Resources: ❏ The ODBC API Reference from Microsoft is available from http://msdn.microsoft.com/en-us/ library/ms714562(VS.85).aspx. ❏ The documentation for the Oracle TimesTen In-Memory Database can be found in the doc/ direc- tory of the Oracle TimesTen installation. ❏ The documentation for Oracle databases can be found here: http://www.oracle.com/technology/documentation/index.html. ❏ The documentation for MySQL databases can be found here: http://dev.mysql.com/doc/refman/5.1/en/index.html. iii Contents 1 Welcome to RTI Real-Time Connect 1.1 Intended Readers................................................................................................................................ 1-1 1.2 Background Reading.......................................................................................................................... 1-1 2 Introduction 2.1 The Edge to Enterprise Integration Solution..................................................................................2-1 2.2 Real-Time Connect’s Unique Features ............................................................................................ 2-2 2.2.1 Interconnecting Standards.................................................................................................... 2-3 2.2.2 Connectivity To Edge Devices ............................................................................................. 2-3 2.2.3 Flexibility and Scalability ..................................................................................................... 2-4 2.2.4 Matching Real-Time Performance....................................................................................... 2-4 2.2.5 High Availability ................................................................................................................... 2-4 2.2.6 Additional Benefits of Real-Time Connect......................................................................... 2-4 3Architecture 3.1 Real-Time Connect Architecture ...................................................................................................... 3-1 3.1.1 Real-Time Connect Daemon ................................................................................................ 3-1 3.1.2 Real-Time Connect’s Unique Features................................................................................ 3-2 3.2 Capturing Real-Time Data in a DBMS............................................................................................. 3-3 3.3 Remote Real-Time Notification of Table Changes ......................................................................... 3-4 3.4 Bidirectional Integration.................................................................................................................... 3-4 3.5 Bridging between Domains............................................................................................................... 3-4 3.6 High-Rate Data Streams Cached before Storage............................................................................ 3-6 3.7 Real-Time Database Replication....................................................................................................... 3-6 4 Using Real-Time Connect 4.1 Introduction to the Real-Time Connect Daemon ........................................................................... 4-1 4.1.1 How to Run the Real-Time Connect Daemon with Oracle ............................................. 4-2 4.1.2 How to Run the Real-Time Connect Daemon with MySQL ........................................... 4-4 4.1.3 How to Run the Real-Time Connect Daemons as Windows Services ........................... 4-5 4.1.4 Typecodes ............................................................................................................................... 4-6 4.2 Command-Line Parameters .............................................................................................................. 4-6 4.3 Environment Variables..................................................................................................................... 4-10 4.4 Configuration File............................................................................................................................. 4-10 4.4.1 How to Load the XML Configuration .............................................................................. 4-10 4.4.2 XML Syntax and Validation ................................................................................................4-11 4.4.3 Top-Level XML Tags ........................................................................................................... 4-12 4.4.4 Database Configuration Using the Real-Time Connect XML Tag................................ 4-14 4.5 Meta-Tables........................................................................................................................................ 4-25 4.5.1 Publications Table................................................................................................................ 4-25 4.5.2 Subscriptions Table.............................................................................................................. 4-36 4.5.3 Table Info............................................................................................................................... 4-52 4.5.4 Log Table............................................................................................................................... 4-53 iv 4.6 User-Table Creation.......................................................................................................................... 4-55 4.7 Support for Extensible Types .......................................................................................................... 4-57 4.8 Enabling RTI Distributed Logger in Real-Time Connect............................................................ 4-58 4.9 Enabling RTI Monitoring Library in Real-Time Connect ........................................................... 4-59 5 IDL/SQL Semantic and Data Mapping 5.1 Semantic Mapping.............................................................................................................................. 5-1 5.2 Data Representation Mapping.......................................................................................................... 5-3 5.2.1 IDL to SQL Mapping............................................................................................................. 5-3 5.2.2 Primitive Types Mapping..................................................................................................... 5-6 5.2.3 Oracle In-Memory Database Cache Mapping................................................................... 5-8 5.2.4 Bit Field Mapping.................................................................................................................. 5-9 5.2.5 Enum Types Mapping.........................................................................................................5-10 5.2.6 Simple IDL Structures......................................................................................................... 5-10 5.2.7 Complex IDL Structures .....................................................................................................5-10 5.2.8 Array Fields.......................................................................................................................... 5-12 5.2.9