Chapter 3 Starting RTI Analyzer
Contents
1. 4 6 4 2 Configuring RTI Analyzer from the GUI Figure 4 6 Properties Tab The Properties tab allows you to add Prop erties to the DomainPar ticipant s Property QoS policy The properties 2 52cmains have a wide range of C onnee mihe RT Anaya uses from configuring en transports to being prop agated with the RTI Data DDS Domain Configuration Configure DDS Domains For each domain configure peer locators discovery settings transport and other properties Peer Locators Transport Properties Resource Limits Wire Protocol Properties A i 5 Set properties to be included in the PropertyQosPolicy in DomainParticipantQos No Distribution Service dis other validation is done except to ensure that both the property name and value are set covery information Please see the RTI Data Distribution Service User s Manual for more infor mation on properties Property Name Property Value Propagate Add Property Delete Property Chapter 4 4 8 Chapter 5 Tutorial The best way to learn about RTI Analyzer is to start using it The goal of the tutorial is to help you become familiar with RTI Analyzer s main features We will use RTI Shapes Demo as an easy way to start a DDS publish subscribe application then we will use RTI Analyzer to analyze the application s DDS entities We ll create a communications prob lem on purpose then walk2. 0 mismatch 1 match 0 potential mismatch Writer HostId 192 168 2 3 Appld 7884 Instanceld 1 Entityld 65538 Status Active 1 Re d Reader HostId 192 168 2 3 AppId 5700 Instanceld 1 Entityld 3079 Status Active 9 Topic Triangle 1 Reader 1 Writer 0 mismatch 1 match 0 potential mismatch Writer HostId 192 168 2 3 Appld 7884 Instanceld 1 Entityld 73730 Status Active 1 Re f Reader HostlId 192 168 2 3 Appld 5700 Instanceld 1 Entityld 3335 Status Active Congratulations you have diagnosed and corrected the communications problem Saving and Comparing Snapshots In this section we ll look at RTI Analyzer s Snapshots Comparison feature A snapshot saves the DDS object information about an attached application You can compare one saved snapshot to the current live data or compare two saved snapshots to each other This feature can help you understand why one configuration behaves dif ferently from another 1 Recall that we took a snapshot of our original configuration just before we cor rected the QoS of the Reader for Circles in Step 6 on page 5 21 Select the Snapshots Comparison view 3 Under Snapshot 1 select the checkbox fore Live Data For Snapshot 2 use the two Browse buttons to select your snapshot file 5 23 JOON G Chapter 5 5 Ensure that the two checkboxes under Options are selected System being ana lyzed and Exclude disposed entities 6 Click the
3. 0 potential mismatch Topic Circle 1 Reader 1 Writer 1 mismatch 0 match 0 potential mismatch Writer Hostld 192 168 2 3 Appld 7884 Instanceld 1 Entityld 65538 Status Active 1 GS Reader Hostld 192 168 2 3 Appld 5700 Instanceld 1 Entityld 2823 Status Active Topic Triangle 0 Reader 1 Writer 0 mismatch 0 match 0 potential mismatch Writer Hostld 192 168 2 3 Appld 7884 Instanceld 1 Entityld 73730 Status Active 0 Match Mismatch Potential Mismatch No Reader Writer for the same Topic 5 18 5 6 Filtering the Match Results Tree 5 6 2 Analyzing Selected Objects Only Let s perform a Match Analysis on just the Writer and Reader for the Topic Circle 1 In the Entity Tree right click the Reader for Topic Circle From the pop up menu select Add to Match List 2A amp e a HEl 4 Circle Type ShapeType 4 DomainiD 0 a Host 192 168 23 4 RTI Shapes Demo Hostld 192 168 2 3 Appld 7884 Instanceld 1 E1 4 amp Publisher Hostld 192 168 2 3 Appld 7884 Instanceld 1 Entityl Writer Circle ShapeType HostlId 192 168 2 3 Appld 7884 Ir 4 G RTI Shapes Demo Hostld 192 168 2 3 Appld 5700 Instanceld 1 E1 4 Subscriber Hostld 192 168 2 3 Appld 5700 Instanceld 1 Entity GS Reader Circlel cort By gt gt Square Type ShapeType Tree View Filter Tree Layouts gt Build Your Own Tree Expand Tree Collapse Tree Expand Node Collapse Node A
4. 19 Correcting the Circle s Liveliness QOS nasisa nka iaraa riannee eE a 5 22 Saving and Comparing Shapshots sssisssssssai irs asiten a e aa 5 23 Chapter 1 Introduction 1 1 Welcome to RTI Analyzer the debugging and analysis tool for RTI Data Distribution Service applications RTI Analyzer provides an easy way to see the topology of an RTI Data Distribution Service application and diagnose peer to peer communication problems Overview RTI Analyzer listens to the declarations meta traffic sent from RTI Data Distribution Service applications running in a specific domain It builds an internal database of the nodes applications topics and DDS objects This information is then displayed in one or more tree view windows each organized according to your specifications For exam ple you could have one window that lists the RTI Data Distribution Service objects DomainParticipants DataWriters DataReaders etc associated with each Topic in another window you could list the objects by host or domain If you have applications that are not fully communicating the Match Analysis feature can help you determine which objects DataWriters and DataReaders or Publishers and Subscribers are matched up and which ones are not If you have objects with incompat ible QoS settings this feature will point them out The RTI Data Distribution Service objects are shown in a familiar explorer style tree that organizes the applic
5. 2 4 Chapter 3 Starting RTI Analyzer 3 1 J You must use a new workspace with RTI Analyzer 1 4 Workspaces created with older versions of RTI Analyzer will not work L RTI Analyzer requires more memory as the size of data set it has to process increases RTI Analyzer is configured for 256 MB of memory by default which is sufficient for a total of 2 000 data readers and data writers For larger data sets make this change before starting RTI Analyzer In the file lt install dir gt apps RTI_Analyzer_1 4 x eclipse rdp ini change Xmx256m to Xmx512m or Xmx1024m depending on the total number of endpoints your system contains In the following we refer to RTI Analyzer 1 4 x x is place holder for a release specific number Windows Systems On a Windows Vista system 1 Modify the RTI Analyzer shortcut to run as Administrator a From the Start menu select All Programs RTI RTI Analyzer 1 4 x b Right click the RTI Analyzer shortcut and select Properties c In the Properties Shortcut tab select Advanced d Check the box Run as administrator e Click OK twice 3 1 1 z jouy La Buywys e Chapter 3 2 Make sure you have administrator privileges 3 From the Start menu select All Programs RTI RTI Analyzer 1 4 x RTI Ana lyzer On other Windows systems L From the Start menu select Programs RTI RTI Analyzer 1 4 x RTI Analyzer 3 2 Solaris and Linux Systems Enter the following com
6. 3 Appld 5700 Instanceld 1 Entityld 2823 Status Active Writer Hostid 192 168 2 3 Appld 7884 Instanceld 1 Entityld 65538 Status Active Match Status Mismatch QoS and Other Attributes Domain ID Deadline Reliability Latency budget Topic Type Durability Presentation access scope Presentation coherent access Presentation ordered access Ownership Liveliness duration Liveliness kind Destination order kind Partition Entity Kind Type Definition Writer 0 Infinite Reliable 0 sec Circle ShapeType Volatile Instance Scope false false Shared Infinite Manual by participant By Reception Timestamp with key Reader 0 Infinite Best Effort 0 sec Circle ShapeType Volatile Instance Scope false false Shared 0 sec 50 ms Manual by participant By Reception Timestamp with key Compatibility Compatible Compatible Compatible Compatible Compatible Compatible Compatible Compatible Compatible Compatible Compatible Liveliness duration QoS incompatible reader duratio Compatible Compatible Compatible Compatible Skipped The Compatibility column shows you which matching criteria are okay and which ones are not In this case the Liveliness QoS settings are not compatible Recall that we created this mismatch on purpose to demonstrate how RTI Ana lyzer helps you diagnose this type of problem In Section 5 7 we will correct th
7. Tree Filter Settings dialog clear the TopicName checkbox and enter Triangle as shown below Tree Filter Settings Select entities to show in the DDS Entity Tree View For each entity you can specify a value which may be regular text a wildcard expression with and or or a regular expression Filter Value Type Regular Text v Entity Host Topic Type Topic Name Triangle Domainld V Hide All Disposed Entities T Hide Container Entities with No Children x cne 4 Click OK to close the dialog Chapter 5 5 Select the Expand Tree button to see all the non triangle entities in the tree which should now look like this The filter button turns green when a filter is in use lt Typs WDA Sl ar iH isplays DDS entities in a tree layout 4 amp Circle Type ShapeType 4 amp DomainlD 0 4 Host 192 168 23 4 ga RTI Shapes Demo Hostld 192 168 2 3 Appld 7884 Instanceld 1 4 amp Publisher Hostid 192 168 2 3 Appld 7884 Instanceld 1 Entit Writer Circle ShapeType Hostld 192 168 2 3 Appld 7884 4 ga RTI Shapes Demo Hostld 192 168 2 3 Appld 5700 Instanceld 1 4 Subscriber Hostld 192 168 2 3 Appld 5700 Instanceld 1 Enti GS Reader Circle ShapeType Hostld 192 168 2 3 Appld 570 4 QD Square Type ShapeType 4 amp DomainlD 0 a Host 192 168 2 3 4 ga RTI Shapes Demo Hostld 192 168 2 3 Appld 7884 Instanceld 1 4 amp Publisher HostId 192 168 2 3 Appld 7884 Instancel
8. appears when there are custom tree layouts 5 Click the triangle on the right of the hee button and select your new layout from the drop down list 6 Select the Expand Tree button to see all the entities in the tree which should now look like this AP intityTree lt P Types BB B alon Displays DDS entities in a tree layout Application id 7884 Nriter Square ShapeType Hostld 192 168 2 3 Appld 7884 Instanceld 1 9 Square Type ShapeType Writer Triangle ShapeType Hostld 192 168 2 3 Appld 7884 Instanceld Q Triangle Type ShapeType 2 Nriter Square ShapeType Hostld 192 168 2 3 Appld 7884 Instanceld 1 Square Type ShapeType Writer Circle ShapeType Hostld 192 168 2 3 Appld 7884 Instanceld 1 9 Circle Type ShapeType 0 Application id 5700 f Reader Circle ShapeType HostId 192 168 2 3 App1d 5700 Instanceld 1 9 Circle Type ShapeType GS Reader Square ShapeType HostId 192 168 2 3 Appld 5700 Instanceld 9 Square Type ShapeType 5 3 2 Filtering Out Specific Entities The Filter button 9 allows you to control which domain IDs hosts and Topics appear in the tree In the Tree Filter Settings dialog you can enter text wildcard expressions or regular expressions to refine the filter 5 10 5 3 Working with the Entity Tree For example let s hide the Topic called Triangle for now 1 Select the Sort by Topic button B 2 Select the Filter button E 3 In the
9. deleted them and then added them back Lines 3 4 yellow Two Readers were added after the snapshot was taken Line 5 blue The original Reader for Circles has been deleted 5 24 5 8 Saving and Comparing Snapshots 8 Click the Snapshots tab to see a side by side comparison of the live data and snapshot entity trees Live Data Tue Oct 06 15 07 07 EDT 2009 Q DomainiD 0 Host 192 168 23 Participant Appld 5700 Subscriber Entityld 1289 6S Reader Circle ShapeType Entityld 3079 d Reader Square ShapeType Entityld 2567 6S Reader Triangle ShapeType Entityld 3335 Participant Appld 7884 amp Publisher Entityld 1032 Writer Circle ShapeType Entityld 65538 Writer Square ShapeType Entityld 32770 Writer Square ShapeType Entityld 40962 Writer Triangle ShapeType Entityld 73730 mySnapshotA xml Tue Oct 06 15 00 00 EDT 2009 Q DomainiD 0 Host 192 168 2 3 J Participant Appld 5700 Subscriber Entityld 1289 d Reader Circle ShapeType Entityld 2823 6S Reader Square ShapeType Entityld 2567 Q Participant Appld 7884 Publisher Entityld 1032 Writer Circle ShapeType Entityld 65538 Writer Square ShapeType Entityld 32770 Writer Square ShapeType Entityld 40962 Writer Triangle ShapeType Entityld 73730 This completes the RTI Analyzer tutorial You can gain further experience by analyzing the applications described in the RTI Data Distribut
10. through the steps to diagnose and correct it The RTI Shapes Demo runs on Windows and Linux systems If you are using a different operating system you can still read through this tutorial to get a sense of the features then you can experiment with the Hello World example described in the RTI Data Distri bution Service Getting Started Guide or the Stock Price and Stock News examples described in the RTI Data Distribution Service Tutorial This tutorial assumes you have a basic understanding of DDS terms such as DomainPar ticipants Publishers DataWriters Topics and Quality of Service QoS policies For an overview of DDS terms please see the RTI Data Distribution Service User s Manual The tutorial assumes you have the following software installed LI RTI Shapes Demo 2 x LI RTI Analyzer 1 4 x See Chapter 2 for installation instructions The tutorial walks you through the following exercises I Setting Up RTI Shapes Demo Section 5 1 J Connecting RTI Analyzer to RTI Shapes Demo Section 5 2 LI Working with the Entity Tree Section 5 3 LI Viewing Entity Details Section 5 4 E Debugging Object Communication Problems with Match Analysis Section 5 5 5 1 JOWON G Chapter 5 5 1 5 2 I Filtering the Match Results Tree Section 5 6 J Correcting the Circle s Liveliness QoS Section 5 7 LI Saving and Comparing Snapshots Section 5 8 Setting Up RTI Shapes Demo We ll use RTI Shapes Demo to publish an
11. Compare Snapshots button and select the Differences tab The Entity Counts tab will show that the current system live data has one more Reader than the snapshot Differences Snapshots Entity Counts Detailed Differences Entity Live Data mySnapshotA xnl Number of Hosts 1 1 Number of Applications 2 2 Number of Participants 2 2 Number of Publishers 1 1 Number of Subscribers 1 1 Number of Writers 4 4 Number of Readers 3 2 Number of Topics 3 3 Number of Types 1 1 7 Click the Detailed Differences subtab Differences Snapshots Entity Counts Detailed Differences Entity Live Data Tue Oct 06 15 07 07 EDT mySnapshotA xml Tue Oct 06 15 00 00 EDT Topic Triangle Topic Triangle Type ShapeType Topic Triangle Type ShapeType Subscriber Entityld 1289 Subscriber Hostid 192 168 2 3 Ap Subscriber HostiId 192 168 2 3 Appld 5700 Reader Triangle ShapeTyp Reader HostId 192 168 2 3 Appld Does not exist Reader Circle ShapeType Reader Hostld 192 168 2 3 Appld Does not exist Reader Circle ShapeType Does not exist Reader HostId 192 168 2 3 Appld 5700 Ins Here RTI Analyzer points out more details Keep in mind that we deleted a Circle in the subscriber then added a new Circle and a Triangle Lines 1 2 pink The Topic Triangle and its Subscriber exist in both the live data and the snapshot but something about them has changed Recall that we
12. NITE is not lt the requested lease_duration 50 ms a Writer Reader pair with incompatible QoS I We also created a Triangle on the publishing side but not on the subscribing side While this is not technically an error it is a situation that you may want to be aware of The Match Analysis view uses a tree view to show DDS objects with the following hier archy e Domain ID e Topic e Writer e Reader The results are color coded to make it easy to see L Matches green by default L Mismatches that is incompatible QoS pink by default I Potential Mismatches meaning RTI Analyzer does not have enough information to determine if there is a match or not yellow by default I Readers without Writers and vice versa light purple by default You can change the colors used for each category simply by clicking the colored boxes in the legend at the bottom of the tab 5 5 Debugging Object Communication Problems with Match Analysis Let s see how these two issues show up in RTI Analyzer s Match Analysis view 1 Select the Match Analysis tab 2 Click the Perform Match Analysis button If the button is disabled make sure that the Match Entities list box has All Writers and Readers selected 3 Click the Expand Tree button in the upper right corner This is not the same button in the Tree pane The Match Results tree should look like this W Entity Info E Summary Ly Mate sis 3 5 Snapshots C
13. RTI Analyzer RTI Data Distribution Service Debugging and Analysis Tool Getting Started Guide Version 1 4 RTD 2006 2010 Real Time Innovations Inc All rights reserved Printed in U S A First printing Fre TI June 2010 Trademarks Real Time Innovations and RTI are 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 per mission 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 385 Moffett Park Drive Sunnyvale CA 94089 Phone 408 990 7444 Email support rti com Website http www rti com support Contents 1 Introduction LI OV GEVIGW erenris eaei dr n E EEE iE EEEE EAE E A S a a ie i da 1 1 Installation 2 1 Installing RT Analy ZE ennea E AN E Ra 2 1 22 Tnstallins the License Files isseire tannet nieee ra e EERE EE 2 2 23 Uninstalling RIL Analy Zr inen a E ER 2 2 Starting RTI Analyzer Bile WINGOWS SY NEMS hrie r a E S E EEEE E E E E EE 3 1 3 2 Solaris and Linux SyStem
14. ation and object relationships RTI Analyzer also allows you to select an object from the tree and display its status and QoS properties This facility makes it easy to understand your distributed application UOHONpo u L Chapter 1 DDS Entities are listed in a Details on Entity tree You can control how selected from Summary Match Snapshot the tree is organized the tree of Entities Analysis Comparison djt Navigate Search Project Snapshots Run Window Help TEMAER s A Typs EDM A E E P 7 E O4 EntityInfo N E Summary Match Analysis EP Snapshots Comparison 0 Displays DDS entities in a tree layout Shows details on the selected entity in the DDS Entity View 4 amp DomainID0 Entity Writer HostId 192 168 2 3 Appld 7884 Instanceld 1 Entityld 8194 Status Active a Host 192 168 2 3 4 GB RTI Shapes Demo Hostld 192 168 2 3 Appld 7884 Instanceld 205 Status User Data QoS Data Type 4 amp Publisher Hostld 192 168 2 3 Appld 7884 Instanceld 1 Er noo Writer Circle ShapeType HostlId 192 168 2 3 Appld 78 a 2 Topic name Writer Square ShapeType Hostld 192 168 2 3 Appid Tonic neue Square Writer Square ShapeType Hostld 192 168 2 3 Appld i p Writer Triangle ShapeType Hostld 192 168 2 3 Appld e name a G RTI Shapes Demo Hostid 192 168 2 3 Appld 5700 Jnstanceld bes a perv 4 Subscriber Hostld 192 168 2 3 Appld 5700 Instanceld 1 dedan dustin Infinite GS Reader Triangle ShapeType Hos
15. d 1 Entit Writer Square ShapeType HostId 192 168 2 3 Appld 788 Writer Square ShapeType Hostld 192 168 2 3 Appld 788 4 g RTI Shapes Demo Hostld 192 168 2 3 Appld 5700 Instanceld 1 4 Subscriber Hostld 192 168 2 3 Appld 5700 Instanceld 1 Enti GS Reader Square ShapeType Hostid 192 168 2 3 Appld 57 5 12 5 4 Viewing Entity Details 5 4 Viewing Entity Details Now let s see what details are available about the Entities in the tree 1 Select a Reader such as the one for the Topic named Circle Entity Tree Displays DDS entities in a tree layout 7 CHE ISIE DAL ESIDA I Summary D Match Analysis Snapshots Comparison O Shows details on the selected entity in the DDS Entity View lt i gt Types ml Entity Reader Hostld 192 168 2 3 Appld 5700 Instanceld 1 Entityld 2823 Status Active lt Q Circle Type ShapeType Status User Data QoS Data Type DomainiD 0 Host 192 168 2 3 Name Current Value a RTI Shapes Demo Hostld 1 Topic name amp Publisher HostId 192 16 Topic name Circle 2 Writer Circle ShapeT Type name Q RTI Shapes Demo Hostld 1 Type name ShapeType Subscriber Hostld 192 1 DeadlineQos f Reader Circle Shape deadline_duration Infinite Square Type ShapeType DurabilityQos durability_kind Volatile direct_communication False LatencyBudgetQos m latency_budget_duration 0 sec ae a m LivelinessQos X T Match Enti
16. d subscribe to Topics which will appear in the Demo s window as colored moving shapes Each shape is a Topic the shape s color is used as the Topic key RTI Shapes Demo showcases the capabilities of RTI Data Distribution Service including publish subscribe communication quality of service QoS fault tolerance and auto matic discovery The demo is a turnkey graphical application and does not require any programming L This tutorial assumes you are using a computer that has an active network inter face If this is not the case see Running without an Active Network Interface Section 3 3 LI RTI Shapes Demo uses Domain ID 0 by default If you want to use a different Domain ID when you start RTI Shapes Demo use the domainId lt gt option for example to use domain ID 5 enter rtishapesdemo domainId 5 To Begin the Tutorial 1 Start two copies of RTI Shapes Demo On Windows Vista systems From the Start menu select All Programs RTI RTI Shapes Demo lt version gt RTI Shapes Demo On other Windows systems From the Start menu select Programs RTI RTI Shapes Demo lt version gt RTI Shapes Demo On UNIX based systems Run RTI Shapes Demo from a command shell gt lt install directory gt rti shapesdemo rtishapesdemo 5 1 Setting Up RTI Shapes Demo The figure to the right shows the demo program s main window You should start two of these We ll refer to the first Demo window as the Publisher Dem
17. dd to Match List DE E 9 Remove from Match List Clear Match List If you d like to change the color used for highlighting entities in the match list click the colored Match Entities box at the bottom 5 19 Chapter 5 2 Do the same thing for the Topic Circle s Writer Now you should see that both entities are highlighted to show they are in the match list 2B ela Holer 4 4 Q Circle Type ShapeType 4 amp DomainID0 4 Host 192 168 2 3 4 ga RTI Shapes Demo HostId 192 168 2 3 Appld 7884 Instanceld 1 Entityld 4 4 amp Publisher HostId 192 168 2 3 Appld 7884 Instanceld 1 Entityld 1032 J 4 RTI Shapes Demo Hostld 192 168 2 3 Appld 5700 Instanceld 1 Entityld 4 4 Subscriber Hostid 192 168 2 3 Appld 5700 Instanceld 1 Entityld 1289 D Square Type ShapeType 3 In the Match Analysis view s Match Entities field use the drop down list to choose Selected Writers and Readers 4 Click the Perform Match Analysis button 5 Select the Expand Tree button on the right 5 20 5 6 Filtering the Match Results Tree The Match Results tree should now look like this Match Entities Selected Writers and Readers Match Results Writer x Reader Tue Oct 06 14 56 39 EDT 2009 amp DomainlD 0 1 Topic 1 Readers 1 Writers 1 mismatch 0 match 0 potential mismatch Q Topic Circle 1 Reader 1 Writer 1 mismatch 0 match 0 potential mismatch Writer Hos
18. differ L Message Log Displays messages from RTI Analyzer You can control which type of messages are displayed severe warning info etc Context sensitive help is available when you press F1 on Windows systems or Ctrl F1 on Solaris and Linux systems or select the help button found in the lower left cor ner of some dialogs Chapter 2 describes the installation process and important information about the required license file Chapter 3 explains how to start RTI Analyzer Chapter 5 presents a short tutorial to introduce the major RTI Analyzer features To fol low along with the tutorial you will start the RTI Shapes Demo application and then walk through the various RTI Analyzer windows and options Once you have completed the tutorial RTI Analyzer operation is intuitive uoHONpoyU L Chapter 1 Chapter 2 Installation This chapter provides instructions on how to download install and start RTI Analyzer J Installing RTI Analyzer Section 2 1 I Installing the License File Section 2 2 LJ Uninstalling RTI Analyzer Section 2 3 After installation see Chapter 3 Starting RTI Analyzer then we recommend that you walk through Chapter 5 Tutorial 2 1 Installing RTI Analyzer In the following instructions replace x to match your version of RTI Analyzer 1 To install RTI Analyzer simply run the installer and follow the on screen instruc tions 2 Optional Download and install RTI Shapes Demo This is
19. dows Vista systems Run RTI Analyzer from the Start menu select All Programs RTI Analyzer lt version gt right click RTI Analyzer and select Run as administrator On other Windows systems Run RTI Analyzer from the Start menu select Programs RTI Analyzer lt version gt RTI Analyzer On UNIX based systems Run RTI Analyzer from a command shell gt lt install directory gt scripts rtianalyzer Next select Go To RTI Analyzer when you see this Welcome screen T RT Analyzer RTI Analyzer File Edit Navigate Search Project Snapshots Run Window Help The Real Time Middleware Experts 1 The Welcome screen is only displayed the first time you use a new workspace 5 5 Chapter 5 2 In the Agent Control view lower left corner select the Configure button B This is where you will tell RTI Analyzer what applications to look for 3 In the DDS Domain Configuration dialog click OK This will configure the tool to use the default Domain ID 0 which is the same default value used by the RTI Shapes Demo However if you started the Demo with a different ID change it before clicking OK Configure DDS Domains For each domain configure peer locators discovery settings transport and other properties DDS Domains Domain ID Configure within RTI Analyzer 9 Configure using XML QoS Profile Peer Locators Transport Properties Resource Limits Wire Pro
20. hat Entities have been discovered By default the objects in the tree are sorted in this order e Domain ID e Host address e Application Name Host ID App ID Instance ID Entity ID e Subscriber Publisher Host ID App ID Instance ID Entity ID e Reader Writer Topic DataType Host ID App ID Instance ID Entity ID 5 3 1 Changing the Tree Layout You can change the way the tree is sorted There are two other predefined layouts Sort by Topic Sort by Domain ID J Try both buttons to see their effect You can create your own tree views by using the Build Your Own Tree button 5 8 5 3 Working with the Entity Tree For example let s create a view that only shows these objects e Application e Reader Writer e Topic To create a custom tree layout 1 From the Entity Tree tab click the Build Your Own Tree button a 2 Click or drag and drop the Application Reader Writer and Topic buttons in that order 2 Save your custom tree x Build Your Own 1 ree Build Your Own Tree Application Reader Writer Topic 1 Click or drag and drop the desired types into the Preview area 5 9 Chapter 5 3 To save this tree layout a Click Save As b Enter a name for the view such as MyTree View c Click OK 4 Click OK to close the Build Your Own Tree dialog In the Entity Tree pane you will see a new button for Tree Layouts f es this button only
21. icense 1 The file lt installation directory gt RTI Analyzer 1 4 x rti_license dat 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 RTI Analyzer cannot find a valid license file automatically it will prompt you to enter the location of a license file If you have any questions about license installation please contact support rti com 2 3 Uninstalling RTI Analyzer On a Windows system select Start Programs RTI RTI Analyzer 1 4 x RTI Analyzer Uninstaller Or you can select Start Control Panel Add Remove Programs 2 2 2 3 Uninstalling RTI Analyzer On a Linux or Solaris system run lt install dir gt uninstall Note If RTI Analyzer was installed on a remote file system the following files will not be removed I install4j I jre I jre bin LL jre lib M jre lib ext LL jre lib i386 LL jre lib i386 xawt I jre lib i386 native_threads I jre lib i386 client I jre lib font To completely uninstall RTI Analyzer on a remote file system run rm rf lt install dir gt 1 On Windows Vista systems select Start Control Panel Programs and Features 2 3 UOHDI D SU Z Chapter 2
22. incompatible This will demonstrate how RTI Analyzer points out the error and then allows you to correct it by writing a new QoS value to the RTI Shapes Demo Do not create a Reader for triangles this will demonstrate how RTI Analyzer points outs Writers without matching Readers 5 3 JDWON G Chapter 5 Your two RTI Shapes Demo windows should look like this Ecka Help Delete All Delete All Pause Publishing i Pause Publishing Hide History Hide History DDS Config DDS Config Read Take QoS Settings Reliability ReadQ Default Default False Read Default Default False Publisher Subscriber Notice that the Subscriber s shapes have colored borders This is how you can distinguish between Subscribers colored borders and Publishers thin black borders By default Subscribers show the most recent 6 samples this is why you see extra squares behind the leading one The most recent shape has a thick border Older historical samples have a thinner border Also notice that you do not see a triangle or circle shape in the Subscriber s window We didn t create a Reader for Triangles and the Reader for Circles has an incompatible QoS c You may minimize these two windows we won t need them for a while 5 4 5 2 Connecting RTI Analyzer to RTI Shapes Demo 5 2 Connecting RTI Analyzer to RTI Shapes Demo 1 Start RTI Analyzer On Win
23. ion Service Tutorial or one of your own RTI Data Distribution Service applications 5 25 Chapter 5 5 26
24. is error 5 Click OK to close the details window 5 16 5 6 Filtering the Match Results Tree 5 6 Filtering the Match Results Tree The Match Results tree can get rather large if you have several Writers and Readers There are two ways to scale down the number of objects included in the Match Results tree You can filter out Topics that you are not interested in or you can limit the analysis to selected objects The following steps allow you to practice both ways 5 6 1 Filtering the Contents of the Match Analysis Tree Since we know the Square Topic is working correctly let s filter it out for now 1 Select the Filter button P in the upper right corner This is not the same button in the Tree pane 2 Clear the checkbox for Topic Square Match View Filter Select entities to perform a match analysis on 4 DomaindD O F Topic Circle Topic Square J Topic Triangle Select Alt Deselect All Y Exclude disposed entities Y Skip matching typecodes D 3 Click OK 4 Click the Perform Match Analysis button 5 17 IOHO NL G Chapter 5 5 Select the Expand Tree button on the right The Match Results tree should now look like this Performs match analysis between readers and writers Match Entities All Writers and Readers x Perform Match Analysis Match Results Writer x Reader Tue Oct 06 14 49 39 EDT 2009 Q DomainlD 0 2 Topics 1 Readers 2 Writers 1 mismatch 0 match
25. mainPartici pant QoS RTI Analyzer will ignore other QoS settings in the profile because it does not create any other DDS entities Note If you make a mistake in entering the File Name Library Name or Profile Name RTI Analyzer will print an error message the next time you click the Start Stop button in the Agent Control window 4 2 Configuring RTI Analyzer from the GUI 4 2 Configuring RTI Analyzer from the GUI You can change commonly used configuration settings from the Configure DDS Domains dialog If you need to change a parameter not exposed through the GUI please use XML profiles see Section 4 1 To access this dialog select the Configure button in the Agent Control view lower left corner Then select the option labeled Configure within RTI Analyzer Then you can select from several tabs described in the following figures Figure 4 2 Peer Locators Tab The Peer Locators tab allows bps Domain Configuration you to set the peer list used by configure DDS Domains RTI Data Distribution Service to For each domain configure peer locators discovery settings transport and other properties discover other DDS entities By 9 ___________ i DDS Domains default this list includes shared Conkigeec within RTT Anatyexs memory UDP loopback and co Configure using XML QoS Profile multicast Please refer to the i RTI Data Distribution Service Peer Locators Transport Properties Re
26. mand lt install dir gt scripts rtianalyzer 3 3 Running without an Active Network Interface To use RTI Analyzer on a computer that does not have an active network interface you must configure the tool so that it only uses shared memory as follows 1 Click the Configure button to open the DDS Domain Configuration dialog 2 Select the Transport Properties tab and clear the checkbox for Enable Multicast If this option is disabled click the Add button first 3 Click OK 3 2 Chapter 4 Configuring RTI Analyzer There are two parts to RTI Analyzer configuration domain configuration and Qos parameters Domain configuration consists of providing RTI Analyzer with the list of domain IDs that you would like to analyze To access the dialog seen in Figure 4 1 select the Config ure button in the Agent Control view lower left corner From the Agent Configu ration window in the lower left portion of this view you can select Add or Delete to add or delete domain IDs to be analyzed Each domain ID can have separate QoS parame ters There are two ways to configure RTI Analyzer Qos parameters LI Specifying a QoS Profile Section 4 1 LI Configuring RTI Analyzer from the GUI Section 4 2 You can use either method however you cannot use both at the same time The QoS profile method gives you greater control over the configuration because you can change all DomainParticipant QoS settings It s also a simple way to use
27. more interesting 6 In the Subscriber Demo window notice that it is now receiving data for Squares the now compatible Circle and Triangles too File View Publish Subscribe Controls Help Triangle Delete All Delete All Pause Publishing zy Pause Publishing Hide History Hide History DDS Config DDS Config X Partitions Read Take QoS Settings Reliability Read Take QoS Settings Reliability Default Default True Read _Default Default False Default Default True ReadQ Default Default False Default Default True i ReadQ Default Default False Default Default True Ready on domain 0 Publisher Subscriber 5 22 5 8 Saving and Comparing Snapshots 5 8 7 In the RTI Analyzer s Match Analysis view change the Match Entities list box to All Writers and Readers Then press Perform Match Analysis You will see the mismatch is gone Squares are not displayed because we filtered them out in Section 5 6 WD Entity Info I Summary is 53 EF Snapshots Comparison z Performs match analysis between readers and writers eas Match Entities All Writers and Readers v Perform Match Analysis Match Results Writer x Reader Tue Oct 06 15 02 33 EDT 2009 Publisher x Subscriber amp DomainlD 0 2 Topics 2 Readers 2 Writers 0 mismatch 2 matches 0 potential mismatch 9 Topic Circle 1 Reader 1 Writer
28. o and the second as the Subscriber ShapesDemo Domain0 File View Publish Subscribe Controls Help Demo In the Publisher Demo create 2 squares 1 triangle and 1 circle all with default QoS settings a b Delete All Pause Publishing Hide History DDS Config X Name Type Color Partitions Read Take QoS Settings Reliability Under Publishers click on Square 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 Use the same process to create a green square a yellow circle and an orange triangle with default settings You ve just created 4 Writers 2 Squares a Triangle and a Circle In the Subscriber Demo subscribe to squares and circles but not triangles a Under Subscribers click on Square and click OK Leave the default set tings You ve just created 1 Reader that will receive data for all squares all colors Use the same process to create a Reader for circles with Liveliness set to AUTOMATIC and Lease Duration set to 50 ms Recall that we created the Circle Writer with the defaults so its Liveliness Lease Duration is INFINITE The QoS compatibility rules for Liveliness require that the Writers Lease Duration must be lt the Reader s By setting the Reader s to 50 ms we are intentionally causing the Circle Reader Writer pair to be
29. omparison 9 Performs match analysis between readers and writers Match Entities Match Results Writer x Reader Tue Oct 06 14 21 58 EDT 2009 Q DomainlD 0 3 Topics 2 Readers 4 Writers 1 mismatch 2 matches 0 potential mismatch Topic Circle 1 Reader 1 Writer 1 mismatch 0 match 0 potential mismatch Writer Hostld 192 168 2 3 Appld 7884 Instanceld 1 Entityld 65538 Status Active 1 GS Reader Hostld 192 168 2 3 Appld 5700 Instanceld 1 Entityld 2823 Status Active Topic Square 1 Readers 2 Writers 0 mismatch 2 matches 0 potential mismatch Writer Hostid 192 168 2 3 Appld 7884 Instanceld 1 Entityld 32770 Status Active 1 GS Reader Hostld 192 168 2 3 Appld 5700 Instanceld 1 Entityid 2567 Status Active Writer Hostid 192 168 2 3 Appld 7884 Instanceld 1 Entityld 40962 Status Active 1 GS Reader Hostid 192 168 2 3 Appld 5700 Instanceld 1 Entityld 2567 Status Active Topic Triangle 0 Reader 1 Writer 0 mismatch 0 match 0 potential mismatch Writer Hostld 192 168 2 3 Appld 7884 Instanceld 1 Entityld 73730 Status Active 0 5 15 Chapter 5 4 Click the pink line for the Reader under Topic Circle to see the details Match Analysis Domainld 0 Topic Circle The match analyses based on the QoS settings and other attributes for Reader and Writer and the corresponding Publisher and Subscriber are shown here Reader Hostld 192 168 2
30. only required if you want to follow the steps in Chapter 5 Tutorial RTI Shapes Demo is available from RTI s Downloads page http www rti com downloads in the section titled Interactive DDS Demonstration RTI Shapes Demo runs on Windows and Linux systems Follow the installation instructions that accompany the distribution file Additional Steps for Linux Systems 1 cd lt location of RTI_Analyzer 1 4 x SetupLinux sh gt 2 chmod 755 RTI_Analyzer 1 4 x SetupLinux sh 3 RTI_Analyzer 1 4 x SetupLinux sh 2 1 UOHD D SU Z Chapter 2 Additional Notes for Solaris Systems If you are root administrator when you install RTI Analyzer then only the root user administrator will be able to run RTI Analyzer unless you do the following e Make sure other users have read access to all files in lt installation directory gt apps RTI Analyzer 1 4 x e Provide other users with execute permission on directories and executables under the lt installation directory gt apps RTI Analyzer 1 4 x directory e Make the lt installation directory gt apps RTI Analyzer 1 4 x eclipse configu ration directory writable by users other than root administrator 2 2 Installing the License File RTI Analyzer requires a valid license to run You will receive one via email after you download the software Save the license file in any location of your choice When RTI Analyzer starts it will look in these locations until it finds a valid l
31. ort 4 4 4 2 Configuring RTI Analyzer from the GUI Figure 4 4 Resource Limits Tab The Resource Limits tab DDS Domain Configuration allows you to change Configure DDS Domains some commonly used For each domain configure peer locators discovery settings transport and other properties resource limits for RTI Data Distribution Service DDS Domains Configure within RTI Analyzer Configure using XML QoS Profile Participant Property List Max Length 1024 Participant Property String Max Length 4096 Type Code Max Serialized Length 2048 Content Filter Property Max Length 256 Receiver Pool Buffer Size 9216 4 5 Chapter 4 Figure 4 5 Wire Protocol Tab The Wire Protocol tab allows you to change configuration parameters for the Real Time Publish Subscribe protocol used by RTI Data Distribution Domain ID a mtr ena Configure using il Service Configure DDS Domains For each domain configure peer locators discovery settings transport and other properties DDS Domains Peer Locators Transport Properties Resource Limits Wire Protocol Participant ID 1 V Automatic Assignment Base Port Offset Domain ID Gain Participant ID Gain 2 Built in Multicast Port Offset 0 Built in Unicast Port Offset 10 User Multicast Port Offset 1 User Unicast Port Offset 11
32. s ss ccissssscleaiseeat e a ea aa A E S E A a 3 2 3 3 Running without an Active Network Interface cccccccccscsseseeceneteseseststeneseseeeesesesnanans 3 2 Configuring RTI Analyzer AT sopecitying a Q09 Propilesciissicc sisi aai seins ave R E ns eine dete ated 4 2 4 2 Configuring RTI Analyzer from the GUI cece cece ee seessseeceseseseeseeseseseeeseeeseeeeeeey 4 3 Tutorial oul Setting Up RI Shapes Demo vee kicsciis ceaieers teat cces co e ei ae ib tetas de Bekeces iste 5 2 5 2 Connecting RTI Analyzer to RTI Shapes Dem0 cccccssssseeeesesesseeseeeseseseeescseseseseees 5 5 5 3 Working withthe Entity Tree i s cc sisctsescscsssstsessaecaatactbeerecriecssesd aves E o E Eae EREE 5 8 5 3 1 Changing the Tree Layout cccssccccsccsssessesssnssscvevscnsssatesssasvecvevsvacsectessesescateesesssestonses 5 8 5 3 2 Filtering Out Specific Entities iscsi cstcssssccsscasssseseaaiciseseasudscseseaseteaassonstianietsscetseseas 5 10 54 Viewing Entity DetailS icicadistcahvienciaidita catia i Aliana Shae 5 13 5 5 Debugging Object Communication Problems with Match Analysis 000 5 14 5 6 5 7 5 8 Filtering the Match Results Tree c cccsgiseiseseesesieseosseveasvesseveosetesanseedevenseieupstedensonsevessvens 5 17 5 6 1 Filtering the Contents of the Match Analysis Tree ccccccceseseeseeteteteseeeees 5 17 5 6 2 Analyzing Selected Objects Only ccccccccssesesestetetescecescsesseneesesescenessseeceneneneaans 5
33. source Limits Wire Protocol Properties User s Manual for more infor Peer Locators Participant ID Limit builtin udpv4 127 0 0 1 4 builtin shmem 4 mation about discovery peers builtin udpv4 239 255 0 1 4 3 uoypInByuosd 7 Chapter 4 Figure 4 3 Transport Properties The Transport Properties tab allows you to set the proper Configure DDS Domains ties of the transports used by For each domain configure peer locators discovery settings transport and other properties RTI Data Distribution Service DDS Domains By default the UDPv4 and OREN O Corsage hes Varnes shared memory transports Configure using XML QoS Profile are enabled there are also tabs for UDPv6 and RTI Peer Locators Transport Properties Resource Limits Wire Protocol Properties Secure WAN Transport You W Enable Multicast may also enable or disable multicast from this tab UDPv4 UDPv6 Shared Memory WAN V Enable UDPv4 Name Value Default ignore_nonrunning_interfaces false false multicast_loopback_disabled false false multicast_ttl 1 1 ignore_loopback_interface automatic automatic multicast_enabled true true no_zero_copy false false message_size_max 9216 9216 send_socket_buffer_size 9216 9216 gather_send_buffer_count_max 16 unicast_enabled true recv_socket_buffer_size 9216 Remove Transp
34. the exact same profile as the RTI Data Distribution Service application that you are analyzing The GUI method allows you to change a subset of QoS values If you do not configure RTI Analyzer it will use the same default configuration as RTI Data Distribution Service The default configuration file for RTI Data Distribution Service is located here T NDDSHOME resource qos_profiles_4 5x xml NDDS_QOS_PROFILES xml 1 NDDSHOME represents the installation directory for RTI Data Distribution Service 2 x stands for the version letter of the current release 4 1 uoyonpyuop Y Chapter 4 4 1 Figure 4 1 4 2 Specifying a QoS Profile The DDS Domain Configuration dialog allows you to specify an XML configuration profile from a file To access the dialog seen in Figure 4 1 select the Configure button in the Agent Control view lower left corner Select the option labeled Configure using XML QoS Profile Then select the profile file library and profile that you want to use Selecting an XML QoS Profile DDS Domain Configuratio Configure DDS Domains For each domain configure peer locators discovery settings transport and other properties DDS Domains Domain ID 0 File Based Configuration QoS Profile File QoS Library Name QoS Profile Name These settings apply to participant QoS only You can create your own profile file and use it to make changes to any Do
35. ties Disposed Entities T m gt 2 Select the Entity Info view Within that view select the different tabs to become familiar with their contents QoS Displays the current QoS settings for the selected entity Status Displays the entity s current state the timestamp from the last update and the number of state changes Not applicable to hosts or applica tions User Data QoS Displays the contents of the User Data QoS policy if any Data Type Displays the definition of the data type used by the selected Writer Reader or Topic Not applicable to other types of objects in the tree 5 13 JOON G Chapter 5 5 5 5 14 Debugging Object Communication Problems with Match Analysis RTI Analyzer s Match Analysis feature helps you see which Writers and Readers are matched and therefore able to communicate with each other and which ones aren t This feature can help you spot incompatible QoS settings as well as common errors such as misspelled Topic names LI As you may recall in Setting Up RTI Shapes Demo Section 5 1 we deliberately created an error in our Publisher and Subscriber Demo so we could see how RTI Analyzer helps you diagnose problems On the publishing side we created a Cir cle with default Liveliness AUTOMATIC kind with INFINITE lease_duration on the subscribing side we created a Circle with Liveliness set to 50 ms Since the offered lease_duration INFI
36. tlId 192 168 2 3 Appld 7884 Instanceld 1 Entityld 65538 Status Active 1 Reader GS Reader HostId 192 168 2 3 Appld 5700 Instanceld 1 Entityld 2823 Status Active Misma Potential Mismatch No Reader Writer for the same Topic Important Step 6 In the next section we will correct the incompatible QoS But before we make any changes take a snapshot of the current system A snapshot saves the DDS object information Later in Section 5 8 we will take another snapshot and show you how to compare them Take a snapshot of our current configuration by selecting Snapshots Save Snap shot As and selecting a filename of your choice such as mysnapshotA Chapter 5 5 7 Correcting the Circle s Liveliness QoS Now that we ve seen how RTI Analyzer can help you find incompatible QoS settings let s correct the problem 1 Open the RTI Shapes Demo window for the Subscriber Demo This window s shapes have dark blue borders 2 In the Legend at the bottom select the row for the Circle 3 Press the Delete key on your keyboard 4 Recreate the Reader for Circles under Subscribers select Circle and click OK So this time we will use the default Liveliness 5 While we re correcting problems create a Reader for Triangles under Subscrib ers select Triangle and click OK Although this isn t part of correcting the Cir cles problem it will make the snapshot comparison in the next section
37. tlId 192 168 2 3 Appld Durability Qos 6c Reader Circle ShapeType HostId 192 168 2 3 Appld 5 durability_kind Volatile 6c Reader Square ShapeType HostId 192 168 2 3 Appld diveck cosumurication False DurabilityServiceQos service_cleanup_delay 0 sec history_kind Keep Last m j r Current Value m E Match Entities Disposed Entities Topic Conflicts JB RTI Developer Platform Message Log ti o Pre AFA a 5 Agent Control SS Display Control Control and configuration of capture agent Agents Time Module Type Message 9 38 37 AM RTI Explorer Info CapturingAgentManager initializec 9 38 37 AM RTI Explorer Data model container initialized w Start Stop Configure 4 Start Here Messages from RTI Analyzer Begin by configuring the agent that captures data from RTI Data Distribution Service applications In this example the RTI Shapes Demo has created Writers for 2 squares 1 triangle and 1 circle The squares use the same Topic name with color as the key You can modify how the tree is organized and filter out Entities that are not of interest 1 1 Overview RTI Analyzer s main window is composed of the following sections Ll Agent Control Allows you to start stop and configure RTI Analyzer s Spy agent which collects discovery data from RTI Data Distribution Service applications l Display Control Allows yo
38. tocol I Properties Peer Locators Participant ID Limit builtin shmem 4 builtin udpv4 239 255 0 1 builtin udpv4 127 0 0 1 4 4 Back in the Agent Control tab select the Start button J l 5 Within a few seconds you should see DomainID 0 in the Entity tree Or if you changed the domain ID you should see your modified ID 5 6 5 2 Connecting RTI Analyzer to RTI Shapes Demo 6 Select the Expand Tree button to see all the entities Click here to expand the tree a amp DomainIDO a Host 192 168 2 3 4 Q RTI Shapes Demo Hostld 192 168 2 3 AppId 7884 Instanceld 1 Ent 4 amp Publisher Hostld 192 168 2 3 Appld 7884 Instanceld 1 Entityld Nriter Square ShapeType Hostld 192 168 2 3 Appld 7884 In Writer Triangle ShapeType Hostld 192 168 2 3 Appld 7884 1 Writer Square ShapeType Hostld 192 168 2 3 Appld 7884 In Writer Circle ShapeType HostId 192 168 2 3 Appld 7884 Ins 4 ee RTI Shapes Demo HostId 192 168 2 3 Appld 5700 Instanceld 1 Ent 4 Subscriber Hostld 192 168 2 3 Appld 5700 Instanceld 1 Entitylc f Reader Circle ShapeType Hostid 192 168 2 3 Appld 5700 In d Reader Square ShapeType Hostld 192 168 2 3 Appld 5700 Ir Note Your HostId Appld etc will be different from those in the screenshots shown throughout this document 5 7 Chapter 5 5 3 Working with the Entity Tree The Entity tree shows you w
39. u to pause the automatic redisplay of data and to con trol how often data on the display is refreshed L Entity Tree The tree is a sorted list of RTI Data Distribution Service objects RTI Ana lyzer listens to the declarations and lists the discovered objects The Entity Tree uses Windows Explorer style displays and techniques for expanding and collaps ing the tree You can double click the folders to expand the lists of hosts Partici pants Writers Topics etc Ll Types Displays the data types for each discovered Topic This view highlights type related conflicts such as two Topics with the same name that use different data types or two data types with the same name that have different structures J Entity Info Contains subordinate tabs for QoS Status and Data Type The contents of these tabs are determined by the object selected in the tree The QoS tab can also be used to temporarily change mutable QoS policies L Summary Shows you how many DDS objects of each type have been discovered J Match Analysis Shows you which Writers Readers or Publishers Subscribers are y matched to each other This information can help you diagnose communications problems between applications such as incompatible QoS settings _ Snapshots Comparison Provides a way to quickly compare the hierarchy of DDS entities in two different systems You can take snapshots of various systems then compare them in a graphical manner to see how they
Download Pdf Manuals
Related Search