RTI Connext Messaging Getting Started Guide
Contents
1. Installing on a Windows System Connext Messaging s components are provided in a single self extracting file one per architecture except for TLS Support and Secure WAN Transport which can be down loaded separately Connext Messaging is provided as an installer one for 32 bit Windows architectures and another for 64 bit Windows architectures You do not need to have administrator privi lege to run the installer If you run the installer with administrator privilege Connext Messaging will be installed for all users on the same machine If you run the installer without administrator privilege Connext Messaging will be installed for the current user only Note If you need to install both the 32 and 64 bit versions on the same machine see Section 2 3 1 before continuing with the installation instructions below 2 5 uoUDIIDISuI E Installation 1 Open the exe file to run the installer which will guide you through the installa tion process and allow you to select an installation directory Welcome to the RTI Connext Messaging 4 5 Setup Wizard This wizard will guide you through the installation of RTI Connext Messaging 4 5 It is recommended that you close all other applications before starting Setup This will make it possible to update relevant system files without having to reboot your computer Click Next to continue The default installation directory is C Program Files RTI if you have adminis2. L See the documentation for each component Each of the components may have Release Notes a Getting Started Guide or Installation Guide and a User s Manual They can all be accessed through the Start menu under RTI Connext 45x RTI Connext 4 5x Components lt component name gt where x represents the letter of the current release While you can skip the installation instructions in each component s Getting Started or Installation Guide please read the rest of the document These docu ments may describe other required steps for setting up the components One of the first documents to read is the RTI Core Libraries and Utilities Getting Started Guide 1 Launcher provides a convenient way to run and configure all of your Connext Messaging components See Chapter 3 Using RTI Launcher 1 To build and run your first Connext based application see Chapter 3 in the RTI Core Libraries and Utilities Getting Started Guide Installing 32 bit and 64 bit Packages on the Same Machine This section describes a special situation not applicable to most users If you need to install both the 32 bit and 64 bit packages on the same machine for example if you need 32 bit and 64 bit libraries on the same machine for cross compila tion we recommend installing both packages under the same directory Note The 64 bit libraries for Persistence Service and Federation Service cannot be used ona 32 bit machine Therefore if you run the 64 bit version of t
3. allowing you to monitor analyze and debug your complete system in operation It provides facilities for persisting data for late joiners and logging data for deeper analysis and archiving It also features adapters for DDS and JMS and superior performance and scalability The entire Connext family of products is based on RTI s ultra high performance Data bus that delivers throughput up to millions of messages per second It can deliver in excess of 50 times the performance of non real time standards such as JMS AMQP and Web Services Additionally it consistently provides low latency on the order of micro seconds QWODIOM L Welcome to RTI Connext Messaging Chapter 2 Installation RTI Connext Messaging includes these components L RTI Connext Launcher is a graphical application that allows you to run and con figure any Connext Messaging component It automatically detects which Connext Messaging components are installed and enables their launch buttons L RTI Connext Core Libraries and Utilities provide publish subscribe network ing middleware for a wide variety of processors and operating systems The Con next Core Libraries and Utilities are delivered as linkable binary libraries target libraries with development tools and documentation that aid in the use of the libraries 1 RTI TLS Support provides secure communication over the Internet using the standard Transport Layer Security TLS protocol The transport a
4. e docs_ lt version gt RTI_Connext_Messaging GettingStarted pdf This document e installers_ lt version gt Wireshark_ lt version gt This directory contains a com pressed distribution tar gz file for Wireshark and the RTI Wireshark Getting Started Guide e ndds lt version gt This directory includes Connext Core Libraries and Utilities Distributed Logger Message Service Monitoring Library and Persistence Service e RTI_Analyzer_ lt version gt e RTI Federation Service versions e RTI_Launcher_ lt version gt e RTI_Monitor_ lt version gt e RTI_Recording_Service_ lt version gt e rti set _bash_ lt version gt You can run the source command with this file name to set some of the environment variables in bash e rti_set_tcsh_ lt version gt You can run the source command with this file name to set some of the environment variables in tcsh e RTI_Shapes_Demo_ lt version gt You will be asked if you want to open the Getting Started Guide Enter either y for yes or n for no To view the Getting Started Guide you must have an application capable of reading PDF documents such as Evince You will also be asked if you want to start Launcher Enter either y for yes or n for no To run Launcher you must be running a graphical environment such as X11 GNOME or KDE Launcher is described in Chapter 3 Optionally install Wireshark Wireshark is not automatically installed be
5. for all the services For example the configuration dialog for RTI Persistence Service looks similar to this Persistence Service Persistence Service Wore rectory bare C Program Fies 8 RTI 4 sfyesourceytpersstenceservee bmi RTI Oper Configuration artn en pra teen custom seda O Cese Configuration Required no default y CEE E conim command As seen above some fields are highlighted in colors l Green indicates a field has a valid entry I Yellow indicates an entry is missing but it is not a required field L Red indicates a field that must be filled in 3 5 J9Y9UND ILA Using RTI Launcher 3 23 Utilities Tab The Utilities tab includes buttons for Connext Launcher L Code Generator generates example code and makefiles Tools Services USES Configuration project files for your data types XML L Type Conversion converts cx data type formats between Code Generator Type Converter e onica XML IDL and XSD I Recording Service Convert converts to commonly accepted formats for export to data analysis tools Shapes Demo DDS Spy DDS Ping L Shapes Demo demonstrates Connext capabilities by pub lishing and subscribing to col ored moving shapes L DDS Spy subscribes to any DDS data L DDS Ping publishes DDS ping messages to test system connectivity RTI Launcher version 4 5 Each utility s configuration dialog is dif
6. use apply Recording Service for testing algorithms and other pro cessing logic against pre recorded test data conducting regression testing from golden data inputs or recording live data from the field for post mission analy sis RTI Federation Service is an out of the box solution for integrating disparate and geographically dispersed systems It scales Connext applications across domains LANs and WANs including firewall and NAT traversal RTI Analyzer is a system level debugging tool that can find Connext objects in a running system organize them and display their communication parameters RTI Spreadsheet Add in for Microsoft Excel integrates Connext with Micro soft Excel By using cell functions Excel can subscribe to topic data and dis play it in real time You can use this live data for formulas graphs and other Before You Install 2 1 2 2 Excel features just like any other regular cell data You can also publish data from a spreadsheet Spreadsheet Add in for Microsoft Excel works with all data types Available for Windows systems only L RTI Shapes Demo is an application that illustrates the powerful real time mes saging and application integration capabilities of Connext including data centric publish subscribe real time Quality of Service QoS fault tolerance and auto matic discovery Shapes Demo is a turnkey graphical application and does not require any programming I Wireshark is a network
7. RTI Connext Messaging Getting Started Guide Version 4 5 t Your systems Working as one O 2012 Real Time Innovations Inc All rights reserved Printed in U S A First printing March 2012 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 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 The software described in this document is furnished under and subject to the RTI software license agreement The software may be used or copied only under the terms of the license agreement Technical Support Real Time Innovations Inc 232 E Java Drive Sunnyvale CA 94089 Phone 408 990 7444 Email support rti com Website https support rti com Contents Welcome to RTI Connext Messaging oooocccccoonooonnonoas 1 1 2 NAA ire a lt a is de 2 1 24 Betorecyoisdnsta il aiseanna A E tt AS Decade as 2 3 2 2 Installing on a Linux st aiii a o e i R daba 2 3 2 3 Installing on a Windows SysteM cococicicononononcononinncnnonanonanananononanancnnnonononenononononananonononananononenos 2 5 2 3 1 Installing 32 bit and 64 bit Packages on the Same Machi
8. VS2010 On Line Documentation Connext Messaging Getting Started Users Manual What s New Release Notes Platform Notes QoS Reference Guide RTI Community RTI RTI Support Portal OMG DDS Portal RTI Launcher version 4 5 3 7 Using RTI Launcher 3 8
9. cause doing so requires root privilege You will find its installer in the installers_ lt version gt Wireshark_ lt version gt directory See the installation instructions in installers_ lt version gt Wireshark_ lt version gt RTI_Wireshark_GettingStarted pdf Optionally download and install Secure WAN Transport and TLS Support You may download them from the RTI Support Portal https support rti com Enter your username and password then select the Downloads tab See Installing the License File Section 2 4 Installing on a Windows System 2 3 After Installation L See the documentation for each component Each of the components you installed may have Release Notes a Getting Started Guide or Installation Guide and a User s Manual While you can skip the installation instructions in each component s Getting Started Guide or Installation Guide please read the rest of the document These documents may describe other required steps for setting up the components One of the first documents to read is the RTI Core Libraries and Utilities Getting Started Guide lt installation directory gt Indds lt version gt doc pd RTI_Connext_GettingStarted pdf 1 Launcher provides a convenient way to run and configure all of your Connext Messaging components See Chapter 3 Using RTI Launcher 1 To build and run your first Connext application see Chapter 3 in the RTI Core Libraries and Utilities Getting Started Guide
10. ferent some have required parameters For example in rtiddsgen s configuration dialog you must specify an input file as indicated by the red field RE avs shown in the dialog to the right Code Generator rtiddsgen Input File Format lt auto detect gt Disable Pre Processor RRT Output Language C namespaces h Generate Example lt no example X Unbound String Size 255 Unbound Sequence Size 100 E Share types with CORBA Generic CORBA Y Generate type code a Econ comard 3 6 A Tour of Launcher 3 24 Configuration Tab The Configuration tab L Displays the installation directory in which Launcher will look for components L For license managed distributions only Displays and allows changes to the license file location it must point to a valid Connext Messaging license file See Installing the License File Section 2 4 L Displays the Connext Messaging version number and installed platforms 1 Provides links to documentation and other resources Connext Launcher With a license managed distribution you can change the license file location here License File C Program Files x86 RTI yt_license dat Change Installation Directory C Program Files x86 RTI Product version RTI Connext Messaging 4 5 RTI Launcher 4 5 86Win32dotnet2 0 S6Win32dotnet4 0 i86Win32jck Installed Platforms S6Win32V52005 i86Win32VS2008 i86Win32
11. grates Connext with Microsoft Excel You can use Excel cell functions to subscribe to topic data and then use the data in real time for formulas graphs and other Excel features You can also publish data from a spreadsheet To start one of the tools left click the tool s button Right clicking a button will give you additional options If a tool is not installed its button will be gray and will not work Not all tools are available on all platforms For example Spreadsheet Add in for Microsoft Excel is only available on Windows systems As described in Chapter 2 Wireshark and Spreadsheet Add in for Microsoft Excel are not auto matically installed with Connext Messaging Launcher will attempt to detect their pres ence by examining the registry on Windows systems or the PATH on Linux systems 3 3 19YIUND La Using RTI Launcher 3 2 2 3 4 Services Tab The Services tab includes buttons to launch Connext Launcher L Recording Service Record records real time data without 553 Unites configuration having prior knowledge of the data types or topics in the sys a tem This service is also avail able by using Recording Console in the Tools tab asa ick sore at a Porlitanto Servico I Recording Service Replay replays recorded data by injecting it back into the cloud You can change data rates and QoS settings This service is also available by using Recording Console in the Too
12. he Connext Messaging installer on a 32 bit machine Persistence Service and Federation Service will not be installed In this Installing the License File 2 4 2 5 situation if you had previously installed the 32 bit version of these services they will still be present Installing the License File You will receive a license file in an email from RTI To install the license file follow these steps 1 Put the license file named rti_license dat in the top level directory where you installed Connext Messaging such as opt rti on Linux systems or C Program Files RTI on Windows systems 2 Set the environment variable RTI_LICENSE_FILE to the full path of the license file including the filename such as opt rti rti_license dat on Linux systems or C Program Files RTI rti_license dat on Windows systems If you have any problems with your license file please email support rti com Note Even if your distribution of Connext Messaging is not license managed you always need a license file to run Analyzer Monitor and Spreadsheet Add in for Microsoft Excel Uninstalling Connext Messaging On a Linux System No uninstaller is provided for Connext Messaging on Linux systems Simply remove the directories that you want to uninstall To remove the entire contents of the installation directory enter the following if you changed any files that you want to save copy them to a new location first rm rf lt installatio
13. level analysis tool that can capture RTPS packets show their contents and analyze network usage Note For Windows Systems Win Pcap is also included with this component If you have questions please email support rti com or call 408 990 7444 Before You Install If you are about to install a version of Connext Messaging that is not license managed you must remove any previously installed versions of the same release that are license managed Installing on a Linux System Connext Messaging s components are provided in a single self extracting file one per architecture except for RTI TLS Support and RTI Secure WAN Transport which can be downloaded separately You do not need to be root to run the self extracting file Throughout this document we refer to 4 5x the x represents the letter of the current release The installer will guide you through the installation process and allow you to specify an installation location the default is your HOME directory the directory RTI will be added to the location you specify This is not a GUl based installer 1 Run the self extracting file for your architecture For example RTI_Connext_Messaging 4 5x RHEL5_32_lic sh Assuming you have selected opt as your installation directory you will end up with the following components under opt RTI the RTI directory is appended to your installation path automatically 2 3 uoUDIIDISuI E Installation 2 4
14. llows applica tions to communicate in a way that is designed to prevent eavesdropping tam pering or data forgery TLS Support is designed for use with the TCP transport that is included with Connext T RTI Secure WAN Transport like the TLS Transport provides secure communi cation over the Internet Instead of TLS it uses the Datagram Transport Layer Security DTLS protocol which can be run over UDP L RTI Message Service is publish subscribe networking middleware that imple ments the Java Message Service JMS specification Message Service is specifically designed for high performance distributed applications Its unique peer to peer architecture and targeted high performance and real time capabilities extend the specification to provide unmatched value 1 Available for download in a separate distribution not included with the Connext Messaging installer 2 1 UOHDI D SU E Installation 2 2 a a a a a a RTI Distributed Logger is a library that enables applications to publish their log messages to Connext The log message data can be visualized with RTI Monitor a separate GUI application that can run on the same host as your application or on a different host Since the data is provided in a topic you can also use rtiddsspy or even write your own visualization tool RTI Monitor provides a detailed graphical view into your entire Connext appli cation It displays the Quality of Service QoS
15. ls tab RTI Launcher version 4 5 Federation Service Persistence Service saves data from Connext publishing applications to memory or permanent storage so it can be delivered to subscribing applications that join the system at a later time even if the publishing application has already terminated Data can be persisted to files or an external database L Federation Service integrates disparate and geographically dispersed systems It scales Connext applications across domains LANs and WANs including firewall and NAT traversal I Routing Service like Federation Service but also supports Connext to Connext bridg ing by allowing you to make transformations in the data along the way This service is not installed with Connext Messaging it is available as part of RTI Connext Integra tor L Real Time Connect provides bidirectional integration between RTI Data Distribu tion Service and a database Oracle Database Oracle TimesTen In Memory Database or MySQL This component is not installed with Connext Messaging it is available as part of RTI Connext Integrator If a tool is not installed its button will be gray and will not work A Tour of Launcher To start one of the services left click the appropriate button use the resulting dialog to configure the service then click Run at the bottom of the configuration dialog The ser vice will start in a separate command window The configuration dialog is similar
16. n directory gt On a Windows System The Connext Messaging uninstaller will remove all the components that were previ ously installed by the Connext Messaging installer It will remove both 32 bit and 64 bit installations as well as all files that you added to any of the component directo ries 2 9 uoUDIIDISuI E Installation 2 10 Run the uninstaller by selecting Start RTI Connext 45x Uninstall RTI Connext Messaging 4 5x or Start Control Panel Add or Remove Programs RTI Connext Messaging 4 5x where x represents the letter of the current release This will not uninstall Wireshark or Spreadsheet Add in for Microsoft Excel since they were not installed by the Connext Messaging installer To uninstall these two components see the instructions in their individual Getting Started Guides Chapter 3 Using RTI Launcher 3 1 Launcher is a graphical application that allows you to run and configure any installed Connext Messaging component It automatically detects which Connext Messaging com ponents are installed and enables their launch buttons Launcher is automatically installed with Connext Messaging Starting Launcher On a Linux system LJ You must have a graphical environment such as X11 GNOME or KDE running J Open a command prompt and navigate to the Connext Messaging installation directory Run the script RTI_Launcher_ lt version gt scripts rtilauncher I Or use your browser to navigate to your C
17. n i86Win32 52005 rtilauncher exe This application has failed to start because the application configuration is incorrect Reinstalling the application may Fix this problem a CilUsersinonadminiDocumentsiRTARTI Launcher_4 5x1bin1i86Win32V52005rtilauncher exe The application has failed to start because its side by side configuration is incorrect Please see the application event log or use the command line sxstrace exe tool for more detail 3 2 A Tour of Launcher Launcher s main window includes four tabs 1 Tools Tab Section 3 2 1 LI Services Tab Section 3 2 2 LJ Utilities Tab Section 3 2 3 LI Configuration Tab Section 3 2 4 3 2 A Tour of Launcher 3 2 1 Tools Tab The Tools tab includes buttons for L Analyzer displays Connext objects and their communi Connext Launcher cation parameters Sexvices uses Configuration L Monitor provides a graphi e mae cal view into your entire y Connext application includ ing QoS and detailed statis Analyzer Monitor Recording Console tics on connections traffic errors and resource usage Ll Recording Console can wan EA record real time data with out having prior knowledge Wireshark ee of the data types or topics in the system can also replay that data back into the cloud L Wireshark captures RTPS packets shows their contents and analyzes network usage RTI Launcher version 4 5 L Spreadsheet Add in for Microsoft Excel inte
18. ne concncinicicnnnnnninincnaninos 2 8 24 Installing the License Fille tl A e a 2 9 2 5 Uninstalling Connext Messaging mocioioononononnnonoacanaranonononanananonononononononononananonononcnananononononos 2 9 Bo USING RTILOUNCA coin 3 1 Sal Starting Hanan cher ntc IL iii de 3 1 32 A Tour OF Ma unichetins i243 is tds da ei ga 3 2 A A a nm 3 3 zi Services Tab A A A SEAR aan 3 4 A il AA E RA 3 6 3 24 Configuration Tabaco iaa 3 7 Chapter 1 Welcome to RTI Connext Messaging Connext Messaging provides a versatile and highly scalable messaging middleware for developing applications leveraging a variety of embedded and enterprise design pat terns Connext Messaging s flexibility reduces development integration and testing costs and enables rapid implementation of new system requirements Features include LJ APIs for JMS and Connext DDS L Support for Persistence Service for late joiners and Recording Service for logging data for deep analysis and archiving L Federation Service securely bridges applications and systems across both local and wide area networks I Tools to monitor analyze and debug your complete system k Seamless interoperability with Connext Micro and Connext DDS With its rich set of tools and its performance and scalability extensions Connext Messag ing provides much more than a traditional messaging system It offers capabilities to visualize your data as it moves through your system even in real time
19. o lt version gt RTI_Federation_Service lt version gt RTI_Launcher_ lt version gt RTI_Monitor_ lt version gt rti_set_env_ lt version gt bat You can use this batch file to set some of the environment variables uninstall_RTI_Connext_Messaging lt version gt exe 2 Optionally install Spreadsheet Add in for Microsoft Excel Spreadsheet Add in for Microsoft Excel is not automatically installed because doing so requires administrator privilege You will find its installer in the installers lt ver sion gt RTI Spreadsheet Add in for Microsoft Excel lt version gt directory See the installation instructions in installers lt version gt RTI Spreadsheet Add in for Microsoft Excel lt version gt RTI_Spreadsheet_Addin_GettingStarted pdf 2 7 uoUDIIDISuI E Installation 2 3 1 2 8 3 Optionally install Wireshark Wireshark is not automatically installed because doing so requires administrator privilege You will find its installer in the installers lt version gt Wireshark lt ver sion gt directory See the installation instructions in installers lt version gt Wire shark lt version gt RTI_Wireshark_GettingStarted pdf 4 Optionally download and install Secure WAN Transport and TLS Support You may download them from the RTI Support Portal https support rti com Enter your username and password then select the Downloads tab 5 See Installing the License File Section 2 4 After Installation
20. onnext Messaging installation directory and double click RTI_Launcher_ lt version gt scripts rtilauncher Note If you have the license managed distribution of Connext Messaging by default at start up Launcher will look for the license file named rti_license dat in the top level directory where you installed Connext Messaging You can configure RTI Launcher to look in a different location by using the Configuration Tab Section 3 2 4 On a Windows system 1 If you have not already done so you must install the Microsoft Visual C 2005 Service Pack 1 Redistributable Package MFC Security Update The update is provided in lt install dir gt installers 4 5x Microsoft Redist where x represents the letter of the current release or you can download it from here http www microsoft com download en details aspx id 26347 3 1 19Y UND 1a Using RTI Launcher Make sure you install the x86 version even if you are using a 64 bit machine 2 Use the Start button to select RTI Connext 45x RTI Connext 4 5x Launcher where x represents the letter of the current release Troubleshooting If you see either of these messages when you run Launcher on a Windows System this indicates the Microsoft Visual C 2005 Service Pack 1 Redistributable Package MFC Security Update has not been installed C Program Files RTINRTI_Launcher_4 5x bin i86Win32VS2005 rtilauncher exe Q C Program Files RTI RTI_Launcher_4 5x bi
21. parameters for every Connext entity in the system as well as detailed statistics on connections traffic errors and resource usage RTI Monitor simplifies troubleshooting and integration RTI Monitoring Library is a plug in that enables Connext applications to pro vide monitoring data to Monitor RTI Persistence Service saves data from Connext publishing applications to memory or permanent storage so it can be delivered to subscribing applications that join the system at a later time even if the publishing application has already terminated Data can be persisted to files or an external database RTI Recording Service can record high rate data arriving in real time with mini mal impact on system behavior It can reliably record large amounts of real time data without having prior knowledge of the data types or topics in the system Recording Service is operating system and programming language agnostic recording data from a heterogeneous networked system running Connext You can also replay the recorded data by injecting it back into the data cloud The replay feature even allows you to change data rates and QoS settings and pro vides fidelity to within 10 milliseconds of the recorded data rate The Recording Console provides a point and click interface for Recording Service This interface significantly reduces Recording Service configuration time and complexity and does not require any programming The Recording Console makes it easy to
22. trator privilege or C Documents and Settings lt user gt My Documents RTI if you do not have administrator privilege aging 4 5 Choose the folder in which to install RTI Connext Messaging 4 5 Setup will install RTI Connext Messaging 4 5 in the following folder To install in a different folder click Browse and select another folder Click Install to start the installation Destination Folder Space required 1 5GB Space available 317 0GB 2 6 Installing on a Windows System You will end up with the following components in your installation directory e docs lt version gt RTI_Connext_Messaging_GettingStarted pdf This document installers lt version gt e Microsoft Redist This directory contains installers for the Microsoft Visual C 2005 Service Pack 1 Redistributable Package MFC Security Update You will need the x86 version if you plan to use RTI Launcher e RTI Spreadsheet Add in for Microsoft Excel lt version gt This direc tory contains the installer for RTI Spreadsheet Add in for Microsoft Excel and its Getting Started Guide e Wireshark lt version gt This directory contains the installer for Wire shark and its Getting Started Guide ndds lt version gt This directory includes Connext Core Libraries and Utilities Distributed Logger Message Service Monitoring Library and Persistence Service RTI Analyzer lt version gt RTI Recording Service lt version gt RTI Shapes Dem
Download Pdf Manuals
Related Search