.. _`Connecting`:

#######################################
Initial configuration of Vortex Insight
#######################################

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.


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``):

.. code-block:: 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>
  ...

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:

.. code-block:: xml
   
   <DDSI2Service name="ddsi2">
     <TCP>
       <Enable>true</Enable>
       <Port>0</Port>
     </TCP>
   </DDSI2Service>
   ...


.. |info| image:: _images/info.*
            :height: 6mm