4. Initial configuration of Vortex Insight

4.1. Vortex OpenSplice Configuration for SOAP

Vortex Insight connects to a domain using the Simple Object Access Protocol (SOAP).

Vortex Insight users have two options for using SOAP:

  • Connect to an OSPL node that is running SOAP.

or

  • Start the SOAP service locally using the Advanced Settings on the client connect page. (Please refer to the Vortex Insight User Guide, Section Start CM SOAP on Connect.)

info Vortex OpenSplice has many configurable features. The tuner service for SOAP can be configured for the maximum number of clients (MaxClients) and the maximum number of threads per client (MaxThreadsPerClient). By default these are both configured to be 10. The defaults can be changed by explicitly setting them in a Vortex OpenSplice configuration file. If these defaults are changed to be less than ten, this could cause problems with Vortex Insight.

4.2. Statistics

One of the features of Vortex Insight is the ability to view the statistics for Vortex OpenSplice entities. However, for this feature to function, statistics must be enabled in any relevant Vortex OpenSplice configuration files.

Vortex OpenSplice provides examples on how to configure statistics. An excerpt from one such configuration file is provided below. The portion that is needed for statistics enablement is near the bottom of the extract.

(Excerpt from ospl_sp_ddsi_statistics.xml):

<OpenSplice>
  <Domain>
    <Name>ospl_sp_ddsi_statistics</Name>
    <Id>0</Id>
    <SingleProcess>true</SingleProcess>
    <Service name="ddsi2">
      <Command>ddsi2</Command>
    </Service>
    <Service name="durability">
      <Command>durability</Command>
    </Service>
    <Service name="cmsoap">
      <Command>cmsoap</Command>
    </Service>
    <Statistics>
      <Category enabled="true" name="reader"/>
      <Category enabled="true" name="writer"/>
      <Category enabled="true" name="durability"/>
      <Category enabled="true" name="networking"/>
    </Statistics>
</Domain>
...

4.3. Connecting to DDS systems using TCP as a transport

By default the Vortex Insight DDS connector is configured to connect to a DDS system using UDP as the transport.

To connect to a DDS system which uses TCP, the configuration file $INSIGHT_HOME/cmsoap/ospl_insight.xml needs to be modified to include the <TCP> section shown below:

<DDSI2Service name="ddsi2">
  <TCP>
    <Enable>true</Enable>
    <Port>0</Port>
  </TCP>
</DDSI2Service>
...