Getting Started - Community RTI Connext Users
Contents
1. domain ID when Monitor starts matchRefreshPeriodSeconds lt seconds gt Specifies the period at which to refresh the system overview panel s matches Default 5 seconds notiicationHistoryDepth value Specifies the number of notifications to ep per entity Default 12 notifications pruneDeadObjectsPetiodSeconds seconde gt Sets the period at which Monitor should clean up userinter face objects such as the Host and Process nodes in the tree views that are no longer current have no more children modes in the tree view This value should be increased when dealing with very large systems where the time to complete discovery is longer than the default value of 3 seconds Default 3 seconds Command line Options Tebie 21 Command Ine Options Option Description Monir to use muliple threads according to We number of cores on the hos to retrieve data fom its DataReaders which contain monitoring data This is typi spawnReadThreads cally only needed for very large systems Default Not specified use a single read thread to retrieve data ata period of 1 second verbosity lt value gt Sets the verbosity for Monitor and the Connext Core Librar 0 silent both Core Libraries and Monitor 1 errors both Core Libraries and Monito 2 wamings Monitor only 3 wamings both Core Libraries and Monitor information Monitor only 5 tracing Monitor only 6 tr2. DP 0 RTI Monitoring Demo in the list of parent entities This will select the DomainParticipant in the Physical View tree and the Status panel will change to show the DomainParticipant s status Notice that the Status panel now shows an aggregation of the statuses of all the DataWriters and DataReaders that belong to the selected DomainParticipant 1 Close the Status panel gt Review all the processes in the system Select the Processes Table button from the toolbar Ee Romain artone nso Showing System Topology Sample Counts end Rates b This will display a panel that shows the processor and memory usage of all monitored processes ITUNES Select one of the processes in the table and click on the Select in Physical View button this will select the same process in the Physical View tree The Find button is useful for searching large table for a specific proces This is a simple string search so you must use the same format displayed in the table for example notice that the process ID includes comma lt Click on the Total CPU column heading This will sort the table by the values in this column Clicking it again will sort in the opposite order This is useful to watch in real time to see which processes are using a lot of CPU You can sort based on any of the columns Click the 9 button just above the vertical scrollbar This allows you to cho
3. includes the monitoring library If you are running on Windows make sure that your PATH environment variable includes the monitoring library Ifyou are seeing error messages similar to the following CREATE Participant DDS DomainParticipantFactory set default Participant qoo ERROR Inconsistent 005 nore information at WARN verbosity evel CREATE Participant DDS DomainParticipantFactory load profilest ERROR loai ing profiles CREATE Participant DDS pomainParticipantFactory create participant dis abledI ERROR loading profiles These messages most likely mean that you are using a lot of properties in the PasticipantQos to configure monitoring partdpant property string max length or participant property list max length in the ResourceLimitsQosPolicy in DomainPartic pantQos is not large enough to accommodate all the properties Try increasing those values in your Connext application to fix the problem Not Receiving Monitoring Data due to Inconsistent QoS Ifyou see an error message similar to the following WARN com rti d s monitor util DebugDataReaderLis tener on requested incompatible qos Unknown Source topic rti dde non storing domainParticipantDescription Requestedrncoupatiblegosstatus total countel total count changeel last policy idepurability polleles QosPolicyCount policy id Durability eount 2111 This message most likely means that the internal DataWriters created by Monitoring Librar
4. issue transport settings and the maximum type code serialized size are left at the default val The maximum type code serialized size and transport settings must be consistent between Moni tor and the Connext application in which monitoring is enabled By keeping the maximum type code serialized size and all the transport settings at default values in the QoS profile used by Monitor all monitored Connext applications that use default settings will work with Monitor out of the box If you are not receiving monitoring data it is most likely because you do have inconsistent transport settings or inconsistent maximum type code serialized size settings between Monitor and the Connex application in which monitoring is enabled maybe you are not using the default maximum type code serialized size or transport settings in the monitored Connext appli cation If your monitored Connext application is required to use a large maximum serialized type code size or transport settings that support large data you will need to change the corresponding set tings in the QoS profile used by Monitor The maximum type code serialized size is configured under resource limits for the participant qos transport settings are configured under property for the participant qos The QoS profile used by Monitor is in installation directory gt contig stimonitor qos profiles xml See Section 3 8 in the Monitor User s Manual for more information on editing this file sam
5. this file 45
6. you may want to do so now Refer to the Monitoring Library Getting Started Guide that is pro vided with the Monitoring Library bundle Monitoring Library is available from the RTI Support Portal accessible from https support rti Running you have RTI Launcher you can use ts Tools tab to start Monitor Or you can start Monitor using the provided rtimonitor script For example if you installed Monitor in start it by entering gt opt eti art Monitor version acriptertinonitor Command line options are described in Section 2 4 Instructions for Windows Systems 22 221 23 Instructions for Windows Systems Installing Monitor is included with RTI Messaging Use the installation instructions in this chapter only if you are installing Monitor independently not as part of RTI Connext Messaging 1 Right click RTI_Monitor cversion gt Win zip and select Extract A to install Monitor in the directory of your choice You must have write access to the directory If you choose the resulting installation will be in RTIRTI_Monitor_ lt ver sion gt 2 See installing the License File Section 23 3 Monitor is designed to monitor Connext applications that are using Monitoring Library If you have not yet installed Monitoring Library for use with your Connext applications you may want to do so now Refer to the documentation in the Monitoring Library bundle for details M
7. 1 41 Debugging Problems with Monitor on Windows System m 42 Running Monitor on a System with Limited Memory m 43 Running Monitor with a Large System m 44 Error Regarding Incompatible Shared Memory Segment a2 45 Unable o Create Participant in Application a2 45 45 46 Not Receiving Monitoring Data due to Inconsistent QoS 47 Not Receiving Monitoring Data for Entities 48 No Type Code for Some Entities in Description Panel 49 Running out of Memory 4 10 Running without an Active Network Interface Chapter 1 Welcome RT Monitor is a graphical tool that displays monitoring data from RTI Connext formerly RTI Data Distri bution Service applications Monitor will help you Q Understand your system with easy to use graphical view into your entire Connext appli cation Verify your design by making sure the entities in your Con next applications are communi cating as expected O Tune performance by provid ing deep statistics on every aspect of the middlewares operation O Optimize integration with detailed information on every entity in your system Monitor real time operation with a dashboard of tools to see traffic patterns errors lost samples and more You can run Monitor on the same host as the Connext application or on a different host To enable a Connext application to provide monitoring data to Monitor the application needs to use the Monitoring Library plugi
8. 2 Examine the data in chart acm Monitor notice the number of received samples increases im the chart ieee Re PN weeny EI E EB c Close the two Chart panels E 13 Let s see how to determine which DataWriter is contributing more received samples a In the Physical View tree select the Expand button b Select the DataReader in the tree then select the Status Panel button from the toolbar For Filter by match select the first matching endpoint in the drop down menu Select the Status Panel button again to open a second status panel for the reader For Filter by match select the second matching endpoint in the drop down menu Showing System Topology Sample Counts end Rates Now you have status for both of the reader s matching writers side by side The Received Count values will point out which one is contributing more samples Duis ie ines S 0 ete ye ara 5 angie Sage atts rro Eme Delta value shows he change forthe update period 14 Let s see how to save the current data to be used for future analysis Select the Save Data button in the toolbar deine Was sav Data b Selecta location and enter a filename in the file dialog c Close the third instance of Shapes Demo the one started with publnterval 250 that is publishing yellow squares 4 In the rema
9. RTI Monitor Getting Started Guide Version 5 1 0 2011 2013 Real Time Innovations Inc ts reserved e All f tj res IEEE Trademarks Real Time Innovations RTI and Connext are trademarks or registered trademarks of Real Time Innovations Inc All other trademarks used in this document are the property of their respective owners Copy and Use Restrictions No part of this publication may be reproduced stored ina retrieval system or transmitted in any form including electronic mechanical photocopy and facsimile without the prior written permission of Real Time Innovations Inc The software described in this document is furnished under and subject to the RTI software license agreement The software may be used or copied only under the terms of the license agreement Technical Support Real Time Innovations Inc 232 E Java Drive Sunnyvale CA 94089 Phone 408 990 7444 Email Support rti com Website pis supportr com Contents 1 Welcome 2 Installation and Start Up 21 Instructions for Linux Systems 211 Installing 212 Running 22 Instructions for Windows Systems 22 221 Installing 22 222 Running 22 23 Installing the License Fle 22 24 Command line Options 23 3 Demo using RTI Shapes Demo 31 Showing System Topology Sample Counts and Rates 32 Showing Content Filtered Samples 312 33 Showing Deadlines 313 34 Showing a Samples Rejected Scenario 316 4 Troubleshooting 4
10. Regarding Incompatible Shared Memory Segment Ifyou se the following error messages Transport Shen attach writer incompatible shared men ory sequent found Found segment with max message size 2216 Needed 65520 These messages likely mean either Another application is curently running on the same host in the same domain with dif feret shared memory transport settings or E you are on a Linux system there was an old application running on that domain ID before with different shared memory transport settings that was not terminated grace fully To correct problem a i you do not intend to monitor the application that has different shared memory settings on the same host you can use another domain ID for the monitoring topics both in Monitor and in the applications that you want o monitor If you intend to mont tor all the Comert applications in that domain onthe same host make sure that all the applica tions running on the same host with the same domain ID have consistent shared memory transport settings The QoS profile used by Monitor is in lt insalltion direciory gt iconfig T monitor qoa profiles xm The transport settings in this profile need to be consistent with the transport settings in all the Connext applications that are running on the same host with the same domain ID All shared memory transport settings are specified under the participant qos and have property names tha
11. The steps in this section assume you are using the same profile used in Section 3 1 for the two instances of Shapes Demo 1 In one instance of Shapes Demo create a reliable square publisher Select Publish Square b Make sure the Reliability box is checked c Select OK In the other instance of Shapes Demo create a content filtered reliable square subscriber Select Subscribe Square b Check the Reliability box Check the Use Filter box under Content Filter Topic d Select OK Notice that the subscriber only receives samples that are within the filtering square Observe the filtered samples in Monitor Select the Expand All 3j button for the Physical View tree in Monitor b In the Physical View tree select the DataReader The Status panel is showing values for the DataReader Notice that the Sample Statis tics Filtered Count is zero This shows that content filtering is only happening on the writer side in this case c Close the Status panel Show the content filter expression a In the Physical View tre select the DataReader then select the Description Panel button from the toolbar Te Doran anons lie Hee A Create a new Des ption panel b Select the Builtin Topic Data tab in the Description Panel E Showing Deadlines See the content filter expression under builtin topic data content filter property filter expression and builtin topie datalcontent fil
12. acing both Core Libraries and Monitor Default 1 24 Chapter 3 Demo using RTI Shapes Demo Before going through the steps in this chapter make sure that both RTI Monitor and RTI Shapes Demo are installed 31 Showing System Topology Sample Counts and Rates 1 Start two instances of Shapes Demo On Linux systems If you have RTI Launcher you can use its Utilities tab to start Shapes Demo Or you can enter the following in a command shell gt lt Shapes Deno install directory gt scripts etishapesdeno On Windows systems Ifyou have RTI Launcher you can use its Utilities tab to start Shapes Demo Or from the Windows Start menu navigate to RTI Connext lt version gt RTI Connext DDS Mes saging lt version gt Components RTI Shapes Demo lt version gt and select RTI Shapes Demo a When the Shapes Demo window appears open the Configuration dialog under Controls If the Stop button is enabled press it b Uncheck the Enable distributed logger checkbox From the drop down list of profiles choose MonitorDemoLibrary Monitor Default Shapes Demo will use domain ID Oby default If you choose to use a different domain ID make sure to use the same value in both instances of Shapes Demo d Press Start Showing System Topology Sample Counts and Rates e Repeat so you are running two instances of Shapes Demo In one instance of Shapes Demo create a reliable square publisher as
13. and Samples Received Counts show the number of samples sent received in the last sample period In this case the sam ple period is 5 seconds Since Shapes Demo publishes 16 samples per second you will see approximately 80 5 x 16 samples per sample period The Chart Time Range slider at the bottom of Monitor changes the time scale of the graphs To unpin the panels press their pin buttons again Notice that now both chart pan els are showing DR as the current entity at the top since that entity is selected in the Physical View tree 10 Start a third instance of Shapes Demo with a specific publishing interval On Windows systems Open a command prompt and enter the following replacing the installation directory to match your system gt c shapes Demo installation directory gt gt scripte rtishapesdano pubInterval 250 On Linux systems Enter the following replacing the installation directory to match your system gt ed Shapes Demo installation directary gt gt mcripte rtishapeademo pubInterval 250 Just like the other Shapes Demo instances choose the profile MonitorDemoLi brarysMonitorDefault Showing System Topology Sample Counts end Rates 11 Inthe new Shapes Demo window create reliable square publisher of a different color a Select Publish Square b Choose the profile MonitorDemoLibrary MonitorDefault c Select YELLOW d Make sure the Reliability box is checked e Select OK 1
14. ate a new Al Notions Tabie The All Notifications Table displays all the notifications in the entire system not just for the selected entity By default it shows both warnings and errors You can choose to see either just the warnings or just the errors by checking unchecking the options emet iem Ene row is selected in the All Notifications Table clicking the Select In Views button will select the corresponding entity in the tree views Close the All Notifications Table panel e Select the System Overview Panel button from the toolbar Select the Notifica tions option the entities in the system that have caused a notification are high lighted in the system map Close the System Overview Panel 33s Showing a Samples Rejected Surio 6 Clear the notifications In the publisher shapes demo instance select Controls Resume Publishing b From Monitor s menu select the Clear All Notifications button from the toolbar This will dear all the yellow markers in the tree perea coe Bp esas TEC 935 Clear Al Naticatins 7 Prepare for the next demo a In one instance of Shapes Demo select Controls Delete b Close the other Shapes Demo instance 3 4 Showing a Samples Rejected Scenario 1 Configure the existing instance of Shapes Demo to use the profile MonitorDemoLibrary SamplesRejectedScenario a Select Controls C
15. bat to change javawexe to java exe so that error messages will be displayed in a command prompt to help you debug the issue Running Monitor on a System with Limited Memory Monitor runs with Java and a default maximum Java heap size of 500m If you are monitoring on system with very little memory and you are only monitoring a very small system you may be able to reduce memory usage by modifying the file in installation directory gt scripts rtimon itorbat on Windows systems or installation directory lscriptsltimonitor on Linux sys terns to decrease the maximum Java heap size usage For example in the script change Xmx500m to Xmx300m Monitor will save some history of statistics to be displayed in the charts By default this value is 12 If you are running on a system with limited memory you can decrease this value with the command line option historyDepth value see page 2 3 Running Monitor with a Large System Monitor runs with Java and a default maximum Java heap size of 500m If you are monitoring very large system you may need to modify the file lt installation directory gt seripts rtimon itorbat on Windows systems or lt installation directory gt scripts rtimonitor on Linux sys tems to increase the maximum Java heap size usage For example in the script change XanxS00m to XmxI536m Error Regarding Incompatible Shared Memory Segment 44 45 Error
16. follows Select Publish Square b Choose the profile MonitorDemoLibrary MonitorDefault lt Make sure the Reliability box is checked d Select OK In the other instance of Shapes Demo create a reliable square subseriber as follows a Select Subscribe Square b Choose the profile MonitorDemoLibrary c Check the Reliability box d Select OK Start Monitor fonitorDefault On Linux systems If you have RTI Launcher you can use its Tools tab to start Monitor you can start Monitor using the provided stimonitor script For example if you installed Monitor in optiti start it by entering gt opt rti RTI Monitor veraion scripta rtimonitor On Windows systems If you have RTI Launcher you can use its Tools tab to start Monitor Or from the Windows Start menu navigate to RTI Connext lt version gt RTI Connext Tools lt version gt Components RTI Monitor lt version gt and select RTI Monitor Or double click installation directory gt scripts rtimonitorbat in your browser 32 Showing System Topology Sample Counts and Rates Review the system topology Expand the Physical View tree by clicking the button below the Physical View tab b Close the Status Panel on the right select the red E at the top right corner of that panel c Select the System Overview button in the toolbar to see a summary of the monitored domain He Doman icons wacom He
17. ining two instances of RTI Shapes Demo select Controls Delete AU No shapes publications or subscriptions should be running in the system now e Select the Load Data button from the toolbar union di a ao Dato You will see a prompt asking if you want to lose the current data and leave the domain Select OK to continue In the file dialog select the file in which you previ ously saved the data Notice that the title of the Monitor window has changed to Historical data mode and shows the name of the loaded data file Now you are seeing a snapshot of the system Select the Expand 3 button for the Physical View tree You can see all the previ ously created entities even though no publications or subscriptions are currently run ning an Showing Content Filtered Samples h Select Domain Show Current Domain from the menu Notice that you are not joined to any domain now because Monitor is showing historical data instead of live data Click OK to close the dialog box 15 Prepare for the next demo a Select the Join Domain button from the toolbar You will see a prompt asking if you want to lose the currently loaded data Click OK to continue Rejoin your original domain by entering the domain ID then click OK Notice that the title of Monitor is no longer showing Historical data mode Monitor is showing live data again b Close all the panels 3 2 Showing Content Filtered Samples
18. mples received by various entities in the system Dejar Pour its neuen tweens bles Notes To change the scaling of the numbers indicated in the color map use the Scale drop down menu Move the mouse over the entities in the map to see a tooltip of the actual value You can select different Display Name Controls for each kind of entity or all enti ties to control how much detail will appear in the map in the System Overview panel Close the System Overview panel d In the Physical View tree select the DataWriter then select the Status Panel button in 4 Select the Advanced display mode Showing System Topology Sample Counts end Rates J Scroll down to see Discovery Statistics Click the link next to Last DataReader GUID This will select the matching DataReader in the Physical View tree and the panel will switch to show DataReader status instead us D Lon Heres jason Ge VH stance panes en man mem ration iia cee ems tn mon nao E Cick here to select he matching reader The top of the Status panel and some of the other entity specific panels that you will sec later in this demo shows a list of parent entities to which the selected entity belongs For example Sane Hat ETAGE IERam Rua i ATMs Bee gt Sa D LR X Click on
19. n CConnext notifies Monitoring Library every time an entity is created deleted or a QoS is changed Monitoring Library also periodically queries the status of all entities Monitoring Library sends all the data to Monitor once it gets the data from the Connext application Monitoring is enabled in the application by setting values in the DomainParticipant s Property QosPolicy programmatically or through an XML QoS profile Refer to the Monitoring Library Getting Started Guide included with the Monitoring Library bun dle for details Monitoring Library is available from the RTI Support Portal accessible from https supportrticom Chapter2 Installation and Start Up 2t 2141 Instructions for Linux Systems Installing Monitor is included with RTI Connext Messaging Use the installation instructions in this chapter only if you are installing Monitor independently not as part of RTI Messaging 1 Untar RT_Monitor cversion gt Linuxtargz in a directory where you have write access For example enter gt opt rti 2 gunzip RTI Monitor lt version Linux tar gz gt atar xvf RTI Monitor lt vereion gt Linux tar The resulting installation will be in opt st RTI_Monitor_ lt version gt 2 See Installing the License File Section 23 3 Monitor is designed to monitor Connext applications that are using Monitoring Library TE you have not yet installed Monitoring Library for use with your Connext applications
20. ome vh Pair 7 oomanrandan AMucnbinadene TE snas same sana Foams b In the Physical View tree select the DataWriter then select the Status Panel button in the toolbar cdm the Status panel select the g re Advanced display mode Under 0 Offered Deadlines Missed notice the pes non zero Total Count highlighted in yellow d In the Physical View tree select the DataReader Now the Status Panel is showing values for the DataReader Under Requested Denilines Missed you will see a non zero Total Count highlighted in yellow 10 00t TICE You may notice that the DataWriter s Offered Deadlines Missed Total Count is dif ferent than the DataReader s Requested Deadlines Missed Total Count That s because these entities were created with different deadline values 100ms for the writer 2500s for the reader e Close the Status panel 5 Look at the notifications In the Physical View tree select the DataWriter then select the Notifications Panel button in the toolbar Showing Deadlines The Notifications panel displays the selected entity s current status and a historical list of all alarm statuses related to the selected entity a iae b Close the Notifications panel Select the All Notifications Table button from the toolbar Ele Domai Sco Wadon Hp ag A Cre
21. onfiguration Stop b Choose the profile MonitorDemoLibrary SamplesRejectedScenatio Select Start 2 Create a reliable square publisher with the ManitorDemoLibrary SamplesRejected Scenario profile Select Publish Square b Choose the profile MonitorDemoLibrary SamplesRejectedScenatio Make sure the Reliability box is checked d Select OK 3 Create a new Shapes Demo instance with a reliable subscribing rate of 1 000 ms For example on a Windows system open a command prompt and enter the following replacing the installation directory to match your system gt ed lt Shapes Demo installation directory gt gt scripte rtishapesdeno bat subInterval 1000 Or on a Linux system enter the following replacing the installation directory to match your system gt c shapes installation directory gt gt mcripts rtishapeademo aubinterval 1000 4 Inthe new Shapes Demo instance create a reliable square subscriber that uses take and the MonitorDemoLibrary SamplesRejectedScenario profile Select Subscribe Square b Choose the profile MonitorDemoLibrary SamplesRejectedScenario c Check the Reliability box 4 For the Read method to use select Take Showing a Samples Rejected Scenario e Select OK Notice that the subscriber is not receiving all the samples Let s see why Select the Expand All button for the Physical View tree in Monitor b In the Physical View tree select
22. onitoring Library is available from the RTI Support Portal accessible from https support rti Running If you have RTI Launcher you can use its Tools tab to start Monitor Or from the Windows Start menu navigate to RTI Connext lt version gt RTI Connext Tools version Components RTI Monitor lt version gt and select RTI Monitor Or you can double click installation directory gt scripts stimonitorbat in your browser You can also start it from the command line if you need to use any of the options described in Section 24 Installing the License File Monitor 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 Monitor starts it will look in these loca tions until it finds a valid license 1 The last saved valid license location of the current user if Monitor has been run before 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 ARTI my rti license dat 3 The file r icense dat in the current working directory 4 The fle si licensedat in the directory specified by the environment variable NDDSHOME 1E Monitor cannot find a valid license file automatically it will prompt you to enter the location of a license file 1E you have any questions about license installation please c
23. ontact support rti com Command line Options 24 Table 21 Command line Options Monitor accepts the command line options in Table 2 1 Command line Options Option Description aggregationPeriodSeconds lt seconds gt iir periodically goes tough all te monitored entier n the system this information is saved n its own database to calculate aggregated statistics and states This value con tols that minimum period specified in seconds Default 5 seconds help Displays all command line options historyDepth cxalue Monitor saves some statistics history so t can be displayed in the charts This option controls how much historical data number of samples is saved per monitoring topie Default 12 samples ignoreTypeConflicts Instructs Manitor to ignore any type conflicts in Monitor type conflicts are based on type code equality rather than ype compatibility This command line option can be useful if you have types that have different type code but are com patible Default Not specified do not ignore type conflicts HinitisIDomainlds domain id list Specifies which domains Monitor will jin when t stars up domain jd list isa list of domain IDs each separated by a To specify multiple domain IDs on a Windows system enclose the comma separated IDs in quotation marks For example initialDomainlds 31 32 Default If not specified you will be prompted to enter a
24. ose which columns appear in the table For instance to remove the ID column uncheck it Note to enable the Pack Selected Column option select a cell in the top row Ea mE Hem You can also change the order of the columns by simply dragging them to a new place in the table e Close the Processes Table Showing System Topology Sample Counts end Rates 7 Review all the data types in the system by selecting the System Types Table button from the toolbar This will display a panel that shows all the known data types n the selected domain In this case there is only one data type called Shape Type Like the Processes Table we saw earlier this table also has a 8 button above he verti al scrollbar to control the columns that appear in the table You can also sort the table based on any of the columns by clicking onthe column heading Close the System Types Table 3 Show details of each data type a Select the Physical View tab on the left b Select DataReader in the tree then select the Description Panel button from the tool le Danh Saone Window Hep In the Description panel select the DataType tab to see the data type for the data reader in IDL You can also see other proper ties related to the data type d Close the Description Panel 9 show panels for two or more entities side by side for comparison you_can press the pin button at the to
25. p e 235 508 sual ass Create a new System Overview panel Showing System Topology Sample Counts and Rates Ci ee a mecs 8 tenere preme ie tr 8 tos netus Sj Tenes Osa eem s rr mese gsiemens frs Prose csr Vic mop ot he sem Ta box representa host DW Bec Rose PAZ precon D Select the Matches option in the System Overview panel Select DW or DR in the sys tem map to see what entities are matched in the system E UR Dir at Tepename im Demaneaneant Tene Name mj Petar sectam a merece 8 Rn pea prec Bt EGER Tras S frons Sn Jt Notice that when you select an entity in the system map that entity also becomes selected in the Physical View tree Showing System Topology Sample Counts end Rates Click the Back button 8 on the toolbar it will change the selection back to the previ ously selected entity n the Physical View tree and the System Overview panel Try the Forward button 5 too In the System Overview panel select the Measurement option and Samples Received Count in the drop down menu You will see a color map that indicates the number of sa
26. p left comer of au the entity specific panels The panel is then pinned to the entity and the panel will periodically receive updated data for the pinned entity even when another entity is selected in the tre Select the Physical View tab on the left b From the menu make sure Window Auto Checkerboard Tile is checked Showing System Topology Sample Counts Rates c In the Physical View tree select the DataWriter then press the Chart button in the toolbar im Eua Create a new Chart panel 4 In the Chart panel press the pin button on the top left comer Notice that the but ton has changed to pinned to indicate that the panel is pinned to a specific entity For Chart Data select Samples Written Counts e In the Physical View tree select the DataReader then press the Chart button in the toolbar to create the second Chart panel and press its pin button For Chart Data select Samples Received Counts Now you can compare the DataWriter s Samples Written Counts and the DataReader s Samples Received Counts side by side Notice that the send and receive sample counts are about the same ur Wella 2 s opes pun Notes The default settings set the publish rate of the monitoring topics to 5 seconds Therefore you may need to wait 5 seconds for the Monitor data to be updated The charts for Samples Written Counts
27. ple large data QoS profile is provided with the Monitoring Library bundle for your refer ence it has large data support turned on for both the UDPv4 and shared memory transports and uses large maximum type code serialized size support Ifyou need to use large data or large type code in your Connext application you can use this provided large data QoS profile in the monitored application and also uncomment the corresponding transport and maximum type code serialized size settings in the Monitor QoS profile this will enable consistent large maxi mum type code serialized size and large data transport settings Please see the documentation in the Monitoring Library bundle for an explanation of this large data QoS profile No Type Code for Some Entities in Description Panel If the type code for your user data type is larger than the default maximum type code serialized size the IDL for that data type may not show up in the DataType tab in Monitors Description Panel However it should not affect the rest of the monitoring data To see the IDL representation of large type code in Monitor you can increase the maximum type code serialized size both in the monitored Conniext application and in Monitor However if you do that you will also need to increase the values in the transport settings to support large data in Connex discovery traffic both in the monitored Connext application and in Monitor sample lange data QoS profile is shipped
28. t begin with dds tanaportahmem builtin See the documentation for Monitoring Library for an explanation of the transport settings To correct problem b use the iperm command to clean up the shared memory and shared semaphore resources See the RTI Core Libraries and Utilities Platform Notes for details You can also run Monitor and the Connext application that you want to monitor with another domain ID that doesn t have any shared memory or shared semaphore resources left over from previous Unable to Create Participant in Connext Application Ifyou see error messages similar to the following CREATE Participant RTIOsapiLihrary cpen error opening Library ztinonitoringnothing dll CREATE Participant DDS DomainParticipantMonitoring initializeMonitoringLibrary ERROR Failed to get load monitoring Library CREATE Participant DDS DomainParticipantMonitoring initializer lereate monitoring Library instance CREATE Participant DDS DomainParticipant createl create builtin monitor ing support CREATE Participant DDS DomainParticipantFactory create participant disabledI create participant These messages most likely mean that your Connext application is configured to load the moni toring library dynamically but you don t have the monitoring library in your path a2 Not Receiving Monitoring Data due to Inconsistent QoS 46 47 If you are running on a Linux system make sure that your LD_LIBRARY_PATH environment variable
29. ter property expression parameters ROCA E i Fania caeno ow perd NE ce ue d 5 Prepare for the next demo a Close the Description panel b In the two instances of Shapes Demo select Controls Delete A 3 3 Showing Deadlines The steps in this section assume you are using the same profile used in Section 3 1 for the two instances of Shapes Demo 1 In one instance of Shapes Demo create a reliable square publisher with a 100ms deadline Select Publish Square b Make sure the Reliability box is checked Set Deadline to 100 d Select OK 2 In the other instance of Spes Demo create a reliable square subscriber with a 250ms deadline Select Subscribe Square b Check the Reliability box c Set Deadline to 250 d Select OK ES Showing Deaiines 3 Inthe publisher Shapes Demo instance select Controls Pause Publishing 4 Observe the results in Monitor Select the Expand 3j button for the Physical View tree in Monitor Notice that all the entities in the Physical View tree are marked with yellow triangles to show there is a potential problem The root cause of the problem is in bold the DataWriter and DataReader in this case The parent entities are also marked with yellow triangles but notin bold vos cegca ven Be try Te EX v v p Tues aae s
30. the DataReader then select the Status Panel button from the toolbar c Select the Advanced display mode Notice that the Total Count values for Samples Lost and Samples Rejected are non zero This indicates that not all samples are being received Samples Lost and Sam ples Rejected are both yellow to indicate that this may or may not be a problem depending on your use case Also notice further down under DataReader Cache that both Sample Count and Sample Count Peak are 2 you will see why this is significant later the Physical View tree select the DataReader then select the Description Panel button from the toolbar sa Showing a Samples Rejected Scenario In the QoS tab scroll down and notice that the values for qos resource limits max samples and qos reader resource limits max samples per remote writer are both 2 which is the same as the Sample Count and Sample Count Peak values we saw in the Status panel This shows that the reader s queue for receiving samples is nial ogress sles t ns ita nag fad P aor menaras ln 6 Fix the problem by creating a DataReader with a larger queue size a In the Subscriber Shapes Demo instance select Controls Delete All b Create a new reliable square subscriber that uses take and the MonitorDemoLi brarysFixedSamplesRejectedScenario profile which will fix the problem by increas ing the que
31. ue size Select Subscribe Square d Choose the profile ManitorDemoLibrary FixedSamplesRejectedScenario This profile uses a larger queue size Check the Reliability box 6 For Read method to use select Take Select OK Showing a Samples Rejected Scenario 7 Verify the new reader queue size in Monitor Select the Expand 3j button under the Physical View tab b In the Physical View tree select the DataReader c In the Status panel that is already open notice that the Total Count values for Sam ples Lost and Samples Rejected are now zero In the DataReader Cache section notice the values for Sample Count and Sample Count Peak In the Description panel that is already open notice in the QoS tab that the values for gos resource limits max samples and qoslreader resource limits max samples per remote writer are now 100 This is larger than the SampleCount and Sample Count Peak values seen in the Status panel This shows that now the reader queue still has a lot of room before it becomes full and starts dropping sam ples This concludes the demo E Chapter4 Troubleshooting 41 42 43 Debugging Problems with Monitor on Windows System 1Eyou run Monitor on a Windows system and itis not showing any error messages but the Mon itor window is not showing up or you are not seeing any data in the Monitor window you can modify the fle installation directory gt scripts stimonitor
32. with the Monitoring Library bundle it has arge data support tumed on for both the UDPv and shared memory transports and a larger maximum type code serialized size Please see the documentation in the Monitoring Library bundle for an explanation of the large data QoS profile If you use the provided large data QoS profile you can uncomment the corresponding settings in the Monitor QoS profile to enable support for large type code and large data Both the monitored Connext application and Monitor must have consistent maximum type code serialized size and consistent transport settings The QoS pro file used by Monitor is in lt installation directory gt config stimonitor_qos_profiles xml Running out of Memory 49 4 10 Running out of Memory 16 Monitor is running out of memory you can use a smaller value for the historyDepth com mand line option or run Monitor on a 64 bit machine Running without an Active Network Interface 1E you run Monitor on a computer that does not have an active network interface you may see an error message stating No interface found enabled for multicast Modify the QoS profile used by Monitor to turn off UDPv and only use the shared memory transport eal SiN fans lt transpore but leine lt participant qos The QoS profile used by Monitor is in installation directory gt config stimonitor qos profiles xml See Section 33 in the Monitor User s Manual for more information on editing
33. y for publishing monitoring topics have QoS that are incompatible with the QoS of the internal DataReaders created by Monitor for subscribing to monitoring topics If you see this error message try specifying the rti monitorconfig qos library and rtimoni torconfig qos_profile properties in the Connext application that has monitoring turned on to ensure that the internally created DataWriters are using the correct QoS values The default QoS values used for the internally created DataReaders are listed in RTIMonitoringQosLibrary and RT IMonitoringPublishingQosProfile in the file Monitoring Library installation directory gt resource xml MONITORING_QOS_PROFILES xml in the Monitoring Library bundle Refer to Monitoring Library s documentation in the Monitoring Library bundle for an explanation of the QoS settings that are required to specify the QoS library and profile Not Receiving Monitoring Data for Entities Some of the monitoring topics the description monitoring topics can have data that is larger than what is supported by the default transport settings especially for cases in which a lot of propagated properties are added to the PropertyQosPolicy or a large UserDataQosPolicy Topic DataQosPolicy or GroupDataQosPolicy is involved By default asynchronous publishing is No Type Code for Some Entities in Description Panel 48 used for the writers in Monitoring Library for these monitoring topics to resolve the large data
Download Pdf Manuals
Related Search