The basic HelloWorld example is used to illustrate the necessary steps to setup DCPS entities.
This example also shows the deployment architecture choices available for OpenSpliceDDS. OpenSpliceDDS can be deployed as multiple processes interfacing directly with shared memory, or can be deployed with all OpenSpliceDDS services and applications in a single process utilizing dynamic heap memory. Please refer to the OpenSplice_Deployment.pdf document for more detailed discussion of these deployment strategies.
It consists of 4 units :
The publisher sends a single HelloWorld sample. The sample contains 2 fields :
When it receives the sample, the subscriber displays the userID field and the message field.
Let's call OpenSplice_install_dir the OpenSplice installation directory.
The OpenSpliceDDS environment variables must be set in order for the examples to build/run correctly. To do this, open a terminal and source the "OpenSplice_install_dir/release.com" script supplied with the distribution.
Building the examples is described on the Summary page
Two executables and a library are generated in the standalone folder when the example is built:
For C++
For C
Building the examples is described on the Summary page
Two jars are generated in the standalone folder when the example is built:
Ensure that the environment for OpenSpliceDDS is set up correctly as described above for each new terminal used. If running the C or C++ examples ensure that . is added to the LD_LIBRARY_PATH.
It is recommended that you run the subscriber and publisher in separate terminals to avoid mixing the output
Running in single process (heap memory) configuration : the application starts OpenSpliceDDS middleware
Running in multiple process shared memory configuration
To enable deployment in this mode, an OpenSpliceDDS configuration file must be selected that has shared memory support e.g. one of the ospl_shmem xml configuration files found in the OpenSplice_install_dir/etc/config directory.
Starting the subscriber and publisher
Let's call OpenSplice_install_dir the OpenSplice installation directory.
The OpenSpliceDDS environment variables must be set in order for the examples to run correctly. To do this open an OpenSpliceDDS Command Prompt which will set up the environment variables for OpenSpliceDDS automatically. The OpenSpliceDDS Command Prompt can be selected from the start menu. Alternatively, open a windows Command Prompt and execute the "OpenSplice_install_dir\release.bat" batch script supplied with the distribution.
Building the examples is described on the Summary page
Two executables are generated in the standalone directory when the example is built:
For C
For C++
Building the examples is described on the Summary page
The subscriber and publisher classes are generated in the standalone folder when the example is built:
Ensure that the environment for OpenSpliceDDS is set up correctly as described above for each new command prompt used.
The following steps describe how to run the examples:
Running in single process (heap memory) configuration : the application starts OpenSpliceDDS middleware
Running in multiple process shared memory configuration
To enable deployment in this mode, an OpenSpliceDDS configuration file must be selected that has shared memory support e.g. one of the ospl_shmem xml configuration files found in the OpenSplice_install_dir\etc\config directory.
Starting the subscriber and publisher
Doing the substitution and additional set ups described below, everything previously said for Standalone Mode can be applied to CORBA Cohabitation Mode.
Besides OpenSplice environment variables, we need to set