Getting Started - Community RTI Connext Users
Contents
1. Stop the Record tool by pressing lt Control C gt Leave the command prompt window open you will use it in Section 4 4 1 On Windows systems from the Start menu select Accessories Command Prompt 4 4 Viewing the Recorded Data with SQLite 44 Viewing the Recorded Data with SQLite 1 After running and stopping the Record tool as described in Section 4 3 list the contents of the current directory You will see that the Record tool created a file called simple_config dat_0_0 The first 0 is a fileset number the second 0 is a segment num ber From the same command prompt used to run the Record tool open the database file with lt Recording Service install directory gt bin lt architecture gt sqlite3 to view the recorded data For example assuming your command prompt is in lt Recording Service install directory gt scripts where the data files are enter the following replace lt architecture gt to match your installation gt bin lt architecture gt sqlite3 simple _config dat_0_0 To use sqlite3 you will need some basic knowledge of SQL commands for informa tion please visit www sqlite org Start by displaying a list of the tables in the database sqlite gt tables The Record tool creates this table for discovery data e DCPSPublication data type DDS_PublicationBuiltinTopicData This table stores the recorded topic data e Circle RecordAll domain0 e Square RecordAll domain0 Topic table name2. lt domain_id gt lt deserialize mode gt RTIDDS DESERTALIZEMODE ALWAYS lt deserialize_mode gt lt domain gt b If your computer does not have an active network interface use the following lines in the domain properties section lt domain name domain0 gt lt domain_id gt 0 lt domain_id gt lt participant_qos gt lt discovery gt lt multicast receive addresses gt lt discovery gt lt transport_builtin gt lt mask gt SHMEM lt mask gt lt transport_builtin gt lt participant_qos gt lt domain gt Running the Record Tool 1 2 Open a command prompt and change to the lt install dir gt scripts directory Start the Record tool with your new configuration file from Section 4 2 For example if you saved the configuration file someplace other than the scripts directory specify the full path to the file gt rtirecord cfgFile mysimple record_config xml cfgName example On Windows systems when using an evaluation version of Recording Service If you are not logged in as Administrator the license manager will display a message Error in saving configuration settings You are not a license administra tor This message is benign and the Record tool should run normally On Windows systems depending on your security settings you may see a Windows Security Alert dialog if so simply click Unblock Wait about one minute to give the Record tool time to record data from Shapes Demo
3. 4 Replaying Data at Normal Speed This example will replay the recorded data once at the same speed and with the same QoS as when the data was recorded The data will be replayed on the domain ID specified in the config uration default 0 or on the domain ID specified on the command line 1 Start one copy of Shapes Demo configured as in Section 4 2 and create subscribers for Squares and Circles Open a command prompt and change to the lt install dir gt scripts directory Start Replay with your new configuration file from Section 4 5 2 For example if you saved the configuration file someplace other than the scripts directory specify the full path to the file gt rtireplay cfgFile mysimple replay _config xml cfgName simple example Expected Results In Shapes Demo you should see the objects moving exactly the same as when they were recorded When the example has finished replaying press lt Control C gt to exit In the XML configuration file look at the configuration named simple_example the first example This example defines a single database simple_config with a single session A Session and a single topic All Topic yet Replay replayed the data from both Squares and Circles This happened because the topic description uses wildcards to indicate that Replay should replay any topics in the database with any values of topic name type name record group name and domain name Replay created a se
4. Demo and or the Console s display area to confirm that the data is replayed at the scheduled time If it runs out of data before the stop time it will simply stop early If you want it to keep repeating the replay press ha to open the Playback Configuration panels and check Auto repeat before scheduling the activity Configured without a file v Auto repeat 3 6 Replaving Data 22 Press the Topics Table button This will show you the Topic names and first and last samples for each Topic Recorded Topics Topic First recorded sample Last recorded sample i Square 11 34 11 AM EST Mon Dec 2 2013 11 34 25 AM EST Mon Dec 2 2013 W Circle 11 34 11 AM EST Mon Dec 2 2013 11 34 25 AM EST Mon Dec 2 2013 Enter Search String 23 Press Clear Selections and then Play Dl Since no topics are selected no data will be replayed 24 Enter Cir in the search field at the bottom Now only Circle topics appear in the table Check the box next to the Circle 25 Press Play I again Notice in the Subscriber Demo that only the circle object is being replayed This concludes the tutorial for Recording Console To learn how to use the individual Replay and Record tools from the command line not through the Console see Chapter 4 Or for more information see the Recording Service User s Manual 3 7 Chapter 4 Tutorial Record and Replay Tools 4 1 While Chapter 3 s tutorial focused on recording and
5. following exercises I Setting Up Shapes Demo Section 3 1 I Recording Data Section 3 2 I Replaying Data Section 3 3 Setting Up Shapes Demo We ll use Shapes Demo to publish and subscribe to Topics which will appear in the application window as colored moving shapes Each shape is a Topic the topic s data includes the shape s color x and y coordinates a fillKind solid empty horizontal or vertical stripes and an angle To Begin the Tutorial 1 Start two copies of Shapes Demo e On Linux systems Enter the following command gt lt Shapes Demo install directory gt scripts rtishapesdemo e On Windows systems If you have RTI Launcher you can use its Utilities tab to start Shapes Demo Or from the Windows Start menu navigate to RTI Shapes Demo lt version gt and select RTI Shapes Demo Depending on your security settings you may see a Windows Security Alert dialog simply click Allow Access No configuration changes are necessary If you choose to use a different domain ID make sure to use the same value in both instances of Shapes Demo as well as in the Console s Configuration panels Repeat so you are running two instances of Shapes Demo 3 1 Recording Data We ll refer to the first Demo window as the Publisher Demo and the second as the Sub scriber Demo 2 In the Publisher Demo create 2 squares and a circle all with default QoS settings a Under Publish select Square b In the Cre
6. gt The lines to look for are lt Source Database Required gt lt replay database name simple config gt lt filename gt replay database dat_ 0 0 lt filename gt Note There are three configurations in simple_config xml so you will need to change the filename in three places if you want to use a different filename The configuration file assumes you want to use domain ID 0 for the participant that will replay the data and domain ID 1 for remote administration If that s alright you can skip this step Otherwise you will need to change the domain ID s in the configuration file or specify the replay domain ID and or the remote administration domain ID on the command line with domainIdBase and remoteAdministrationDomainId options respectively In the configuration file the domain ID assignment for replaying the data is right after the filename parameter and looks like this lt participant gt lt domain_id gt 0 lt domain_id gt lt participant_qos gt The replay participant domain ID assignment occurs in three places so be sure to change all of them The domain ID assignment for remote administration is near the top of the service con figuration and looks like this lt administration gt lt name gt example lt name gt lt domain_id gt 1 lt domain_id gt lt administration gt The remote administration domain ID is only set in one of the examples 4 7 Using Replay 4 5 3 4 5
7. replaying data from the Recording Console this chapter s tutorial will show you how to use the individual Replay and Record tools These are actually the same services that the Console invokes First we will generate recordable data via Shapes Demo a Connext application Then we will record data sent between two instances of Shapes Demo and view the database tables with the provided SQL tool sqlite3 Next we will replay the data Finally we will learn how to manage the Record tool remotely Important LJ To understand the contents of each database record you will need to consult the RTI Core Libraries and Utilities C API Reference documentation L To use sqlite3 to view the recorded data you will need a basic understanding of SQL commands for information please visit www sqlite org The tutorial assumes you have the following software installed using the same version number for both components LI Recording Service I Shapes Demo Exercises in the tutorial include m Setting Up Shapes Demo Section 4 1 L Configuring the Record Tool Section 4 2 I Running the Record Tool Section 4 3 m Viewing the Recorded Data with SQLite Section 4 4 I Using Replay Section 4 5 m Managing the Record Tool Remotely Section 4 6 Setting Up Shapes Demo We ll use Shapes Demo to publish and subscribe to Topics which will appear in the application window as colored moving shapes Each shape is a Topic the topic s data includes the
8. RIT Recording Service Getting Started Guide Version 5 1 0 t I Your systems Working as one 2007 2013 Real Time Innovations Inc All rights reserved Printed in U S A First printing December 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 a and Use Restrictions T of this publication may be reproduced stored in a retrieval system or transmitted in any form including electronic mechanical photocopy and facsimile without the a written permission of Real Time Innovations Inc The software described in this Fenny 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 Third Party Copyright Notices Portions of this product include software derived from Fnmatch c 1989 1993 1994 The Regents of the University of California All rights reserved The Regents and contributors provide this software as is without warranty 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 Contenis N Ww A Welcome to RTI Recording Service Installation 2 1 Downloading Recording Service ccccceeeeccssssssssesssssssseesesesssssssesesssss
9. Recording Service you must download the distribution file from the RTI Support Portal accessible from https support rti ccom You will need your username and password to log in these are included in the letter confirming your purchase or evaluation copy If you do not have this letter please contact license rti com Once you have logged into the portal select the Downloads link then select the distribution that matches the architecture on which you will be running the Record tool and the version of your Connext application Distribution files follow the naming convention RTI_Recording_ Service lt version gt lt architec ture gt exe For example RTI_Recording_Service 5 x y WIN32 exe Save the file to a temporary directory on your computer such as tmp on UNIX based systems or My Documents on Windows systems If you need help with the download process contact support rti com RTI Shapes Demo If you want to work through the tutorials in Chapter 3 and Chapter 4 you will also need RTI Shapes Demo It is included with Connext Messaging It is also available from the RTI Support Portal https support rti ccom or RTI s Downloads page http www tti com downloads in the section titled Interactive Demonstration Shapes Demo runs on Windows and Linux systems Follow the installation instructions that accompany the distribu tion file 2 1 Installing Recording Service 2 2 Installing Recording Service On Windows Se
10. ate New Publisher dialog select RED and click OK Use the defaults for the other settings You should see a red square moving in the display area c Use the same process to create a green square and a yellow circle You ve just created 3 Writers 2 Squares 1 Circle 3 In the Subscriber Demo subscribe to squares and circles a Under Subscribe select Square and click OK Leave the default settings You ve just created a single Reader that will receive data for all squares all colors b Use the same process to create a Reader for circles Your two Shapes Demo windows should look like this File View Publish Subscribe Controls Help File View Publish Subscribe Controls Help a RTI Shapes Demo Domain 0 Publish ish Square Circle Triangle Square Circle 7 Triangle Delete All Delete All Pause Publishing Pause Publishing Hide History Hide History Configuration m Configuration Publisher Subscriber By default Subscribers show the most recent 6 samples this is why you see extra shapes behind the leading one The most recent shape has a thick colored border Older historical samples have a thinner border of the same color Published shapes have a thin black border c You may minimize these two windows 3 2 Recording Data 1 Start Recording Console On UNIX based systems If you have Connext Messaging you can start the Rec
11. be to squares and circles a Under Subscribe select Square and click OK Leave the default settings You ve just created a single Reader that will receive data for all squares all colors b Use the same process to create a Reader for circles 4 2 Configuring the Record Tool 4 2 Your two Shapes Demo windows should look like this RTI Shapes Demo Domain 0 ACEA L RTI Shapes Demo Domain 0 28 File View Publish Subscribe Controls Help File View Publish Subscribe Controls Help Publish Publish Square a Square i Circle Circle Triangle Triangle A Subscribe LJ Subscribe Square F e Square ircle Circle m O Triangle Triangle Delete All Delete All Pause Publishing Pause Publishing Hide History Hide History Configuration m Configuration Publisher Subscriber By default Subscribers show the most recent six samples this is why you see extra shapes behind the leading one The most recent shape has a thick colored border Older historical samples have a thinner border of the same color Published shapes have a thin black border c You may minimize these two windows Configuring the Record Tool You may specify a configuration file when you start the Record tool The configuration file is used to set properties that control what to record how to record and where to save the recorded data The lt install
12. d in a pattern Slider controls replay speed Press Stop ol Replay the data again but this time try moving the vertical slider on the right which controls the replay rate Slide it up to go faster down to go slower You will be able to see the rate change in the Subscribing Demo To quickly return to the original speed press Play Dl Press Stop ol Replay just a section in the middle of the data Drag the vertical bars on the progress bar inward to shorten the replay time Drag these bars inward to restrict the time range for replaying data 3 5 Replaving Data 15 Press Play 16 17 18 19 20 21 to begin replaying the just the middle section of the data beginning the left bar and ending where you put the right bar ia where you Press Stop E Slide the bars back to their original positions to the far left and far right Now let s see how to schedule a recording Press the Schedule button From the drop down list on the left select replay Set a starting time for 1 minute from now and a stop time for 1 minute a ter that Check the Ends at box Activity Schedule at 12 02 PM gt December 2013 4 December 2013 Sun Mon Tue Wed Thu Sun Mon Tue Wed Thu 24 25 26 27 28 24 25 26 27 28 1 i 3 5 B 3 4 5 8 9 10 12 8 9 10 nHn pB 15 16 17 18 19 15 16 17 18 19 22 23 24 25 26 22 23 24 25 26 29 30 31 1 2 29 30 31 1 2 Watch the Subscriber
13. dir gt examples record directory contains these example files _ simple_config xml I advanced_config xml L remote_shell xml Let s start learning about the Record tool with the simple configuration 1 Copy lt install dir gt examples record simple_config xml to lt install dir gt scripts mysimple_record_config xml On Windows Vista Windows 7 and Windows 8 If you installed under Program Files and do not have write permission to that directory you will have to put mysimple_record_config xml in your Documents folder instead When you start Record you will need to specify the full path to the file such as c Users lt user name gt Docu ments mysimple_record_config xml If your computer has an active network interface and you are using the default domain ID 0 for Shapes Demo proceed to Running the Record Tool Section 4 3 you can use the copied configuration file as is Otherwise open mysimple_record_config xml with an editor of your choice make the following changes then save and close the file a If you changed the domain ID used by Shapes Demo change the lt domain_id gt line to use the same value For example if you set the domain ID to 3 in Shapes Demo then change it here too 4 3 Running the Record Tool Change the bold line to use the same domain ID as Shapes Demo Turn off multicast gt Only use shared memory gt 4 3 lt domain name domain0 gt lt domain id gt 3
14. dvanced_example remotefile examples record advanced_config xml Wait a few seconds and enter status in the shell The Record tool should now be config ured based on advanced_config xml Wait a few seconds and enter stop in the shell The Record tool should now be stopped Reconfigure the Record tool with a file that is local to the Record Shell tool configure advanced_example localfile examples record advanced_config xml Wait a few seconds and enter status in the shell The Record tool should now be config ured based on advanced_config xml Enter the stop command to stop recording Enter the shutdown command to shut down the Record tool Enter the exit command to exit the shell 4 6 2 Modifying the Record Tool While it is Running 1 Copy lt installation directory gt examples record remote_shell xml to lt installation directory gt scripts remote_shell xml Start the Record tool with the configuration file remote_shell xml in the examples directory rtirecord cfgFile remote_shell xml cfgName remote_shell Start Shapes Demo and create publishers for a Square Circle and Triangle Start the remote shell rtirecsh domainId 1 In the shell enter model Managing the Record Tool Remotely You will see the following results Current Record Model lt recorder gt lt model name configuration gt lt domain name domain0O state RUNNING gt lt domain_id gt 0 lt domain_id gt lt domain g
15. e Files used by Recording Console L doc Documentation L examples Example configuration files for Record and Replay Ld jre Java libraries and executables LI lib lt architecture gt Libraries L resource idl IDL files used by Record and Replay L resource schema The Recording Service XSD and DTD for XML validation and configuration help L resource xml Folder for XML files including the default Recording Service configuration Please put your own XML files here I scripts Scripts to launch the executables Ll zip Files used by Recording Console Recording Console creates an additional directory J On UNIX based systems lt user home directory gt rti recording_service_5 x y console J On Windows systems My Documents RTI RTI Recording Service 5 x y This directory contains LI A settings ini file which contains operational settings If you want to reset the applica tion settings delete this file A new file will be created the next time you start Recording Console 2 2 Installing the License File 2 3 LI A logs directory which may contain message logs in case you need to troubleshoot prob lems Installing the License File If your Recording Service distribution requires a license file you will receive one via email from RTI If you have Connext Messaging and you want to use RTI Launcher to start Recording Service By default Launcher looks for the license file rti_license dat in the top level director
16. e Record Tool using Shared Memory ireerreeesserseessereseeseeess 4 11 4 6 2 Modifying the Record Tool While it is Running s sesssssessssessesssssiesessessessenressesseess 4 11 iii Chapter 1 Welcome to RTI Recording Service RT Recording Service includes these components m m m m m Record an RTI Connext formerly RTI Data Distribution Service application that records both Connext discovery and topic data All recorded data is stored in one or more SQL data base files Replay a tool that can play back the recorded data You even have the option of replaying the data with different data rates or QoS settings Recording Console a simple graphical user interface GUI for using the Record and Replay tools This interface significantly reduces Recording Service configuration time and complex ity and does not require any programming The Recording Console makes it easy to use Recording Service for testing algorithms and other processing logic against pre recorded test data conducting regression testing from golden data inputs or recording live data from the field for post mission analysis Convert a utility that enables serialized or deserialized data recorded with Record to be exported to CSV HTML SQL or XML formats sqlite3 a SQL command line tool that provides another way to view the data files Recording Features L Records data from applications in multiple domains I Record
17. elect count from CircleSRecordAl1l domaino To find all x values greater than 100 sqlite gt select x from Circle RecordAll domainO where x gt 100 To find all x y values where x is greater than y sqlite gt select x y from Circle RecordAll domainO where x gt y Try other SQL commands to explore the recorded data When you are ready to exit sqlite3 enter sqlite gt exit Using Replay In this section you will learn about I Recording Data for Replay Section 4 5 1 I Changing Replay s Configuration File Section 4 5 2 I Replaying Data at Normal Speed Section 4 5 3 I Replaying Data at a Faster Rate and Using Remote Control Section 4 5 4 Recording Data for Replay To get started with Replay you can either a use the example database provided in examples replay replay_database dat_0_0 or b configure and run Record using the steps in Section 4 2 and Section 4 3 with the replay_example configuration instead of example gt rtirecord cfgFile mysimple record_config xml cfgName replay example Remember the name of the data file that gets created you will need it in the next section Replay can replay data that has been recorded in either serialized or deserialized form For files recorded in serialized mode SQLite is unable to look at the individual fields in the sample data For files recorded in deserialized mode it is important for the Record tool to record all of the fields of the sample data as R
18. eplay is unable to replay partial data Changing Replay s Configuration File Replay requires an XML configuration file We will use the example file simple_config xml pro vided in lt install dir gt examples replay Note that this is not the same file that you changed in Section 4 5 1 that was Record s simple_config xml now we are using Replay s simple_config xml 4 6 Using Replay Copy lt install dir gt examples replay simple_config xml to lt install dir gt scripts mysimple_replay_config xml On Windows Vista Windows 7 and Windows 8 If you installed under Program Files and do not have write permission to that directory you will have to put mysimple_replay_config xml in your Documents folder instead When you start Replay you will need to specify the full path to the file such as c Users lt user name gt Documents mysimple_replay_config xml The configuration file assumes that the database containing serialized samples is named replay_database dat_0_0 this file is in lt install directory gt examples replay if you want to replay this example database copy it to lt install directory gt script and skip the rest of this step However if you want to replay a file that has a different name you will need to edit mysimple_replay_config xml To change the name of the database file in mysimple_replay_config xml change the value of the lt filename gt parameter just below the tag for lt replay_database
19. in gt lt topic group name Circle state RUNNING ref count 0 gt lt topics gt lt topic_expr gt Circle lt topic_expr gt lt exemption gt lt exemption gt lt topics gt lt field_expr gt lt field_expr gt lt topic_group gt lt topic_group name Square state RUNNING ref count 1 gt 4 12 Managing the Record Tool Remotely lt topics gt lt topic_expr gt Square lt topic_expr gt lt exemption gt lt exemption gt lt topics gt lt field_expr gt lt field_expr gt lt topic_group gt lt topic_group name Triangle state RUNNING ref count 1 gt lt topics gt lt topic_expr gt Triangle lt topic_expr gt lt exemption gt lt exemption gt lt topics gt lt field_expr gt lt field_expr gt lt topic_group gt record group name SquareTriangle state RUNNING ref _count 1 gt lt domain_ref gt lt element gt domain0 lt element gt lt domain_ref gt lt topic_ref gt lt element gt Square lt element gt lt element gt Triangle lt element gt lt topic_ref gt lt record_group gt lt model gt lt recorder gt Notice that the topic group we just added has a ref_count of 0 This means no record groups are referencing it at the moment Now let s fix that In the shell enter the following command all on one line add lt dds gt lt recorder gt lt record_ group name Circle gt lt domain_ref gt lt element gt domain0 lt element gt lt domain_ref gt lt topic_ref g
20. ll commands I Connecting to the Record Tool using Shared Memory Section 4 6 1 LI Modifying the Record Tool While it is Running Section 4 6 2 The configuration files used in the examples are in lt install directory gt examples record Note If you are using different domain IDs for running the Record tool you must edit the con figuration files to use your domain IDs By default the example configuration files use domain IDs 0 and 1 4 10 Managing the Record Tool Remotely 4 6 1 Connecting to the Record Tool using Shared Memory 1 10 11 12 13 14 15 16 17 Copy lt install directory gt examples record advanced_config xml to lt install directory gt scripts advanced_config xml Change to this directory lt installation directory gt scripts Start the Record tool as follows rtirecord cfgFile advanced_config xml cfgName remote example In another shell change to this directory lt installation directory gt scripts In the shell from step 4 start the Record Shell rtirecsh domainId 0 noUdpv4 Enter info in the shell that is running rtirecsh to see which Record session it is con nected to Enter status to check Record s status Note that State is RECORDING Enter stop to tell Record to stop recording Enter status The State value should be STOPPED indicating that recording has been stopped Reconfigure the Record tool with a file that is local to the Record tool configure a
21. main_ref gt lt element gt domain0 lt element gt lt domain_ref gt lt topic_ref gt lt element gt Square lt element gt lt element gt Triangle lt element gt lt topic_ref gt lt record_group gt lt model gt lt recorder gt Now we re recording the topic Circle You can open the database to verify this 4 14
22. ording Console from RTI Launcher s Tools tab Or open a command prompt change to the lt Recording Service install directory gt scripts directory and start the Console gt rtirecordingconsole Wait a few seconds for the Console to launch 3 2 Recording Data On Windows systems If you have Connext Messaging you can start the Recording Console from RTI Launcher s Tools tab Or from the Start menu navigate to RTI Recording Service lt version gt and select RTI Recording Console Wait a few seconds for the Console to launch 2 Create a new file in which to record data from Shapes Demo e Press the New Recording button b and specify a file name and location Then click on Create File 3 Press the Record button O to start recording Creating a new recording file 3 Recording name MyConsoleRecording On Windows systems depending on your security settings you may see a Windows Security Alert 99 Aar dialog if so simply click Allow Access 3 3 Replaying Data 3 3 4 Wait a few seconds for the Console to discover and start recording data from Shapes Demo File size grows as data is recorded Elapsed time Stop Pause Tip If you have trouble recording see Troubleshoot ing Recording Problems Section 2 4 2 5 In the Publishing Demo click on the red square and move it around in a pattern such as a circle or zig zag Notice that the red square in the Subscribing Demo is mo
23. parate DataWriter for each topic that it found matching the selection parameters in this exam ple there were two Squares and Circles In the next example we will be more discrimi nating Replaying Data at a Faster Rate and Using Remote Control This example demonstrates a higher degree of control over the parameters used during replay We will replay the data faster than its original speed by using a different configuration named fast_replay And while the data is replaying you will see how to remotely control the replay by pausing resuming and single stepping 1 Open a command prompt and change to the lt install dir gt scripts directory 2 Start Replay in the same manner described in Section 4 5 3 with these minor changes to the command line e Replace cfgName simple example with cfgName fast replay e Add the parameter remoteAdministrationDomainId followed by the domain ID that you want to use for remote operation You can omit this option if you already changed the remote administration domain ID assignment in the configuration file as discussed in Section 4 5 2 For example if you saved the configuration file someplace other than the scripts direc tory specify the full path to the file 1 On Windows systems from the Start menu select Accessories Command Prompt 2 On Windows systems from the Start menu select Accessories Command Prompt 4 8 Using Replay gt rtireplay cfgFile mysimple re
24. play config xml cgfName fast_replay remoteAdministrationDomainId lt other_domain_id gt Expected Results You should see the objects moving in Shapes Demo at a higher rate of speed than in the previous example In the XML configuration file look at the configuration named fast_replay the second example You will see that the higher rate of replay was configured using the lt rate gt parameter of the lt replay_service gt lt time_control gt section of this configuration By this time you should also notice that this replay does not stop but repeats the move ment of the objects once the original data has been replayed You can see in the configu ration that this was selected by setting the mode LOOP for the lt start_mode gt parameters of the lt replay_topic gt lt topic_time_control gt sections of A_Topic and B_Topic Repeating the data allows us to experiment with remote control without hav ing the data stream come to an end You can also see that both A_Topic and B_Topic are more discriminating in their choice of topics to replay explicitly naming the topics and types of interest Separating the two topics allows them to be controlled individually 3 Now we ll see how to control Replay remotely using a program called rtireplaysh the Replay shell a Open a command prompt and change to the lt install dir gt scripts directory b Start Replay Shell using the same domain ID that you used for the remoteAdminis t
25. rationDomainId argument in the previous step gt rtireplaysh domainId lt other_domain_id gt You will see this prompt Replay Shell gt c Enter help to see what commands are supported Replay Shell commands use this format lt command gt lt replay_service gt lt entity gt value where e lt command gt is one of the supported commands e lt replay_service gt is the name given to the Replay service by one of the following in descending order of precedence e Value specified with the appName command line option used when start ing Replay highest precedence e Value for the lt replay service gt lt administration gt lt name gt element e Value for the lt replay_service gt name attribute lowest precedence e lt entity gt is any one of the service entities expressed in this hierarchical form lt database name gt lt session name gt lt topic name gt e value depends on the command Not all commands require a value Note In this release not all commands are supported for all entity levels Please see the Recording Service Release Notes for details on which modes are currently supported 1 On Windows systems from the Start menu select Accessories Command Prompt 4 9 Managing the Record Tool Remotely 4 6 The database name must match a name from a lt replay_database gt tag in the configu ration file that you specified when starting Replay such as lt replay database name
26. rver 2008 systems You must have administrator privileges to install Recording Service On all other Windows systems Administrator privileges are not required to install Recording Service but you do need write permission to the installation directory Note that non adminis trator users do not have write permission to Program Files on Windows Vista and Windows 7 systems Note for 64 bit platforms If you are installing Recording Service on an Ubuntu 64 bit platform or a Red Hat Enterprise Linux 5 or 6 64 bit platform you will also need to install a set of 32 bit libraries before installing Recording Service J On Red Hat Enterprise Linux 5 and 6 64 bit platforms run this command you will need root permission yum install glibc i686 1ibX11 1686 gtk2 i686 libXtst i686 L On Ubuntu 64 bit platforms run this command you will need root permission apt get install libc6 ia32 libs multiarch Note When selecting an installation directory do not choose one with square brackets in the path To install Recording Service simply run the installation file that you downloaded and follow the on screen instructions After installation you will end up with the following directory structure under your chosen installation location LL bin lt architecture gt Executables for lt architecture gt includes rtirecconv rtirecord rtirecsh rtireplay rtireplaysh and sqlite3 You can have several architectures installed L consol
27. s entire Topics or specific Topic fields based on POSIX file name matching expressions I Records all data types except bit fields LJ Records to multiple files with configurable file size limits Optionally overwrites the old est file when the maximum number of files has been reached I Records the DDS SampleInfo structure and a timestamp for both discovery data and user data I Records using either Best Effort or Reliable communications m Optionally records data from only specified partitions L Supports remote operation Replay Features l Publishes data samples that were recorded in serialized format L Highly configurable you can e Choose which serialized topics to replay e Set the replay rate faster or slower or use the original rate 1 1 Change the QoS of the publications Configure the QoS for the tool itself Dynamically control the replay start stop pause and single step through the data samples 1 2 Chapter 2 Installation 2 1 RTI Recording Service is included with RTI Connext Messaging Use the installation instructions in this chapter only if you are installing Recording Service independently not part of Connext Mes saging This chapter describes how to download and install Recording Service L Downloading Recording Service Section 2 1 I Installing Recording Service Section 2 2 I Installing the License File Section 2 3 Downloading Recording Service Before you can install
28. s follow this format TopicName RecordGroupName DomainName A RecordGroup is a way to specify what topics to record from what domains This con cept is explained in the Recording Service User s Manual In this example the RecordGroup is called RecordAll The Record tool also creates two tables for internal use RTILog and RTIVersion SQLite provides a number of builtin commands Start with help sqlite gt help It is useful to turn column headings on sqlite gt headers on Query the tables using standard SQL syntax Note that using limit x syntax at the end of each select statement will limit the number of records displayed Without a limit you will likely see too many records scrolling off your display Here are some examples To list 3 records of data on Topic Circle sqlite gt select from CircleSRecordAll domainoO limit 3 To get the largest x coordinate value for a Circle sqlite gt select max x from Circle RecordAll domain0O To get 10 samples from the table in descending order by the column named SampleInfo_reception_timestamp 1 For some platforms such as Ubuntu and SUSE you will not find a folder for your specific architecture You can run sqlite3 from any lt architecture gt folder 4 5 Using Replay 4 5 4 5 1 4 5 2 sqlite gt select from CircleSRecordAll domainO order by SampleInfo reception_timestamp desc limit 10 To find the number of samples recorded sqlite gt s
29. shape s color x and y coordinates a fillKind solid empty horizontal or vertical stripes and an angle 4 1 Setting Up Shapes Demo To Begin the Tutorial 1 Start two copies of Shapes Demo 2 3 e On Linux systems Enter the following command gt lt Shapes Demo install directory gt scripts rtishapesdemo e On Windows systems If you have RTI Launcher you can use its Utilities tab to start Shapes Demo Or from the Windows Start menu navigate to RTI Shapes Demo lt version gt and select RTI Shapes Demo Depending on your security settings you may see a Windows Security Alert dialog simply click Allow Access No configuration changes are necessary If you choose to use a different domain ID make sure to use the same value in both instances of Shapes Demo as well as in the Console s Configuration panels Repeat so you are running two instances of Shapes Demo We ll refer to the first Demo window as the Publisher Demo and the second as the Sub scriber Demo In the Publisher Demo create 2 squares and a circle all with default QoS settings a Under Publish select Square b In the Create New Publisher dialog select RED and click OK We ll use the defaults for the other settings You should see a red square moving in the display area c Use the same process to create a green square and a yellow circle You ve just created 3 Writers 2 Squares 1 Circle In the Subscriber Demo subscri
30. simple config gt Similarly if you specify a session name it must match a name from a lt session gt tag within the specified database such as lt session name A Session gt If you specify a topic name it must match a name from a lt replay_topic gt tag within the specified session such as lt replay_ topic name All_ Topic 4 While topics are being replayed you can pause or stop the replay For example to pause the replay use this command Replay Shell pause example simple config A Session Note The Replay Shell has no line editing capabilities so take extra care when entering commands 5 Once paused you can resume or step like this Replay Shell gt step example simple config A Session Replay Shell gt resume example simple config A Session 6 Itis also possible to control individual topics Replay Shell pause example simple config A_ Session A Topic Replay Shell step example simple config A Session A Topic Replay Shell gt resume example simple _config A Session A Topic Replay Shell gt rate example simple config A Session A Topic 1 Replay Shell rate example simple config A Session B Topic 1 Managing the Record Tool Remotely The Record tool can be managed remotely using one of two ways I RTI Record Shell l Another Connext application using special message types See Chapter 7 in the Recording Service User s Manual for details This section contains examples of how to use the Record She
31. ssseessssssesssssessseseseeees 2 1 2 2 Installing Recording Services sccctics dees racks sear tectetvarsevessustestveeus oes a a cso as arsa os as seosghi 2 2 2 3 Installing the License File tc tsreiecssageiissnetis beth aae a a cas dd taye 2 3 Tutorial RTI Recording Console 3 1 3 2 3 3 Setting Up Shapes Deos tsss iiiseil svi ita tisha iaeo eapi ain 3 1 Recording Data wesrecetterecectstosincetudies aeea Eea i a E Aaaa EEEE aa eE o eana Er AR F kea ain a 3 2 Replaying Data seisean naa E AA cite ee E E ean ais E NE E N 3 4 Tutorial Record and Replay Tools 4 1 4 2 4 3 4 4 4 5 4 6 Setting Up Shapes Demo sreap e a a a a ire 4 1 Configuring the Record TOO isisi nisaties nnes e an E ai es 4 3 Running the Record Toolin reae er aes paa TA Ee Eae oh HS eana as e Eai 4 4 Viewing the Recorded Data with SQLite sssssssssssissesssesiesissesssestesississsnsiestestessentesieseessesses 4 5 Using Replay sessions si r Gan a a o aes i aaae E pent NEA 4 6 45 1 Recording Data forReplay acinis ppsspp pn a a E s 4 6 452 Changing Replay s Configuration File ireesesseseesersessreeseeshasesseasssesssssassassssss 4 6 453 Replaying Data atNormalSpeed iieerereeseessresresessessassseessassasseshssessessssssssssse 4 8 454 Replaying Data at a Faster Rate and Using Remote Control uu 4 8 Managing the Record Tool Remotely cccccesesseesesssssesesssssssssessseessesesessseseseseesssesesees 4 10 461 Connecting to th
32. t lt domain name domainl state RUNNING gt lt domain_id gt 1 lt domain_id gt lt domain gt lt topic_group name Square state RUNNING ref count 1 gt lt topics gt lt topic_expr gt Square lt topic_expr gt lt exemption gt lt exemption gt lt topics gt lt field_expr gt lt field_expr gt lt topic_group gt lt topic_group name Triangle state RUNNING ref count 1 gt lt topics gt lt topic_expr gt Triangle lt topic_expr gt lt exemption gt lt exemption gt lt topics gt lt field_expr gt lt field_expr gt lt topic_group gt lt record group name SquareTriangle state RUNNING ref _count 1 gt lt domain_ref gt lt element gt domain0 lt element gt lt domain_ref gt lt topic_ref gt lt element gt Square lt element gt lt element gt Triangle lt element gt lt topic_ref gt lt record_group gt lt model gt lt recorder gt 6 In the shell enter the following command all on one line add lt dds gt lt recorder gt lt topic_group name Circle gt lt topics gt lt topic_expr gt Circle lt topic_expr gt lt topics gt lt field_expr gt lt field_expr gt lt topic_group gt lt recorder gt lt dds gt The new model lt recorder gt lt model name configuration gt lt domain name domain0 state RUNNING gt lt domain_id gt 0 lt domain_id gt lt domain gt lt domain name domainl state RUNNING gt lt domain_id gt 1 lt domain_id gt lt doma
33. t lt element gt Circle lt element gt lt topic_ ref gt lt record_group gt lt recorder gt lt dds gt New model lt recorder gt lt model name configuration gt lt domain name domain0O state RUNNING gt lt domain_id gt 0 lt domain_id gt lt domain gt lt domain name domainl state RUNNING gt lt domain_id gt 1 lt domain_id gt lt domain gt lt topic group name Circle state RUNNING ref count 1 gt lt topics gt lt topic_expr gt Circle lt topic_expr gt lt exemption gt lt exemption gt lt topics gt lt field_expr gt lt field_expr gt lt topic_group gt lt topic_group name Square state RUNNING ref count 1 gt lt topics gt lt topic_expr gt Square lt topic_expr gt lt exemption gt lt exemption gt lt topics gt lt field_expr gt lt field_expr gt lt topic_group gt lt topic_ group name Triangle state RUNNING ref_count 1 gt lt topics gt lt topic_expr gt Triangle lt topic_expr gt lt exemption gt lt exemption gt lt topics gt lt field_expr gt lt field_expr gt 4 13 Managing the Record Tool Remotely lt topic_group gt lt record_ group name Circle state RUNNING ref count 1 gt lt domain_ref gt lt element gt domain0 lt element gt lt domain_ref gt lt topic_ref gt lt element gt Circle lt element gt lt topic_ref gt lt record_group gt lt record group name SquareTriangle state RUNNING ref count 1 gt lt do
34. ving the same way We will look for this pattern of movement again later in the next section of the tutorial 6 Press the Console s Stop button E 7 You can close the Publishing Demo Keep the Console and Subscribing Demo running you will use them in the next section 8 Notice that the shapes in the Subscribing Demo still appear but they are no longer mov ing That s because this copy of Shapes Demo is no longer receiving data Replaying Data In this section we will replay data that was recorded from Shapes Demo in Section 3 2 This example will replay the recorded data with the same QoS settings as when the data was recorded You should still be running Recording Console and the Subscribing Demo from Section 3 2 9 In the Console press the Open Folder button __ in the upper right corner locate the file whose data is to be replayed then click Open This will be the same file you recorded in Section 3 2 If you skipped that part of the tutorial you can use the example file in lt installation directory gt example replay Another way to open a recording file is simply to drag the file from your file browser and drop it into the long black rectangle at the top of the Console 3 4 Replaying Data 10 Press Play I to begin replaying the data 11 12 13 14 In the Subscribing Demo you will see the objects moving exactly the same as when they were recorded including when you moved the red sguare aroun
35. y where you installed Connext Messaging If you choose to save the license file elsewhere you can configure Launcher to look in a different location by using its Configuration tab Otherwise Save the license file in any location of your choice When the Record tool starts it will look in these locations until it finds a valid license 1 The file specified with the licenseFile option when you start the Record tool from the command line 2 The file specified in the environment variable RTI_LICENSE_FILE which you may set to point to the full path of the license file including the filename for example C RTI my_rti_license dat 3 The file rti_license dat in the current working directory 4 The file rti_license dat in the directory specified by the environment variable NDDSHOME If you have any questions about license installation please contact support rti com 1 Launcher is a convenient GUI based tool that can start and configure all of your Connext Messaging components including Recording Service 2 3 Chapter 3 Tutorial RTI Recording Console 3 1 The best way to learn about RTI Recording Console is to start using it This chapter will walk you through the steps to use the Console to record and replay data from Shapes Demo The tutorial assumes you have the following software installed using the same version number for both components LI Recording Service I Shapes Demo The tutorial walks you through the
Download Pdf Manuals
Related Search