Getting Started - Community RTI Connext Users
Contents
1. 2 7 Chapter 3 Tutorial Record and Replay Tools While the previous chapter s tutorial focused on recording and replaying data from the Record ing Console this 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 DDS application Then we will record data sent between two instances of Shapes Demo Next we will replay the data Finally we will learn how to manage the Record tool remotely Important LI Review Paths Mentioned in Documentation Section 1 1 J To see the database tables use a SQLite viewer tool of your choice such as SQLIte Studio or SQLiteMan LJ To understand the contents of each database record you will need to consult the RTI Con next DDS Core Libraries C API Reference HTML documentation 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 I Setting Up Shapes Demo Section 3 1 L Configuring the Record Tool Section 3 2 J Running the Record Tool Section 3 3 l Viewing the Recorded Data with SQLite Section 3 4 I Using Replay Section 3 5 Ll Managing the Record Tool Remotely Section 3 6 3 1 Setting Up Shapes Demo 3 1 Setting Up Shapes Demo We ll use Shapes Demo to publish and subscribe to Topics whi2. Reconfigure the Record tool with a file that is local to the Record Shell tool enter this on one line and replace lt path to examples gt as described in Paths Mentioned in Documen tation Section 1 1 configure advanced example localfile lt path to examples gt recording service record advanced_conf ig 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 3 10
3. to set properties that control what to record how to record and where to save the recorded data The path to examples gt recording_service record directory contains these example files L simple_config xml L advanced_config xml L remote_shell xml Let s start learning about the Record tool with the simple configuration 1 2 Copy lt path to examples gt recording_service record simple_config xml to lt path to examples gt recording_service record mysimple_rerecord_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 3 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 1 See Paths Mentioned in Documentation Section 1 1 3 3 Running the Record Tool Change the bold lt domain name domain0 gt line to use the domain id gt 3 lt domain_id gt same domain lt deserialize _mode gt ID as Shapes RTIDDS DESERIALIZEMODE ALWAYS Demo i eam E lt deserialize_mode gt lt domain gt b If your computer does not have an active network interface use the followi
4. viewer when you are done Using Replay In this section you will learn about LI Recording Data for Replay Section 3 5 1 L Changing Replay s Configuration File Section 3 5 2 Replaying Data at Normal Speed Section 3 5 3 I Replaying Data at a Faster Rate and Using Remote Control Section 3 5 4 Recording Data for Replay To get started with Replay you can either a use the example database provided in lt path to examples gt recording_service replay replay_database dat_0_0 or b configure and run Record using the steps in Section 3 2 and Section 3 3 with the replay_example configuration instead of 3 5 Using Replay 3 5 2 example Enter this all on one line and replace lt path to examples gt as described in Paths Men tioned in Documentation Section 1 1 rtirecord cfgFile lt path to examples gt recording service record 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 Replay is unable to replay partial data Changing Replay s Configuration File Replay requires an XML configuration fi
5. your domain IDs By default the example configuration files use domain IDs 0 and 1 Connecting to the Record Tool using Shared Memory 1 2 10 11 12 13 14 15 Change to this directory lt NDDSHOME gt bin Start the Record tool Enter this all on one line and replace lt path to examples gt as described in Paths Mentioned in Documentation Section 1 1 rtirecord cfgFile lt path to examples gt recording service record advanced_config xml cfgName remote_example In another shell change to lt NDDSHOME gt bin and start the Record Shell cd lt NDDSHOME gt bin 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 enter this on one line and replace lt path to examples gt as described in Paths Mentioned in Documentation Section 1 1 configure advanced_example remotefile path to examples gt recording service 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
6. I Records all data types except bit fields 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 I Optionally records data from only specified partitions L Supports remote operation Replay Features I 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 e Change the QoS of the publications e Configure the QoS for the tool itself 1 1 Paths Mentioned in Documentation e Dynamically control the replay start stop pause and single step through the data samples 1 1 Paths Mentioned in Documentation The documentation refers to L lt NDDSHOME gt This refers to the installation directory for Connext DDS The default installation paths are e Mac OS X systems Applications rti_connext_dds version e UNIX based systems non root user home your user name rti_connext_dds version e UNIX based systems root user opt rti_connext_dds version e Windows systems user without Administrator privileges lt your home directory gt rti_connext_dds version e Windows systems user with Administrator privileges C Program Files
7. RTI Recording Service Getting Started Guide Version 5 2 0 a f Your systems Working as one 2007 2015 Real Time Innovations Inc All rights reserved Printed in U S A First printing June 2015 Trademarks Real Time Innovations RTI NDDS RTI Data Distribution Service DataBus Connext Micro DDS the RTI logo 1RTI and the phrase Your Systems Working as one are registered trademarks trademarks or service marks of Real Time Innovations Inc All other trademarks belong to 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 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 1 Welcome to RTI Recording Servi
8. Windows systems from the Start menu select Accessories Command Prompt 3 8 Managing the Record Tool Remotely 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 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 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 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 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 gt 4 While topics are being repl
9. and prompt and change to the lt NDDSHOME gt bin directory Start Replay with your new configuration file from Section 3 5 2 Enter this all on one line and replace lt path to examples gt as described in Paths Mentioned in Documentation Section 1 1 rtireplay cfgFile lt path to examples gt recording service replay 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 separate 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 or
10. 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 2 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 2 2 2 4 Replaving Data 1 Inthe 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 2 2 If you skipped that part of the tutorial you can use the example file in path to examples gt recording_service 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 2 Press Play IS to begin replaying the data 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 around in a pattern amp RTI Recording Console l gt E x 3 U Y Slider a controls replay speed 04 15 2015 04 15 2015 i a i alia o Press Stop E 4 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
11. ayed 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 Repl Repl 6 Itis Repl Repl Repl Repl Repl Lay Lay S S hell gt step example simple_config A Session hell gt resume example simple_config A_Session also possible to control individual topics ay ay ay ay ay Shell hell hell hell S S S S hell VVVV Vv pause example simple config A Session A Topic step example simple config A Session A Topic resum xample simple config A Session A Topic rate example simple config A Session A Topic 1 rate example simple config A Session B Topic 1 3 6 Managing the Record Tool Remotely The Record tool can be managed remotely using one of two ways LI RTI Record Shell LJ Another Connext DDS application using special message types 3 9 Managing the Record Tool Remotely 3 6 1 See Chapter 7 in the Recording Service User s Manual for details This section contains examples of how to use the Record Shell commands The configuration files used in the examples are in lt path to examples gt recording_service Note If you are using different domain IDs for running the Record tool you must edit the con figuration files to use
12. ce 1 1 1 2 Paths Mentioned in Documentation ccccccccccccssssccescssscescesessssescscsscessscsesssscecesssssesecessuecesseass 1 2 Recording Service Installation Components cccccscscesesceceeseseseeneneeseeeeeseseeseneneseseaneneees 1 3 2 Tutorial RTI Recording Console 2 1 22 2 3 Setting Up Shapes Demo sraoin Seach iiien Hentetdasianaveb esta eatederdipsnvandeespsnvensesioterstrs 2 1 Recording Data ssisssncvctissientecctsthneeesteshswtasdish clattistssbentadieskertusi aliai paas vas Enn a 2 3 Replaying Da t p nise aoe aaas ie iene in raaa ei AAE RE a A EE 2 4 3 Tutorial Record and Replay Tools 3 1 3 2 3 3 3 4 3 5 3 6 Setting Up Shapes Demo sissies rie ei e aia E AE Ea avetedy S E 3 2 Configuring the Record Tol isini sieht stared aa aE sech AE ashabsreigashoi 3 3 Running the Record Tool sizc tesvesaviees oveven an aani ES E EE R E E i 3 4 Viewing the Recorded Data with SQLite ssssesssssssissessssssesisstsssestestestsssesiestesresnestesiesreseesses 3 5 Using Replay tncs acisiesch cine aeien E e aean aa aeaa aiaa i A des dbeaatinocinssieneaas neta 3 5 3 5 1 Recording Data for Repl y ereserkia e aa 3 5 3 5 2 Changing Replay s Configuration File ieireeeseresesessesessrhssessessssssessessassssssssse 3 6 3 5 3 Replaying Data at Normal Speed se ssssssssississrsseessestestessnsnestessesresnesnsnsiesesnennennees 3 7 354 Replaying Data at a Faster Rate and Using Remote Co
13. ch 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 2 3 Start two copies of Shapes Demo e From RTI Launcher select the Tools tab and click the Shapes Demo icon or e From a command prompt enter replacing lt NDDSHOME gt to match your sys tem e On Linux and Mac OS X systems lt NDDSHOME gt bin rtishapesdemo e On Windows systems lt NDDSHOME gt bin rtishapesdemo bat 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 To start a second instance In Shapes Demo select File New Shapes Demo Now you should be running two instances of Shapes Demo We ll refer to the first Demo window as the Publisher Demo and the second as the Subscriber 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 proces
14. e Installation Components Recording Service is installed automatically when you install one of Connext DDS packages Pro fessional Evaluation or Basic After installation you will end up with the following directory structure where lt NDDSHOMES gt is where you installed the Connext DDS package see Paths Mentioned in Doc umentation Section 1 1 LJ lt NDDSHOME gt e bin Executable scripts for the applications includes rtirecconv rtirecord rtirecsh rtire play rtireplaysh and rtirecordingconsole e doc manuals recording service Documentation for Recording Service in PDF format e resource app bin lt architecture gt Binary executable files for the applications rtirecconv rtirecord rtirecsh rtireplay rtireplaysh and RTI recording console These files are architecture dependent they are used by the scripts in the bin directory and provide the necessary environment settings There is no need to use them directly e resource idl IDL files describing Recorder and Replay s remote administration interfaces e resource schema Recorder and Replay s XSD and DTD files for XML validation and configuration help e resource xml Recorder and Replay default XML configuration files RTI_LRECORDING_SERVICE xml and RTI_REPLAY_SERVICE xml These files are picked up by Recorder and Replay automatically so there is no need to specify them when using the configurations inside e resource app app_support recording_serv
15. ice lt architecture gt This directory contains necessary configuration files and information for Recording Console As described in Paths Mentioned in Documentation Section 1 1 examples are copied into your home directory the first time you run RTI Launcher or any script in lt NDDSHOMED gt bin For Recording Service the relevant files are here L path to examples e recording_service record 1 3 Recording Service Installation Components Example files and configurations for Recorder e recording_service replay Example files and configurations for Replay e user_config recording service This directory contains user modifiable files with configurations for Recorder and Replay USER_RECORDING_SERVICE xml and USER_REPLAY_SERVICE xml These files are picked up by Recorder and Replay automatically when they are present in the working directory For example Launcher always sets the working directory to this folder so that the files are detected automatically when running Recorder or Replay 1 4 Chapter 2 Tutorial RTI Recording Console 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 following exerc
16. iginal 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 On Windows systems from the Start menu select Accessories Command Prompt 2 See Paths Mentioned in Documentation Section 1 1 3 7 Using Replay 1 Open a command prompt and change to the lt NDDSHOME gt bin directory 2 Start Replay in the same manner described in Section 3 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 3 5 2 For example enter this all on one line and replace lt path to examples gt as described in Paths Mentioned in Documentation Section 1 1 rtireplay cfgFile path to examples gt recording service replay mysimple replay _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 co
17. ises I Setting Up Shapes Demo Section 2 1 I Recording Data Section 2 2 L Replaying Data Section 2 3 Important LI Review Paths Mentioned in Documentation Section 1 1 2 1 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 There are two ways to start Shapes Demo e From RTI Launcher select the Tools tab and click the Shapes Demo icon or e From a command prompt enter replacing lt NDDSHOME gt to match your sys tem e On Linux and Mac OS X systems lt NDDSHOME gt bin rtishapesdemo e On Windows systems lt NDDSHOME gt bin rtishapesdemo bat 1 See Paths Mentioned in Documentation Section 1 1 2 1 Setting Up 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 scribe
18. ite 3 4 3 5 3 5 1 3 4 Wait about one minute to give the Record tool time to record data from Shapes Demo Stop the Record tool by pressing lt Control C gt Leave the command prompt window open you will use it in Section 3 4 Viewing the Recorded Data with SQLite 1 After running and stopping the Record tool as described in Section 3 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 With a SQLite viewer of your choice open simple_config dat_0_0 Look at the list of the recorded 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 SRecordAll domain0 e Square RecordAll domainO Topic table names 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 Open one of the recorded tables that contains user data such as Cir cle RecordAll domainO The Record tool records each field of the data type in its own column alongside some metadata fields Close the SQLite
19. le We will use the example file simple_config xml pro vided in path to examples gt recording_service replay Note that this is not the same file that you changed in Section 3 5 1 that was Record s simple_config xml now we are using Replay s simple_config xml 1 Copy path to examples gt recording_service replay simple_config xml to lt path to examples gt recording_service replay mysimple_replay_config xml 2 The simple_config xml configuration file assumes that the database containing serial ized samples is named replay_database dat_0_0 this file is in lt path to examples gt recording _service replay if you want to replay this example database 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 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 3 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 admi
20. nfigured 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 NDDSHOME gt bin directory b Start Replay Shell using the same domain ID that you used for the remoteAdminis trationDomainId 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 command is one of the supported commands 1 On
21. ng lines in the domain properties section lt domain name domain0 gt lt domain_id gt 0 lt domain_id gt lt participant_qos gt Turn off lt discovery gt multicast gt lt multicast_receive_addresses gt lt discovery gt Only use shared lt transport builtins memory gt lt mask gt SHMEM lt mask gt lt transport_builtin gt lt participant_qos gt lt domain gt 33 Running the Record Tool 1 Open a command prompt and change to the lt NDDSHOME gt bin directory 2 Start the Record tool with your new configuration file from Section 3 2 For example enter this all on one line and replace lt path to examples gt as described in Paths Men tioned in Documentation Section 1 1 rtirecord cfgFile path to examples gt recording service record 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 adminis trator 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 1 On Windows systems from the Start menu select Accessories Command Prompt 2 See Paths Mentioned in Documentation Section 1 1 3 4 Viewing the Recorded Data with SQL
22. nistration 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 1 See Paths Mentioned in Documentation Section 1 1 3 6 Using Replay 3 5 3 3 5 4 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 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 3 2 and create subscribers for Squares and Circles Open a comm
23. ntrol uu ees 3 7 Managing the Record Tool Remotely ccccessesesesssssssesssesesssssesesesssesesesesessesesssessesesesees 3 9 361 Connecting to the Record Tool using Shared Memory ieeeesereserssessersseaseess 3 10 iii Chapter 1 Welcome to RTI Recording Service RTI Recording Service includes these components L Record an RTI Connext DDS application that records both Connext DDS discovery and topic data All recorded data is stored in one or more SQL database files LI Replay a tool that can play back the recorded data You even have the option of replay ing the data with different data rates or QoS settings I Recording Console a simple graphical user interface GUI for using the Record and Replay tools This interface significantly reduces Recording Service configuration time and complexity 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 L Convert a utility that enables serialized or deserialized data recorded with Record to be exported to CSV HTML SQL or XML formats Recording Features I Records data from applications in multiple domains I Records entire Topics or specific Topic fields based on POSIX file name matching expressions
24. r 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 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 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 I File View Publish Subscribe Controls Help Loe Pause Publishing istor 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 2 2 Recording Data 2 2 Recording Data 1 Start Recording Console There are two ways to start Recording Console e From RTI Launcher select the Tools tab and click the Recording Console icon or e From a command prompt enter replacing lt NDDSHOME gt
25. rti_connext_dds version You may also see NDDSHOME or NDDSHOME which refers to an environment variable set to the installation path Wherever you see lt NDDSHOME gt used in a path replace it with your installation path Note for Windows Users When using a command prompt to enter a command that includes the path C Program Files or any directory name that has a space enclose the path in quotation marks For example C Program Files rti_connext_dds version bin rtiddsgen or if you have defined the NDDSHOME environment variable SNDDSHOMES bin rtiddsgen _ path to examples Examples are copied into your home directory the first time you run RTI Launcher or any script in lt NDDSHOME gt bin This document refers to the location of these examples as lt path to examples gt Wherever you see lt path to examples gt replace it with the appropriate path By default the examples are copied here e Mac OS X systems Users your user name rti_workspace version examples e UNIX based systems home your user name rti_workspace version examples 1 2 Recording Service Installation Components 1 2 e Windows systems lt your home directory gt rti_workspace version examples You can specify a different location for the rti_workspace directory You can also specify that you do not want the examples copied to the workspace See the RTI Connext DDS Core Libraries Getting Started Guide Recording Servic
26. s to create a green square and a yellow circle You ve just created 3 Writers 2 Squares 1 Circle 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 1 See Paths Mentioned in Documentation Section 1 1 3 2 Configuring the Record Tool 3 2 Your two Shapes Demo windows should look like this filer Spe Dore Semen Domain 0 o Akg RTI Shapes Demo Domain 0 Ee xX File Viev h Sub Controls Help File View Publish Subscribe Controls Help Publish Publish Square Square iL Circle Circle Triangle Tnangle a Subscribe Subscribe o Circle Circle Triangl Triangl Controls Controls Delete All Delete All Pause Publishing Pause Publishing Hide History Hide History Configuration Configuration v 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
27. 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 in to open the Playback Configuration panels and check Auto repeat be ore scheduling the activity Configured without a file v Specify a domain for playback Specify playback speed Auto repeat Auto repeat 2 6 Replaving Data 14 Press the Topics Table button This will show you the Topic names and first and last samples for each Topic Topic First recorded sample Last recorded sample Triangle 01 06 50 PM CEST Sun Apr 19 2015 01 07 27 PM CEST Sun Apr 19 2015 Square 01 06 50 PM CEST Sun Apr 19 2015 01 07 27 PM CEST Sun Apr 19 2015 Circle 01 06 50 PM CEST Sun Apr 19 2015 01 07 27 PM CEST Sun Apr 19 2015 Select All Clear Selections Enter Search String 15 Press Clear Selections and then Play IS Since no topics are selected no data will be replayed 16 Enter Cir in the search field at the bottom Now only Circle topics appear in the table Check the box next to the Circle 17 Press Play IS 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 3 Tutorial Record and Replay Tools Or for more information see the Recording Service User s Manual
28. to see the rate change in the Subscribing Demo To quickly return to the original speed press Play Dl 5 Press Stop m 6 Replay just a section in the middle of the data Drag the vertical bars on the progress bar inward to shorten the replay time gs RTI Recording Console gt a x rtj 04 19 2015 010658 PM El 04 15 2015 010715 PM A Drag these bars inward to restrict the time range for replaying data 1 See Paths Mentioned in Documentation Section 1 1 2 5 Replaving Data 7 10 11 12 13 Press Play Is to begin replaying the just the middle section of the data beginning where you put the left bar and ending where you put the right bar gs RTI Recording Console Eel x ct a 04 19 2015 04 19 2015 COS BE A aile 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 after that Check the Ends at box Activity Schedule 4 April 2015 April 2015 Sun Mon Tue Wed Thu i Sun Mon Tue Wed Thu 29 30 5 6 12 13 19 Watch the Subscriber Demo and or the Console s display area to confirm that the data is replayed at the
29. to match your sys tem e On Linux and Mac OS X systems lt NDDSHOME gt bin rtirecordingconsole e On Windows systems lt NDDSHOME gt bin rtirecordingconsole bat 2 Wait a few seconds for the Console to launch 3 Create a new file in which to record data from Shapes Demo e Press the New Recording button D and specify a file name and location Then click on Create File 1 See Paths Mentioned in Documentation Section 1 1 2 3 Replaving Data 2 3 4 Press the Record button fe to start recording On Windows systems depending on your security settings you may see a Windows Security Alert dialog if so simply click Allow Access 5 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 Troubleshooting Recording Problems Section 2 4 2 6 Inthe 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 moving the same way We will look for this pattern of movement again later in the next section of the tutorial 7 Press the Console s Stop button E 8 You can close the Publishing Demo Keep the Console and Subscribing Demo running you will use them in the next section 9 Notice that the shapes in the Subscribing Demo still appear but they
Download Pdf Manuals
Related Search